From 3c613d78e4086f075fada912285d47dab9b2ac7d Mon Sep 17 00:00:00 2001 From: Scott Hart Date: Mon, 4 Nov 2024 15:49:51 -0500 Subject: [PATCH 1/3] chore(compute): update discovery doc circa 20241015 --- .../compute_public_google_rest_v1.json | 161129 +++++++-------- 1 file changed, 79948 insertions(+), 81181 deletions(-) diff --git a/generator/discovery/compute_public_google_rest_v1.json b/generator/discovery/compute_public_google_rest_v1.json index f5e10e4f36721..49a01f6511154 100644 --- a/generator/discovery/compute_public_google_rest_v1.json +++ b/generator/discovery/compute_public_google_rest_v1.json @@ -1,47021 +1,37408 @@ { - "servicePath": "compute/v1/", - "description": "Creates and runs virtual machines on Google Cloud Platform. ", - "baseUrl": "https://compute.googleapis.com/compute/v1/", - "title": "Compute Engine API", - "batchPath": "batch/compute/v1", - "mtlsRootUrl": "https://compute.mtls.googleapis.com/", - "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" - }, - "rootUrl": "https://compute.googleapis.com/", - "kind": "discovery#restDescription", - "id": "compute:v1", - "auth": { - "oauth2": { - "scopes": { - "https://www.googleapis.com/auth/cloud-platform": { - "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." - }, - "https://www.googleapis.com/auth/compute": { - "description": "View and manage your Google Compute Engine resources" - }, - "https://www.googleapis.com/auth/compute.readonly": { - "description": "View your Google Compute Engine resources" - }, - "https://www.googleapis.com/auth/devstorage.full_control": { - "description": "Manage your data and permissions in Cloud Storage and see the email address for your Google Account" - }, - "https://www.googleapis.com/auth/devstorage.read_only": { - "description": "View your data in Google Cloud Storage" - }, - "https://www.googleapis.com/auth/devstorage.read_write": { - "description": "Manage your data in Cloud Storage and see the email address of your Google Account" - } - } + "parameters": { + "access_token": { + "type": "string", + "description": "OAuth access token.", + "location": "query" + }, + "alt": { + "type": "string", + "description": "Data format for response.", + "default": "json", + "enum": [ + "json", + "media", + "proto" + ], + "enumDescriptions": [ + "Responses with Content-Type of application/json", + "Media download with context-dependent Content-Type", + "Responses with Content-Type of application/x-protobuf" + ], + "location": "query" + }, + "callback": { + "type": "string", + "description": "JSONP", + "location": "query" + }, + "fields": { + "type": "string", + "description": "Selector specifying which fields to include in a partial response.", + "location": "query" + }, + "key": { + "type": "string", + "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", + "location": "query" + }, + "oauth_token": { + "type": "string", + "description": "OAuth 2.0 token for the current user.", + "location": "query" + }, + "prettyPrint": { + "type": "boolean", + "description": "Returns response with indentations and line breaks.", + "default": "true", + "location": "query" + }, + "quotaUser": { + "type": "string", + "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", + "location": "query" + }, + "upload_protocol": { + "type": "string", + "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", + "location": "query" + }, + "uploadType": { + "type": "string", + "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", + "location": "query" + }, + "userIp": { + "type": "string", + "description": "Legacy name for parameter that has been superseded by `quotaUser`.", + "location": "query" + }, + "$.xgafv": { + "type": "string", + "description": "V1 error format.", + "enum": [ + "1", + "2" + ], + "enumDescriptions": [ + "v1 error format", + "v2 error format" + ], + "location": "query" } }, - "schemas": { - "AcceleratorTypeList": { - "id": "AcceleratorTypeList", - "description": "Contains a list of accelerator types.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#acceleratorTypeList for lists of accelerator types.", - "default": "compute#acceleratorTypeList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of AcceleratorType resources.", - "type": "array", - "items": { - "$ref": "AcceleratorType" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "description": "Creates and runs virtual machines on Google Cloud Platform. ", + "ownerName": "Google", + "protocol": "rest", + "resources": { + "acceleratorTypes": { + "methods": { + "list": { + "id": "compute.acceleratorTypes.list", + "path": "projects/{project}/zones/{zone}/acceleratorTypes", + "flatPath": "projects/{project}/zones/{zone}/acceleratorTypes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "AcceleratorTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of accelerator types that are available to the specified project." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "aggregatedList": { + "id": "compute.acceleratorTypes.aggregatedList", + "path": "projects/{project}/aggregated/acceleratorTypes", + "flatPath": "projects/{project}/aggregated/acceleratorTypes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "AcceleratorTypeAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of accelerator types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + }, + "get": { + "id": "compute.acceleratorTypes.get", + "path": "projects/{project}/zones/{zone}/acceleratorTypes/{acceleratorType}", + "flatPath": "projects/{project}/zones/{zone}/acceleratorTypes/{acceleratorType}", + "httpMethod": "GET", + "parameters": { + "acceleratorType": { + "description": "Name of the accelerator type to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "zone", + "acceleratorType" + ], + "response": { + "$ref": "AcceleratorType" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified accelerator type." } } }, - "AcceleratorType": { - "id": "AcceleratorType", - "description": "Represents an Accelerator Type resource. Google Cloud Platform provides graphics processing units (accelerators) that you can add to VM instances to improve or accelerate performance when working with intensive workloads. For more information, read GPUs on Compute Engine.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The type of the resource. Always compute#acceleratorType for accelerator types.", - "default": "compute#acceleratorType", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "[Output Only] Name of the resource.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - }, - "description": { - "description": "[Output Only] An optional textual description of the resource.", - "type": "string" + "globalOperations": { + "methods": { + "list": { + "id": "compute.globalOperations.list", + "path": "projects/{project}/global/operations", + "flatPath": "projects/{project}/global/operations", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "OperationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of Operation resources contained within the specified project." }, - "deprecated": { - "description": "[Output Only] The deprecation status associated with this accelerator type.", - "$ref": "DeprecationStatus" + "aggregatedList": { + "id": "compute.globalOperations.aggregatedList", + "path": "projects/{project}/aggregated/operations", + "flatPath": "projects/{project}/aggregated/operations", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "OperationAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of all operations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "zone": { - "description": "[Output Only] The name of the zone where the accelerator type resides, such as us-central1-a. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" + "get": { + "id": "compute.globalOperations.get", + "path": "projects/{project}/global/operations/{operation}", + "flatPath": "projects/{project}/global/operations/{operation}", + "httpMethod": "GET", + "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric identifier.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "operation" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the specified Operations resource." }, - "selfLink": { - "description": "[Output Only] Server-defined, fully qualified URL for this resource.", - "type": "string" + "wait": { + "id": "compute.globalOperations.wait", + "path": "projects/{project}/global/operations/{operation}/wait", + "flatPath": "projects/{project}/global/operations/{operation}/wait", + "httpMethod": "POST", + "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric identifier.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "operation" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. " }, - "maximumCardsPerInstance": { - "description": "[Output Only] Maximum number of accelerator cards allowed per instance.", - "type": "integer", - "format": "int32" + "delete": { + "id": "compute.globalOperations.delete", + "path": "projects/{project}/global/operations/{operation}", + "flatPath": "projects/{project}/global/operations/{operation}", + "httpMethod": "DELETE", + "parameters": { + "operation": { + "description": "Name of the Operations resource to delete, or its unique numeric identifier.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "operation" + ], + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified Operations resource." } } }, - "DeprecationStatus": { - "id": "DeprecationStatus", - "description": "Deprecation status for a public resource.", - "type": "object", - "properties": { - "state": { - "description": "The deprecation state of this resource. This can be ACTIVE, DEPRECATED, OBSOLETE, or DELETED. Operations which communicate the end of life date for an image, can use ACTIVE. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "globalOrganizationOperations": { + "methods": { + "list": { + "id": "compute.globalOrganizationOperations.list", + "path": "locations/global/operations", + "flatPath": "locations/global/operations", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "parentId": { + "description": "Parent ID for this request.", + "location": "query", + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "response": { + "$ref": "OperationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ACTIVE", - "DELETED", - "DEPRECATED", - "OBSOLETE" - ] - }, - "replacement": { - "description": "The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.", - "type": "string" - }, - "deprecated": { - "description": "An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.", - "type": "string" + "description": "Retrieves a list of Operation resources contained within the specified organization." }, - "obsolete": { - "description": "An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.", - "type": "string" + "get": { + "id": "compute.globalOrganizationOperations.get", + "path": "locations/global/operations/{operation}", + "flatPath": "locations/global/operations/{operation}", + "httpMethod": "GET", + "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric identifier.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "parentId": { + "description": "Parent ID for this request.", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "operation" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the specified Operations resource. Gets a list of operations by making a `list()` request." }, - "deleted": { - "description": "An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.", - "type": "string" + "delete": { + "id": "compute.globalOrganizationOperations.delete", + "path": "locations/global/operations/{operation}", + "flatPath": "locations/global/operations/{operation}", + "httpMethod": "DELETE", + "parameters": { + "operation": { + "description": "Name of the Operations resource to delete, or its unique numeric identifier.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "parentId": { + "description": "Parent ID for this request.", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "operation" + ], + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified Operations resource." } } }, - "AcceleratorTypeAggregatedList": { - "id": "AcceleratorTypeAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#acceleratorTypeAggregatedList for aggregated lists of accelerator types.", - "default": "compute#acceleratorTypeAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of AcceleratorTypesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of accelerator types.", - "$ref": "AcceleratorTypesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "zoneOperations": { + "methods": { + "list": { + "id": "compute.zoneOperations.list", + "path": "projects/{project}/zones/{zone}/operations", + "flatPath": "projects/{project}/zones/{zone}/operations", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "Name of the zone for request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "AcceleratorTypesScopedList": { - "id": "AcceleratorTypesScopedList", - "type": "object", - "properties": { - "acceleratorTypes": { - "description": "[Output Only] A list of accelerator types contained in this scope.", - "type": "array", - "items": { - "$ref": "AcceleratorType" - } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "OperationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of Operation resources contained within the specified zone." }, - "warning": { - "description": "[Output Only] An informational warning that appears when the accelerator types list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "id": "compute.zoneOperations.get", + "path": "projects/{project}/zones/{zone}/operations/{operation}", + "flatPath": "projects/{project}/zones/{zone}/operations/{operation}", + "httpMethod": "GET", + "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric identifier.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "OperationList": { - "id": "OperationList", - "description": "Contains a list of Operation resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always `compute#operations` for Operations resource.", - "default": "compute#operationList", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string" - }, - "items": { - "description": "[Output Only] A list of Operation resources.", - "type": "array", - "items": { + }, + "parameterOrder": [ + "project", + "zone", + "operation" + ], + "response": { "$ref": "Operation" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results.", - "type": "string" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the specified zone-specific Operations resource." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "wait": { + "id": "compute.zoneOperations.wait", + "path": "projects/{project}/zones/{zone}/operations/{operation}/wait", + "flatPath": "projects/{project}/zones/{zone}/operations/{operation}/wait", + "httpMethod": "POST", + "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric identifier.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "operation" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method waits for no more than the 2 minutes and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. " }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "id": "compute.zoneOperations.delete", + "path": "projects/{project}/zones/{zone}/operations/{operation}", + "flatPath": "projects/{project}/zones/{zone}/operations/{operation}", + "httpMethod": "DELETE", + "parameters": { + "operation": { + "description": "Name of the Operations resource to delete, or its unique numeric identifier.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "zone", + "operation" + ], + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified zone-specific Operations resource." } } }, - "Operation": { - "id": "Operation", - "description": "Represents an Operation resource. Google Compute Engine has three Operation resources: * [Global](/compute/docs/reference/rest/v1/globalOperations) * [Regional](/compute/docs/reference/rest/v1/regionOperations) * [Zonal](/compute/docs/reference/rest/v1/zoneOperations) You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses. Operations can be global, regional or zonal. - For global operations, use the `globalOperations` resource. - For regional operations, use the `regionOperations` resource. - For zonal operations, use the `zoneOperations` resource. For more information, read Global, Regional, and Zonal Resources. Note that completed Operation resources have a limited retention period.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always `compute#operation` for Operation resources.", - "default": "compute#operation", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the operation. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Deprecated] This field is deprecated.", - "type": "string" - }, - "name": { - "description": "[Output Only] Name of the operation.", - "type": "string" - }, - "zone": { - "description": "[Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.", - "type": "string" - }, - "clientOperationId": { - "description": "[Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.", - "type": "string" - }, - "operationType": { - "description": "[Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.", - "type": "string" - }, - "targetLink": { - "description": "[Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the persistent disk that the snapshot was created from.", - "type": "string" - }, - "targetId": { - "description": "[Output Only] The unique target ID, which identifies a specific incarnation of the target resource.", - "type": "string", - "format": "uint64" - }, - "status": { - "description": "[Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "regionOperations": { + "methods": { + "list": { + "id": "compute.regionOperations.list", + "path": "projects/{project}/regions/{region}/operations", + "flatPath": "projects/{project}/regions/{region}/operations", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "DONE", - "PENDING", - "RUNNING" - ] - }, - "statusMessage": { - "description": "[Output Only] An optional textual description of the current status of the operation.", - "type": "string" - }, - "user": { - "description": "[Output Only] User who requested the operation, for example: `user@example.com` or `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.", - "type": "string" - }, - "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 when the operation will be complete. This number should monotonically increase as the operation progresses.", - "type": "integer", - "format": "int32" - }, - "insertTime": { - "description": "[Output Only] The time that this operation was requested. This value is in RFC3339 text format.", - "type": "string" - }, - "startTime": { - "description": "[Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.", - "type": "string" - }, - "endTime": { - "description": "[Output Only] The time that this operation was completed. This value is in RFC3339 text format.", - "type": "string" + "response": { + "$ref": "OperationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of Operation resources contained within the specified region." }, - "error": { - "description": "[Output Only] If errors are generated during processing of the operation, this field will be populated.", - "type": "object", - "properties": { - "errors": { - "description": "[Output Only] The array of errors encountered while processing this operation.", - "type": "array", - "items": { - "type": "object", - "properties": { - "code": { - "description": "[Output Only] The error type identifier for this error.", - "type": "string" - }, - "location": { - "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", - "type": "string" - }, - "message": { - "description": "[Output Only] An optional, human-readable error message.", - "type": "string" - }, - "errorDetails": { - "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", - "type": "array", - "items": { - "type": "object", - "properties": { - "errorInfo": { - "$ref": "ErrorInfo" - }, - "quotaInfo": { - "$ref": "QuotaExceededInfo" - }, - "help": { - "$ref": "Help" - }, - "localizedMessage": { - "$ref": "LocalizedMessage" - } - } - } - } - } - } + "get": { + "id": "compute.regionOperations.get", + "path": "projects/{project}/regions/{region}/operations/{operation}", + "flatPath": "projects/{project}/regions/{region}/operations/{operation}", + "httpMethod": "GET", + "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric identifier.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "region", + "operation" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the specified region-specific Operations resource." }, - "warnings": { - "description": "[Output Only] If warning messages are generated during processing of the operation, this field will be populated.", - "type": "array", - "items": { - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } + "wait": { + "id": "compute.regionOperations.wait", + "path": "projects/{project}/regions/{region}/operations/{operation}/wait", + "flatPath": "projects/{project}/regions/{region}/operations/{operation}/wait", + "httpMethod": "POST", + "parameters": { + "operation": { + "description": "Name of the Operations resource to return, or its unique numeric identifier.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - }, - "httpErrorStatusCode": { - "description": "[Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a `404` means the resource was not found.", - "type": "integer", - "format": "int32" - }, - "httpErrorMessage": { - "description": "[Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.", - "type": "string" - }, - "description": { - "description": "[Output Only] A textual description of the operation, which is set when the operation is created.", - "type": "string" - }, - "operationGroupId": { - "description": "[Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.", - "type": "string" - }, - "setCommonInstanceMetadataOperationMetadata": { - "description": "[Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state.", - "$ref": "SetCommonInstanceMetadataOperationMetadata" + }, + "parameterOrder": [ + "project", + "region", + "operation" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. " }, - "instancesBulkInsertOperationMetadata": { - "$ref": "InstancesBulkInsertOperationMetadata" + "delete": { + "id": "compute.regionOperations.delete", + "path": "projects/{project}/regions/{region}/operations/{operation}", + "flatPath": "projects/{project}/regions/{region}/operations/{operation}", + "httpMethod": "DELETE", + "parameters": { + "operation": { + "description": "Name of the Operations resource to delete, or its unique numeric identifier.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "operation" + ], + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified region-specific Operations resource." } } }, - "ErrorInfo": { - "id": "ErrorInfo", - "description": "Describes the cause of the error with structured details. Example of an error when contacting the \"pubsub.googleapis.com\" API when it is not enabled: { \"reason\": \"API_DISABLED\" \"domain\": \"googleapis.com\" \"metadata\": { \"resource\": \"projects/123\", \"service\": \"pubsub.googleapis.com\" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { \"reason\": \"STOCKOUT\" \"domain\": \"spanner.googleapis.com\", \"metadata\": { \"availableRegions\": \"us-central1,us-east2\" } }", - "type": "object", - "properties": { - "reason": { - "description": "The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.", - "type": "string" - }, - "domain": { - "description": "The logical grouping to which the \"reason\" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: \"pubsub.googleapis.com\". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is \"googleapis.com\".", - "type": "string" + "globalAddresses": { + "methods": { + "list": { + "id": "compute.globalAddresses.list", + "path": "projects/{project}/global/addresses", + "flatPath": "projects/{project}/global/addresses", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "AddressList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of global addresses." }, - "metadatas": { - "description": "Additional structured details about this error. Keys must match /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {\"instanceLimit\": \"100/request\"}, should be returned as, {\"instanceLimitPerRequest\": \"100\"}, if the client exceeds the number of instances that can be created in a single (batch) request.", - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } - }, - "QuotaExceededInfo": { - "id": "QuotaExceededInfo", - "description": "Additional details for quota exceeded error for resource quota.", - "type": "object", - "properties": { - "metricName": { - "description": "The Compute Engine quota metric name.", - "type": "string" + "get": { + "id": "compute.globalAddresses.get", + "path": "projects/{project}/global/addresses/{address}", + "flatPath": "projects/{project}/global/addresses/{address}", + "httpMethod": "GET", + "parameters": { + "address": { + "description": "Name of the address resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "address" + ], + "response": { + "$ref": "Address" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified address resource." }, - "limitName": { - "description": "The name of the quota limit.", - "type": "string" + "insert": { + "id": "compute.globalAddresses.insert", + "path": "projects/{project}/global/addresses", + "flatPath": "projects/{project}/global/addresses", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "Address" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates an address resource in the specified project by using the data included in the request." }, - "dimensions": { - "description": "The map holding related quota dimensions.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "limit": { - "description": "Current effective quota limit. The limit's unit depends on the quota type or metric.", - "type": "number", - "format": "double" - }, - "futureLimit": { - "description": "Future quota limit being rolled out. The limit's unit depends on the quota type or metric.", - "type": "number", - "format": "double" - }, - "rolloutStatus": { - "description": "Rollout status of the future quota limit.", - "type": "string", - "enumDescriptions": [ - "IN_PROGRESS - A rollout is in process which will change the limit value to future limit.", - "ROLLOUT_STATUS_UNSPECIFIED - Rollout status is not specified. The default value." + "delete": { + "id": "compute.globalAddresses.delete", + "path": "projects/{project}/global/addresses/{address}", + "flatPath": "projects/{project}/global/addresses/{address}", + "httpMethod": "DELETE", + "parameters": { + "address": { + "description": "Name of the address resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "address" ], - "enum": [ - "IN_PROGRESS", - "ROLLOUT_STATUS_UNSPECIFIED" - ] - } - } - }, - "Help": { - "id": "Help", - "description": "Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.", - "type": "object", - "properties": { - "links": { - "description": "URL(s) pointing to additional information on handling the current error.", - "type": "array", - "items": { - "$ref": "HelpLink" - } - } - } - }, - "HelpLink": { - "id": "HelpLink", - "description": "Describes a URL link.", - "type": "object", - "properties": { - "description": { - "description": "Describes what the link offers.", - "type": "string" - }, - "url": { - "description": "The URL of the link.", - "type": "string" - } - } - }, - "LocalizedMessage": { - "id": "LocalizedMessage", - "description": "Provides a localized error message that is safe to return to the user which can be attached to an RPC error.", - "type": "object", - "properties": { - "locale": { - "description": "The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: \"en-US\", \"fr-CH\", \"es-MX\"", - "type": "string" - }, - "message": { - "description": "The localized error message in the above locale.", - "type": "string" - } - } - }, - "SetCommonInstanceMetadataOperationMetadata": { - "id": "SetCommonInstanceMetadataOperationMetadata", - "type": "object", - "properties": { - "clientOperationId": { - "description": "[Output Only] The client operation id.", - "type": "string" - }, - "perLocationOperations": { - "description": "[Output Only] Status information per location (location name is key). Example key: zones/us-central1-a", - "type": "object", - "additionalProperties": { - "$ref": "SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo" - } - } - } - }, - "SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo": { - "id": "SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo", - "type": "object", - "properties": { - "state": { - "description": "[Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.", - "type": "string", - "enumDescriptions": [ - "Operation not tracked in this location e.g. zone is marked as DOWN.", - "Operation has completed successfully.", - "Operation is in an error state.", - "Operation is confirmed to be in the location.", - "Operation is not yet confirmed to have been created in the location.", - "" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "ABANDONED", - "DONE", - "FAILED", - "PROPAGATED", - "PROPAGATING", - "UNSPECIFIED" - ] - }, - "error": { - "description": "[Output Only] If state is `ABANDONED` or `FAILED`, this field is populated.", - "$ref": "Status" - } - } - }, - "Status": { - "id": "Status", - "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", - "type": "object", - "properties": { - "code": { - "description": "The status code, which should be an enum value of google.rpc.Code.", - "type": "integer", - "format": "int32" - }, - "message": { - "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", - "type": "string" + "description": "Deletes the specified address resource." }, - "details": { - "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", - "type": "array", - "items": { - "type": "object", - "additionalProperties": { - "type": "any", - "description": "Properties of the object. Contains field @type with type URL." + "move": { + "id": "compute.globalAddresses.move", + "path": "projects/{project}/global/addresses/{address}/move", + "flatPath": "projects/{project}/global/addresses/{address}/move", + "httpMethod": "POST", + "parameters": { + "address": { + "description": "Name of the address resource to move.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Source project ID which the Address is moved from.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "InstancesBulkInsertOperationMetadata": { - "id": "InstancesBulkInsertOperationMetadata", - "type": "object", - "properties": { - "perLocationStatus": { - "description": "Status information per location (location name is key). Example key: zones/us-central1-a", - "type": "object", - "additionalProperties": { - "$ref": "BulkInsertOperationStatus" - } - } - } - }, - "BulkInsertOperationStatus": { - "id": "BulkInsertOperationStatus", - "type": "object", - "properties": { - "status": { - "description": "[Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back.", - "type": "string", - "enumDescriptions": [ - "Rolling forward - creating VMs.", - "Done", - "Rolling back - cleaning up after an error.", - "" + }, + "parameterOrder": [ + "project", + "address" ], - "enum": [ - "CREATING", - "DONE", - "ROLLING_BACK", - "STATUS_UNSPECIFIED" - ] - }, - "targetVmCount": { - "description": "[Output Only] Count of VMs originally planned to be created.", - "type": "integer", - "format": "int32" - }, - "createdVmCount": { - "description": "[Output Only] Count of VMs successfully created so far.", - "type": "integer", - "format": "int32" - }, - "failedToCreateVmCount": { - "description": "[Output Only] Count of VMs that started creating but encountered an error.", - "type": "integer", - "format": "int32" + "request": { + "$ref": "GlobalAddressesMoveRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Moves the specified address resource from one project to another project." }, - "deletedVmCount": { - "description": "[Output Only] Count of VMs that got deleted during rollback.", - "type": "integer", - "format": "int32" + "setLabels": { + "id": "compute.globalAddresses.setLabels", + "path": "projects/{project}/global/addresses/{resource}/setLabels", + "flatPath": "projects/{project}/global/addresses/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on a GlobalAddress. To learn more about labels, read the Labeling Resources documentation." } } }, - "OperationAggregatedList": { - "id": "OperationAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always `compute#operationAggregatedList` for aggregated lists of operations.", - "default": "compute#operationAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string" - }, - "items": { - "description": "[Output Only] A map of scoped operation lists.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of operations.", - "$ref": "OperationsScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "addresses": { + "methods": { + "list": { + "id": "compute.addresses.list", + "path": "projects/{project}/regions/{region}/addresses", + "flatPath": "projects/{project}/regions/{region}/addresses", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "AddressList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of addresses contained within the specified region." }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "OperationsScopedList": { - "id": "OperationsScopedList", - "type": "object", - "properties": { - "operations": { - "description": "[Output Only] A list of operations contained in this scope.", - "type": "array", - "items": { - "$ref": "Operation" - } - }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of operations when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "id": "compute.addresses.aggregatedList", + "path": "projects/{project}/aggregated/addresses", + "flatPath": "projects/{project}/aggregated/addresses", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" } - } - } - } - }, - "AddressList": { - "id": "AddressList", - "description": "Contains a list of addresses.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#addressList for lists of addresses.", - "default": "compute#addressList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "AddressAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of addresses. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "items": { - "description": "A list of Address resources.", - "type": "array", - "items": { + "get": { + "id": "compute.addresses.get", + "path": "projects/{project}/regions/{region}/addresses/{address}", + "flatPath": "projects/{project}/regions/{region}/addresses/{address}", + "httpMethod": "GET", + "parameters": { + "address": { + "description": "Name of the address resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "address" + ], + "response": { "$ref": "Address" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified address resource." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.addresses.insert", + "path": "projects/{project}/regions/{region}/addresses", + "flatPath": "projects/{project}/regions/{region}/addresses", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - } - } - }, - "Address": { - "id": "Address", - "description": "Represents an IP Address resource. Google Compute Engine has two IP Address resources: * [Global (external and internal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses) * [Regional (external and internal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses) For more information, see Reserving a static external IP address.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#address for addresses.", - "default": "compute#address", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "annotations": { - "required": [ - "compute.addresses.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this field when you create the resource.", - "type": "string" - }, - "address": { - "description": "The static IP address represented by this resource.", - "type": "string" - }, - "prefixLength": { - "description": "The prefix length if the resource represents an IP range.", - "type": "integer", - "format": "int32" - }, - "status": { - "description": "[Output Only] The status of the address, which can be one of RESERVING, RESERVED, or IN_USE. An address that is RESERVING is currently in the process of being reserved. A RESERVED address is currently reserved and available to use. An IN_USE address is currently being used by another resource and is not available.", - "type": "string", - "enumDescriptions": [ - "Address is being used by another resource and is not available.", - "Address is reserved and available to use.", - "Address is being reserved." + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "IN_USE", - "RESERVED", - "RESERVING" - ] - }, - "region": { - "description": "[Output Only] The URL of the region where a regional address resides. For regional addresses, you must specify the region as a path parameter in the HTTP request URL. *This field is not applicable to global addresses.*", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "users": { - "description": "[Output Only] The URLs of the resources that are using this address.", - "type": "array", - "items": { - "type": "string" - } - }, - "networkTier": { - "description": "This signifies the networking tier used for configuring this address and can only take the following values: PREMIUM or STANDARD. Internal IP addresses are always Premium Tier; global external IP addresses are always Premium Tier; regional external IP addresses can be either Standard or Premium Tier. If this field is not specified, it is assumed to be PREMIUM.", - "type": "string", - "enumDescriptions": [ - "Public internet quality with fixed bandwidth.", - "High quality, Google-grade network tier, support for all networking products.", - "Public internet quality, only limited support for other networking products.", - "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." + "request": { + "$ref": "Address" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" - ] - }, - "labels": { - "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this Address, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Address.", - "type": "string", - "format": "byte" + "description": "Creates an address resource in the specified project by using the data included in the request." }, - "ipVersion": { - "description": "The IP version that will be used by this address. Valid options are IPV4 or IPV6.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "delete": { + "id": "compute.addresses.delete", + "path": "projects/{project}/regions/{region}/addresses/{address}", + "flatPath": "projects/{project}/regions/{region}/addresses/{address}", + "httpMethod": "DELETE", + "parameters": { + "address": { + "description": "Name of the address resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "address" ], - "enum": [ - "IPV4", - "IPV6", - "UNSPECIFIED_VERSION" - ] - }, - "addressType": { - "description": "The type of address to reserve, either INTERNAL or EXTERNAL. If unspecified, defaults to EXTERNAL.", - "type": "string", - "enumDescriptions": [ - "A publicly visible external IP address.", - "A private network IP address, for use with an Instance or Internal Load Balancer forwarding rule.", - "" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "EXTERNAL", - "INTERNAL", - "UNSPECIFIED_TYPE" - ] + "description": "Deletes the specified address resource." }, - "purpose": { - "description": "The purpose of this resource, which can be one of the following values: - GCE_ENDPOINT for addresses that are used by VM instances, alias IP ranges, load balancers, and similar resources. - DNS_RESOLVER for a DNS resolver address in a subnetwork for a Cloud DNS inbound forwarder IP addresses (regional internal IP address in a subnet of a VPC network) - VPC_PEERING for global internal IP addresses used for private services access allocated ranges. - NAT_AUTO for the regional external IP addresses used by Cloud NAT when allocating addresses using automatic NAT IP address allocation. - IPSEC_INTERCONNECT for addresses created from a private IP range that are reserved for a VLAN attachment in an *HA VPN over Cloud Interconnect* configuration. These addresses are regional resources. - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned to multiple internal forwarding rules. - `PRIVATE_SERVICE_CONNECT` for a private network address that is used to configure Private Service Connect. Only global internal addresses can use this purpose. ", - "type": "string", - "enumDescriptions": [ - "DNS resolver address in the subnetwork.", - "VM internal/alias IP, Internal LB service IP, etc.", - "A regional internal IP address range reserved for the VLAN attachment that is used in HA VPN over Cloud Interconnect. This regional internal IP address range must not overlap with any IP address range of subnet/route in the VPC network and its peering networks. After the VLAN attachment is created with the reserved IP address range, when creating a new VPN gateway, its interface IP address is allocated from the associated VLAN attachment’s IP address range.", - "External IP automatically reserved for Cloud NAT.", - "A private network IP address that can be used to configure Private Service Connect. This purpose can be specified only for GLOBAL addresses of Type INTERNAL", - "A regional internal IP address range reserved for Serverless.", - "A private network IP address that can be shared by multiple Internal Load Balancer forwarding rules.", - "IP range for peer networks." + "move": { + "id": "compute.addresses.move", + "path": "projects/{project}/regions/{region}/addresses/{address}/move", + "flatPath": "projects/{project}/regions/{region}/addresses/{address}/move", + "httpMethod": "POST", + "parameters": { + "address": { + "description": "Name of the address resource to move.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Source project ID which the Address is moved from.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "address" ], - "enum": [ - "DNS_RESOLVER", - "GCE_ENDPOINT", - "IPSEC_INTERCONNECT", - "NAT_AUTO", - "PRIVATE_SERVICE_CONNECT", - "SERVERLESS", - "SHARED_LOADBALANCER_VIP", - "VPC_PEERING" - ] - }, - "subnetwork": { - "description": "The URL of the subnetwork in which to reserve the address. If an IP address is specified, it must be within the subnetwork's IP range. This field can only be used with INTERNAL type with a GCE_ENDPOINT or DNS_RESOLVER purpose.", - "type": "string" - }, - "network": { - "description": "The URL of the network in which to reserve the address. This field can only be used with INTERNAL type with the VPC_PEERING purpose.", - "type": "string" - }, - "ipv6EndpointType": { - "description": "The endpoint type of this address, which should be VM or NETLB. This is used for deciding which type of endpoint this address can be used after the external IPv6 address reservation.", - "type": "string", - "enumDescriptions": [ - "Reserved IPv6 address can be used on network load balancer.", - "Reserved IPv6 address can be used on VM." + "request": { + "$ref": "RegionAddressesMoveRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "NETLB", - "VM" - ] - } - } - }, - "GlobalAddressesMoveRequest": { - "id": "GlobalAddressesMoveRequest", - "type": "object", - "properties": { - "destinationAddress": { - "description": "The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project /global/addresses/address - projects/project/global/addresses/address Note that destination project must be different from the source project. So /global/addresses/address is not valid partial url.", - "type": "string" - }, - "description": { - "description": "An optional destination address description if intended to be different from the source.", - "type": "string" - } - } - }, - "GlobalSetLabelsRequest": { - "id": "GlobalSetLabelsRequest", - "type": "object", - "properties": { - "labels": { - "description": "A list of labels to apply for this resource. Each label must comply with the requirements for labels. For example, \"webserver-frontend\": \"images\". A label value can also be empty (e.g. \"my-label\": \"\").", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash when updating or changing labels, otherwise the request will fail with error 412 conditionNotMet. Make a get() request to the resource to get the latest fingerprint.", - "type": "string", - "format": "byte" - } - } - }, - "AddressAggregatedList": { - "id": "AddressAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#addressAggregatedList for aggregated lists of addresses.", - "default": "compute#addressAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of AddressesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of addresses.", - "$ref": "AddressesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "description": "Moves the specified address resource." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setLabels": { + "id": "compute.addresses.setLabels", + "path": "projects/{project}/regions/{region}/addresses/{resource}/setLabels", + "flatPath": "projects/{project}/regions/{region}/addresses/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on an Address. To learn more about labels, read the Labeling Resources documentation." } } }, - "AddressesScopedList": { - "id": "AddressesScopedList", - "type": "object", - "properties": { - "addresses": { - "description": "[Output Only] A list of addresses contained in this scope.", - "type": "array", - "items": { - "$ref": "Address" - } - }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of addresses when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "images": { + "methods": { + "list": { + "id": "compute.images.list", + "path": "projects/{project}/global/images", + "flatPath": "projects/{project}/global/images", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "RegionAddressesMoveRequest": { - "id": "RegionAddressesMoveRequest", - "type": "object", - "properties": { - "destinationAddress": { - "description": "The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project/regions/region /addresses/address - projects/project/regions/region/addresses/address Note that destination project must be different from the source project. So /regions/region/addresses/address is not valid partial url.", - "type": "string" - }, - "description": { - "description": "An optional destination address description if intended to be different from the source.", - "type": "string" - } - } - }, - "RegionSetLabelsRequest": { - "id": "RegionSetLabelsRequest", - "type": "object", - "properties": { - "labels": { - "description": "The labels to set for this resource.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint.", - "type": "string", - "format": "byte" - } - } - }, - "ImageList": { - "id": "ImageList", - "description": "Contains a list of images.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#imageList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "ImageList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of custom images available to the specified project. Custom images are images you create that belong to your project. This method does not get any images that belong to other projects, including publicly-available images, like Debian 8. If you want to get a list of publicly-available images, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud." }, - "items": { - "description": "A list of Image resources.", - "type": "array", - "items": { + "get": { + "id": "compute.images.get", + "path": "projects/{project}/global/images/{image}", + "flatPath": "projects/{project}/global/images/{image}", + "httpMethod": "GET", + "parameters": { + "image": { + "description": "Name of the image resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "image" + ], + "response": { "$ref": "Image" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified image." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "getFromFamily": { + "id": "compute.images.getFromFamily", + "path": "projects/{project}/global/images/family/{family}", + "flatPath": "projects/{project}/global/images/family/{family}", + "httpMethod": "GET", + "parameters": { + "family": { + "description": "Name of the image family to search for.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "The image project that the image belongs to. For example, to get a CentOS image, specify centos-cloud as the image project.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "family" + ], + "response": { + "$ref": "Image" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the latest image that is part of an image family and is not deprecated. For more information on image families, see Public image families documentation." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.images.insert", + "path": "projects/{project}/global/images", + "flatPath": "projects/{project}/global/images", + "httpMethod": "POST", + "parameters": { + "forceCreate": { + "description": "Force image creation if true.", + "location": "query", + "type": "boolean" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "Image": { - "id": "Image", - "description": "Represents an Image resource. You can use images to create boot disks for your VM instances. For more information, read Images.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#image for images.", - "default": "compute#image", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.images.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "Image" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/devstorage.full_control", + "https://www.googleapis.com/auth/devstorage.read_only", + "https://www.googleapis.com/auth/devstorage.read_write" + ], + "description": "Creates an image in the specified project using the data included in the request." }, - "sourceType": { - "description": "The type of the image used to create this disk. The default and only valid value is RAW.", - "default": "RAW", - "type": "string", - "enumDescriptions": [ - "" + "setLabels": { + "id": "compute.images.setLabels", + "path": "projects/{project}/global/images/{resource}/setLabels", + "flatPath": "projects/{project}/global/images/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "RAW" - ] + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on an image. To learn more about labels, read the Labeling Resources documentation." }, - "rawDisk": { - "description": "The parameters of the raw disk image.", - "type": "object", - "properties": { - "source": { - "description": "The full Google Cloud Storage URL where the raw disk image archive is stored. The following are valid formats for the URL: - https://storage.googleapis.com/bucket_name/image_archive_name - https://storage.googleapis.com/bucket_name/folder_name/ image_archive_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL ", + "delete": { + "id": "compute.images.delete", + "path": "projects/{project}/global/images/{image}", + "flatPath": "projects/{project}/global/images/{image}", + "httpMethod": "DELETE", + "parameters": { + "image": { + "description": "Name of the image resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, "type": "string" }, - "sha1Checksum": { - "description": "[Deprecated] This field is deprecated. An optional SHA1 checksum of the disk image before unpackaging provided by the client when the disk image is created.", - "pattern": "[a-f0-9]{40}", - "deprecated": true, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "containerType": { - "description": "The format used to encode and transmit the block device, which should be TAR. This is just a container and transmission format and not a runtime format. Provided by the client when the disk image is created.", - "type": "string", - "enumDescriptions": [ - "" - ], - "enum": [ - "TAR" - ] + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "deprecated": { - "description": "The deprecation status associated with this image.", - "$ref": "DeprecationStatus" - }, - "status": { - "description": "[Output Only] The status of the image. An image can be used to create other resources, such as instances, only after the image has been successfully created and the status is set to READY. Possible values are FAILED, PENDING, or READY.", - "type": "string", - "enumDescriptions": [ - "Image is deleting.", - "Image creation failed due to an error.", - "Image hasn't been created as yet.", - "Image has been successfully created." + }, + "parameterOrder": [ + "project", + "image" ], - "enum": [ - "DELETING", - "FAILED", - "PENDING", - "READY" - ] - }, - "archiveSizeBytes": { - "description": "Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).", - "type": "string", - "format": "int64" - }, - "diskSizeGb": { - "description": "Size of the image when restored onto a persistent disk (in GB).", - "type": "string", - "format": "int64" - }, - "sourceDisk": { - "description": "URL of the source disk used to create this image. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL ", - "type": "string" - }, - "sourceDiskId": { - "description": "[Output Only] 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" - }, - "licenses": { - "description": "Any applicable license URI.", - "type": "array", - "items": { - "type": "string" - } + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified image." }, - "family": { - "description": "The name of the image family to which this image belongs. The image family name can be from a publicly managed image family provided by Compute Engine, or from a custom image family you create. For example, centos-stream-9 is a publicly available image family. For more information, see Image family best practices. When creating disks, you can specify an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.", - "type": "string" - }, - "imageEncryptionKey": { - "description": "Encrypts the image using a customer-supplied encryption key. After you encrypt an image with a customer-supplied key, you must provide the same key if you use the image later (e.g. to create a disk from the image). Customer-supplied encryption keys do not protect access to metadata of the disk. If you do not provide an encryption key when creating the image, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the image later.", - "$ref": "CustomerEncryptionKey" - }, - "sourceDiskEncryptionKey": { - "description": "The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key.", - "$ref": "CustomerEncryptionKey" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "labels": { - "description": "Labels to apply to this image. These can be later modified by the setLabels method.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an image.", - "type": "string", - "format": "byte" - }, - "guestOsFeatures": { - "description": "A list of features to enable on the guest operating system. Applicable only for bootable images. To see a list of available options, see the guestOSfeatures[].type parameter.", - "type": "array", - "items": { - "$ref": "GuestOsFeature" - } - }, - "licenseCodes": { - "description": "Integer license codes indicating which licenses are attached to this image.", - "type": "array", - "items": { - "type": "string", - "format": "int64" - } - }, - "sourceImage": { - "description": "URL of the source image used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ images/image_name - projects/project_id/global/images/image_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL ", - "type": "string" - }, - "sourceImageId": { - "description": "[Output Only] The ID value of the image 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 image name.", - "type": "string" - }, - "sourceImageEncryptionKey": { - "description": "The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key.", - "$ref": "CustomerEncryptionKey" - }, - "sourceSnapshot": { - "description": "URL of the source snapshot used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ snapshots/snapshot_name - projects/project_id/global/snapshots/snapshot_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL ", - "type": "string" - }, - "sourceSnapshotId": { - "description": "[Output Only] The ID value of the snapshot used to create this image. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given snapshot name.", - "type": "string" - }, - "sourceSnapshotEncryptionKey": { - "description": "The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key.", - "$ref": "CustomerEncryptionKey" - }, - "storageLocations": { - "description": "Cloud Storage bucket storage location of the image (regional or multi-regional).", - "type": "array", - "items": { - "type": "string" - } - }, - "shieldedInstanceInitialState": { - "description": "Set the secure boot keys of shielded instance.", - "$ref": "InitialStateConfig" - }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - }, - "architecture": { - "description": "The architecture of the image. Valid values are ARM64 or X86_64.", - "type": "string", - "enumDescriptions": [ - "Default value indicating Architecture is not set.", - "Machines with architecture ARM64", - "Machines with architecture X86_64" + "deprecate": { + "id": "compute.images.deprecate", + "path": "projects/{project}/global/images/{image}/deprecate", + "flatPath": "projects/{project}/global/images/{image}/deprecate", + "httpMethod": "POST", + "parameters": { + "image": { + "description": "Image name.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "image" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" - ] - }, - "enableConfidentialCompute": { - "description": "Whether this image is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk.", - "type": "boolean" - }, - "satisfiesPzi": { - "description": "Output only. Reserved for future use.", - "readOnly": true, - "type": "boolean" - } - } - }, - "CustomerEncryptionKey": { - "id": "CustomerEncryptionKey", - "type": "object", - "properties": { - "rawKey": { - "description": "Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 base64 to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: \"rawKey\": \"SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=\" ", - "type": "string" + "request": { + "$ref": "DeprecationStatus" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the deprecation status of an image. If an empty request body is given, clears the deprecation status instead." }, - "rsaEncryptedKey": { - "description": "Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit customer-supplied encryption key to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: \"rsaEncryptedKey\": \"ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==\" The key must meet the following requirements before you can provide it to Compute Engine: 1. The key is wrapped using a RSA public key certificate provided by Google. 2. After being wrapped, the key must be encoded in RFC 4648 base64 encoding. Gets the RSA public key certificate provided by Google at: https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem ", - "type": "string" + "getIamPolicy": { + "id": "compute.images.getIamPolicy", + "path": "projects/{project}/global/images/{resource}/getIamPolicy", + "flatPath": "projects/{project}/global/images/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "kmsKeyName": { - "description": "The name of the encryption key that is stored in Google Cloud KMS. For example: \"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key The fully-qualifed key name may be returned for resource GET requests. For example: \"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeyVersions/1 ", - "type": "string" + "patch": { + "id": "compute.images.patch", + "path": "projects/{project}/global/images/{image}", + "flatPath": "projects/{project}/global/images/{image}", + "httpMethod": "PATCH", + "parameters": { + "image": { + "description": "Name of the image resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "image" + ], + "request": { + "$ref": "Image" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified image with the data included in the request. Only the following fields can be modified: family, description, deprecation status." }, - "sha256": { - "description": "[Output only] The RFC 4648 base64 encoded SHA-256 hash of the customer-supplied encryption key that protects this resource.", - "type": "string" + "setIamPolicy": { + "id": "compute.images.setIamPolicy", + "path": "projects/{project}/global/images/{resource}/setIamPolicy", + "flatPath": "projects/{project}/global/images/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "kmsKeyServiceAccount": { - "description": "The service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. For example: \"kmsKeyServiceAccount\": \"name@project_id.iam.gserviceaccount.com/ ", - "type": "string" + "testIamPermissions": { + "id": "compute.images.testIamPermissions", + "path": "projects/{project}/global/images/{resource}/testIamPermissions", + "flatPath": "projects/{project}/global/images/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "GuestOsFeature": { - "id": "GuestOsFeature", - "description": "Guest OS features.", - "type": "object", - "properties": { - "type": { - "description": "The ID of a supported feature. To add multiple values, use commas to separate values. Set to one or more of the following values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE_V2 - SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF For more information, see Enabling guest operating system features.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "imageFamilyViews": { + "methods": { + "get": { + "id": "compute.imageFamilyViews.get", + "path": "projects/{project}/zones/{zone}/imageFamilyViews/{family}", + "flatPath": "projects/{project}/zones/{zone}/imageFamilyViews/{family}", + "httpMethod": "GET", + "parameters": { + "family": { + "description": "Name of the image family to search for.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "family" ], - "enum": [ - "FEATURE_TYPE_UNSPECIFIED", - "GVNIC", - "IDPF", - "MULTI_IP_SUBNET", - "SECURE_BOOT", - "SEV_CAPABLE", - "SEV_LIVE_MIGRATABLE", - "SEV_LIVE_MIGRATABLE_V2", - "SEV_SNP_CAPABLE", - "TDX_CAPABLE", - "UEFI_COMPATIBLE", - "VIRTIO_SCSI_MULTIQUEUE", - "WINDOWS" - ] + "response": { + "$ref": "ImageFamilyView" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the latest image that is part of an image family, is not deprecated and is rolled out in the specified zone." } } }, - "InitialStateConfig": { - "id": "InitialStateConfig", - "description": "Initial State for shielded instance, these are public keys which are safe to store in public", - "type": "object", - "properties": { - "pk": { - "description": "The Platform Key (PK).", - "$ref": "FileContentBuffer" - }, - "keks": { - "description": "The Key Exchange Key (KEK).", - "type": "array", - "items": { - "$ref": "FileContentBuffer" - } + "snapshots": { + "methods": { + "list": { + "id": "compute.snapshots.list", + "path": "projects/{project}/global/snapshots", + "flatPath": "projects/{project}/global/snapshots", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "SnapshotList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of Snapshot resources contained within the specified project." }, - "dbs": { - "description": "The Key Database (db).", - "type": "array", - "items": { - "$ref": "FileContentBuffer" - } + "get": { + "id": "compute.snapshots.get", + "path": "projects/{project}/global/snapshots/{snapshot}", + "flatPath": "projects/{project}/global/snapshots/{snapshot}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "snapshot": { + "description": "Name of the Snapshot resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "snapshot" + ], + "response": { + "$ref": "Snapshot" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified Snapshot resource." }, - "dbxs": { - "description": "The forbidden key database (dbx).", - "type": "array", - "items": { - "$ref": "FileContentBuffer" - } - } - } - }, - "FileContentBuffer": { - "id": "FileContentBuffer", - "type": "object", - "properties": { - "content": { - "description": "The raw content in the secure keys file.", - "type": "string", - "format": "byte" - }, - "fileType": { - "description": "The file type of source file.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "insert": { + "id": "compute.snapshots.insert", + "path": "projects/{project}/global/snapshots", + "flatPath": "projects/{project}/global/snapshots", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" ], - "enum": [ - "BIN", - "UNDEFINED", - "X509" - ] - } - } - }, - "Policy": { - "id": "Policy", - "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", - "type": "object", - "properties": { - "version": { - "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", - "type": "integer", - "format": "int32" - }, - "bindings": { - "description": "Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.", - "type": "array", - "items": { - "$ref": "Binding" - } - }, - "auditConfigs": { - "description": "Specifies cloud audit logging configuration for this policy.", - "type": "array", - "items": { - "$ref": "AuditConfig" - } - }, - "rules": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "array", - "items": { - "$ref": "Rule" - } - }, - "etag": { - "description": "`etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.", - "type": "string", - "format": "byte" - } - } - }, - "Binding": { - "id": "Binding", - "description": "Associates `members`, or principals, with a `role`.", - "type": "object", - "properties": { - "role": { - "description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).", - "type": "string" - }, - "members": { - "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", - "type": "array", - "items": { - "type": "string" - } - }, - "condition": { - "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", - "$ref": "Expr" - }, - "bindingId": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - } - } - }, - "Expr": { - "id": "Expr", - "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' && document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", - "type": "object", - "properties": { - "expression": { - "description": "Textual representation of an expression in Common Expression Language syntax.", - "type": "string" - }, - "title": { - "description": "Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.", - "type": "string" - }, - "description": { - "description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.", - "type": "string" - }, - "location": { - "description": "Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.", - "type": "string" - } - } - }, - "AuditLogConfig": { - "id": "AuditLogConfig", - "description": "Provides the configuration for logging a type of permissions. Example: { \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.", - "type": "object", - "properties": { - "logType": { - "description": "The log type that this config enables.", - "type": "string", - "enumDescriptions": [ - "Admin reads. Example: CloudIAM getIamPolicy", - "Data reads. Example: CloudSQL Users list", - "Data writes. Example: CloudSQL Users create", - "Default case. Should never be this." + "request": { + "$ref": "Snapshot" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "ADMIN_READ", - "DATA_READ", - "DATA_WRITE", - "LOG_TYPE_UNSPECIFIED" - ] - }, - "exemptedMembers": { - "description": "Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.", - "type": "array", - "items": { - "type": "string" - } - }, - "ignoreChildExemptions": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "boolean" - } - } - }, - "Rule": { - "id": "Rule", - "description": "This is deprecated and has no effect. Do not use.", - "type": "object", - "properties": { - "description": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "permissions": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "array", - "items": { - "type": "string" - } + "description": "Creates a snapshot in the specified project using the data included in the request. For regular snapshot creation, consider using this method instead of disks.createSnapshot, as this method supports more features, such as creating snapshots in a project different from the source disk project." }, - "action": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string", - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." + "setLabels": { + "id": "compute.snapshots.setLabels", + "path": "projects/{project}/global/snapshots/{resource}/setLabels", + "flatPath": "projects/{project}/global/snapshots/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "ALLOW", - "ALLOW_WITH_LOG", - "DENY", - "DENY_WITH_LOG", - "LOG", - "NO_ACTION" - ] - }, - "ins": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "array", - "items": { - "type": "string" - } - }, - "notIns": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "array", - "items": { - "type": "string" - } - }, - "conditions": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "array", - "items": { - "$ref": "Condition" - } - }, - "logConfigs": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "array", - "items": { - "$ref": "LogConfig" - } - } - } - }, - "Condition": { - "id": "Condition", - "description": "This is deprecated and has no effect. Do not use.", - "type": "object", - "properties": { - "iam": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string", - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "APPROVER", - "ATTRIBUTION", - "AUTHORITY", - "CREDENTIALS_TYPE", - "CREDS_ASSERTION", - "JUSTIFICATION_TYPE", - "NO_ATTR", - "SECURITY_REALM" - ] + "description": "Sets the labels on a snapshot. To learn more about labels, read the Labeling Resources documentation." }, - "sys": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string", - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." + "delete": { + "id": "compute.snapshots.delete", + "path": "projects/{project}/global/snapshots/{snapshot}", + "flatPath": "projects/{project}/global/snapshots/{snapshot}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "snapshot": { + "description": "Name of the Snapshot resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "snapshot" ], - "enum": [ - "IP", - "NAME", - "NO_ATTR", - "REGION", - "SERVICE" - ] - }, - "svc": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "op": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string", - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "DISCHARGED", - "EQUALS", - "IN", - "NOT_EQUALS", - "NOT_IN", - "NO_OP" - ] - }, - "values": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "LogConfig": { - "id": "LogConfig", - "description": "This is deprecated and has no effect. Do not use.", - "type": "object", - "properties": { - "counter": { - "description": "This is deprecated and has no effect. Do not use.", - "$ref": "LogConfigCounterOptions" - }, - "dataAccess": { - "description": "This is deprecated and has no effect. Do not use.", - "$ref": "LogConfigDataAccessOptions" - }, - "cloudAudit": { - "description": "This is deprecated and has no effect. Do not use.", - "$ref": "LogConfigCloudAuditOptions" - } - } - }, - "LogConfigCounterOptions": { - "id": "LogConfigCounterOptions", - "description": "This is deprecated and has no effect. Do not use.", - "type": "object", - "properties": { - "metric": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "field": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - }, - "customFields": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "array", - "items": { - "$ref": "LogConfigCounterOptionsCustomField" - } - } - } - }, - "LogConfigCounterOptionsCustomField": { - "id": "LogConfigCounterOptionsCustomField", - "description": "This is deprecated and has no effect. Do not use.", - "type": "object", - "properties": { - "name": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" + "description": "Deletes the specified Snapshot resource. Keep in mind that deleting a single snapshot might not necessarily delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next corresponding snapshot. For more information, see Deleting snapshots." }, - "value": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string" - } - } - }, - "LogConfigDataAccessOptions": { - "id": "LogConfigDataAccessOptions", - "description": "This is deprecated and has no effect. Do not use.", - "type": "object", - "properties": { - "logMode": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string", - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." + "getIamPolicy": { + "id": "compute.snapshots.getIamPolicy", + "path": "projects/{project}/global/snapshots/{resource}/getIamPolicy", + "flatPath": "projects/{project}/global/snapshots/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "LOG_FAIL_CLOSED", - "LOG_MODE_UNSPECIFIED" - ] - } - } - }, - "LogConfigCloudAuditOptions": { - "id": "LogConfigCloudAuditOptions", - "description": "This is deprecated and has no effect. Do not use.", - "type": "object", - "properties": { - "logName": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "string", - "enumDescriptions": [ - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use.", - "This is deprecated and has no effect. Do not use." + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ADMIN_ACTIVITY", - "DATA_ACCESS", - "UNSPECIFIED_LOG_NAME" - ] - } - } - }, - "GlobalSetPolicyRequest": { - "id": "GlobalSetPolicyRequest", - "type": "object", - "properties": { - "policy": { - "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them.", - "$ref": "Policy" + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "bindings": { - "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings.", - "type": "array", - "items": { - "$ref": "Binding" - } + "setIamPolicy": { + "id": "compute.snapshots.setIamPolicy", + "path": "projects/{project}/global/snapshots/{resource}/setIamPolicy", + "flatPath": "projects/{project}/global/snapshots/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "etag": { - "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.", - "type": "string", - "format": "byte" - } - } - }, - "TestPermissionsRequest": { - "id": "TestPermissionsRequest", - "type": "object", - "properties": { - "permissions": { - "description": "The set of permissions to check for the 'resource'. Permissions with wildcards (such as '*' or 'storage.*') are not allowed.", - "type": "array", - "items": { - "type": "string" - } + "testIamPermissions": { + "id": "compute.snapshots.testIamPermissions", + "path": "projects/{project}/global/snapshots/{resource}/testIamPermissions", + "flatPath": "projects/{project}/global/snapshots/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "TestPermissionsResponse": { - "id": "TestPermissionsResponse", - "type": "object", - "properties": { - "permissions": { - "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ImageFamilyView": { - "id": "ImageFamilyView", - "type": "object", - "properties": { - "image": { - "description": "The latest image that is part of the specified image family in the requested location, and that is not deprecated.", - "$ref": "Image" - } - } - }, - "SnapshotList": { - "id": "SnapshotList", - "description": "Contains a list of Snapshot resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#snapshotList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Snapshot resources.", - "type": "array", - "items": { - "$ref": "Snapshot" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "disks": { + "methods": { + "list": { + "id": "compute.disks.list", + "path": "projects/{project}/zones/{zone}/disks", + "flatPath": "projects/{project}/zones/{zone}/disks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "Snapshot": { - "id": "Snapshot", - "description": "Represents a Persistent Disk Snapshot resource. You can use snapshots to back up data on a regular interval. For more information, read Creating persistent disk snapshots.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#snapshot for Snapshot resources.", - "default": "compute#snapshot", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.disks.createSnapshot", - "compute.snapshots.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "status": { - "description": "[Output Only] The status of the snapshot. This can be CREATING, DELETING, FAILED, READY, or UPLOADING.", - "type": "string", - "enumDescriptions": [ - "Snapshot creation is in progress.", - "Snapshot is currently being deleted.", - "Snapshot creation failed.", - "Snapshot has been created successfully.", - "Snapshot is being uploaded." + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY", - "UPLOADING" - ] - }, - "sourceDisk": { - "description": "The source disk used to create this snapshot.", - "type": "string" - }, - "sourceDiskId": { - "description": "[Output Only] The ID value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name.", - "type": "string" - }, - "diskSizeGb": { - "description": "[Output Only] Size of the source disk, specified in GB.", - "type": "string", - "format": "int64" - }, - "storageBytes": { - "description": "[Output Only] A size of the storage used by the snapshot. As snapshots share storage, this number is expected to change with snapshot creation/deletion.", - "type": "string", - "format": "int64" - }, - "storageBytesStatus": { - "description": "[Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date.", - "type": "string", - "enumDescriptions": [ - "", - "" + "response": { + "$ref": "DiskList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "UPDATING", - "UP_TO_DATE" - ] - }, - "licenses": { - "description": "[Output Only] A list of public visible licenses that apply to this snapshot. This can be because the original image had licenses attached (such as a Windows image).", - "type": "array", - "items": { - "type": "string" - } - }, - "snapshotEncryptionKey": { - "description": "Encrypts the snapshot using a customer-supplied encryption key. After you encrypt a snapshot using a customer-supplied key, you must provide the same key if you use the snapshot later. For example, you must provide the encryption key when you create a disk from the encrypted snapshot in a future request. Customer-supplied encryption keys do not protect access to metadata of the snapshot. If you do not provide an encryption key when creating the snapshot, then the snapshot will be encrypted using an automatically generated key and you do not need to provide a key to use the snapshot later.", - "$ref": "CustomerEncryptionKey" - }, - "sourceDiskEncryptionKey": { - "description": "The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key.", - "$ref": "CustomerEncryptionKey" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "labels": { - "description": "Labels to apply to this snapshot. These can be later modified by the setLabels method. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this snapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a snapshot.", - "type": "string", - "format": "byte" - }, - "licenseCodes": { - "description": "[Output Only] Integer license codes indicating which licenses are attached to this snapshot.", - "type": "array", - "items": { - "type": "string", - "format": "int64" - } - }, - "storageLocations": { - "description": "Cloud Storage bucket storage location of the snapshot (regional or multi-regional).", - "type": "array", - "items": { - "type": "string" - } - }, - "autoCreated": { - "description": "[Output Only] Set to true if snapshots are automatically created by applying resource policy on the target disk.", - "type": "boolean" - }, - "guestOsFeatures": { - "description": "[Output Only] A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options.", - "type": "array", - "items": { - "$ref": "GuestOsFeature" - } - }, - "downloadBytes": { - "description": "[Output Only] Number of bytes downloaded to restore a snapshot to a disk.", - "type": "string", - "format": "int64" - }, - "chainName": { - "description": "Creates the new snapshot in the snapshot chain labeled with the specified name. The chain name must be 1-63 characters long and comply with RFC1035. This is an uncommon option only for advanced service owners who needs to create separate snapshot chains, for example, for chargeback tracking. When you describe your snapshot resource, this field is visible only if it has a non-empty value.", - "type": "string" - }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - }, - "locationHint": { - "description": "An opaque location hint used to place the snapshot close to other resources. This field is for use by internal tools that use the public API.", - "type": "string" - }, - "sourceSnapshotSchedulePolicy": { - "description": "[Output Only] URL of the resource policy which created this scheduled snapshot.", - "type": "string" - }, - "sourceSnapshotSchedulePolicyId": { - "description": "[Output Only] ID of the resource policy which created this scheduled snapshot.", - "type": "string" - }, - "sourceInstantSnapshot": { - "description": "The source instant snapshot used to create this snapshot. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot ", - "type": "string" - }, - "sourceInstantSnapshotId": { - "description": "[Output Only] The unique ID of the instant snapshot used to create this snapshot. This value identifies the exact instant snapshot that was used to create this persistent disk. For example, if you created the persistent disk from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact instant snapshot that was used.", - "type": "string" + "description": "Retrieves a list of persistent disks contained within the specified zone." }, - "architecture": { - "description": "[Output Only] The architecture of the snapshot. Valid values are ARM64 or X86_64.", - "type": "string", - "enumDescriptions": [ - "Default value indicating Architecture is not set.", - "Machines with architecture ARM64", - "Machines with architecture X86_64" + "aggregatedList": { + "id": "compute.disks.aggregatedList", + "path": "projects/{project}/aggregated/disks", + "flatPath": "projects/{project}/aggregated/disks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" - ] + "response": { + "$ref": "DiskAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of persistent disks. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "snapshotType": { - "description": "Indicates the type of the snapshot.", - "type": "string", - "enumDescriptions": [ - "", - "" + "get": { + "id": "compute.disks.get", + "path": "projects/{project}/zones/{zone}/disks/{disk}", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", + "httpMethod": "GET", + "parameters": { + "disk": { + "description": "Name of the persistent disk to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "disk" ], - "enum": [ - "ARCHIVE", - "STANDARD" - ] + "response": { + "$ref": "Disk" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified persistent disk." }, - "creationSizeBytes": { - "description": "[Output Only] Size in bytes of the snapshot at creation time.", - "type": "string", - "format": "int64" - }, - "enableConfidentialCompute": { - "description": "Whether this snapshot is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk.", - "type": "boolean" - }, - "sourceDiskForRecoveryCheckpoint": { - "description": "The source disk whose recovery checkpoint will be used to create this snapshot.", - "type": "string" - }, - "sourceInstantSnapshotEncryptionKey": { - "description": "Customer provided encryption key when creating Snapshot from Instant Snapshot.", - "$ref": "CustomerEncryptionKey" - }, - "satisfiesPzi": { - "description": "Output only. Reserved for future use.", - "readOnly": true, - "type": "boolean" - } - } - }, - "DiskList": { - "id": "DiskList", - "description": "A list of Disk resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#diskList for lists of disks.", - "default": "compute#diskList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Disk resources.", - "type": "array", - "items": { + "insert": { + "id": "compute.disks.insert", + "path": "projects/{project}/zones/{zone}/disks", + "flatPath": "projects/{project}/zones/{zone}/disks", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sourceImage": { + "description": "Source image to restore onto a disk. This field is optional.", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { "$ref": "Disk" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a persistent disk in the specified project using the data in the request. You can create a disk from a source (sourceImage, sourceSnapshot, or sourceDisk) or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setLabels": { + "id": "compute.disks.setLabels", + "path": "projects/{project}/zones/{zone}/disks/{resource}/setLabels", + "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "Disk": { - "id": "Disk", - "description": "Represents a Persistent Disk resource. Google Compute Engine has two Disk resources: * [Zonal](/compute/docs/reference/rest/v1/disks) * [Regional](/compute/docs/reference/rest/v1/regionDisks) Persistent disks are required for running your VM instances. Create both boot and non-boot (data) persistent disks. For more information, read Persistent Disks. For more storage options, read Storage options. The disks resource represents a zonal persistent disk. For more information, read Zonal persistent disks. The regionDisks resource represents a regional persistent disk. For more information, read Regional resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#disk for disks.", - "default": "compute#disk", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.disks.insert" - ] }, - "type": "string" + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "request": { + "$ref": "ZoneSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on a disk. To learn more about labels, read the Labeling Resources documentation." }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" + "delete": { + "id": "compute.disks.delete", + "path": "projects/{project}/zones/{zone}/disks/{disk}", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", + "httpMethod": "DELETE", + "parameters": { + "disk": { + "description": "Name of the persistent disk to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "disk" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified persistent disk. Deleting a disk removes its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots." }, - "sizeGb": { - "description": "Size, in GB, of the persistent disk. You can specify this field when creating a persistent disk using the sourceImage, sourceSnapshot, or sourceDisk parameter, or specify it alone to create an empty persistent disk. If you specify this field along with a source, the value of sizeGb must not be less than the size of the source. Acceptable values are greater than 0.", - "type": "string", - "format": "int64" + "createSnapshot": { + "id": "compute.disks.createSnapshot", + "path": "projects/{project}/zones/{zone}/disks/{disk}/createSnapshot", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/createSnapshot", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "Name of the persistent disk to snapshot.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "guestFlush": { + "description": "[Input Only] Whether to attempt an application consistent snapshot by informing the OS to prepare for the snapshot process.", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "disk" + ], + "request": { + "$ref": "Snapshot" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project." }, - "zone": { - "description": "[Output Only] URL of the zone where the disk resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" + "resize": { + "id": "compute.disks.resize", + "path": "projects/{project}/zones/{zone}/disks/{disk}/resize", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/resize", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "The name of the persistent disk.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "disk" + ], + "request": { + "$ref": "DisksResizeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Resizes the specified persistent disk. You can only increase the size of the disk." }, - "status": { - "description": "[Output Only] The status of disk creation. - CREATING: Disk is provisioning. - RESTORING: Source data is being copied into the disk. - FAILED: Disk creation failed. - READY: Disk is ready for use. - DELETING: Disk is deleting. ", - "type": "string", - "enumDescriptions": [ - "Disk is provisioning", - "Disk is deleting.", - "Disk creation failed.", - "Disk is ready for use.", - "Source data is being copied into the disk.", - "Disk is currently unavailable and cannot be accessed, attached or detached." + "addResourcePolicies": { + "id": "compute.disks.addResourcePolicies", + "path": "projects/{project}/zones/{zone}/disks/{disk}/addResourcePolicies", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/addResourcePolicies", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "The disk name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "disk" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY", - "RESTORING", - "UNAVAILABLE" - ] + "request": { + "$ref": "DisksAddResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Adds existing resource policies to a disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation." }, - "sourceSnapshot": { - "description": "The source snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project /global/snapshots/snapshot - projects/project/global/snapshots/snapshot - global/snapshots/snapshot ", - "type": "string" - }, - "sourceSnapshotId": { - "description": "[Output Only] The unique ID of the snapshot used to create this disk. This value identifies the exact snapshot that was used to create this persistent disk. For example, if you created the persistent disk from a snapshot that was later deleted and recreated under the same name, the source snapshot ID would identify the exact version of the snapshot that was used.", - "type": "string" - }, - "sourceStorageObject": { - "description": "The full Google Cloud Storage URI where the disk image is stored. This file must be a gzip-compressed tarball whose name ends in .tar.gz or virtual machine disk whose name ends in vmdk. Valid URIs may start with gs:// or https://storage.googleapis.com/. This flag is not optimized for creating multiple disks from a source storage object. To create many disks from a source storage object, use gcloud compute images import instead.", - "type": "string" - }, - "options": { - "description": "Internal use only.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined fully-qualified URL for this resource.", - "type": "string" - }, - "sourceImage": { - "description": "The source image used to create this disk. If the source image is deleted, this field will not be set. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family ", - "type": "string" - }, - "sourceImageId": { - "description": "[Output Only] The ID value of the image used to create this disk. This value identifies the exact image that was used to create this persistent disk. For example, if you created the persistent disk from an image that was later deleted and recreated under the same name, the source image ID would identify the exact version of the image that was used.", - "type": "string" - }, - "type": { - "description": "URL of the disk type resource describing which disk type to use to create the disk. Provide this when creating the disk. For example: projects/project /zones/zone/diskTypes/pd-ssd . See Persistent disk types.", - "type": "string" - }, - "licenses": { - "description": "A list of publicly visible licenses. Reserved for Google's use.", - "type": "array", - "items": { - "type": "string" - } - }, - "guestOsFeatures": { - "description": "A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options.", - "type": "array", - "items": { - "$ref": "GuestOsFeature" - } - }, - "lastAttachTimestamp": { - "description": "[Output Only] Last attach timestamp in RFC3339 text format.", - "type": "string" - }, - "lastDetachTimestamp": { - "description": "[Output Only] Last detach timestamp in RFC3339 text format.", - "type": "string" - }, - "users": { - "description": "[Output Only] Links to the users of the disk (attached instances) in form: projects/project/zones/zone/instances/instance", - "type": "array", - "items": { - "type": "string" - } - }, - "diskEncryptionKey": { - "description": "Encrypts the disk using a customer-supplied encryption key or a customer-managed encryption key. Encryption keys do not protect access to metadata of the disk. After you encrypt a disk with a customer-supplied key, you must provide the same key if you use the disk later. For example, to create a disk snapshot, to create a disk image, to create a machine image, or to attach the disk to a virtual machine. After you encrypt a disk with a customer-managed key, the diskEncryptionKey.kmsKeyName is set to a key *version* name once the disk is created. The disk is encrypted with this version of the key. In the response, diskEncryptionKey.kmsKeyName appears in the following format: \"diskEncryptionKey.kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeysVersions/version If you do not provide an encryption key when creating the disk, then the disk is encrypted using an automatically generated key and you don't need to provide a key to use the disk later.", - "$ref": "CustomerEncryptionKey" - }, - "sourceImageEncryptionKey": { - "description": "The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key.", - "$ref": "CustomerEncryptionKey" - }, - "sourceSnapshotEncryptionKey": { - "description": "The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key.", - "$ref": "CustomerEncryptionKey" - }, - "labels": { - "description": "Labels to apply to this disk. These can be later modified by the setLabels method.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this disk, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a disk.", - "type": "string", - "format": "byte" - }, - "region": { - "description": "[Output Only] URL of the region where the disk resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "replicaZones": { - "description": "URLs of the zones where the disk should be replicated to. Only applicable for regional resources.", - "type": "array", - "items": { - "type": "string" - } - }, - "licenseCodes": { - "description": "Integer license codes indicating which licenses are attached to this disk.", - "type": "array", - "items": { - "type": "string", - "format": "int64" - } - }, - "physicalBlockSizeBytes": { - "description": "Physical block size of the persistent disk, in bytes. If not present in a request, a default value is used. The currently supported size is 4096, other sizes may be added in the future. If an unsupported value is requested, the error message will list the supported values for the caller's project.", - "type": "string", - "format": "int64" - }, - "resourcePolicies": { - "description": "Resource policies applied to this disk for automatic snapshot creations.", - "type": "array", - "items": { - "type": "string" - } - }, - "sourceDisk": { - "description": "The source disk used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk ", - "type": "string" - }, - "sourceDiskId": { - "description": "[Output Only] The unique ID of the disk used to create this disk. This value identifies the exact disk that was used to create this persistent disk. For example, if you created the persistent disk from a disk that was later deleted and recreated under the same name, the source disk ID would identify the exact version of the disk that was used.", - "type": "string" - }, - "provisionedIops": { - "description": "Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation.", - "type": "string", - "format": "int64" - }, - "provisionedThroughput": { - "description": "Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must be greater than or equal to 1.", - "type": "string", - "format": "int64" - }, - "enableConfidentialCompute": { - "description": "Whether this disk is using confidential compute mode.", - "type": "boolean" - }, - "sourceInstantSnapshot": { - "description": "The source instant snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot ", - "type": "string" - }, - "sourceInstantSnapshotId": { - "description": "[Output Only] The unique ID of the instant snapshot used to create this disk. This value identifies the exact instant snapshot that was used to create this persistent disk. For example, if you created the persistent disk from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact version of the instant snapshot that was used.", - "type": "string" - }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - }, - "satisfiesPzi": { - "description": "Output only. Reserved for future use.", - "readOnly": true, - "type": "boolean" - }, - "locationHint": { - "description": "An opaque location hint used to place the disk close to other resources. This field is for use by internal tools that use the public API.", - "type": "string" - }, - "storagePool": { - "description": "The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool ", - "type": "string" - }, - "accessMode": { - "description": "The access mode of the disk. - READ_WRITE_SINGLE: The default AccessMode, means the disk can be attached to single instance in RW mode. - READ_WRITE_MANY: The AccessMode means the disk can be attached to multiple instances in RW mode. - READ_ONLY_MANY: The AccessMode means the disk can be attached to multiple instances in RO mode. The AccessMode is only valid for Hyperdisk disk types.", - "type": "string", - "enumDescriptions": [ - "The AccessMode means the disk can be attached to multiple instances in RO mode.", - "The AccessMode means the disk can be attached to multiple instances in RW mode.", - "The default AccessMode, means the disk can be attached to single instance in RW mode." + "removeResourcePolicies": { + "id": "compute.disks.removeResourcePolicies", + "path": "projects/{project}/zones/{zone}/disks/{disk}/removeResourcePolicies", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/removeResourcePolicies", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "The disk name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "disk" ], - "enum": [ - "READ_ONLY_MANY", - "READ_WRITE_MANY", - "READ_WRITE_SINGLE" - ] - }, - "asyncPrimaryDisk": { - "description": "Disk asynchronously replicated into this disk.", - "$ref": "DiskAsyncReplication" - }, - "asyncSecondaryDisks": { - "description": "[Output Only] A list of disks this disk is asynchronously replicated to.", - "type": "object", - "additionalProperties": { - "$ref": "DiskAsyncReplicationList" - } + "request": { + "$ref": "DisksRemoveResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Removes resource policies from a disk." }, - "resourceStatus": { - "description": "[Output Only] Status information for the disk resource.", - "$ref": "DiskResourceStatus" + "getIamPolicy": { + "id": "compute.disks.getIamPolicy", + "path": "projects/{project}/zones/{zone}/disks/{resource}/getIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "sourceConsistencyGroupPolicy": { - "description": "[Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group.", - "type": "string" + "setIamPolicy": { + "id": "compute.disks.setIamPolicy", + "path": "projects/{project}/zones/{zone}/disks/{resource}/setIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "sourceConsistencyGroupPolicyId": { - "description": "[Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group.", - "type": "string" + "testIamPermissions": { + "id": "compute.disks.testIamPermissions", + "path": "projects/{project}/zones/{zone}/disks/{resource}/testIamPermissions", + "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." }, - "architecture": { - "description": "The architecture of the disk. Valid values are ARM64 or X86_64.", - "type": "string", - "enumDescriptions": [ - "Default value indicating Architecture is not set.", - "Machines with architecture ARM64", - "Machines with architecture X86_64" + "update": { + "id": "compute.disks.update", + "path": "projects/{project}/zones/{zone}/disks/{disk}", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", + "httpMethod": "PATCH", + "parameters": { + "disk": { + "description": "The disk name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "paths": { + "location": "query", + "repeated": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "disk" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" - ] + "request": { + "$ref": "Disk" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified disk with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: user_license." }, - "params": { - "description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.", - "$ref": "DiskParams" - } - } - }, - "DiskAsyncReplication": { - "id": "DiskAsyncReplication", - "type": "object", - "properties": { - "disk": { - "description": "The other disk asynchronously replicated to or from the current disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk ", - "type": "string" + "startAsyncReplication": { + "id": "compute.disks.startAsyncReplication", + "path": "projects/{project}/zones/{zone}/disks/{disk}/startAsyncReplication", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/startAsyncReplication", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "The name of the persistent disk.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "disk" + ], + "request": { + "$ref": "DisksStartAsyncReplicationRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Starts asynchronous replication. Must be invoked on the primary disk." }, - "diskId": { - "description": "[Output Only] The unique ID of the other disk asynchronously replicated to or from the current disk. This value identifies the exact disk that was used to create this replication. For example, if you started replicating the persistent disk from a disk that was later deleted and recreated under the same name, the disk ID would identify the exact version of the disk that was used.", - "type": "string" - }, - "consistencyGroupPolicy": { - "description": "[Output Only] URL of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group.", - "type": "string" - }, - "consistencyGroupPolicyId": { - "description": "[Output Only] ID of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group.", - "type": "string" - } - } - }, - "DiskAsyncReplicationList": { - "id": "DiskAsyncReplicationList", - "type": "object", - "properties": { - "asyncReplicationDisk": { - "$ref": "DiskAsyncReplication" - } - } - }, - "DiskResourceStatus": { - "id": "DiskResourceStatus", - "type": "object", - "properties": { - "asyncPrimaryDisk": { - "$ref": "DiskResourceStatusAsyncReplicationStatus" - }, - "asyncSecondaryDisks": { - "description": "Key: disk, value: AsyncReplicationStatus message", - "type": "object", - "additionalProperties": { - "$ref": "DiskResourceStatusAsyncReplicationStatus" - } - } - } - }, - "DiskResourceStatusAsyncReplicationStatus": { - "id": "DiskResourceStatusAsyncReplicationStatus", - "type": "object", - "properties": { - "state": { - "type": "string", - "enumDescriptions": [ - "Replication is active.", - "Secondary disk is created and is waiting for replication to start.", - "Replication is starting.", - "", - "Replication is stopped.", - "Replication is stopping." + "stopAsyncReplication": { + "id": "compute.disks.stopAsyncReplication", + "path": "projects/{project}/zones/{zone}/disks/{disk}/stopAsyncReplication", + "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/stopAsyncReplication", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "The name of the persistent disk.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "disk" ], - "enum": [ - "ACTIVE", - "CREATED", - "STARTING", - "STATE_UNSPECIFIED", - "STOPPED", - "STOPPING" - ] - } - } - }, - "DiskParams": { - "id": "DiskParams", - "description": "Additional disk params.", - "type": "object", - "properties": { - "resourceManagerTags": { - "description": "Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } - }, - "DiskAggregatedList": { - "id": "DiskAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#diskAggregatedList for aggregated lists of persistent disks.", - "default": "compute#diskAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of DisksScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of disks.", - "$ref": "DisksScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Stops asynchronous replication. Can be invoked either on the primary or on the secondary disk." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "stopGroupAsyncReplication": { + "id": "compute.disks.stopGroupAsyncReplication", + "path": "projects/{project}/zones/{zone}/disks/stopGroupAsyncReplication", + "flatPath": "projects/{project}/zones/{zone}/disks/stopGroupAsyncReplication", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request. This must be the zone of the primary or secondary disks in the consistency group.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "DisksScopedList": { - "id": "DisksScopedList", - "type": "object", - "properties": { - "disks": { - "description": "[Output Only] A list of disks contained in this scope.", - "type": "array", - "items": { - "$ref": "Disk" - } + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { + "$ref": "DisksStopGroupAsyncReplicationResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope." }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of disks when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "bulkInsert": { + "id": "compute.disks.bulkInsert", + "path": "projects/{project}/zones/{zone}/disks/bulkInsert", + "flatPath": "projects/{project}/zones/{zone}/disks/bulkInsert", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "ZoneSetLabelsRequest": { - "id": "ZoneSetLabelsRequest", - "type": "object", - "properties": { - "labels": { - "description": "The labels to set for this resource.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint.", - "type": "string", - "format": "byte" - } - } - }, - "DisksResizeRequest": { - "id": "DisksResizeRequest", - "type": "object", - "properties": { - "sizeGb": { - "description": "The new size of the persistent disk, which is specified in GB.", - "type": "string", - "format": "int64" + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { + "$ref": "BulkInsertDiskResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Bulk create a set of disks." } } }, - "DisksAddResourcePoliciesRequest": { - "id": "DisksAddResourcePoliciesRequest", - "type": "object", - "properties": { - "resourcePolicies": { - "description": "Full or relative path to the resource policy to be added to this disk. You can only specify one resource policy.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "DisksRemoveResourcePoliciesRequest": { - "id": "DisksRemoveResourcePoliciesRequest", - "type": "object", - "properties": { - "resourcePolicies": { - "description": "Resource policies to be removed from this disk.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ZoneSetPolicyRequest": { - "id": "ZoneSetPolicyRequest", - "type": "object", - "properties": { - "policy": { - "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them.", - "$ref": "Policy" - }, - "bindings": { - "description": "Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings.", - "type": "array", - "items": { - "$ref": "Binding" - } - }, - "etag": { - "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.", - "type": "string", - "format": "byte" - } - } - }, - "DisksStartAsyncReplicationRequest": { - "id": "DisksStartAsyncReplicationRequest", - "type": "object", - "properties": { - "asyncSecondaryDisk": { - "description": "The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk ", - "type": "string" - } - } - }, - "DisksStopGroupAsyncReplicationResource": { - "id": "DisksStopGroupAsyncReplicationResource", - "description": "A transient resource used in compute.disks.stopGroupAsyncReplication and compute.regionDisks.stopGroupAsyncReplication. It is only used to process requests and is not persisted.", - "type": "object", - "properties": { - "resourcePolicy": { - "description": "The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy ", - "type": "string" - } - } - }, - "BulkInsertDiskResource": { - "id": "BulkInsertDiskResource", - "description": "A transient resource used in compute.disks.bulkInsert and compute.regionDisks.bulkInsert. It is only used to process requests and is not persisted.", - "type": "object", - "properties": { - "sourceConsistencyGroupPolicy": { - "description": "The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy ", - "type": "string" - } - } - }, - "RegionDisksResizeRequest": { - "id": "RegionDisksResizeRequest", - "type": "object", - "properties": { - "sizeGb": { - "description": "The new size of the regional persistent disk, which is specified in GB.", - "type": "string", - "format": "int64" - } - } - }, - "RegionDisksAddResourcePoliciesRequest": { - "id": "RegionDisksAddResourcePoliciesRequest", - "type": "object", - "properties": { - "resourcePolicies": { - "description": "Resource policies to be added to this disk.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "RegionDisksRemoveResourcePoliciesRequest": { - "id": "RegionDisksRemoveResourcePoliciesRequest", - "type": "object", - "properties": { - "resourcePolicies": { - "description": "Resource policies to be removed from this disk.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "RegionSetPolicyRequest": { - "id": "RegionSetPolicyRequest", - "type": "object", - "properties": { - "policy": { - "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them.", - "$ref": "Policy" - }, - "bindings": { - "description": "Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings.", - "type": "array", - "items": { - "$ref": "Binding" - } - }, - "etag": { - "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.", - "type": "string", - "format": "byte" - } - } - }, - "RegionDisksStartAsyncReplicationRequest": { - "id": "RegionDisksStartAsyncReplicationRequest", - "type": "object", - "properties": { - "asyncSecondaryDisk": { - "description": "The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk ", - "type": "string" - } - } - }, - "FirewallList": { - "id": "FirewallList", - "description": "Contains a list of firewalls.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#firewallList for lists of firewalls.", - "default": "compute#firewallList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Firewall resources.", - "type": "array", - "items": { - "$ref": "Firewall" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "regionDisks": { + "methods": { + "list": { + "id": "compute.regionDisks.list", + "path": "projects/{project}/regions/{region}/disks", + "flatPath": "projects/{project}/regions/{region}/disks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "Firewall": { - "id": "Firewall", - "description": "Represents a Firewall Rule resource. Firewall rules allow or deny ingress traffic to, and egress traffic from your instances. For more information, read Firewall rules.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#firewall for firewall rules.", - "default": "compute#firewall", - "type": "string" + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "DiskList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of persistent disks contained within the specified region." }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" + "get": { + "id": "compute.regionDisks.get", + "path": "projects/{project}/regions/{region}/disks/{disk}", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}", + "httpMethod": "GET", + "parameters": { + "disk": { + "description": "Name of the regional persistent disk to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "disk" + ], + "response": { + "$ref": "Disk" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns a specified regional persistent disk." }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" + "insert": { + "id": "compute.regionDisks.insert", + "path": "projects/{project}/regions/{region}/disks", + "flatPath": "projects/{project}/regions/{region}/disks", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sourceImage": { + "description": "Source image to restore onto a disk. This field is optional.", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "Disk" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a persistent regional disk in the specified project using the data included in the request." }, - "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])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "annotations": { - "required": [ - "compute.firewalls.insert", - "compute.firewalls.patch" - ] + "setLabels": { + "id": "compute.regionDisks.setLabels", + "path": "projects/{project}/regions/{region}/disks/{resource}/setLabels", + "flatPath": "projects/{project}/regions/{region}/disks/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } }, - "type": "string" + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on the target regional disk." }, - "description": { - "description": "An optional description of this resource. Provide this field when you create the resource.", - "type": "string" - }, - "network": { - "description": "URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used: global/networks/default If you choose to specify this field, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network - projects/myproject/global/networks/my-network - global/networks/default ", - "type": "string" - }, - "priority": { - "description": "Priority for this rule. This is an integer between `0` and `65535`, both inclusive. The default value is `1000`. Relative priorities determine which rule takes effect if multiple rules apply. Lower values indicate higher priority. For example, a rule with priority `0` has higher precedence than a rule with priority `1`. DENY rules take precedence over ALLOW rules if they have equal priority. Note that VPC networks have implied rules with a priority of `65535`. To avoid conflicts with the implied rules, use a priority number less than `65535`.", - "type": "integer", - "format": "int32" - }, - "sourceRanges": { - "description": "If source ranges are specified, the firewall rule applies only to traffic that has a source IP address in these ranges. These ranges must be expressed in CIDR format. One or both of sourceRanges and sourceTags may be set. If both fields are set, the rule applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the rule to apply. Both IPv4 and IPv6 are supported.", - "type": "array", - "items": { - "type": "string" - } - }, - "destinationRanges": { - "description": "If destination ranges are specified, the firewall rule applies only to traffic that has destination IP address in these ranges. These ranges must be expressed in CIDR format. Both IPv4 and IPv6 are supported.", - "type": "array", - "items": { - "type": "string" - } - }, - "sourceTags": { - "description": "If source tags are specified, the firewall rule applies only to traffic with source IPs that match the primary network interfaces of VM instances that have the tag and are in the same VPC network. Source tags cannot be used to control traffic to an instance's external IP address, it only applies to traffic between instances in the same virtual network. Because tags are associated with instances, not IP addresses. One or both of sourceRanges and sourceTags may be set. If both fields are set, the firewall applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the firewall to apply.", - "type": "array", - "items": { - "type": "string" - } - }, - "targetTags": { - "description": "A list of tags that controls which instances the firewall rule applies to. If targetTags are specified, then the firewall rule applies only to instances in the VPC network that have one of those tags. If no targetTags are specified, the firewall rule applies to all instances on the specified network.", - "type": "array", - "items": { - "type": "string" - } - }, - "sourceServiceAccounts": { - "description": "If source service accounts are specified, the firewall rules apply only to traffic originating from an instance with a service account in this list. Source service accounts cannot be used to control traffic to an instance's external IP address because service accounts are associated with an instance, not an IP address. sourceRanges can be set at the same time as sourceServiceAccounts. If both are set, the firewall applies to traffic that has a source IP address within the sourceRanges OR a source IP that belongs to an instance with service account listed in sourceServiceAccount. The connection does not need to match both fields for the firewall to apply. sourceServiceAccounts cannot be used at the same time as sourceTags or targetTags.", - "type": "array", - "items": { - "type": "string" - } - }, - "targetServiceAccounts": { - "description": "A list of service accounts indicating sets of instances located in the network that may make network connections as specified in allowed[]. targetServiceAccounts cannot be used at the same time as targetTags or sourceTags. If neither targetServiceAccounts nor targetTags are specified, the firewall rule applies to all instances on the specified network.", - "type": "array", - "items": { - "type": "string" - } - }, - "allowed": { - "description": "The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.", - "type": "array", - "items": { - "type": "object", - "properties": { - "IPProtocol": { - "description": "The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number.", - "type": "string" - }, - "ports": { - "description": "An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: [\"22\"], [\"80\",\"443\"], and [\"12345-12349\"].", - "type": "array", - "items": { - "type": "string" - } - } + "delete": { + "id": "compute.regionDisks.delete", + "path": "projects/{project}/regions/{region}/disks/{disk}", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}", + "httpMethod": "DELETE", + "parameters": { + "disk": { + "description": "Name of the regional persistent disk to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "region", + "disk" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified regional persistent disk. Deleting a regional disk removes all the replicas of its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots." }, - "denied": { - "description": "The list of DENY rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a denied connection.", - "type": "array", - "items": { - "type": "object", - "properties": { - "IPProtocol": { - "description": "The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number.", - "type": "string" - }, - "ports": { - "description": "An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: [\"22\"], [\"80\",\"443\"], and [\"12345-12349\"].", - "type": "array", - "items": { - "type": "string" - } - } + "createSnapshot": { + "id": "compute.regionDisks.createSnapshot", + "path": "projects/{project}/regions/{region}/disks/{disk}/createSnapshot", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/createSnapshot", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "Name of the regional persistent disk to snapshot.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "direction": { - "description": "Direction of traffic to which this firewall applies, either `INGRESS` or `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot specify the sourceTags fields.", - "type": "string", - "enumDescriptions": [ - "Indicates that firewall should apply to outgoing traffic.", - "Indicates that firewall should apply to incoming traffic." + }, + "parameterOrder": [ + "project", + "region", + "disk" ], - "enum": [ - "EGRESS", - "INGRESS" - ] - }, - "logConfig": { - "description": "This field denotes the logging options for a particular firewall rule. If logging is enabled, logs will be exported to Cloud Logging.", - "$ref": "FirewallLogConfig" - }, - "disabled": { - "description": "Denotes whether the firewall rule is disabled. When set to true, the firewall rule is not enforced and the network behaves as if it did not exist. If this is unspecified, the firewall rule will be enabled.", - "type": "boolean" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - } - } - }, - "FirewallLogConfig": { - "id": "FirewallLogConfig", - "description": "The available logging options for a firewall rule.", - "type": "object", - "properties": { - "enable": { - "description": "This field denotes whether to enable logging for a particular firewall rule.", - "type": "boolean" - }, - "metadata": { - "description": "This field can only be specified for a particular firewall rule if logging is enabled for that rule. This field denotes whether to include or exclude metadata for firewall logs.", - "type": "string", - "enumDescriptions": [ - "", - "" + "request": { + "$ref": "Snapshot" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "EXCLUDE_ALL_METADATA", - "INCLUDE_ALL_METADATA" - ] - } - } - }, - "FirewallPolicyList": { - "id": "FirewallPolicyList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#firewallPolicyList for listsof FirewallPolicies", - "default": "compute#firewallPolicyList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of FirewallPolicy resources.", - "type": "array", - "items": { - "$ref": "FirewallPolicy" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "description": "Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "resize": { + "id": "compute.regionDisks.resize", + "path": "projects/{project}/regions/{region}/disks/{disk}/resize", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/resize", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "Name of the regional persistent disk.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "The project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "FirewallPolicy": { - "id": "FirewallPolicy", - "description": "Represents a Firewall Policy resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output only] Type of the resource. Always compute#firewallPolicyfor firewall policies", - "default": "compute#firewallPolicy", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "Name of the resource. For Organization Firewall Policies it's a [Output Only] numeric ID allocated by Google Cloud which uniquely identifies the Organization Firewall Policy.", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "rules": { - "description": "A list of rules that belong to this policy. There must always be a default rule (rule with priority 2147483647 and match \"*\"). If no rules are provided when creating a firewall policy, a default rule with action \"allow\" will be added.", - "type": "array", - "items": { - "$ref": "FirewallPolicyRule" - } - }, - "fingerprint": { - "description": "Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the firewall policy.", - "type": "string", - "format": "byte" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" + }, + "parameterOrder": [ + "project", + "region", + "disk" + ], + "request": { + "$ref": "RegionDisksResizeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Resizes the specified regional persistent disk." }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource with the resource id.", - "type": "string" + "addResourcePolicies": { + "id": "compute.regionDisks.addResourcePolicies", + "path": "projects/{project}/regions/{region}/disks/{disk}/addResourcePolicies", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/addResourcePolicies", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "The disk name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "disk" + ], + "request": { + "$ref": "RegionDisksAddResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Adds existing resource policies to a regional disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation." }, - "associations": { - "description": "A list of associations that belong to this firewall policy.", - "type": "array", - "items": { - "$ref": "FirewallPolicyAssociation" - } - }, - "ruleTupleCount": { - "description": "[Output Only] Total count of all firewall policy rule tuples. A firewall policy can not exceed a set number of tuples.", - "type": "integer", - "format": "int32" - }, - "shortName": { - "description": "User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. 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" - }, - "displayName": { - "description": "Deprecated, please use short name instead. User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. 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])?", - "deprecated": true, - "type": "string" - }, - "parent": { - "description": "[Output Only] The parent of the firewall policy. This field is not applicable to network firewall policies.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the regional firewall policy resides. This field is not applicable to global firewall policies. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - } - } - }, - "FirewallPolicyRule": { - "id": "FirewallPolicyRule", - "description": "Represents a rule that describes one or more match conditions along with the action to be taken when traffic matches this condition (allow or deny).", - "type": "object", - "properties": { - "kind": { - "description": "[Output only] Type of the resource. Returns compute#firewallPolicyRule for firewall rules and compute#packetMirroringRule for packet mirroring rules.", - "default": "compute#firewallPolicyRule", - "type": "string" - }, - "ruleName": { - "description": "An optional name for the rule. This field is not a unique identifier and can be updated.", - "type": "string" - }, - "description": { - "description": "An optional description for this resource.", - "type": "string" - }, - "priority": { - "description": "An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority.", - "type": "integer", - "format": "int32" - }, - "match": { - "description": "A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced.", - "$ref": "FirewallPolicyRuleMatcher" - }, - "action": { - "description": "The Action to perform when the client connection triggers the rule. Valid actions for firewall rules are: \"allow\", \"deny\", \"apply_security_profile_group\" and \"goto_next\". Valid actions for packet mirroring rules are: \"mirror\", \"do_not_mirror\" and \"goto_next\".", - "type": "string" - }, - "securityProfileGroup": { - "description": "A fully-qualified URL of a SecurityProfile resource instance. Example: https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group Must be specified if action is one of 'apply_security_profile_group' or 'mirror'. Cannot be specified for other actions.", - "type": "string" - }, - "tlsInspect": { - "description": "Boolean flag indicating if the traffic should be TLS decrypted. Can be set only if action = 'apply_security_profile_group' and cannot be set for other actions.", - "type": "boolean" - }, - "direction": { - "description": "The direction in which this rule applies.", - "type": "string", - "enumDescriptions": [ - "", - "" + "removeResourcePolicies": { + "id": "compute.regionDisks.removeResourcePolicies", + "path": "projects/{project}/regions/{region}/disks/{disk}/removeResourcePolicies", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/removeResourcePolicies", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "The disk name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "disk" ], - "enum": [ - "EGRESS", - "INGRESS" - ] + "request": { + "$ref": "RegionDisksRemoveResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Removes resource policies from a regional disk." }, - "targetResources": { - "description": "A list of network resource URLs to which this rule applies. This field allows you to control which network's VMs get this rule. If this field is left blank, all VMs within the organization will receive the rule.", - "type": "array", - "items": { - "type": "string" - } + "getIamPolicy": { + "id": "compute.regionDisks.getIamPolicy", + "path": "projects/{project}/regions/{region}/disks/{resource}/getIamPolicy", + "flatPath": "projects/{project}/regions/{region}/disks/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "enableLogging": { - "description": "Denotes whether to enable logging for a particular rule. If logging is enabled, logs will be exported to the configured export destination in Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you cannot enable logging on \"goto_next\" rules.", - "type": "boolean" + "setIamPolicy": { + "id": "compute.regionDisks.setIamPolicy", + "path": "projects/{project}/regions/{region}/disks/{resource}/setIamPolicy", + "flatPath": "projects/{project}/regions/{region}/disks/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "ruleTupleCount": { - "description": "[Output Only] Calculation of the complexity of a single firewall policy rule.", - "type": "integer", - "format": "int32" + "testIamPermissions": { + "id": "compute.regionDisks.testIamPermissions", + "path": "projects/{project}/regions/{region}/disks/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/disks/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." }, - "targetServiceAccounts": { - "description": "A list of service accounts indicating the sets of instances that are applied with this rule.", - "type": "array", - "items": { - "type": "string" - } + "update": { + "id": "compute.regionDisks.update", + "path": "projects/{project}/regions/{region}/disks/{disk}", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}", + "httpMethod": "PATCH", + "parameters": { + "disk": { + "description": "The disk name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "paths": { + "location": "query", + "repeated": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" + } + }, + "parameterOrder": [ + "project", + "region", + "disk" + ], + "request": { + "$ref": "Disk" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Update the specified disk with the data included in the request. Update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: user_license." }, - "targetSecureTags": { - "description": "A list of secure tags that controls which instances the firewall rule applies to. If targetSecureTag are specified, then the firewall rule applies only to instances in the VPC network that have one of those EFFECTIVE secure tags, if all the target_secure_tag are in INEFFECTIVE state, then this rule will be ignored. targetSecureTag may not be set at the same time as targetServiceAccounts. If neither targetServiceAccounts nor targetSecureTag are specified, the firewall rule applies to all instances on the specified network. Maximum number of target label tags allowed is 256.", - "type": "array", - "items": { - "$ref": "FirewallPolicyRuleSecureTag" - } + "startAsyncReplication": { + "id": "compute.regionDisks.startAsyncReplication", + "path": "projects/{project}/regions/{region}/disks/{disk}/startAsyncReplication", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/startAsyncReplication", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "The name of the persistent disk.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "disk" + ], + "request": { + "$ref": "RegionDisksStartAsyncReplicationRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Starts asynchronous replication. Must be invoked on the primary disk." }, - "disabled": { - "description": "Denotes whether the firewall policy rule is disabled. When set to true, the firewall policy rule is not enforced and traffic behaves as if it did not exist. If this is unspecified, the firewall policy rule will be enabled.", - "type": "boolean" - } - } - }, - "FirewallPolicyRuleMatcher": { - "id": "FirewallPolicyRuleMatcher", - "description": "Represents a match condition that incoming traffic is evaluated against. Exactly one field must be specified.", - "type": "object", - "properties": { - "srcIpRanges": { - "description": "CIDR IP address range. Maximum number of source CIDR IP ranges allowed is 5000.", - "type": "array", - "items": { - "type": "string" - } + "stopAsyncReplication": { + "id": "compute.regionDisks.stopAsyncReplication", + "path": "projects/{project}/regions/{region}/disks/{disk}/stopAsyncReplication", + "flatPath": "projects/{project}/regions/{region}/disks/{disk}/stopAsyncReplication", + "httpMethod": "POST", + "parameters": { + "disk": { + "description": "The name of the persistent disk.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "disk" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Stops asynchronous replication. Can be invoked either on the primary or on the secondary disk." }, - "destIpRanges": { - "description": "CIDR IP address range. Maximum number of destination CIDR IP ranges allowed is 5000.", - "type": "array", - "items": { - "type": "string" - } + "stopGroupAsyncReplication": { + "id": "compute.regionDisks.stopGroupAsyncReplication", + "path": "projects/{project}/regions/{region}/disks/stopGroupAsyncReplication", + "flatPath": "projects/{project}/regions/{region}/disks/stopGroupAsyncReplication", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request. This must be the region of the primary or secondary disks in the consistency group.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "DisksStopGroupAsyncReplicationResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope." }, - "layer4Configs": { - "description": "Pairs of IP protocols and ports that the rule should match.", - "type": "array", - "items": { - "$ref": "FirewallPolicyRuleMatcherLayer4Config" - } - }, - "srcSecureTags": { - "description": "List of secure tag values, which should be matched at the source of the traffic. For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, and there is no srcIpRange, this rule will be ignored. Maximum number of source tag values allowed is 256.", - "type": "array", - "items": { - "$ref": "FirewallPolicyRuleSecureTag" - } - }, - "destAddressGroups": { - "description": "Address groups which should be matched against the traffic destination. Maximum number of destination address groups is 10.", - "type": "array", - "items": { - "type": "string" - } - }, - "srcAddressGroups": { - "description": "Address groups which should be matched against the traffic source. Maximum number of source address groups is 10.", - "type": "array", - "items": { - "type": "string" - } - }, - "srcFqdns": { - "description": "Fully Qualified Domain Name (FQDN) which should be matched against traffic source. Maximum number of source fqdn allowed is 100.", - "type": "array", - "items": { - "type": "string" - } - }, - "destFqdns": { - "description": "Fully Qualified Domain Name (FQDN) which should be matched against traffic destination. Maximum number of destination fqdn allowed is 100.", - "type": "array", - "items": { - "type": "string" - } - }, - "srcRegionCodes": { - "description": "Region codes whose IP addresses will be used to match for source of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex.\"US\" Maximum number of source region codes allowed is 5000.", - "type": "array", - "items": { - "type": "string" - } - }, - "destRegionCodes": { - "description": "Region codes whose IP addresses will be used to match for destination of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex.\"US\" Maximum number of dest region codes allowed is 5000.", - "type": "array", - "items": { - "type": "string" - } - }, - "destThreatIntelligences": { - "description": "Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic destination.", - "type": "array", - "items": { - "type": "string" - } - }, - "srcThreatIntelligences": { - "description": "Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic source.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "FirewallPolicyRuleMatcherLayer4Config": { - "id": "FirewallPolicyRuleMatcherLayer4Config", - "type": "object", - "properties": { - "ipProtocol": { - "description": "The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp), or the IP protocol number.", - "type": "string" - }, - "ports": { - "description": "An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: [\"22\"], [\"80\",\"443\"], and [\"12345-12349\"].", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "FirewallPolicyRuleSecureTag": { - "id": "FirewallPolicyRuleSecureTag", - "type": "object", - "properties": { - "name": { - "description": "Name of the secure tag, created with TagManager's TagValue API.", - "pattern": "tagValues/[0-9]+", - "type": "string" - }, - "state": { - "description": "[Output Only] State of the secure tag, either `EFFECTIVE` or `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted or its network is deleted.", - "type": "string", - "enumDescriptions": [ - "", - "" + "bulkInsert": { + "id": "compute.regionDisks.bulkInsert", + "path": "projects/{project}/regions/{region}/disks/bulkInsert", + "flatPath": "projects/{project}/regions/{region}/disks/bulkInsert", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "EFFECTIVE", - "INEFFECTIVE" - ] - } - } - }, - "FirewallPolicyAssociation": { - "id": "FirewallPolicyAssociation", - "type": "object", - "properties": { - "name": { - "description": "The name for an association.", - "type": "string" - }, - "attachmentTarget": { - "description": "The target that the firewall policy is attached to.", - "type": "string" - }, - "firewallPolicyId": { - "description": "[Output Only] The firewall policy ID of the association.", - "type": "string" - }, - "shortName": { - "description": "[Output Only] The short name of the firewall policy of the association.", - "type": "string" - }, - "displayName": { - "description": "[Output Only] Deprecated, please use short name instead. The display name of the firewall policy of the association.", - "deprecated": true, - "type": "string" - } - } - }, - "FirewallPoliciesListAssociationsResponse": { - "id": "FirewallPoliciesListAssociationsResponse", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of firewallPolicy associations. Always compute#FirewallPoliciesListAssociations for lists of firewallPolicy associations.", - "default": "compute#firewallPoliciesListAssociationsResponse", - "type": "string" - }, - "associations": { - "description": "A list of associations.", - "type": "array", - "items": { - "$ref": "FirewallPolicyAssociation" - } + "request": { + "$ref": "BulkInsertDiskResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Bulk create a set of disks." } } }, - "GlobalOrganizationSetPolicyRequest": { - "id": "GlobalOrganizationSetPolicyRequest", - "type": "object", - "properties": { - "policy": { - "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them.", - "$ref": "Policy" - }, - "bindings": { - "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings.", - "type": "array", - "items": { - "$ref": "Binding" - } + "firewalls": { + "methods": { + "list": { + "id": "compute.firewalls.list", + "path": "projects/{project}/global/firewalls", + "flatPath": "projects/{project}/global/firewalls", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "FirewallList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of firewall rules available to the specified project." }, - "etag": { - "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.", - "type": "string", - "format": "byte" - } - } - }, - "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse": { - "id": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse", - "type": "object", - "properties": { - "firewalls": { - "description": "Effective firewalls on the network.", - "type": "array", - "items": { + "get": { + "id": "compute.firewalls.get", + "path": "projects/{project}/global/firewalls/{firewall}", + "flatPath": "projects/{project}/global/firewalls/{firewall}", + "httpMethod": "GET", + "parameters": { + "firewall": { + "description": "Name of the firewall rule to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewall" + ], + "response": { "$ref": "Firewall" - } + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified firewall." }, - "firewallPolicys": { - "description": "Effective firewalls from firewall policy.", - "type": "array", - "items": { - "$ref": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy" - } - } - } - }, - "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { - "id": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", - "type": "object", - "properties": { - "name": { - "description": "[Output Only] The name of the firewall policy.", - "type": "string" + "insert": { + "id": "compute.firewalls.insert", + "path": "projects/{project}/global/firewalls", + "flatPath": "projects/{project}/global/firewalls", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "Firewall" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a firewall rule in the specified project using the data included in the request." }, - "type": { - "description": "[Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "delete": { + "id": "compute.firewalls.delete", + "path": "projects/{project}/global/firewalls/{firewall}", + "flatPath": "projects/{project}/global/firewalls/{firewall}", + "httpMethod": "DELETE", + "parameters": { + "firewall": { + "description": "Name of the firewall rule to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewall" ], - "enum": [ - "HIERARCHY", - "NETWORK", - "NETWORK_REGIONAL", - "UNSPECIFIED" - ] + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified firewall." }, - "displayName": { - "description": "[Output Only] The display name of the firewall policy.", - "type": "string" + "update": { + "id": "compute.firewalls.update", + "path": "projects/{project}/global/firewalls/{firewall}", + "flatPath": "projects/{project}/global/firewalls/{firewall}", + "httpMethod": "PUT", + "parameters": { + "firewall": { + "description": "Name of the firewall rule to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewall" + ], + "request": { + "$ref": "Firewall" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified firewall rule with the data included in the request. Note that all fields will be updated if using PUT, even fields that are not specified. To update individual fields, please use PATCH instead." }, - "rules": { - "description": "The rules that apply to the network.", - "type": "array", - "items": { - "$ref": "FirewallPolicyRule" - } + "patch": { + "id": "compute.firewalls.patch", + "path": "projects/{project}/global/firewalls/{firewall}", + "flatPath": "projects/{project}/global/firewalls/{firewall}", + "httpMethod": "PATCH", + "parameters": { + "firewall": { + "description": "Name of the firewall rule to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewall" + ], + "request": { + "$ref": "Firewall" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified firewall rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." } } }, - "SecurityPolicyList": { - "id": "SecurityPolicyList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#securityPolicyList for listsof securityPolicies", - "default": "compute#securityPolicyList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of SecurityPolicy resources.", - "type": "array", - "items": { - "$ref": "SecurityPolicy" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "firewallPolicies": { + "methods": { + "list": { + "id": "compute.firewallPolicies.list", + "path": "locations/global/firewallPolicies", + "flatPath": "locations/global/firewallPolicies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "parentId": { + "description": "Parent ID for this request. The ID can be either be \"folders/[FOLDER_ID]\" if the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the parent is an organization.", + "location": "query", + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "SecurityPolicy": { - "id": "SecurityPolicy", - "description": "Represents a Google Cloud Armor security policy resource. Only external backend services that use load balancers can reference a security policy. For more information, see Google Cloud Armor security policy overview.", - "type": "object", - "properties": { - "userDefinedFields": { - "description": "Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A user-defined field consists of up to 4 bytes extracted from a fixed offset in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an optional mask to select certain bits. Rules may then specify matching values for these fields. Example: userDefinedFields: - name: \"ipv4_fragment_offset\" base: IPV4 offset: 6 size: 2 mask: \"0x1fff\"", - "type": "array", - "items": { - "$ref": "SecurityPolicyUserDefinedField" - } - }, - "kind": { - "description": "[Output only] Type of the resource. Always compute#securityPolicyfor security policies", - "default": "compute#securityPolicy", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "rules": { - "description": "A list of rules that belong to this policy. There must always be a default rule which is a rule with priority 2147483647 and match all condition (for the match condition this means match \"*\" for srcIpRanges and for the networkMatch condition every field must be either match \"*\" or not set). If no rules are provided when creating a security policy, a default rule with action \"allow\" will be added.", - "type": "array", - "items": { - "$ref": "SecurityPolicyRule" - } - }, - "adaptiveProtectionConfig": { - "$ref": "SecurityPolicyAdaptiveProtectionConfig" - }, - "ddosProtectionConfig": { - "$ref": "SecurityPolicyDdosProtectionConfig" - }, - "advancedOptionsConfig": { - "$ref": "SecurityPolicyAdvancedOptionsConfig" - }, - "recaptchaOptionsConfig": { - "$ref": "SecurityPolicyRecaptchaOptionsConfig" - }, - "fingerprint": { - "description": "Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the security policy.", - "type": "string", - "format": "byte" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" + }, + "response": { + "$ref": "FirewallPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all the policies that have been configured for the specified folder or organization." }, - "type": { - "description": "The type indicates the intended use of the security policy. - CLOUD_ARMOR: Cloud Armor backend security policies can be configured to filter incoming HTTP requests targeting backend services. They filter requests before they hit the origin servers. - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can be configured to filter incoming HTTP requests targeting backend services (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). They filter requests before the request is served from Google's cache. - CLOUD_ARMOR_INTERNAL_SERVICE: Cloud Armor internal service policies can be configured to filter HTTP requests targeting services managed by Traffic Director in a service mesh. They filter requests before the request is served from the application. - CLOUD_ARMOR_NETWORK: Cloud Armor network policies can be configured to filter packets targeting network load balancing resources such as backend services, target pools, target instances, and instances with external IPs. They filter requests before the request is served from the application. This field can be set only at resource creation time.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "get": { + "id": "compute.firewallPolicies.get", + "path": "locations/global/firewallPolicies/{firewallPolicy}", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "GET", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to get.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "firewallPolicy" ], - "enum": [ - "CLOUD_ARMOR", - "CLOUD_ARMOR_EDGE", - "CLOUD_ARMOR_NETWORK" - ] + "response": { + "$ref": "FirewallPolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified firewall policy." }, - "labels": { - "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } + "insert": { + "id": "compute.firewallPolicies.insert", + "path": "locations/global/firewallPolicies", + "flatPath": "locations/global/firewallPolicies", + "httpMethod": "POST", + "parameters": { + "parentId": { + "description": "Parent ID for this request. The ID can be either be \"folders/[FOLDER_ID]\" if the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the parent is an organization.", + "location": "query", + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a new policy in the specified project using the data included in the request." }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this security policy, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the security policy.", - "type": "string", - "format": "byte" + "delete": { + "id": "compute.firewallPolicies.delete", + "path": "locations/global/firewallPolicies/{firewallPolicy}", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "DELETE", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to delete.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified policy." }, - "region": { - "description": "[Output Only] URL of the region where the regional security policy resides. This field is not applicable to global security policies.", - "type": "string" - } - } - }, - "SecurityPolicyUserDefinedField": { - "id": "SecurityPolicyUserDefinedField", - "type": "object", - "properties": { - "name": { - "description": "The name of this field. Must be unique within the policy.", - "type": "string" + "patch": { + "id": "compute.firewallPolicies.patch", + "path": "locations/global/firewallPolicies/{firewallPolicy}", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "PATCH", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified policy with the data included in the request." }, - "base": { - "description": "The base relative to which 'offset' is measured. Possible values are: - IPV4: Points to the beginning of the IPv4 header. - IPV6: Points to the beginning of the IPv6 header. - TCP: Points to the beginning of the TCP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. - UDP: Points to the beginning of the UDP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. required", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "getRule": { + "id": "compute.firewallPolicies.getRule", + "path": "locations/global/firewallPolicies/{firewallPolicy}/getRule", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/getRule", + "httpMethod": "GET", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried rule belongs.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to get from the firewall policy.", + "location": "query", + "type": "integer", + "format": "int32" + } + }, + "parameterOrder": [ + "firewallPolicy" ], - "enum": [ - "IPV4", - "IPV6", - "TCP", - "UDP" - ] + "response": { + "$ref": "FirewallPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets a rule of the specified priority." }, - "offset": { - "description": "Offset of the first byte of the field (in network byte order) relative to 'base'.", - "type": "integer", - "format": "int32" + "addRule": { + "id": "compute.firewallPolicies.addRule", + "path": "locations/global/firewallPolicies/{firewallPolicy}/addRule", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/addRule", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Inserts a rule into a firewall policy." }, - "size": { - "description": "Size of the field in bytes. Valid values: 1-4.", - "type": "integer", - "format": "int32" + "removeRule": { + "id": "compute.firewallPolicies.removeRule", + "path": "locations/global/firewallPolicies/{firewallPolicy}/removeRule", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/removeRule", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to remove from the firewall policy.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes a rule of the specified priority." }, - "mask": { - "description": "If specified, apply this mask (bitwise AND) to the field to ignore bits before matching. Encoded as a hexadecimal number (starting with \"0x\"). The last byte of the field (in network byte order) corresponds to the least significant byte of the mask.", - "type": "string" - } - } - }, - "SecurityPolicyRule": { - "id": "SecurityPolicyRule", - "description": "Represents a rule that describes one or more match conditions along with the action to be taken when traffic matches this condition (allow or deny).", - "type": "object", - "properties": { - "kind": { - "description": "[Output only] Type of the resource. Always compute#securityPolicyRule for security policy rules", - "default": "compute#securityPolicyRule", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" + "patchRule": { + "id": "compute.firewallPolicies.patchRule", + "path": "locations/global/firewallPolicies/{firewallPolicy}/patchRule", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/patchRule", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to patch.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches a rule of the specified priority." }, - "priority": { - "description": "An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority.", - "type": "integer", - "format": "int32" + "addAssociation": { + "id": "compute.firewallPolicies.addAssociation", + "path": "locations/global/firewallPolicies/{firewallPolicy}/addAssociation", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/addAssociation", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + }, + "replaceExistingAssociation": { + "description": "Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists.", + "location": "query", + "type": "boolean" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicyAssociation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Inserts an association for the specified firewall policy." }, - "match": { - "description": "A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced.", - "$ref": "SecurityPolicyRuleMatcher" + "removeAssociation": { + "id": "compute.firewallPolicies.removeAssociation", + "path": "locations/global/firewallPolicies/{firewallPolicy}/removeAssociation", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/removeAssociation", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + }, + "name": { + "description": "Name for the attachment that will be removed.", + "location": "query", + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Removes an association for the specified firewall policy." }, - "networkMatch": { - "description": "A match condition that incoming packets are evaluated against for CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding 'action' is enforced. The match criteria for a rule consists of built-in match fields (like 'srcIpRanges') and potentially multiple user-defined match fields ('userDefinedFields'). Field values may be extracted directly from the packet or derived from it (e.g. 'srcRegionCodes'). Some fields may not be present in every packet (e.g. 'srcPorts'). A user-defined field is only present if the base header is found in the packet and the entire field is in bounds. Each match field may specify which values can match it, listing one or more ranges, prefixes, or exact values that are considered a match for the field. A field value must be present in order to match a specified match field. If no match values are specified for a match field, then any field value is considered to match it, and it's not required to be present. For strings specifying '*' is also equivalent to match all. For a packet to match a rule, all specified match fields must match the corresponding field values derived from the packet. Example: networkMatch: srcIpRanges: - \"192.0.2.0/24\" - \"198.51.100.0/24\" userDefinedFields: - name: \"ipv4_fragment_offset\" values: - \"1-0x1fff\" The above match condition matches packets with a source IP in 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named \"ipv4_fragment_offset\" with a value between 1 and 0x1fff inclusive.", - "$ref": "SecurityPolicyRuleNetworkMatcher" + "listAssociations": { + "id": "compute.firewallPolicies.listAssociations", + "path": "locations/global/firewallPolicies/listAssociations", + "flatPath": "locations/global/firewallPolicies/listAssociations", + "httpMethod": "GET", + "parameters": { + "targetResource": { + "description": "The target resource to list associations. It is an organization, or a folder.", + "location": "query", + "type": "string" + } + }, + "response": { + "$ref": "FirewallPoliciesListAssociationsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists associations of a specified target, i.e., organization or folder." }, - "action": { - "description": "The Action to perform when the rule is matched. The following are the valid actions: - allow: allow access to target. - deny(STATUS): deny access to target, returns the HTTP response code specified. Valid values for `STATUS` are 403, 404, and 502. - rate_based_ban: limit client traffic to the configured threshold and ban the client if the traffic exceeds the threshold. Configure parameters for this action in RateLimitOptions. Requires rate_limit_options to be set. - redirect: redirect to a different target. This can either be an internal reCAPTCHA redirect, or an external URL-based redirect via a 302 response. Parameters for this action can be configured via redirectOptions. This action is only supported in Global Security Policies of type CLOUD_ARMOR. - throttle: limit client traffic to the configured threshold. Configure parameters for this action in rateLimitOptions. Requires rate_limit_options to be set for this. ", - "type": "string" + "getAssociation": { + "id": "compute.firewallPolicies.getAssociation", + "path": "locations/global/firewallPolicies/{firewallPolicy}/getAssociation", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/getAssociation", + "httpMethod": "GET", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried rule belongs.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + }, + "name": { + "description": "The name of the association to get from the firewall policy.", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "FirewallPolicyAssociation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets an association with the specified name." }, - "preview": { - "description": "If set to true, the specified action is not enforced.", - "type": "boolean" + "cloneRules": { + "id": "compute.firewallPolicies.cloneRules", + "path": "locations/global/firewallPolicies/{firewallPolicy}/cloneRules", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/cloneRules", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sourceFirewallPolicy": { + "description": "The firewall policy from which to copy rules.", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Copies rules to the specified firewall policy." }, - "rateLimitOptions": { - "description": "Must be specified if the action is \"rate_based_ban\" or \"throttle\". Cannot be specified for any other actions.", - "$ref": "SecurityPolicyRuleRateLimitOptions" + "move": { + "id": "compute.firewallPolicies.move", + "path": "locations/global/firewallPolicies/{firewallPolicy}/move", + "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/move", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + }, + "parentId": { + "description": "The new parent of the firewall policy. The ID can be either be \"folders/[FOLDER_ID]\" if the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the parent is an organization.", + "location": "query", + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Moves the specified firewall policy." }, - "headerAction": { - "description": "Optional, additional actions that are performed on headers. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", - "$ref": "SecurityPolicyRuleHttpHeaderAction" + "getIamPolicy": { + "id": "compute.firewallPolicies.getIamPolicy", + "path": "locations/global/firewallPolicies/{resource}/getIamPolicy", + "flatPath": "locations/global/firewallPolicies/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "redirectOptions": { - "description": "Parameters defining the redirect action. Cannot be specified for any other actions. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", - "$ref": "SecurityPolicyRuleRedirectOptions" + "setIamPolicy": { + "id": "compute.firewallPolicies.setIamPolicy", + "path": "locations/global/firewallPolicies/{resource}/setIamPolicy", + "flatPath": "locations/global/firewallPolicies/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "resource" + ], + "request": { + "$ref": "GlobalOrganizationSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "preconfiguredWafConfig": { - "description": "Preconfigured WAF configuration to be applied for the rule. If the rule does not evaluate preconfigured WAF rules, i.e., if evaluatePreconfiguredWaf() is not used, this field will have no effect.", - "$ref": "SecurityPolicyRulePreconfiguredWafConfig" + "testIamPermissions": { + "id": "compute.firewallPolicies.testIamPermissions", + "path": "locations/global/firewallPolicies/{resource}/testIamPermissions", + "flatPath": "locations/global/firewallPolicies/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "(firewallPolicies/)?[0-9]{0,20}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "SecurityPolicyRuleMatcher": { - "id": "SecurityPolicyRuleMatcher", - "description": "Represents a match condition that incoming traffic is evaluated against. Exactly one field must be specified.", - "type": "object", - "properties": { - "expr": { - "description": "User defined CEVAL expression. A CEVAL expression is used to specify match criteria such as origin.ip, source.region_code and contents in the request header. Expressions containing `evaluateThreatIntelligence` require Cloud Armor Managed Protection Plus tier and are not supported in Edge Policies nor in Regional Policies. Expressions containing `evaluatePreconfiguredExpr('sourceiplist-*')` require Cloud Armor Managed Protection Plus tier and are only supported in Global Security Policies.", - "$ref": "Expr" + "networkFirewallPolicies": { + "methods": { + "list": { + "id": "compute.networkFirewallPolicies.list", + "path": "projects/{project}/global/firewallPolicies", + "flatPath": "projects/{project}/global/firewallPolicies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "FirewallPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all the policies that have been configured for the specified project." }, - "exprOptions": { - "description": "The configuration options available when specifying a user defined CEVAL expression (i.e., 'expr').", - "$ref": "SecurityPolicyRuleMatcherExprOptions" + "get": { + "id": "compute.networkFirewallPolicies.get", + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "GET", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to get.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "response": { + "$ref": "FirewallPolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified network firewall policy." }, - "versionedExpr": { - "description": "Preconfigured versioned expression. If this field is specified, config must also be specified. Available preconfigured expressions along with their requirements are: SRC_IPS_V1 - must specify the corresponding src_ip_range field in config.", - "type": "string", - "enumDescriptions": [ - "Matches the source IP address of a request to the IP ranges supplied in config." + "insert": { + "id": "compute.networkFirewallPolicies.insert", + "path": "projects/{project}/global/firewallPolicies", + "flatPath": "projects/{project}/global/firewallPolicies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" ], - "enum": [ - "SRC_IPS_V1" - ] + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a new policy in the specified project using the data included in the request." }, - "config": { - "description": "The configuration options available when specifying versioned_expr. This field must be specified if versioned_expr is specified and cannot be specified if versioned_expr is not specified.", - "$ref": "SecurityPolicyRuleMatcherConfig" - } - } - }, - "SecurityPolicyRuleMatcherExprOptions": { - "id": "SecurityPolicyRuleMatcherExprOptions", - "type": "object", - "properties": { - "recaptchaOptions": { - "description": "reCAPTCHA configuration options to be applied for the rule. If the rule does not evaluate reCAPTCHA tokens, this field has no effect.", - "$ref": "SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions" - } - } - }, - "SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions": { - "id": "SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions", - "type": "object", - "properties": { - "actionTokenSiteKeys": { - "description": "A list of site keys to be used during the validation of reCAPTCHA action-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created.", - "type": "array", - "items": { - "type": "string" - } - }, - "sessionTokenSiteKeys": { - "description": "A list of site keys to be used during the validation of reCAPTCHA session-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "SecurityPolicyRuleMatcherConfig": { - "id": "SecurityPolicyRuleMatcherConfig", - "type": "object", - "properties": { - "srcIpRanges": { - "description": "CIDR IP address range. Maximum number of src_ip_ranges allowed is 10.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "SecurityPolicyRuleNetworkMatcher": { - "id": "SecurityPolicyRuleNetworkMatcher", - "description": "Represents a match condition that incoming network traffic is evaluated against.", - "type": "object", - "properties": { - "userDefinedFields": { - "description": "User-defined fields. Each element names a defined field and lists the matching values for that field.", - "type": "array", - "items": { - "$ref": "SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch" - } - }, - "srcIpRanges": { - "description": "Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.", - "type": "array", - "items": { - "type": "string" - } - }, - "destIpRanges": { - "description": "Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text format.", - "type": "array", - "items": { - "type": "string" - } - }, - "ipProtocols": { - "description": "IPv4 protocol / IPv6 next header (after extension headers). Each element can be an 8-bit unsigned decimal number (e.g. \"6\"), range (e.g. \"253-254\"), or one of the following protocol names: \"tcp\", \"udp\", \"icmp\", \"esp\", \"ah\", \"ipip\", or \"sctp\".", - "type": "array", - "items": { - "type": "string" - } - }, - "srcPorts": { - "description": "Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. \"80\") or range (e.g. \"0-1023\").", - "type": "array", - "items": { - "type": "string" - } - }, - "destPorts": { - "description": "Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. \"80\") or range (e.g. \"0-1023\").", - "type": "array", - "items": { - "type": "string" - } - }, - "srcRegionCodes": { - "description": "Two-letter ISO 3166-1 alpha-2 country code associated with the source IP address.", - "type": "array", - "items": { - "type": "string" - } + "delete": { + "id": "compute.networkFirewallPolicies.delete", + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "DELETE", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified policy." }, - "srcAsns": { - "description": "BGP Autonomous System Number associated with the source IP address.", - "type": "array", - "items": { - "type": "integer", - "format": "uint32" - } - } - } - }, - "SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch": { - "id": "SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch", - "type": "object", - "properties": { - "name": { - "description": "Name of the user-defined field, as given in the definition.", - "type": "string" + "patch": { + "id": "compute.networkFirewallPolicies.patch", + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", + "httpMethod": "PATCH", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified policy with the data included in the request." }, - "values": { - "description": "Matching values of the field. Each element can be a 32-bit unsigned decimal or hexadecimal (starting with \"0x\") number (e.g. \"64\") or range (e.g. \"0x400-0x7ff\").", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "SecurityPolicyRuleRateLimitOptions": { - "id": "SecurityPolicyRuleRateLimitOptions", - "type": "object", - "properties": { - "rateLimitThreshold": { - "description": "Threshold at which to begin ratelimiting.", - "$ref": "SecurityPolicyRuleRateLimitOptionsThreshold" + "getRule": { + "id": "compute.networkFirewallPolicies.getRule", + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getRule", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getRule", + "httpMethod": "GET", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried rule belongs.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to get from the firewall policy.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "response": { + "$ref": "FirewallPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets a rule of the specified priority." }, - "conformAction": { - "description": "Action to take for requests that are under the configured rate limit threshold. Valid option is \"allow\" only.", - "type": "string" + "addRule": { + "id": "compute.networkFirewallPolicies.addRule", + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addRule", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addRule", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "maxPriority": { + "description": "When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority\u003e. This field is exclusive with rule.priority.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "minPriority": { + "description": "When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority\u003e. This field is exclusive with rule.priority.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Inserts a rule into a firewall policy." }, - "exceedAction": { - "description": "Action to take for requests that are above the configured rate limit threshold, to either deny with a specified HTTP response code, or redirect to a different endpoint. Valid options are `deny(STATUS)`, where valid values for `STATUS` are 403, 404, 429, and 502, and `redirect`, where the redirect parameters come from `exceedRedirectOptions` below. The `redirect` action is only supported in Global Security Policies of type CLOUD_ARMOR.", - "type": "string" + "removeRule": { + "id": "compute.networkFirewallPolicies.removeRule", + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeRule", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeRule", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to remove from the firewall policy.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes a rule of the specified priority." }, - "exceedRedirectOptions": { - "description": "Parameters defining the redirect action that is used as the exceed action. Cannot be specified if the exceed action is not redirect. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", - "$ref": "SecurityPolicyRuleRedirectOptions" + "patchRule": { + "id": "compute.networkFirewallPolicies.patchRule", + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchRule", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchRule", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to patch.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches a rule of the specified priority." }, - "enforceOnKey": { - "description": "Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if \"enforceOnKey\" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under \"enforceOnKeyName\". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under \"enforceOnKeyName\". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on \"userIpRequestHeaders\" configured with the security policy. If there is no \"userIpRequestHeaders\" configuration or an IP address cannot be resolved from it, the key type defaults to IP. ", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "getIamPolicy": { + "id": "compute.networkFirewallPolicies.getIamPolicy", + "path": "projects/{project}/global/firewallPolicies/{resource}/getIamPolicy", + "flatPath": "projects/{project}/global/firewallPolicies/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "ALL", - "HTTP_COOKIE", - "HTTP_HEADER", - "HTTP_PATH", - "IP", - "REGION_CODE", - "SNI", - "TLS_JA3_FINGERPRINT", - "USER_IP", - "XFF_IP" - ] + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "enforceOnKeyName": { - "description": "Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value.", - "type": "string" + "setIamPolicy": { + "id": "compute.networkFirewallPolicies.setIamPolicy", + "path": "projects/{project}/global/firewallPolicies/{resource}/setIamPolicy", + "flatPath": "projects/{project}/global/firewallPolicies/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "enforceOnKeyConfigs": { - "description": "If specified, any combination of values of enforce_on_key_type/enforce_on_key_name is treated as the key on which ratelimit threshold/action is enforced. You can specify up to 3 enforce_on_key_configs. If enforce_on_key_configs is specified, enforce_on_key must not be specified.", - "type": "array", - "items": { - "$ref": "SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig" - } - }, - "banThreshold": { - "description": "Can only be specified if the action for the rule is \"rate_based_ban\". If specified, the key will be banned for the configured 'ban_duration_sec' when the number of requests that exceed the 'rate_limit_threshold' also exceed this 'ban_threshold'.", - "$ref": "SecurityPolicyRuleRateLimitOptionsThreshold" - }, - "banDurationSec": { - "description": "Can only be specified if the action for the rule is \"rate_based_ban\". If specified, determines the time (in seconds) the traffic will continue to be banned by the rate limit after the rate falls below the threshold.", - "type": "integer", - "format": "int32" - } - } - }, - "SecurityPolicyRuleRateLimitOptionsThreshold": { - "id": "SecurityPolicyRuleRateLimitOptionsThreshold", - "type": "object", - "properties": { - "count": { - "description": "Number of HTTP(S) requests for calculating the threshold.", - "type": "integer", - "format": "int32" - }, - "intervalSec": { - "description": "Interval over which the threshold is computed.", - "type": "integer", - "format": "int32" - } - } - }, - "SecurityPolicyRuleRedirectOptions": { - "id": "SecurityPolicyRuleRedirectOptions", - "type": "object", - "properties": { - "type": { - "description": "Type of the redirect action.", - "type": "string", - "enumDescriptions": [ - "", - "" + "testIamPermissions": { + "id": "compute.networkFirewallPolicies.testIamPermissions", + "path": "projects/{project}/global/firewallPolicies/{resource}/testIamPermissions", + "flatPath": "projects/{project}/global/firewallPolicies/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "EXTERNAL_302", - "GOOGLE_RECAPTCHA" - ] - }, - "target": { - "description": "Target for the redirect action. This is required if the type is EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.", - "type": "string" - } - } - }, - "SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig": { - "id": "SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig", - "type": "object", - "properties": { - "enforceOnKeyType": { - "description": "Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if \"enforceOnKeyConfigs\" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under \"enforceOnKeyName\". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under \"enforceOnKeyName\". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on \"userIpRequestHeaders\" configured with the security policy. If there is no \"userIpRequestHeaders\" configuration or an IP address cannot be resolved from it, the key type defaults to IP. ", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ALL", - "HTTP_COOKIE", - "HTTP_HEADER", - "HTTP_PATH", - "IP", - "REGION_CODE", - "SNI", - "TLS_JA3_FINGERPRINT", - "USER_IP", - "XFF_IP" - ] - }, - "enforceOnKeyName": { - "description": "Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value.", - "type": "string" - } - } - }, - "SecurityPolicyRuleHttpHeaderAction": { - "id": "SecurityPolicyRuleHttpHeaderAction", - "type": "object", - "properties": { - "requestHeadersToAdds": { - "description": "The list of request headers to add or overwrite if they're already present.", - "type": "array", - "items": { - "$ref": "SecurityPolicyRuleHttpHeaderActionHttpHeaderOption" - } - } - } - }, - "SecurityPolicyRuleHttpHeaderActionHttpHeaderOption": { - "id": "SecurityPolicyRuleHttpHeaderActionHttpHeaderOption", - "type": "object", - "properties": { - "headerName": { - "description": "The name of the header to set.", - "type": "string" - }, - "headerValue": { - "description": "The value to set the named header to.", - "type": "string" - } - } - }, - "SecurityPolicyRulePreconfiguredWafConfig": { - "id": "SecurityPolicyRulePreconfiguredWafConfig", - "type": "object", - "properties": { - "exclusions": { - "description": "A list of exclusions to apply during preconfigured WAF evaluation.", - "type": "array", - "items": { - "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusion" - } - } - } - }, - "SecurityPolicyRulePreconfiguredWafConfigExclusion": { - "id": "SecurityPolicyRulePreconfiguredWafConfigExclusion", - "type": "object", - "properties": { - "targetRuleSet": { - "description": "Target WAF rule set to apply the preconfigured WAF exclusion.", - "type": "string" - }, - "targetRuleIds": { - "description": "A list of target rule IDs under the WAF rule set to apply the preconfigured WAF exclusion. If omitted, it refers to all the rule IDs under the WAF rule set.", - "type": "array", - "items": { - "type": "string" - } - }, - "requestHeadersToExclude": { - "description": "A list of request header names whose value will be excluded from inspection during preconfigured WAF evaluation.", - "type": "array", - "items": { - "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" - } - }, - "requestCookiesToExclude": { - "description": "A list of request cookie names whose value will be excluded from inspection during preconfigured WAF evaluation.", - "type": "array", - "items": { - "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" - } - }, - "requestQueryParamsToExclude": { - "description": "A list of request query parameter names whose value will be excluded from inspection during preconfigured WAF evaluation. Note that the parameter can be in the query string or in the POST body.", - "type": "array", - "items": { - "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" - } - }, - "requestUrisToExclude": { - "description": "A list of request URIs from the request line to be excluded from inspection during preconfigured WAF evaluation. When specifying this field, the query or fragment part should be excluded.", - "type": "array", - "items": { - "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" - } - } - } - }, - "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams": { - "id": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams", - "type": "object", - "properties": { - "val": { - "description": "The value of the field.", - "type": "string" + "description": "Returns permissions that a caller has on the specified resource." }, - "op": { - "description": "The match operator for the field.", - "type": "string", - "enumDescriptions": [ - "The operator matches if the field value contains the specified value.", - "The operator matches if the field value ends with the specified value.", - "The operator matches if the field value equals the specified value.", - "The operator matches if the field value is any value.", - "The operator matches if the field value starts with the specified value." + "addAssociation": { + "id": "compute.networkFirewallPolicies.addAssociation", + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addAssociation", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addAssociation", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "replaceExistingAssociation": { + "description": "Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists.", + "location": "query", + "type": "boolean" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewallPolicy" ], - "enum": [ - "CONTAINS", - "ENDS_WITH", - "EQUALS", - "EQUALS_ANY", - "STARTS_WITH" - ] - } - } - }, - "SecurityPolicyAdaptiveProtectionConfig": { - "id": "SecurityPolicyAdaptiveProtectionConfig", - "description": "Configuration options for Cloud Armor Adaptive Protection (CAAP).", - "type": "object", - "properties": { - "layer7DdosDefenseConfig": { - "description": "If set to true, enables Cloud Armor Machine Learning.", - "$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig" - } - } - }, - "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig": { - "id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig", - "description": "Configuration options for L7 DDoS detection. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", - "type": "object", - "properties": { - "enable": { - "description": "If set to true, enables CAAP for L7 DDoS detection. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", - "type": "boolean" - }, - "ruleVisibility": { - "description": "Rule visibility can be one of the following: STANDARD - opaque rules. (default) PREMIUM - transparent rules. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", - "type": "string", - "enumDescriptions": [ - "", - "" + "request": { + "$ref": "FirewallPolicyAssociation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "PREMIUM", - "STANDARD" - ] - }, - "thresholdConfigs": { - "description": "Configuration options for layer7 adaptive protection for various customizable thresholds.", - "type": "array", - "items": { - "$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig" - } - } - } - }, - "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig": { - "id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig", - "type": "object", - "properties": { - "name": { - "description": "The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the security policy.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - }, - "autoDeployLoadThreshold": { - "type": "number", - "format": "float" - }, - "autoDeployConfidenceThreshold": { - "type": "number", - "format": "float" - }, - "autoDeployImpactedBaselineThreshold": { - "type": "number", - "format": "float" - }, - "autoDeployExpirationSec": { - "type": "integer", - "format": "int32" - }, - "detectionLoadThreshold": { - "type": "number", - "format": "float" - }, - "detectionAbsoluteQps": { - "type": "number", - "format": "float" - }, - "detectionRelativeToBaselineQps": { - "type": "number", - "format": "float" + "description": "Inserts an association for the specified firewall policy." }, - "trafficGranularityConfigs": { - "description": "Configuration options for enabling Adaptive Protection to operate on specified granular traffic units.", - "type": "array", - "items": { - "$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig" - } - } - } - }, - "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig": { - "id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig", - "description": "Configurations to specifc granular traffic units processed by Adaptive Protection.", - "type": "object", - "properties": { - "type": { - "description": "Type of this configuration.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "removeAssociation": { + "id": "compute.networkFirewallPolicies.removeAssociation", + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeAssociation", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeAssociation", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "name": { + "description": "Name for the attachment that will be removed.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewallPolicy" ], - "enum": [ - "HTTP_HEADER_HOST", - "HTTP_PATH", - "UNSPECIFIED_TYPE" - ] + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Removes an association for the specified firewall policy." }, - "value": { - "description": "Requests that match this value constitute a granular traffic unit.", - "type": "string" + "getAssociation": { + "id": "compute.networkFirewallPolicies.getAssociation", + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getAssociation", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getAssociation", + "httpMethod": "GET", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried association belongs.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "name": { + "description": "The name of the association to get from the firewall policy.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "response": { + "$ref": "FirewallPolicyAssociation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets an association with the specified name." }, - "enableEachUniqueValue": { - "description": "If enabled, traffic matching each unique value for the specified type constitutes a separate traffic unit. It can only be set to true if `value` is empty.", - "type": "boolean" + "cloneRules": { + "id": "compute.networkFirewallPolicies.cloneRules", + "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/cloneRules", + "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/cloneRules", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sourceFirewallPolicy": { + "description": "The firewall policy from which to copy rules.", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Copies rules to the specified firewall policy." } } }, - "SecurityPolicyDdosProtectionConfig": { - "id": "SecurityPolicyDdosProtectionConfig", - "type": "object", - "properties": { - "ddosProtection": { - "type": "string", - "enumDescriptions": [ - "", - "" + "regionNetworkFirewallPolicies": { + "methods": { + "list": { + "id": "compute.regionNetworkFirewallPolicies.list", + "path": "projects/{project}/regions/{region}/firewallPolicies", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ADVANCED", - "STANDARD" - ] - } - } - }, - "SecurityPolicyAdvancedOptionsConfig": { - "id": "SecurityPolicyAdvancedOptionsConfig", - "type": "object", - "properties": { - "jsonParsing": { - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "response": { + "$ref": "FirewallPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "DISABLED", - "STANDARD", - "STANDARD_WITH_GRAPHQL" - ] - }, - "jsonCustomConfig": { - "description": "Custom configuration to apply the JSON parsing. Only applicable when json_parsing is set to STANDARD.", - "$ref": "SecurityPolicyAdvancedOptionsConfigJsonCustomConfig" + "description": "Lists all the network firewall policies that have been configured for the specified project in the given region." }, - "logLevel": { - "type": "string", - "enumDescriptions": [ - "", - "" + "get": { + "id": "compute.regionNetworkFirewallPolicies.get", + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", + "httpMethod": "GET", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to get.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "NORMAL", - "VERBOSE" - ] - }, - "userIpRequestHeaders": { - "description": "An optional list of case-insensitive request header names to use for resolving the callers client IP address.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "SecurityPolicyAdvancedOptionsConfigJsonCustomConfig": { - "id": "SecurityPolicyAdvancedOptionsConfigJsonCustomConfig", - "type": "object", - "properties": { - "contentTypes": { - "description": "A list of custom Content-Type header values to apply the JSON parsing. As per RFC 1341, a Content-Type header value has the following format: Content-Type := type \"/\" subtype *[\";\" parameter] When configuring a custom Content-Type header value, only the type/subtype needs to be specified, and the parameters should be excluded.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "SecurityPolicyRecaptchaOptionsConfig": { - "id": "SecurityPolicyRecaptchaOptionsConfig", - "type": "object", - "properties": { - "redirectSiteKey": { - "description": "An optional field to supply a reCAPTCHA site key to be used for all the rules using the redirect action with the type of GOOGLE_RECAPTCHA under the security policy. The specified site key needs to be created from the reCAPTCHA API. The user is responsible for the validity of the specified site key. If not specified, a Google-managed site key is used. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", - "type": "string" - } - } - }, - "SecurityPoliciesListPreconfiguredExpressionSetsResponse": { - "id": "SecurityPoliciesListPreconfiguredExpressionSetsResponse", - "type": "object", - "properties": { - "preconfiguredExpressionSets": { - "$ref": "SecurityPoliciesWafConfig" - } - } - }, - "SecurityPoliciesWafConfig": { - "id": "SecurityPoliciesWafConfig", - "type": "object", - "properties": { - "wafRules": { - "$ref": "PreconfiguredWafSet" - } - } - }, - "PreconfiguredWafSet": { - "id": "PreconfiguredWafSet", - "type": "object", - "properties": { - "expressionSets": { - "description": "List of entities that are currently supported for WAF rules.", - "type": "array", - "items": { - "$ref": "WafExpressionSet" - } - } - } - }, - "WafExpressionSet": { - "id": "WafExpressionSet", - "type": "object", - "properties": { - "id": { - "description": "Google specified expression set ID. The format should be: - E.g. XSS-20170329 required", - "type": "string" - }, - "aliases": { - "description": "A list of alternate IDs. The format should be: - E.g. XSS-stable Generic suffix like \"stable\" is particularly useful if a policy likes to avail newer set of expressions without having to change the policy. A given alias name can't be used for more than one entity set.", - "type": "array", - "items": { - "type": "string" - } - }, - "expressions": { - "description": "List of available expressions.", - "type": "array", - "items": { - "$ref": "WafExpressionSetExpression" - } - } - } - }, - "WafExpressionSetExpression": { - "id": "WafExpressionSetExpression", - "type": "object", - "properties": { - "id": { - "description": "Expression ID should uniquely identify the origin of the expression. E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set version 2.9.1 rule id 973337. The ID could be used to determine the individual attack definition that has been detected. It could also be used to exclude it from the policy in case of false positive. required", - "type": "string" - }, - "sensitivity": { - "description": "The sensitivity value associated with the WAF rule ID. This corresponds to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for opt-in only rules.", - "type": "integer", - "format": "int32" - } - } - }, - "SecurityPoliciesAggregatedList": { - "id": "SecurityPoliciesAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#securityPolicyAggregatedList for lists of Security Policies.", - "default": "compute#securityPoliciesAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of SecurityPoliciesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of security policies.", - "$ref": "SecurityPoliciesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "response": { + "$ref": "FirewallPolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified network firewall policy." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.regionNetworkFirewallPolicies.insert", + "path": "projects/{project}/regions/{region}/firewallPolicies", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "etag": { - "type": "string" + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a new network firewall policy in the specified project and region." }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "SecurityPoliciesScopedList": { - "id": "SecurityPoliciesScopedList", - "type": "object", - "properties": { - "securityPolicies": { - "description": "A list of SecurityPolicies contained in this scope.", - "type": "array", - "items": { - "$ref": "SecurityPolicy" - } + "delete": { + "id": "compute.regionNetworkFirewallPolicies.delete", + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", + "httpMethod": "DELETE", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "firewallPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified network firewall policy." }, - "warning": { - "description": "Informational warning which replaces the list of security policies when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "id": "compute.regionNetworkFirewallPolicies.patch", + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", + "httpMethod": "PATCH", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "InstanceList": { - "id": "InstanceList", - "description": "Contains a list of instances.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#instanceList for lists of Instance resources.", - "default": "compute#instanceList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Instance resources.", - "type": "array", - "items": { - "$ref": "Instance" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + }, + "parameterOrder": [ + "project", + "region", + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified network firewall policy." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getRule": { + "id": "compute.regionNetworkFirewallPolicies.getRule", + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getRule", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getRule", + "httpMethod": "GET", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried rule belongs.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "priority": { + "description": "The priority of the rule to get from the firewall policy.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "Instance": { - "id": "Instance", - "description": "Represents an Instance resource. An instance is a virtual machine that is hosted on Google Cloud Platform. For more information, read Virtual Machine Instances.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#instance for instances.", - "default": "compute#instance", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "annotations": { - "required": [ - "compute.instances.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "tags": { - "description": "Tags to apply to this instance. Tags are used to identify valid sources or targets for network firewalls and are specified by the client during instance creation. The tags can be later modified by the setTags method. Each tag within the list must comply with RFC1035. Multiple tags can be specified via the 'tags.items' field.", - "$ref": "Tags" - }, - "machineType": { - "description": "Full or partial URL of the machine type resource to use for this instance, in the format: zones/zone/machineTypes/machine-type. This is provided by the client when the instance is created. For example, the following is a valid partial url to a predefined machine type: zones/us-central1-f/machineTypes/n1-standard-1 To create a custom machine type, provide a URL to a machine type in the following format, where CPUS is 1 or an even number up to 32 (2, 4, 6, ... 24, etc), and MEMORY is the total memory for this instance. Memory must be a multiple of 256 MB and must be supplied in MB (e.g. 5 GB of memory is 5120 MB): zones/zone/machineTypes/custom-CPUS-MEMORY For example: zones/us-central1-f/machineTypes/custom-4-5120 For a full list of restrictions, read the Specifications for custom machine types.", - "type": "string" - }, - "status": { - "description": "[Output Only] The status of the instance. One of the following values: PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING, and TERMINATED. For more information about the status of the instance, see Instance life cycle.", - "type": "string", - "enumDescriptions": [ - "The instance is halted and we are performing tear down tasks like network deprogramming, releasing quota, IP, tearing down disks etc.", - "Resources are being allocated for the instance.", - "The instance is in repair.", - "The instance is running.", - "All required resources have been allocated and the instance is being started.", - "The instance has stopped successfully.", - "The instance is currently stopping (either being deleted or killed).", - "The instance has suspended.", - "The instance is suspending.", - "The instance has stopped (either by explicit action or underlying failure)." + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "DEPROVISIONING", - "PROVISIONING", - "REPAIRING", - "RUNNING", - "STAGING", - "STOPPED", - "STOPPING", - "SUSPENDED", - "SUSPENDING", - "TERMINATED" - ] - }, - "statusMessage": { - "description": "[Output Only] An optional, human-readable explanation of the status.", - "type": "string" - }, - "zone": { - "description": "[Output Only] URL of the zone where the instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "canIpForward": { - "description": "Allows this instance to send and receive packets with non-matching destination or source IPs. This is required if you plan to use this instance to forward routes. For more information, see Enabling IP Forwarding .", - "type": "boolean" - }, - "networkInterfaces": { - "description": "An array of network configurations for this instance. These specify how interfaces are configured to interact with other network services, such as connecting to the internet. Multiple interfaces are supported per instance.", - "type": "array", - "items": { - "$ref": "NetworkInterface" - } - }, - "disks": { - "description": "Array of disks associated with this instance. Persistent disks must be created before you can assign them.", - "type": "array", - "items": { - "$ref": "AttachedDisk" - } - }, - "metadata": { - "description": "The metadata key/value pairs assigned to this instance. This includes custom metadata and predefined keys.", - "$ref": "Metadata" - }, - "serviceAccounts": { - "description": "A list of service accounts, with their specified scopes, authorized for this instance. Only one service account per VM instance is supported. Service accounts generate access tokens that can be accessed through the metadata server and used to authenticate applications on the instance. See Service Accounts for more information.", - "type": "array", - "items": { - "$ref": "ServiceAccount" - } - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "scheduling": { - "description": "Sets the scheduling options for this instance.", - "$ref": "Scheduling" + "response": { + "$ref": "FirewallPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets a rule of the specified priority." }, - "cpuPlatform": { - "description": "[Output Only] The CPU platform used by this instance.", - "type": "string" + "addRule": { + "id": "compute.regionNetworkFirewallPolicies.addRule", + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addRule", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addRule", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "maxPriority": { + "description": "When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority\u003e. This field is exclusive with rule.priority.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "minPriority": { + "description": "When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority\u003e. This field is exclusive with rule.priority.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "firewallPolicy" + ], + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Inserts a rule into a network firewall policy." }, - "labels": { - "description": "Labels to apply to this instance. These can be later modified by the setLabels method.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "params": { - "description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.", - "$ref": "InstanceParams" - }, - "labelFingerprint": { - "description": "A fingerprint for this request, which is essentially a hash of the label's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the instance.", - "type": "string", - "format": "byte" - }, - "instanceEncryptionKey": { - "description": "Encrypts suspended data for an instance with a customer-managed encryption key. If you are creating a new instance, this field will encrypt the local SSD and in-memory contents of the instance during the suspend operation. If you do not provide an encryption key when creating the instance, then the local SSD and in-memory contents will be encrypted using an automatically generated key during the suspend operation.", - "$ref": "CustomerEncryptionKey" - }, - "minCpuPlatform": { - "description": "Specifies a minimum CPU platform for the VM instance. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: \"Intel Haswell\" or minCpuPlatform: \"Intel Sandy Bridge\".", - "type": "string" - }, - "guestAccelerators": { - "description": "A list of the type and count of accelerator cards attached to the instance.", - "type": "array", - "items": { - "$ref": "AcceleratorConfig" - } - }, - "startRestricted": { - "description": "[Output Only] Whether a VM has been restricted for start because Compute Engine has detected suspicious activity.", - "type": "boolean" - }, - "deletionProtection": { - "description": "Whether the resource should be protected against deletion.", - "type": "boolean" - }, - "resourcePolicies": { - "description": "Resource policies applied to this instance.", - "type": "array", - "items": { - "type": "string" - } - }, - "sourceMachineImage": { - "description": "Source machine image", - "type": "string" - }, - "reservationAffinity": { - "description": "Specifies the reservations that this instance can consume from.", - "$ref": "ReservationAffinity" - }, - "hostname": { - "description": "Specifies the hostname of the instance. The specified hostname must be RFC1035 compliant. If hostname is not specified, the default hostname is [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS.", - "type": "string" - }, - "displayDevice": { - "description": "Enables display device for the instance.", - "$ref": "DisplayDevice" - }, - "shieldedInstanceConfig": { - "$ref": "ShieldedInstanceConfig" - }, - "shieldedInstanceIntegrityPolicy": { - "$ref": "ShieldedInstanceIntegrityPolicy" - }, - "sourceMachineImageEncryptionKey": { - "description": "Source machine image encryption key when creating an instance from a machine image.", - "$ref": "CustomerEncryptionKey" - }, - "confidentialInstanceConfig": { - "$ref": "ConfidentialInstanceConfig" - }, - "fingerprint": { - "description": "Specifies a fingerprint for this resource, which is essentially a hash of the instance's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance. You must always provide an up-to-date fingerprint hash in order to update the instance. To see the latest fingerprint, make get() request to the instance.", - "type": "string", - "format": "byte" - }, - "privateIpv6GoogleAccess": { - "description": "The private IPv6 google access type for the VM. If not specified, use INHERIT_FROM_SUBNETWORK as default.", - "type": "string", - "enumDescriptions": [ - "Bidirectional private IPv6 access to/from Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before.", - "Outbound private IPv6 access from VMs in this subnet to Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before.", - "Each network interface inherits PrivateIpv6GoogleAccess from its subnetwork." + "removeRule": { + "id": "compute.regionNetworkFirewallPolicies.removeRule", + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeRule", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeRule", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to remove from the firewall policy.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", - "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE", - "INHERIT_FROM_SUBNETWORK" - ] - }, - "advancedMachineFeatures": { - "description": "Controls for advanced machine-related behavior features.", - "$ref": "AdvancedMachineFeatures" - }, - "lastStartTimestamp": { - "description": "[Output Only] Last start timestamp in RFC3339 text format.", - "type": "string" - }, - "lastStopTimestamp": { - "description": "[Output Only] Last stop timestamp in RFC3339 text format.", - "type": "string" - }, - "lastSuspendedTimestamp": { - "description": "[Output Only] Last suspended timestamp in RFC3339 text format.", - "type": "string" - }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - }, - "satisfiesPzi": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - }, - "resourceStatus": { - "description": "[Output Only] Specifies values set for instance attributes as compared to the values requested by user in the corresponding input only field.", - "$ref": "ResourceStatus" - }, - "networkPerformanceConfig": { - "$ref": "NetworkPerformanceConfig" - }, - "keyRevocationActionType": { - "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and \"NONE\". The default value is \"NONE\" if it is not specified.", - "type": "string", - "enumDescriptions": [ - "Default value. This value is unused.", - "Indicates user chose no operation.", - "Indicates user chose to opt for VM shutdown on key revocation." + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", - "NONE", - "STOP" - ] - } - } - }, - "Tags": { - "id": "Tags", - "description": "A set of instance tags.", - "type": "object", - "properties": { - "items": { - "description": "An array of tags. Each tag must be 1-63 characters long, and comply with RFC1035.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "array", - "items": { - "type": "string" - } - }, - "fingerprint": { - "description": "Specifies a fingerprint for this request, which is essentially a hash of the tags' contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update tags. You must always provide an up-to-date fingerprint hash in order to update or change tags. To see the latest fingerprint, make get() request to the instance.", - "type": "string", - "format": "byte" - } - } - }, - "NetworkInterface": { - "id": "NetworkInterface", - "description": "A network interface resource attached to an instance.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#networkInterface for network interfaces.", - "default": "compute#networkInterface", - "type": "string" - }, - "network": { - "description": "URL of the VPC network resource for this instance. When creating an instance, if neither the network nor the subnetwork is specified, the default network global/networks/default is used. If the selected project doesn't have the default network, you must specify a network or subnet. If the network is not specified but the subnetwork is specified, the network is inferred. If you specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/global/networks/ network - projects/project/global/networks/network - global/networks/default ", - "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: - https://www.googleapis.com/compute/v1/projects/project/regions/region /subnetworks/subnetwork - regions/region/subnetworks/subnetwork ", - "type": "string" - }, - "networkIP": { - "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" - }, - "ipv6Address": { - "description": "An IPv6 internal network address for this network interface. To use a static internal IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an internal IPv6 address from the instance's subnetwork.", - "type": "string" - }, - "internalIpv6PrefixLength": { - "description": "The prefix length of the primary internal IPv6 range.", - "type": "integer", - "format": "int32" - }, - "name": { - "description": "[Output Only] The name of the network interface, which is generated by the server. For a VM, the network interface uses the nicN naming format. Where N is a value between 0 and 7. The default interface value is nic0.", - "type": "string" - }, - "accessConfigs": { - "description": "An array of configurations for this interface. Currently, only one access config, ONE_TO_ONE_NAT, is supported. If there are no accessConfigs specified, then this instance will have no external internet access.", - "type": "array", - "items": { - "$ref": "AccessConfig" - } - }, - "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.", - "type": "array", - "items": { - "$ref": "AccessConfig" - } - }, - "aliasIpRanges": { - "description": "An array of alias IP ranges for this network interface. You can only specify this field for network interfaces in VPC networks.", - "type": "array", - "items": { - "$ref": "AliasIpRange" - } - }, - "fingerprint": { - "description": "Fingerprint hash of contents stored in this network interface. This field will be ignored when inserting an Instance or adding a NetworkInterface. An up-to-date fingerprint must be provided in order to update the NetworkInterface. The request will fail with error 400 Bad Request if the fingerprint is not provided, or 412 Precondition Failed if the fingerprint is out of date.", - "type": "string", - "format": "byte" + "description": "Deletes a rule of the specified priority." }, - "stackType": { - "description": "The stack type for this network interface. To assign only IPv4 addresses, use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, use IPV4_IPV6. If not specified, IPV4_ONLY is used. This field can be both set at instance creation and update network interface operations.", - "type": "string", - "enumDescriptions": [ - "The network interface can have both IPv4 and IPv6 addresses.", - "The network interface will be assigned IPv4 address." + "patchRule": { + "id": "compute.regionNetworkFirewallPolicies.patchRule", + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/patchRule", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/patchRule", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "priority": { + "description": "The priority of the rule to patch.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY" - ] - }, - "ipv6AccessType": { - "description": "[Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be accessed from the Internet. This field is always inherited from its subnetwork. Valid only if stackType is IPV4_IPV6.", - "type": "string", - "enumDescriptions": [ - "This network interface can have external IPv6.", - "This network interface can have internal IPv6." + "request": { + "$ref": "FirewallPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "EXTERNAL", - "INTERNAL" - ] - }, - "queueCount": { - "description": "The networking queue count that's specified by users for the network interface. Both Rx and Tx queues will be set to this number. It'll be empty if not specified by the users.", - "type": "integer", - "format": "int32" + "description": "Patches a rule of the specified priority." }, - "nicType": { - "description": "The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.", - "type": "string", - "enumDescriptions": [ - "GVNIC", - "IDPF", - "No type specified.", - "VIRTIO" + "cloneRules": { + "id": "compute.regionNetworkFirewallPolicies.cloneRules", + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/cloneRules", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/cloneRules", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sourceFirewallPolicy": { + "description": "The firewall policy from which to copy rules.", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "GVNIC", - "IDPF", - "UNSPECIFIED_NIC_TYPE", - "VIRTIO_NET" - ] - }, - "networkAttachment": { - "description": "The URL of the network attachment that this interface should connect to in the following format: projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.", - "type": "string" - } - } - }, - "AccessConfig": { - "id": "AccessConfig", - "description": "An access configuration attached to an instance's network interface. Only one access config per instance is supported.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#accessConfig for access configs.", - "default": "compute#accessConfig", - "type": "string" - }, - "type": { - "description": "The type of configuration. In accessConfigs (IPv4), the default and only option is ONE_TO_ONE_NAT. In ipv6AccessConfigs, the default and only option is DIRECT_IPV6.", - "type": "string", - "enumDescriptions": [ - "", - "" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "DIRECT_IPV6", - "ONE_TO_ONE_NAT" - ] - }, - "name": { - "description": "The name of this access configuration. In accessConfigs (IPv4), the default and recommended name is External NAT, but you can use any arbitrary string, such as My external IP or Network Access. In ipv6AccessConfigs, the recommend name is External IPv6.", - "type": "string" - }, - "natIP": { - "description": "Applies to accessConfigs (IPv4) only. An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.", - "type": "string" - }, - "externalIpv6": { - "description": "Applies to ipv6AccessConfigs only. The first IPv6 address of the external IPv6 range associated with this instance, prefix length is stored in externalIpv6PrefixLength in ipv6AccessConfig. To use a static external IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an external IPv6 address from the instance's subnetwork.", - "type": "string" - }, - "externalIpv6PrefixLength": { - "description": "Applies to ipv6AccessConfigs only. The prefix length of the external IPv6 range.", - "type": "integer", - "format": "int32" - }, - "setPublicPtr": { - "description": "Specifies whether a public DNS 'PTR' record should be created to map the external IP address of the instance to a DNS domain name. This field is not used in ipv6AccessConfig. A default PTR record will be created if the VM has external IPv6 range associated.", - "type": "boolean" - }, - "publicPtrDomainName": { - "description": "The DNS domain name for the public PTR record. You can set this field only if the `setPublicPtr` field is enabled in accessConfig. If this field is unspecified in ipv6AccessConfig, a default PTR record will be created for first IP in associated external IPv6 range.", - "type": "string" + "description": "Copies rules to the specified network firewall policy." }, - "networkTier": { - "description": "This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM, STANDARD. If an AccessConfig is specified without a valid external IP address, an ephemeral IP will be created with this networkTier. If an AccessConfig with a valid external IP address is specified, it must match that of the networkTier associated with the Address resource owning that IP.", - "type": "string", - "enumDescriptions": [ - "Public internet quality with fixed bandwidth.", - "High quality, Google-grade network tier, support for all networking products.", - "Public internet quality, only limited support for other networking products.", - "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." + "getAssociation": { + "id": "compute.regionNetworkFirewallPolicies.getAssociation", + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getAssociation", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getAssociation", + "httpMethod": "GET", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to which the queried association belongs.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "name": { + "description": "The name of the association to get from the firewall policy.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" - ] - }, - "securityPolicy": { - "description": "[Output Only] The resource URL for the security policy associated with this access config.", - "type": "string" - } - } - }, - "AliasIpRange": { - "id": "AliasIpRange", - "description": "An alias IP range attached to an instance's network interface.", - "type": "object", - "properties": { - "ipCidrRange": { - "description": "The IP alias ranges to allocate for this interface. This IP CIDR range must belong to the specified subnetwork and cannot contain IP addresses reserved by system or used by other network interfaces. This range may be a single IP address (such as 10.2.3.4), a netmask (such as /24) or a CIDR-formatted string (such as 10.1.2.0/24).", - "type": "string" - }, - "subnetworkRangeName": { - "description": "The name of a subnetwork secondary IP range from which to allocate an IP alias range. If not specified, the primary range of the subnetwork is used.", - "type": "string" - } - } - }, - "AttachedDisk": { - "id": "AttachedDisk", - "description": "An instance-attached disk resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#attachedDisk for attached disks.", - "default": "compute#attachedDisk", - "type": "string" - }, - "type": { - "description": "Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.", - "type": "string", - "enumDescriptions": [ - "", - "" + "response": { + "$ref": "FirewallPolicyAssociation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "PERSISTENT", - "SCRATCH" - ] + "description": "Gets an association with the specified name." }, - "mode": { - "description": "The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.", - "type": "string", - "enumDescriptions": [ - "Attaches this disk in read-only mode. Multiple virtual machines can use a disk in read-only mode at a time.", - "*[Default]* Attaches this disk in read-write mode. Only one virtual machine at a time can be attached to a disk in read-write mode." + "addAssociation": { + "id": "compute.regionNetworkFirewallPolicies.addAssociation", + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addAssociation", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addAssociation", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "replaceExistingAssociation": { + "description": "Indicates whether or not to replace it if an association already exists. This is false by default, in which case an error will be returned if an association already exists.", + "location": "query", + "type": "boolean" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "READ_ONLY", - "READ_WRITE" - ] - }, - "savedState": { - "description": "For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this field is set to PRESERVED if the LocalSSD data has been saved to a persistent location by customer request. (see the discard_local_ssd option on Stop/Suspend). Read-only in the api.", - "type": "string", - "enumDescriptions": [ - "*[Default]* Disk state has not been preserved.", - "Disk state has been preserved." + "request": { + "$ref": "FirewallPolicyAssociation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "DISK_SAVED_STATE_UNSPECIFIED", - "PRESERVED" - ] - }, - "source": { - "description": "Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks. Note that for InstanceTemplate, specify the disk name for zonal disk, and the URL for regional disk.", - "type": "string" - }, - "deviceName": { - "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. If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks.", - "type": "string" - }, - "index": { - "description": "[Output Only] A zero-based index to this disk, where 0 is reserved for the boot disk. If you have many disks attached to an instance, each disk would have a unique index number.", - "type": "integer", - "format": "int32" - }, - "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" - }, - "initializeParams": { - "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. This property is mutually exclusive with the source property; you can only define one or the other, but not both.", - "$ref": "AttachedDiskInitializeParams" - }, - "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" - }, - "licenses": { - "description": "[Output Only] Any valid publicly visible licenses.", - "type": "array", - "items": { - "type": "string" - } + "description": "Inserts an association for the specified network firewall policy." }, - "interface": { - "description": "Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. For most machine types, the default is SCSI. Local SSDs can use either NVME or SCSI. In certain configurations, persistent disks can use NVMe. For more information, see About persistent disks.", - "type": "string", - "enumDescriptions": [ - "", - "" + "removeAssociation": { + "id": "compute.regionNetworkFirewallPolicies.removeAssociation", + "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeAssociation", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeAssociation", + "httpMethod": "POST", + "parameters": { + "firewallPolicy": { + "description": "Name of the firewall policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "name": { + "description": "Name for the association that will be removed.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "firewallPolicy" ], - "enum": [ - "NVME", - "SCSI" - ] - }, - "guestOsFeatures": { - "description": "A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options.", - "type": "array", - "items": { - "$ref": "GuestOsFeature" - } - }, - "diskEncryptionKey": { - "description": "Encrypts or decrypts a disk using a customer-supplied encryption key. If you are creating a new disk, this field encrypts the new disk using an encryption key that you provide. If you are attaching an existing disk that is already encrypted, this field decrypts the disk using the customer-supplied encryption key. If you encrypt a disk using a customer-supplied key, you must provide the same key again when you attempt to use this resource at a later time. For example, you must provide the key when you create a snapshot or an image from the disk or when you attach the disk to a virtual machine instance. If you do not provide an encryption key, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the disk later. Note: Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt disks in a managed instance group. You cannot create VMs that have disks with customer-supplied keys using the bulk insert method.", - "$ref": "CustomerEncryptionKey" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Removes an association for the specified network firewall policy." }, - "diskSizeGb": { - "description": "The size of the disk in GB.", - "type": "string", - "format": "int64" + "getEffectiveFirewalls": { + "id": "compute.regionNetworkFirewallPolicies.getEffectiveFirewalls", + "path": "projects/{project}/regions/{region}/firewallPolicies/getEffectiveFirewalls", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/getEffectiveFirewalls", + "httpMethod": "GET", + "parameters": { + "network": { + "description": "Network reference", + "location": "query", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "network" + ], + "response": { + "$ref": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the effective firewalls on a given network." }, - "shieldedInstanceInitialState": { - "description": "[Output Only] shielded vm initial state stored on disk", - "$ref": "InitialStateConfig" + "getIamPolicy": { + "id": "compute.regionNetworkFirewallPolicies.getIamPolicy", + "path": "projects/{project}/regions/{region}/firewallPolicies/{resource}/getIamPolicy", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "forceAttach": { - "description": "[Input Only] Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error.", - "type": "boolean" + "setIamPolicy": { + "id": "compute.regionNetworkFirewallPolicies.setIamPolicy", + "path": "projects/{project}/regions/{region}/firewallPolicies/{resource}/setIamPolicy", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "architecture": { - "description": "[Output Only] The architecture of the attached disk. Valid values are ARM64 or X86_64.", - "type": "string", - "enumDescriptions": [ - "Default value indicating Architecture is not set.", - "Machines with architecture ARM64", - "Machines with architecture X86_64" + "testIamPermissions": { + "id": "compute.regionNetworkFirewallPolicies.testIamPermissions", + "path": "projects/{project}/regions/{region}/firewallPolicies/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" - ] + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "AttachedDiskInitializeParams": { - "id": "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. This field is persisted and returned for instanceTemplate and not returned in the context of instance. This property is mutually exclusive with the source property; you can only define one or the other, but not both.", - "type": "object", - "properties": { - "diskName": { - "description": "Specifies the disk name. If not specified, the default is to use the name of the instance. If a disk with the same name already exists in the given region, the existing disk is attached to the new instance and the new disk is not created.", - "type": "string" - }, - "sourceImage": { - "description": "The source image to create this disk. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family If the source image is deleted later, this field will not be set.", - "type": "string" - }, - "diskSizeGb": { - "description": "Specifies the size of the disk in base-2 GB. The size must be at least 10 GB. If you specify a sourceImage, which is required for boot disks, the default size is the size of the sourceImage. If you do not specify a sourceImage, the default disk size is 500 GB.", - "type": "string", - "format": "int64" - }, - "diskType": { - "description": "Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/pd-standard For a full list of acceptable values, see Persistent disk types. If you specify this field when creating a VM, you can provide either the full or partial URL. For example, the following values are valid: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/diskType - projects/project/zones/zone/diskTypes/diskType - zones/zone/diskTypes/diskType If you specify this field when creating or updating an instance template or all-instances configuration, specify the type of the disk, not the URL. For example: pd-standard.", - "type": "string" - }, - "sourceImageEncryptionKey": { - "description": "The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. InstanceTemplate and InstancePropertiesPatch do not store customer-supplied encryption keys, so you cannot create disks for instances in a managed instance group if the source images are encrypted with your own keys.", - "$ref": "CustomerEncryptionKey" + "securityPolicies": { + "methods": { + "list": { + "id": "compute.securityPolicies.list", + "path": "projects/{project}/global/securityPolicies", + "flatPath": "projects/{project}/global/securityPolicies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "SecurityPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "List all the policies that have been configured for the specified project." }, - "labels": { - "description": "Labels to apply to this disk. These can be later modified by the disks.setLabels method. This field is only applicable for persistent disks.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "sourceSnapshot": { - "description": "The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set.", - "type": "string" - }, - "sourceSnapshotEncryptionKey": { - "description": "The customer-supplied encryption key of the source snapshot.", - "$ref": "CustomerEncryptionKey" - }, - "description": { - "description": "An optional description. Provide this property when creating the disk.", - "type": "string" - }, - "replicaZones": { - "description": "Required for each regional disk associated with the instance. Specify the URLs of the zones where the disk should be replicated to. You must provide exactly two replica zones, and one zone must be the same as the instance zone.", - "type": "array", - "items": { - "type": "string" - } - }, - "resourcePolicies": { - "description": "Resource policies applied to this disk for automatic snapshot creations. Specified using the full or partial URL. For instance template, specify only the resource policy name.", - "type": "array", - "items": { - "type": "string" - } - }, - "onUpdateAction": { - "description": "Specifies which action to take on instance update with this disk. Default is to use the existing disk.", - "type": "string", - "enumDescriptions": [ - "Always recreate the disk.", - "Recreate the disk if source (image, snapshot) of this disk is different from source of existing disk.", - "Use the existing disk, this is the default behaviour." + "get": { + "id": "compute.securityPolicies.get", + "path": "projects/{project}/global/securityPolicies/{securityPolicy}", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to get.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "securityPolicy" ], - "enum": [ - "RECREATE_DISK", - "RECREATE_DISK_IF_SOURCE_CHANGED", - "USE_EXISTING_DISK" - ] - }, - "provisionedIops": { - "description": "Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation.", - "type": "string", - "format": "int64" - }, - "licenses": { - "description": "A list of publicly visible licenses. Reserved for Google's use.", - "type": "array", - "items": { - "type": "string" - } - }, - "architecture": { - "description": "The architecture of the attached disk. Valid values are arm64 or x86_64.", - "type": "string", - "enumDescriptions": [ - "Default value indicating Architecture is not set.", - "Machines with architecture ARM64", - "Machines with architecture X86_64" + "response": { + "$ref": "SecurityPolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" - ] - }, - "resourceManagerTags": { - "description": "Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "provisionedThroughput": { - "description": "Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must greater than or equal to 1.", - "type": "string", - "format": "int64" - }, - "enableConfidentialCompute": { - "description": "Whether this disk is using confidential compute mode.", - "type": "boolean" - }, - "storagePool": { - "description": "The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool ", - "type": "string" - } - } - }, - "Metadata": { - "id": "Metadata", - "description": "A metadata key/value entry.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#metadata for metadata.", - "default": "compute#metadata", - "type": "string" - }, - "fingerprint": { - "description": "Specifies a fingerprint for this request, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource.", - "type": "string", - "format": "byte" + "description": "List all of the ordered rules present in a single specified policy." }, - "items": { - "description": "Array of key/value pairs. The total size of all keys and values must be less than 512 KB.", - "type": "array", - "items": { - "description": "Metadata", - "type": "object", - "properties": { - "key": { - "description": "Key for the metadata entry. Keys must conform to the following regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is reflected as part of a URL in the metadata server. Additionally, to avoid ambiguity, keys must not conflict with any other metadata keys for the project.", - "pattern": "[a-zA-Z0-9-_]{1,128}", - "annotations": { - "required": [ - "compute.instances.insert", - "compute.projects.setCommonInstanceMetadata" - ] - }, - "type": "string" - }, - "value": { - "description": "Value for the metadata entry. These are free-form strings, and only have meaning as interpreted by the image running in the instance. The only restriction placed on values is that their size must be less than or equal to 262144 bytes (256 KiB).", - "annotations": { - "required": [ - "compute.instances.insert", - "compute.projects.setCommonInstanceMetadata" - ] - }, - "type": "string" - } + "insert": { + "id": "compute.securityPolicies.insert", + "path": "projects/{project}/global/securityPolicies", + "flatPath": "projects/{project}/global/securityPolicies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "ServiceAccount": { - "id": "ServiceAccount", - "description": "A service account.", - "type": "object", - "properties": { - "email": { - "description": "Email address of the service account.", - "type": "string" - }, - "scopes": { - "description": "The list of scopes to be made available for this service account.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "Scheduling": { - "id": "Scheduling", - "description": "Sets the scheduling options for an Instance.", - "type": "object", - "properties": { - "onHostMaintenance": { - "description": "Defines the maintenance behavior for this instance. For standard instances, the default behavior is MIGRATE. For preemptible instances, the default and only possible behavior is TERMINATE. For more information, see Set VM host maintenance policy.", - "type": "string", - "enumDescriptions": [ - "*[Default]* Allows Compute Engine to automatically migrate instances out of the way of maintenance events.", - "Tells Compute Engine to terminate and (optionally) restart the instance away from the maintenance activity. If you would like your instance to be restarted, set the automaticRestart flag to true. Your instance may be restarted more than once, and it may be restarted outside the window of maintenance events." + }, + "parameterOrder": [ + "project" ], - "enum": [ - "MIGRATE", - "TERMINATE" - ] - }, - "automaticRestart": { - "description": "Specifies whether the instance should be automatically restarted if it is terminated by Compute Engine (not terminated by a user). You can only set the automatic restart option for standard instances. Preemptible instances cannot be automatically restarted. By default, this is set to true so an instance is automatically restarted if it is terminated by Compute Engine.", - "type": "boolean" - }, - "preemptible": { - "description": "Defines whether the instance is preemptible. This can only be set during instance creation or while the instance is stopped and therefore, in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states.", - "type": "boolean" - }, - "nodeAffinities": { - "description": "A set of node affinity and anti-affinity configurations. Refer to Configuring node affinity for more information. Overrides reservationAffinity.", - "type": "array", - "items": { - "$ref": "SchedulingNodeAffinity" - } - }, - "minNodeCpus": { - "description": "The minimum number of virtual CPUs this instance will consume when running on a sole-tenant node.", - "type": "integer", - "format": "int32" - }, - "locationHint": { - "description": "An opaque location hint used to place the instance close to other resources. This field is for use by internal tools that use the public API.", - "type": "string" - }, - "availabilityDomain": { - "description": "Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance.", - "type": "integer", - "format": "int32" - }, - "provisioningModel": { - "description": "Specifies the provisioning model of the instance.", - "type": "string", - "enumDescriptions": [ - "Heavily discounted, no guaranteed runtime.", - "Standard provisioning with user controlled runtime, no discounts." + "request": { + "$ref": "SecurityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "SPOT", - "STANDARD" - ] + "description": "Creates a new policy in the specified project using the data included in the request." }, - "instanceTerminationAction": { - "description": "Specifies the termination action for the instance.", - "type": "string", - "enumDescriptions": [ - "Delete the VM.", - "Default value. This value is unused.", - "Stop the VM without storing in-memory content. default action." + "delete": { + "id": "compute.securityPolicies.delete", + "path": "projects/{project}/global/securityPolicies/{securityPolicy}", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "securityPolicy" ], - "enum": [ - "DELETE", - "INSTANCE_TERMINATION_ACTION_UNSPECIFIED", - "STOP" - ] - }, - "maxRunDuration": { - "description": "Specifies the max run duration for the given instance. If specified, the instance termination action will be performed at the end of the run duration.", - "$ref": "Duration" - }, - "terminationTime": { - "description": "Specifies the timestamp, when the instance will be terminated, in RFC3339 text format. If specified, the instance termination action will be performed at the termination time.", - "type": "string" - }, - "onInstanceStopAction": { - "$ref": "SchedulingOnInstanceStopAction" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified policy." }, - "localSsdRecoveryTimeout": { - "description": "Specifies the maximum amount of time a Local Ssd Vm should wait while recovery of the Local Ssd state is attempted. Its value should be in between 0 and 168 hours with hour granularity and the default value being 1 hour.", - "$ref": "Duration" - } - } - }, - "SchedulingNodeAffinity": { - "id": "SchedulingNodeAffinity", - "description": "Node Affinity: the configuration of desired nodes onto which this Instance could be scheduled.", - "type": "object", - "properties": { - "key": { - "description": "Corresponds to the label key of Node resource.", - "type": "string" + "patch": { + "id": "compute.securityPolicies.patch", + "path": "projects/{project}/global/securityPolicies/{securityPolicy}", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" + } + }, + "parameterOrder": [ + "project", + "securityPolicy" + ], + "request": { + "$ref": "SecurityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified policy with the data included in the request. To clear fields in the policy, leave the fields empty and specify them in the updateMask. This cannot be used to be update the rules in the policy. Please use the per rule methods like addRule, patchRule, and removeRule instead." }, - "operator": { - "description": "Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity.", - "type": "string", - "enumDescriptions": [ - "Requires Compute Engine to seek for matched nodes.", - "Requires Compute Engine to avoid certain nodes.", - "" + "getRule": { + "id": "compute.securityPolicies.getRule", + "path": "projects/{project}/global/securityPolicies/{securityPolicy}/getRule", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/getRule", + "httpMethod": "GET", + "parameters": { + "priority": { + "description": "The priority of the rule to get from the security policy.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to which the queried rule belongs.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "securityPolicy" ], - "enum": [ - "IN", - "NOT_IN", - "OPERATOR_UNSPECIFIED" - ] + "response": { + "$ref": "SecurityPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets a rule at the specified priority." }, - "values": { - "description": "Corresponds to the label values of Node resource.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "Duration": { - "id": "Duration", - "description": "A Duration represents a fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution. It is independent of any calendar and concepts like \"day\" or \"month\". Range is approximately 10,000 years.", - "type": "object", - "properties": { - "seconds": { - "description": "Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years", - "type": "string", - "format": "int64" + "addRule": { + "id": "compute.securityPolicies.addRule", + "path": "projects/{project}/global/securityPolicies/{securityPolicy}/addRule", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/addRule", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "securityPolicy" + ], + "request": { + "$ref": "SecurityPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Inserts a rule into a security policy." }, - "nanos": { - "description": "Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 `seconds` field and a positive `nanos` field. Must be from 0 to 999,999,999 inclusive.", - "type": "integer", - "format": "int32" - } - } - }, - "SchedulingOnInstanceStopAction": { - "id": "SchedulingOnInstanceStopAction", - "description": "Defines the behaviour for instances with the instance_termination_action STOP.", - "type": "object", - "properties": { - "discardLocalSsd": { - "description": "If true, the contents of any attached Local SSD disks will be discarded else, the Local SSD data will be preserved when the instance is stopped at the end of the run duration/termination time.", - "type": "boolean" - } - } - }, - "InstanceParams": { - "id": "InstanceParams", - "description": "Additional instance params.", - "type": "object", - "properties": { - "resourceManagerTags": { - "description": "Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } - }, - "AcceleratorConfig": { - "id": "AcceleratorConfig", - "description": "A specification of the type and number of accelerator cards attached to the instance.", - "type": "object", - "properties": { - "acceleratorType": { - "description": "Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types.", - "type": "string" - }, - "acceleratorCount": { - "description": "The number of the guest accelerator cards exposed to this instance.", - "type": "integer", - "format": "int32" - } - } - }, - "ReservationAffinity": { - "id": "ReservationAffinity", - "description": "Specifies the reservations that this instance can consume from.", - "type": "object", - "properties": { - "consumeReservationType": { - "description": "Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples.", - "type": "string", - "enumDescriptions": [ - "Consume any allocation available.", - "Do not consume from any allocated capacity.", - "Must consume from a specific reservation. Must specify key value fields for specifying the reservations.", - "" + "removeRule": { + "id": "compute.securityPolicies.removeRule", + "path": "projects/{project}/global/securityPolicies/{securityPolicy}/removeRule", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/removeRule", + "httpMethod": "POST", + "parameters": { + "priority": { + "description": "The priority of the rule to remove from the security policy.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "securityPolicy" ], - "enum": [ - "ANY_RESERVATION", - "NO_RESERVATION", - "SPECIFIC_RESERVATION", - "UNSPECIFIED" - ] - }, - "key": { - "description": "Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, specify googleapis.com/reservation-name as the key and specify the name of your reservation as its value.", - "type": "string" - }, - "values": { - "description": "Corresponds to the label values of a reservation resource. This can be either a name to a reservation in the same project or \"projects/different-project/reservations/some-reservation-name\" to target a shared reservation in the same zone but in a different project.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "DisplayDevice": { - "id": "DisplayDevice", - "description": "A set of Display Device options", - "type": "object", - "properties": { - "enableDisplay": { - "description": "Defines whether the instance has Display enabled.", - "type": "boolean" - } - } - }, - "ShieldedInstanceConfig": { - "id": "ShieldedInstanceConfig", - "description": "A set of Shielded Instance options.", - "type": "object", - "properties": { - "enableSecureBoot": { - "description": "Defines whether the instance has Secure Boot enabled. Disabled by default.", - "type": "boolean" - }, - "enableVtpm": { - "description": "Defines whether the instance has the vTPM enabled. Enabled by default.", - "type": "boolean" - }, - "enableIntegrityMonitoring": { - "description": "Defines whether the instance has integrity monitoring enabled. Enabled by default.", - "type": "boolean" - } - } - }, - "ShieldedInstanceIntegrityPolicy": { - "id": "ShieldedInstanceIntegrityPolicy", - "description": "The policy describes the baseline against which Instance boot integrity is measured.", - "type": "object", - "properties": { - "updateAutoLearnPolicy": { - "description": "Updates the integrity policy baseline using the measurements from the VM instance's most recent boot.", - "type": "boolean" - } - } - }, - "ConfidentialInstanceConfig": { - "id": "ConfidentialInstanceConfig", - "description": "A set of Confidential Instance options.", - "type": "object", - "properties": { - "enableConfidentialCompute": { - "description": "Defines whether the instance should have confidential compute enabled.", - "type": "boolean" - }, - "confidentialInstanceType": { - "description": "Defines the type of technology used by the confidential instance.", - "type": "string", - "enumDescriptions": [ - "No type specified. Do not use this value.", - "AMD Secure Encrypted Virtualization.", - "AMD Secure Encrypted Virtualization - Secure Nested Paging." + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED", - "SEV", - "SEV_SNP" - ] - } - } - }, - "AdvancedMachineFeatures": { - "id": "AdvancedMachineFeatures", - "description": "Specifies options for controlling advanced machine features. Options that would traditionally be configured in a BIOS belong here. Features that require operating system support may have corresponding entries in the GuestOsFeatures of an Image (e.g., whether or not the OS in the Image supports nested virtualization being enabled or disabled).", - "type": "object", - "properties": { - "enableNestedVirtualization": { - "description": "Whether to enable nested virtualization or not (default is false).", - "type": "boolean" - }, - "threadsPerCore": { - "description": "The number of threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. If unset, the maximum number of threads supported per core by the underlying processor is assumed.", - "type": "integer", - "format": "int32" - }, - "visibleCoreCount": { - "description": "The number of physical cores to expose to an instance. Multiply by the number of threads per core to compute the total number of virtual CPUs to expose to the instance. If unset, the number of cores is inferred from the instance's nominal CPU count and the underlying platform's SMT width.", - "type": "integer", - "format": "int32" - }, - "enableUefiNetworking": { - "description": "Whether to enable UEFI networking for instance creation.", - "type": "boolean" + "description": "Deletes a rule at the specified priority." }, - "performanceMonitoringUnit": { - "description": "Type of Performance Monitoring Unit requested on instance.", - "type": "string", - "enumDescriptions": [ - "Architecturally defined non-LLC events.", - "Most documented core/L2 and LLC events.", - "", - "Most documented core/L2 events." + "patchRule": { + "id": "compute.securityPolicies.patchRule", + "path": "projects/{project}/global/securityPolicies/{securityPolicy}/patchRule", + "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/patchRule", + "httpMethod": "POST", + "parameters": { + "priority": { + "description": "The priority of the rule to patch.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "securityPolicy" ], - "enum": [ - "ARCHITECTURAL", - "ENHANCED", - "PERFORMANCE_MONITORING_UNIT_UNSPECIFIED", - "STANDARD" - ] - }, - "turboMode": { - "description": "Turbo frequency mode to use for the instance. Supported modes include: * ALL_CORE_MAX Using empty string or not setting this field will use the platform-specific default turbo mode.", - "type": "string" - } - } - }, - "ResourceStatus": { - "id": "ResourceStatus", - "description": "Contains output only fields. Use this sub-message for actual values set on Instance attributes as compared to the value requested by the user (intent) in their instance CRUD calls.", - "type": "object", - "properties": { - "scheduling": { - "$ref": "ResourceStatusScheduling" - }, - "upcomingMaintenance": { - "$ref": "UpcomingMaintenance" - }, - "physicalHost": { - "description": "[Output Only] An opaque ID of the host on which the VM is running.", - "type": "string" - } - } - }, - "ResourceStatusScheduling": { - "id": "ResourceStatusScheduling", - "type": "object", - "properties": { - "availabilityDomain": { - "description": "Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance.", - "type": "integer", - "format": "int32" - } - } - }, - "UpcomingMaintenance": { - "id": "UpcomingMaintenance", - "description": "Upcoming Maintenance notification information.", - "type": "object", - "properties": { - "type": { - "description": "Defines the type of maintenance.", - "type": "string", - "enumDescriptions": [ - "Scheduled maintenance (e.g. maintenance after uptime guarantee is complete).", - "No type specified. Do not use this value.", - "Unscheduled maintenance (e.g. emergency maintenance during uptime guarantee)." + "request": { + "$ref": "SecurityPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "SCHEDULED", - "UNKNOWN_TYPE", - "UNSCHEDULED" - ] - }, - "canReschedule": { - "description": "Indicates if the maintenance can be customer triggered.", - "type": "boolean" - }, - "windowStartTime": { - "description": "The current start time of the maintenance window. This timestamp value is in RFC3339 text format.", - "type": "string" + "description": "Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty and specify them in the updateMask." }, - "windowEndTime": { - "description": "The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format.", - "type": "string" + "listPreconfiguredExpressionSets": { + "id": "compute.securityPolicies.listPreconfiguredExpressionSets", + "path": "projects/{project}/global/securityPolicies/listPreconfiguredExpressionSets", + "flatPath": "projects/{project}/global/securityPolicies/listPreconfiguredExpressionSets", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "SecurityPoliciesListPreconfiguredExpressionSetsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the current list of preconfigured Web Application Firewall (WAF) expressions." }, - "latestWindowStartTime": { - "description": "The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format.", - "type": "string" + "setLabels": { + "id": "compute.securityPolicies.setLabels", + "path": "projects/{project}/global/securityPolicies/{resource}/setLabels", + "flatPath": "projects/{project}/global/securityPolicies/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on a security policy. To learn more about labels, read the Labeling Resources documentation." }, - "maintenanceStatus": { - "type": "string", - "enumDescriptions": [ - "There is ongoing maintenance on this VM.", - "There is pending maintenance.", - "Unknown maintenance status. Do not use this value." + "aggregatedList": { + "id": "compute.securityPolicies.aggregatedList", + "path": "projects/{project}/aggregated/securityPolicies", + "flatPath": "projects/{project}/aggregated/securityPolicies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" ], - "enum": [ - "ONGOING", - "PENDING", - "UNKNOWN" - ] - } - } - }, - "NetworkPerformanceConfig": { - "id": "NetworkPerformanceConfig", - "type": "object", - "properties": { - "totalEgressBandwidthTier": { - "type": "string", - "enumDescriptions": [ - "", - "" + "response": { + "$ref": "SecurityPoliciesAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "DEFAULT", - "TIER_1" - ] + "description": "Retrieves the list of all SecurityPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." } } }, - "InstanceAggregatedList": { - "id": "InstanceAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#instanceAggregatedList for aggregated lists of Instance resources.", - "default": "compute#instanceAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "An object that contains a list of instances scoped by zone.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of instances.", - "$ref": "InstancesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "regionSecurityPolicies": { + "methods": { + "list": { + "id": "compute.regionSecurityPolicies.list", + "path": "projects/{project}/regions/{region}/securityPolicies", + "flatPath": "projects/{project}/regions/{region}/securityPolicies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InstancesScopedList": { - "id": "InstancesScopedList", - "type": "object", - "properties": { - "instances": { - "description": "[Output Only] A list of instances contained in this scope.", - "type": "array", - "items": { - "$ref": "Instance" - } - }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of instances when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "InstanceListReferrers": { - "id": "InstanceListReferrers", - "description": "Contains a list of instance referrers.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#instanceListReferrers for lists of Instance referrers.", - "default": "compute#instanceListReferrers", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Reference resources.", - "type": "array", - "items": { - "$ref": "Reference" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "SecurityPolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "List all the policies that have been configured for the specified project and region." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "id": "compute.regionSecurityPolicies.get", + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "securityPolicy": { + "description": "Name of the security policy to get.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "Reference": { - "id": "Reference", - "description": "Represents a reference to a resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#reference for references.", - "default": "compute#reference", - "type": "string" - }, - "target": { - "description": "URL of the resource to which this reference points.", - "type": "string" + }, + "parameterOrder": [ + "project", + "region", + "securityPolicy" + ], + "response": { + "$ref": "SecurityPolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "List all of the ordered rules present in a single specified policy." }, - "referenceType": { - "description": "A description of the reference type with no implied semantics. Possible values include: 1. MEMBER_OF ", - "type": "string" + "insert": { + "id": "compute.regionSecurityPolicies.insert", + "path": "projects/{project}/regions/{region}/securityPolicies", + "flatPath": "projects/{project}/regions/{region}/securityPolicies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "SecurityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a new policy in the specified project using the data included in the request." }, - "referrer": { - "description": "URL of the resource which refers to the target.", - "type": "string" - } - } - }, - "SerialPortOutput": { - "id": "SerialPortOutput", - "description": "An instance serial console output.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#serialPortOutput for serial port output.", - "default": "compute#serialPortOutput", - "type": "string" + "delete": { + "id": "compute.regionSecurityPolicies.delete", + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "securityPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified policy." }, - "contents": { - "description": "[Output Only] The contents of the console output.", - "type": "string" + "patch": { + "id": "compute.regionSecurityPolicies.patch", + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" + } + }, + "parameterOrder": [ + "project", + "region", + "securityPolicy" + ], + "request": { + "$ref": "SecurityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified policy with the data included in the request. To clear fields in the policy, leave the fields empty and specify them in the updateMask. This cannot be used to be update the rules in the policy. Please use the per rule methods like addRule, patchRule, and removeRule instead." }, - "start": { - "description": "The starting byte position of the output that was returned. This should match the start parameter sent with the request. If the serial console output exceeds the size of the buffer (1 MB), older output is overwritten by newer content. The output start value will indicate the byte position of the output that was returned, which might be different than the `start` value that was specified in the request.", - "type": "string", - "format": "int64" + "getRule": { + "id": "compute.regionSecurityPolicies.getRule", + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/getRule", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/getRule", + "httpMethod": "GET", + "parameters": { + "priority": { + "description": "The priority of the rule to get from the security policy.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to which the queried rule belongs.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "securityPolicy" + ], + "response": { + "$ref": "SecurityPolicyRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets a rule at the specified priority." }, - "next": { - "description": "[Output Only] The position of the next byte of content, regardless of whether the content exists, following the output returned in the `contents` property. Use this value in the next request as the start parameter.", - "type": "string", - "format": "int64" + "addRule": { + "id": "compute.regionSecurityPolicies.addRule", + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/addRule", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/addRule", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region", + "securityPolicy" + ], + "request": { + "$ref": "SecurityPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Inserts a rule into a security policy." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - } - } - }, - "Screenshot": { - "id": "Screenshot", - "description": "An instance's screenshot.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#screenshot for the screenshots.", - "default": "compute#screenshot", - "type": "string" + "removeRule": { + "id": "compute.regionSecurityPolicies.removeRule", + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/removeRule", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/removeRule", + "httpMethod": "POST", + "parameters": { + "priority": { + "description": "The priority of the rule to remove from the security policy.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "securityPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes a rule at the specified priority." }, - "contents": { - "description": "[Output Only] The Base64-encoded screenshot data.", - "type": "string" + "patchRule": { + "id": "compute.regionSecurityPolicies.patchRule", + "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/patchRule", + "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/patchRule", + "httpMethod": "POST", + "parameters": { + "priority": { + "description": "The priority of the rule to patch.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "securityPolicy": { + "description": "Name of the security policy to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be cleared as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region", + "securityPolicy" + ], + "request": { + "$ref": "SecurityPolicyRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty and specify them in the updateMask." } } }, - "GuestAttributes": { - "id": "GuestAttributes", - "description": "A guest attributes entry.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#guestAttributes for guest attributes entry.", - "default": "compute#guestAttributes", - "type": "string" - }, - "variableKey": { - "description": "The key to search for.", - "type": "string" - }, - "variableValue": { - "description": "[Output Only] The value found for the requested key.", - "type": "string" - }, - "queryPath": { - "description": "The path to be queried. This can be the default namespace ('') or a nested namespace ('\\/') or a specified key ('\\/\\').", - "type": "string" - }, - "queryValue": { - "description": "[Output Only] The value of the requested queried path.", - "$ref": "GuestAttributesValue" + "instances": { + "methods": { + "list": { + "id": "compute.instances.list", + "path": "projects/{project}/zones/{zone}/instances", + "flatPath": "projects/{project}/zones/{zone}/instances", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "InstanceList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of instances contained within the specified zone." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - } - } - }, - "GuestAttributesValue": { - "id": "GuestAttributesValue", - "description": "Array of guest attribute namespace/key/value tuples.", - "type": "object", - "properties": { - "items": { - "type": "array", - "items": { - "$ref": "GuestAttributesEntry" - } - } - } - }, - "GuestAttributesEntry": { - "id": "GuestAttributesEntry", - "description": "A guest attributes namespace/key/value entry.", - "type": "object", - "properties": { - "namespace": { - "description": "Namespace for the guest attribute entry.", - "type": "string" - }, - "key": { - "description": "Key for the guest attribute entry.", - "type": "string" - }, - "value": { - "description": "Value for the guest attribute entry.", - "type": "string" - } - } - }, - "InstancesSetMachineResourcesRequest": { - "id": "InstancesSetMachineResourcesRequest", - "type": "object", - "properties": { - "guestAccelerators": { - "description": "A list of the type and count of accelerator cards attached to the instance.", - "type": "array", - "items": { - "$ref": "AcceleratorConfig" - } - } - } - }, - "InstancesSetMachineTypeRequest": { - "id": "InstancesSetMachineTypeRequest", - "type": "object", - "properties": { - "machineType": { - "description": "Full or partial URL of the machine type resource. See Machine Types for a full list of machine types. For example: zones/us-central1-f/machineTypes/n1-standard-1", - "type": "string" - } - } - }, - "InstancesSetMinCpuPlatformRequest": { - "id": "InstancesSetMinCpuPlatformRequest", - "type": "object", - "properties": { - "minCpuPlatform": { - "description": "Minimum cpu/platform this instance should be started at.", - "type": "string" - } - } - }, - "InstancesSetLabelsRequest": { - "id": "InstancesSetLabelsRequest", - "type": "object", - "properties": { - "labels": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "Fingerprint of the previous set of labels for this resource, used to prevent conflicts. Provide the latest fingerprint value when making a request to add or change labels.", - "type": "string", - "format": "byte" - } - } - }, - "InstancesSetNameRequest": { - "id": "InstancesSetNameRequest", - "type": "object", - "properties": { - "name": { - "description": "The name to be applied to the instance. Needs to be RFC 1035 compliant.", - "type": "string" - }, - "currentName": { - "description": "The current name of this resource, used to prevent conflicts. Provide the latest name when making a request to change name.", - "type": "string" - } - } - }, - "InstancesStartWithEncryptionKeyRequest": { - "id": "InstancesStartWithEncryptionKeyRequest", - "type": "object", - "properties": { - "disks": { - "description": "Array of disks associated with this instance that are protected with a customer-supplied encryption key. In order to start the instance, the disk url and its corresponding key must be provided. If the disk is not protected with a customer-supplied encryption key it should not be specified.", - "type": "array", - "items": { - "$ref": "CustomerEncryptionKeyProtectedDisk" - } - } - } - }, - "CustomerEncryptionKeyProtectedDisk": { - "id": "CustomerEncryptionKeyProtectedDisk", - "type": "object", - "properties": { - "source": { - "description": "Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. For example: \"source\": \"/compute/v1/projects/project_id/zones/zone/disks/ disk_name ", - "type": "string" - }, - "diskEncryptionKey": { - "description": "Decrypts data associated with the disk with a customer-supplied encryption key.", - "$ref": "CustomerEncryptionKey" - } - } - }, - "InstancesSetServiceAccountRequest": { - "id": "InstancesSetServiceAccountRequest", - "type": "object", - "properties": { - "email": { - "description": "Email address of the service account.", - "type": "string" - }, - "scopes": { - "description": "The list of scopes to be made available for this service account.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InstancesAddResourcePoliciesRequest": { - "id": "InstancesAddResourcePoliciesRequest", - "type": "object", - "properties": { - "resourcePolicies": { - "description": "Resource policies to be added to this instance.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InstancesRemoveResourcePoliciesRequest": { - "id": "InstancesRemoveResourcePoliciesRequest", - "type": "object", - "properties": { - "resourcePolicies": { - "description": "Resource policies to be removed from this instance.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InstancesSetSecurityPolicyRequest": { - "id": "InstancesSetSecurityPolicyRequest", - "type": "object", - "properties": { - "securityPolicy": { - "description": "A full or partial URL to a security policy to add to this instance. If this field is set to an empty string it will remove the associated security policy.", - "type": "string" - }, - "networkInterfaces": { - "description": "The network interfaces that the security policy will be applied to. Network interfaces use the nicN naming format. You can only set a security policy for network interfaces with an access config.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ShieldedInstanceIdentity": { - "id": "ShieldedInstanceIdentity", - "description": "A Shielded Instance Identity.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#shieldedInstanceIdentity for shielded Instance identity entry.", - "default": "compute#shieldedInstanceIdentity", - "type": "string" - }, - "signingKey": { - "description": "An Attestation Key (AK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM.", - "$ref": "ShieldedInstanceIdentityEntry" - }, - "encryptionKey": { - "description": "An Endorsement Key (EK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM.", - "$ref": "ShieldedInstanceIdentityEntry" - } - } - }, - "ShieldedInstanceIdentityEntry": { - "id": "ShieldedInstanceIdentityEntry", - "description": "A Shielded Instance Identity Entry.", - "type": "object", - "properties": { - "ekCert": { - "description": "A PEM-encoded X.509 certificate. This field can be empty.", - "type": "string" - }, - "ekPub": { - "description": "A PEM-encoded public key.", - "type": "string" - } - } - }, - "BulkInsertInstanceResource": { - "id": "BulkInsertInstanceResource", - "description": "A transient resource used in compute.instances.bulkInsert and compute.regionInstances.bulkInsert . This resource is not persisted anywhere, it is used only for processing the requests.", - "type": "object", - "properties": { - "count": { - "description": "The maximum number of instances to create.", - "type": "string", - "format": "int64" - }, - "minCount": { - "description": "The minimum number of instances to create. If no min_count is specified then count is used as the default value. If min_count instances cannot be created, then no instances will be created and instances already created will be deleted.", - "type": "string", - "format": "int64" - }, - "namePattern": { - "description": "The string pattern used for the names of the VMs. Either name_pattern or per_instance_properties must be set. The pattern must contain one continuous sequence of placeholder hash characters (#) with each character corresponding to one digit of the generated instance name. Example: a name_pattern of inst-#### generates instance names such as inst-0001 and inst-0002. If existing instances in the same project and zone have names that match the name pattern then the generated instance numbers start after the biggest existing number. For example, if there exists an instance with name inst-0050, then instance names generated using the pattern inst-#### begin with inst-0051. The name pattern placeholder #...# can contain up to 18 characters.", - "type": "string" - }, - "perInstanceProperties": { - "description": "Per-instance properties to be set on individual instances. Keys of this map specify requested instance names. Can be empty if name_pattern is used.", - "type": "object", - "additionalProperties": { - "$ref": "BulkInsertInstanceResourcePerInstanceProperties" - } - }, - "sourceInstanceTemplate": { - "description": "Specifies the instance template from which to create instances. You may combine sourceInstanceTemplate with instanceProperties to override specific values from an existing instance template. Bulk API follows the semantics of JSON Merge Patch described by RFC 7396. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate This field is optional.", - "type": "string" - }, - "instanceProperties": { - "description": "The instance properties defining the VM instances to be created. Required if sourceInstanceTemplate is not provided.", - "$ref": "InstanceProperties" - }, - "locationPolicy": { - "description": "Policy for chosing target zone. For more information, see Create VMs in bulk .", - "$ref": "LocationPolicy" - } - } - }, - "BulkInsertInstanceResourcePerInstanceProperties": { - "id": "BulkInsertInstanceResourcePerInstanceProperties", - "description": "Per-instance properties to be set on individual instances. To be extended in the future.", - "type": "object", - "properties": { - "name": { - "description": "This field is only temporary. It will be removed. Do not use it.", - "type": "string" - }, - "hostname": { - "description": "Specifies the hostname of the instance. More details in: https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention", - "type": "string" - } - } - }, - "InstanceProperties": { - "id": "InstanceProperties", - "type": "object", - "properties": { - "description": { - "description": "An optional text description for the instances that are created from these properties.", - "type": "string" - }, - "tags": { - "description": "A list of tags to apply to the instances that are created from these properties. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035.", - "$ref": "Tags" - }, - "resourceManagerTags": { - "description": "Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "machineType": { - "description": "The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`.", - "annotations": { - "required": [ - "compute.instanceTemplates.insert" - ] - }, - "type": "string" - }, - "canIpForward": { - "description": "Enables instances created based on these properties to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information.", - "type": "boolean" - }, - "networkInterfaces": { - "description": "An array of network access configurations for this interface.", - "type": "array", - "items": { - "$ref": "NetworkInterface" - } - }, - "disks": { - "description": "An array of disks that are associated with the instances that are created from these properties.", - "type": "array", - "items": { - "$ref": "AttachedDisk" - } - }, - "metadata": { - "description": "The metadata key/value pairs to assign to instances that are created from these properties. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information.", - "$ref": "Metadata" - }, - "serviceAccounts": { - "description": "A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from these properties. Use metadata queries to obtain the access tokens for these instances.", - "type": "array", - "items": { - "$ref": "ServiceAccount" - } - }, - "scheduling": { - "description": "Specifies the scheduling options for the instances that are created from these properties.", - "$ref": "Scheduling" - }, - "labels": { - "description": "Labels to apply to instances that are created from these properties.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "guestAccelerators": { - "description": "A list of guest accelerator cards' type and count to use for instances created from these properties.", - "type": "array", - "items": { - "$ref": "AcceleratorConfig" - } - }, - "minCpuPlatform": { - "description": "Minimum cpu/platform to be used by instances. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: \"Intel Haswell\" or minCpuPlatform: \"Intel Sandy Bridge\". For more information, read Specifying a Minimum CPU Platform.", - "type": "string" - }, - "reservationAffinity": { - "description": "Specifies the reservations that instances can consume from. Note that for MachineImage, this is not supported yet.", - "$ref": "ReservationAffinity" - }, - "shieldedInstanceConfig": { - "description": "Note that for MachineImage, this is not supported yet.", - "$ref": "ShieldedInstanceConfig" - }, - "resourcePolicies": { - "description": "Resource policies (names, not URLs) applied to instances created from these properties. Note that for MachineImage, this is not supported yet.", - "type": "array", - "items": { - "type": "string" - } - }, - "confidentialInstanceConfig": { - "description": "Specifies the Confidential Instance options. Note that for MachineImage, this is not supported yet.", - "$ref": "ConfidentialInstanceConfig" - }, - "privateIpv6GoogleAccess": { - "description": "The private IPv6 google access type for VMs. If not specified, use INHERIT_FROM_SUBNETWORK as default. Note that for MachineImage, this is not supported yet.", - "type": "string", - "enumDescriptions": [ - "Bidirectional private IPv6 access to/from Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before.", - "Outbound private IPv6 access from VMs in this subnet to Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before.", - "Each network interface inherits PrivateIpv6GoogleAccess from its subnetwork." - ], - "enum": [ - "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", - "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE", - "INHERIT_FROM_SUBNETWORK" - ] - }, - "advancedMachineFeatures": { - "description": "Controls for advanced machine-related behavior features. Note that for MachineImage, this is not supported yet.", - "$ref": "AdvancedMachineFeatures" - }, - "networkPerformanceConfig": { - "description": "Note that for MachineImage, this is not supported yet.", - "$ref": "NetworkPerformanceConfig" - }, - "keyRevocationActionType": { - "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and \"NONE\". The default value is \"NONE\" if it is not specified.", - "type": "string", - "enumDescriptions": [ - "Default value. This value is unused.", - "Indicates user chose no operation.", - "Indicates user chose to opt for VM shutdown on key revocation." - ], - "enum": [ - "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", - "NONE", - "STOP" - ] - } - } - }, - "LocationPolicy": { - "id": "LocationPolicy", - "description": "Configuration for location policy among multiple possible locations (e.g. preferences for zone selection among zones in a single region).", - "type": "object", - "properties": { - "locations": { - "description": "Location configurations mapped by location name. Currently only zone names are supported and must be represented as valid internal URLs, such as zones/us-central1-a.", - "type": "object", - "additionalProperties": { - "$ref": "LocationPolicyLocation" - } - }, - "targetShape": { - "description": "Strategy for distributing VMs across zones in a region.", - "type": "string", - "enumDescriptions": [ - "GCE picks zones for creating VM instances to fulfill the requested number of VMs within present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads that do not require high availability.", - "GCE always selects a single zone for all the VMs, optimizing for resource quotas, available reservations and general capacity. Recommended for batch workloads that cannot tollerate distribution over multiple zones. This the default shape in Bulk Insert and Capacity Advisor APIs.", - "GCE prioritizes acquisition of resources, scheduling VMs in zones where resources are available while distributing VMs as evenly as possible across allowed zones to minimize the impact of zonal failure. Recommended for highly available serving workloads." - ], - "enum": [ - "ANY", - "ANY_SINGLE_ZONE", - "BALANCED" - ] - } - } - }, - "LocationPolicyLocation": { - "id": "LocationPolicyLocation", - "type": "object", - "properties": { - "preference": { - "description": "Preference for a given location. Set to either ALLOW or DENY.", - "type": "string", - "enumDescriptions": [ - "Location is allowed for use.", - "Location is prohibited.", - "Default value, unused." - ], - "enum": [ - "ALLOW", - "DENY", - "PREFERENCE_UNSPECIFIED" - ] - }, - "constraints": { - "description": "Constraints that the caller requires on the result distribution in this zone.", - "$ref": "LocationPolicyLocationConstraints" - } - } - }, - "LocationPolicyLocationConstraints": { - "id": "LocationPolicyLocationConstraints", - "description": "Per-zone constraints on location policy for this zone.", - "type": "object", - "properties": { - "maxCount": { - "description": "Maximum number of items that are allowed to be placed in this zone. The value must be non-negative.", - "type": "integer", - "format": "int32" - } - } - }, - "InstancesGetEffectiveFirewallsResponse": { - "id": "InstancesGetEffectiveFirewallsResponse", - "type": "object", - "properties": { - "firewalls": { - "description": "Effective firewalls on the instance.", - "type": "array", - "items": { - "$ref": "Firewall" - } - }, - "firewallPolicys": { - "description": "Effective firewalls from firewall policies.", - "type": "array", - "items": { - "$ref": "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy" - } - } - } - }, - "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { - "id": "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", - "type": "object", - "properties": { - "name": { - "description": "[Output Only] The name of the firewall policy.", - "type": "string" - }, - "type": { - "description": "[Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "" - ], - "enum": [ - "HIERARCHY", - "NETWORK", - "NETWORK_REGIONAL", - "SYSTEM_GLOBAL", - "SYSTEM_REGIONAL", - "UNSPECIFIED" - ] - }, - "shortName": { - "description": "[Output Only] The short name of the firewall policy.", - "type": "string" - }, - "displayName": { - "description": "[Output Only] Deprecated, please use short name instead. The display name of the firewall policy.", - "deprecated": true, - "type": "string" - }, - "rules": { - "description": "The rules that apply to the network.", - "type": "array", - "items": { - "$ref": "FirewallPolicyRule" - } - }, - "priority": { - "description": "[Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY.", - "type": "integer", - "format": "int32" - } - } - }, - "ReservationList": { - "id": "ReservationList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource.Always compute#reservationsList for listsof reservations", - "default": "compute#reservationList", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string" - }, - "items": { - "description": "[Output Only] A list of Allocation resources.", - "type": "array", - "items": { - "$ref": "Reservation" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - } - } - }, - "Reservation": { - "id": "Reservation", - "description": "Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#reservations for reservations.", - "default": "compute#reservation", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined fully-qualified URL for this resource.", - "type": "string" - }, - "zone": { - "description": "Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "name": { - "description": "The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "annotations": { - "required": [ - "compute.instances.insert" - ] - }, - "type": "string" - }, - "specificReservation": { - "description": "Reservation for instances with specific machine shapes.", - "$ref": "AllocationSpecificSKUReservation" - }, - "aggregateReservation": { - "description": "Reservation for aggregated resources, providing shape flexibility.", - "$ref": "AllocationAggregateReservation" - }, - "commitment": { - "description": "[Output Only] Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.", - "type": "string" - }, - "specificReservationRequired": { - "description": "Indicates whether the reservation can be consumed by VMs with affinity for \"any\" reservation. If the field is set, then only VMs that target the reservation by name can consume from this reservation.", - "type": "boolean" - }, - "status": { - "description": "[Output Only] The status of the reservation.", - "type": "string", - "enumDescriptions": [ - "Resources are being allocated for the reservation.", - "Reservation is currently being deleted.", - "", - "Reservation has allocated all its resources.", - "Reservation is currently being resized." - ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY", - "UPDATING" - ] - }, - "shareSettings": { - "description": "Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation.", - "$ref": "ShareSettings" - }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - }, - "resourcePolicies": { - "description": "Resource policies to be added to this reservation. The key is defined by user, and the value is resource policy url. This is to define placement policy with reservation.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "resourceStatus": { - "description": "[Output Only] Status information for Reservation resource.", - "$ref": "AllocationResourceStatus" - } - } - }, - "AllocationSpecificSKUReservation": { - "id": "AllocationSpecificSKUReservation", - "description": "This reservation type allows to pre allocate specific instance configuration.", - "type": "object", - "properties": { - "instanceProperties": { - "description": "The instance properties for the reservation.", - "$ref": "AllocationSpecificSKUAllocationReservedInstanceProperties" - }, - "count": { - "description": "Specifies the number of resources that are allocated.", - "type": "string", - "format": "int64" - }, - "inUseCount": { - "description": "[Output Only] Indicates how many instances are in use.", - "type": "string", - "format": "int64" - }, - "assuredCount": { - "description": "[Output Only] Indicates how many instances are actually usable currently.", - "type": "string", - "format": "int64" - }, - "sourceInstanceTemplate": { - "description": "Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate ", - "type": "string" - } - } - }, - "AllocationSpecificSKUAllocationReservedInstanceProperties": { - "id": "AllocationSpecificSKUAllocationReservedInstanceProperties", - "description": "Properties of the SKU instances being reserved. Next ID: 9", - "type": "object", - "properties": { - "machineType": { - "description": "Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.", - "type": "string" - }, - "guestAccelerators": { - "description": "Specifies accelerator type and count.", - "type": "array", - "items": { - "$ref": "AcceleratorConfig" - } - }, - "minCpuPlatform": { - "description": "Minimum cpu platform the reservation.", - "type": "string" - }, - "localSsds": { - "description": "Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd.", - "type": "array", - "items": { - "$ref": "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk" - } - }, - "locationHint": { - "description": "An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API.", - "type": "string" - } - } - }, - "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk": { - "id": "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk", - "type": "object", - "properties": { - "diskSizeGb": { - "description": "Specifies the size of the disk in base-2 GB.", - "type": "string", - "format": "int64" - }, - "interface": { - "description": "Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.", - "type": "string", - "enumDescriptions": [ - "", - "" - ], - "enum": [ - "NVME", - "SCSI" - ] - } - } - }, - "AllocationAggregateReservation": { - "id": "AllocationAggregateReservation", - "description": "This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation.", - "type": "object", - "properties": { - "vmFamily": { - "description": "The VM family that all instances scheduled against this reservation must belong to.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" - ], - "enum": [ - "VM_FAMILY_CLOUD_TPU_DEVICE_CT3", - "VM_FAMILY_CLOUD_TPU_LITE_DEVICE_CT5L", - "VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP", - "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P", - "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P" - ] - }, - "reservedResources": { - "description": "List of reserved resources (CPUs, memory, accelerators).", - "type": "array", - "items": { - "$ref": "AllocationAggregateReservationReservedResourceInfo" - } - }, - "inUseResources": { - "description": "[Output only] List of resources currently in use.", - "type": "array", - "items": { - "$ref": "AllocationAggregateReservationReservedResourceInfo" - } - }, - "workloadType": { - "description": "The workload type of the instances that will target this reservation.", - "type": "string", - "enumDescriptions": [ - "Reserved resources will be optimized for BATCH workloads, such as ML training.", - "Reserved resources will be optimized for SERVING workloads, such as ML inference.", - "" - ], - "enum": [ - "BATCH", - "SERVING", - "UNSPECIFIED" - ] - } - } - }, - "AllocationAggregateReservationReservedResourceInfo": { - "id": "AllocationAggregateReservationReservedResourceInfo", - "type": "object", - "properties": { - "accelerator": { - "description": "Properties of accelerator resources in this reservation.", - "$ref": "AllocationAggregateReservationReservedResourceInfoAccelerator" - } - } - }, - "AllocationAggregateReservationReservedResourceInfoAccelerator": { - "id": "AllocationAggregateReservationReservedResourceInfoAccelerator", - "type": "object", - "properties": { - "acceleratorCount": { - "description": "Number of accelerators of specified type.", - "type": "integer", - "format": "int32" - }, - "acceleratorType": { - "description": "Full or partial URL to accelerator type. e.g. \"projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l\"", - "type": "string" - } - } - }, - "ShareSettings": { - "id": "ShareSettings", - "description": "The share setting for reservations and sole tenancy node groups.", - "type": "object", - "properties": { - "shareType": { - "description": "Type of sharing for this shared-reservation", - "type": "string", - "enumDescriptions": [ - "Default value.", - "Shared-reservation is open to entire Organization", - "Default value. This value is unused.", - "Shared-reservation is open to specific projects" - ], - "enum": [ - "LOCAL", - "ORGANIZATION", - "SHARE_TYPE_UNSPECIFIED", - "SPECIFIC_PROJECTS" - ] - }, - "projectMap": { - "description": "A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS.", - "type": "object", - "additionalProperties": { - "$ref": "ShareSettingsProjectConfig" - } - } - } - }, - "ShareSettingsProjectConfig": { - "id": "ShareSettingsProjectConfig", - "description": "Config for each project in the share settings.", - "type": "object", - "properties": { - "projectId": { - "description": "The project ID, should be same as the key of this project config in the parent map.", - "type": "string" - } - } - }, - "AllocationResourceStatus": { - "id": "AllocationResourceStatus", - "description": "[Output Only] Contains output only fields.", - "type": "object", - "properties": { - "specificSkuAllocation": { - "description": "Allocation Properties of this reservation.", - "$ref": "AllocationResourceStatusSpecificSKUAllocation" - } - } - }, - "AllocationResourceStatusSpecificSKUAllocation": { - "id": "AllocationResourceStatusSpecificSKUAllocation", - "description": "Contains Properties set for the reservation.", - "type": "object", - "properties": { - "sourceInstanceTemplateId": { - "description": "ID of the instance template used to populate reservation properties.", - "type": "string" - } - } - }, - "ReservationAggregatedList": { - "id": "ReservationAggregatedList", - "description": "Contains a list of reservations.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#reservationAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Allocation resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of reservations.", - "$ref": "ReservationsScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ReservationsScopedList": { - "id": "ReservationsScopedList", - "type": "object", - "properties": { - "reservations": { - "description": "A list of reservations contained in this scope.", - "type": "array", - "items": { - "$ref": "Reservation" - } - }, - "warning": { - "description": "Informational warning which replaces the list of reservations when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "ReservationsResizeRequest": { - "id": "ReservationsResizeRequest", - "type": "object", - "properties": { - "specificSkuCount": { - "description": "Number of allocated resources can be resized with minimum = 1 and maximum = 1000.", - "type": "string", - "format": "int64" - } - } - }, - "InstanceGroupList": { - "id": "InstanceGroupList", - "description": "A list of InstanceGroup resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#instanceGroupList for instance group lists.", - "default": "compute#instanceGroupList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InstanceGroup resources.", - "type": "array", - "items": { - "$ref": "InstanceGroup" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "InstanceGroup": { - "id": "InstanceGroup", - "description": "Represents an Instance Group resource. Instance Groups can be used to configure a target for load balancing. Instance groups can either be managed or unmanaged. To create managed instance groups, use the instanceGroupManager or regionInstanceGroupManager resource instead. Use zonal unmanaged instance groups if you need to apply load balancing to groups of heterogeneous instances or if you need to manage the instances yourself. You cannot create regional unmanaged instance groups. For more information, read Instance groups.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#instanceGroup for instance groups.", - "default": "compute#instanceGroup", - "type": "string" - }, - "id": { - "description": "[Output Only] A unique identifier for this instance group, generated by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] The creation timestamp for this instance group in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "The name of the 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])?", - "annotations": { - "required": [ - "compute.instanceGroups.insert" - ] - }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "namedPorts": { - "description": " Assigns a name to a port number. For example: {name: \"http\", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: \"app1\", port: 8080}, {name: \"app1\", port: 8081}, {name: \"app2\", port: 8082}] Named ports apply to all instances in this instance group. ", - "type": "array", - "items": { - "$ref": "NamedPort" - } - }, - "network": { - "description": "[Output Only] The URL of the network to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0).", - "type": "string" - }, - "fingerprint": { - "description": "[Output Only] The fingerprint of the named ports. The system uses this fingerprint to detect conflicts when multiple users change the named ports concurrently.", - "type": "string", - "format": "byte" - }, - "zone": { - "description": "[Output Only] The URL of the zone where the instance group is located (for zonal resources).", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] The URL for this instance group. The server generates this URL.", - "type": "string" - }, - "size": { - "description": "[Output Only] The total number of instances in the instance group.", - "type": "integer", - "format": "int32" - }, - "region": { - "description": "[Output Only] The URL of the region where the instance group is located (for regional resources).", - "type": "string" - }, - "subnetwork": { - "description": "[Output Only] The URL of the subnetwork to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0).", - "type": "string" - } - } - }, - "NamedPort": { - "id": "NamedPort", - "description": "The named port. For example: \u003c\"http\", 80\u003e.", - "type": "object", - "properties": { - "name": { - "description": "The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.", - "type": "string" - }, - "port": { - "description": "The port number, which can be a value between 1 and 65535.", - "type": "integer", - "format": "int32" - } - } - }, - "InstanceGroupAggregatedList": { - "id": "InstanceGroupAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#instanceGroupAggregatedList for aggregated lists of instance groups.", - "default": "compute#instanceGroupAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InstanceGroupsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "The name of the scope that contains this set of instance groups.", - "$ref": "InstanceGroupsScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InstanceGroupsScopedList": { - "id": "InstanceGroupsScopedList", - "type": "object", - "properties": { - "instanceGroups": { - "description": "[Output Only] The list of instance groups that are contained in this scope.", - "type": "array", - "items": { - "$ref": "InstanceGroup" - } - }, - "warning": { - "description": "[Output Only] An informational warning that replaces the list of instance groups when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "InstanceGroupsAddInstancesRequest": { - "id": "InstanceGroupsAddInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The list of instances to add to the instance group.", - "type": "array", - "items": { - "$ref": "InstanceReference" - } - } - } - }, - "InstanceReference": { - "id": "InstanceReference", - "type": "object", - "properties": { - "instance": { - "description": "The URL for a specific instance. @required compute.instancegroups.addInstances/removeInstances", - "type": "string" - } - } - }, - "InstanceGroupsRemoveInstancesRequest": { - "id": "InstanceGroupsRemoveInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The list of instances to remove from the instance group.", - "type": "array", - "items": { - "$ref": "InstanceReference" - } - } - } - }, - "InstanceGroupsListInstancesRequest": { - "id": "InstanceGroupsListInstancesRequest", - "type": "object", - "properties": { - "instanceState": { - "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.", - "type": "string", - "enumDescriptions": [ - "Includes all instances in the generated list regardless of their state.", - "Includes instances in the generated list only if they have a RUNNING state." - ], - "enum": [ - "ALL", - "RUNNING" - ] - } - } - }, - "InstanceGroupsListInstances": { - "id": "InstanceGroupsListInstances", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#instanceGroupsListInstances for the list of instances in the specified instance group.", - "default": "compute#instanceGroupsListInstances", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InstanceWithNamedPorts resources.", - "type": "array", - "items": { - "$ref": "InstanceWithNamedPorts" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "InstanceWithNamedPorts": { - "id": "InstanceWithNamedPorts", - "type": "object", - "properties": { - "instance": { - "description": "[Output Only] The URL of the instance.", - "type": "string" - }, - "status": { - "description": "[Output Only] The status of the instance.", - "type": "string", - "enumDescriptions": [ - "The instance is halted and we are performing tear down tasks like network deprogramming, releasing quota, IP, tearing down disks etc.", - "Resources are being allocated for the instance.", - "The instance is in repair.", - "The instance is running.", - "All required resources have been allocated and the instance is being started.", - "The instance has stopped successfully.", - "The instance is currently stopping (either being deleted or killed).", - "The instance has suspended.", - "The instance is suspending.", - "The instance has stopped (either by explicit action or underlying failure)." - ], - "enum": [ - "DEPROVISIONING", - "PROVISIONING", - "REPAIRING", - "RUNNING", - "STAGING", - "STOPPED", - "STOPPING", - "SUSPENDED", - "SUSPENDING", - "TERMINATED" - ] - }, - "namedPorts": { - "description": "[Output Only] The named ports that belong to this instance group.", - "type": "array", - "items": { - "$ref": "NamedPort" - } - } - } - }, - "InstanceGroupsSetNamedPortsRequest": { - "id": "InstanceGroupsSetNamedPortsRequest", - "type": "object", - "properties": { - "namedPorts": { - "description": "The list of named ports to set for this instance group.", - "type": "array", - "items": { - "$ref": "NamedPort" - } - }, - "fingerprint": { - "description": "The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. A request with an incorrect fingerprint will fail with error 412 conditionNotMet.", - "type": "string", - "format": "byte" - } - } - }, - "RegionInstanceGroupList": { - "id": "RegionInstanceGroupList", - "description": "Contains a list of InstanceGroup resources.", - "type": "object", - "properties": { - "kind": { - "description": "The resource type.", - "default": "compute#regionInstanceGroupList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InstanceGroup resources.", - "type": "array", - "items": { - "$ref": "InstanceGroup" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "RegionInstanceGroupsListInstancesRequest": { - "id": "RegionInstanceGroupsListInstancesRequest", - "type": "object", - "properties": { - "instanceState": { - "description": "Instances in which state should be returned. Valid options are: 'ALL', 'RUNNING'. By default, it lists all instances.", - "type": "string", - "enumDescriptions": [ - "Matches any status of the instances, running, non-running and others.", - "Instance is in RUNNING state if it is running." - ], - "enum": [ - "ALL", - "RUNNING" - ] - }, - "portName": { - "description": "Name of port user is interested in. It is optional. If it is set, only information about this ports will be returned. If it is not set, all the named ports will be returned. Always lists all instances.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - } - } - }, - "RegionInstanceGroupsListInstances": { - "id": "RegionInstanceGroupsListInstances", - "type": "object", - "properties": { - "kind": { - "description": "The resource type.", - "default": "compute#regionInstanceGroupsListInstances", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InstanceWithNamedPorts resources.", - "type": "array", - "items": { - "$ref": "InstanceWithNamedPorts" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "RegionInstanceGroupsSetNamedPortsRequest": { - "id": "RegionInstanceGroupsSetNamedPortsRequest", - "type": "object", - "properties": { - "namedPorts": { - "description": "The list of named ports to set for this instance group.", - "type": "array", - "items": { - "$ref": "NamedPort" - } - }, - "fingerprint": { - "description": "The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request.", - "type": "string", - "format": "byte" - } - } - }, - "InstanceGroupManagerList": { - "id": "InstanceGroupManagerList", - "description": "[Output Only] A list of managed instance groups.", - "type": "object", - "properties": { - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InstanceGroupManager resources.", - "type": "array", - "items": { - "$ref": "InstanceGroupManager" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "kind": { - "description": "[Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups.", - "default": "compute#instanceGroupManagerList", - "type": "string" - } - } - }, - "InstanceGroupManager": { - "id": "InstanceGroupManager", - "description": "Represents a Managed Instance Group resource. An instance group is a collection of VM instances that you can manage as a single entity. For more information, read Instance groups. For zonal Managed Instance Group, use the instanceGroupManagers resource. For regional Managed Instance Group, use the regionInstanceGroupManagers resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.", - "default": "compute#instanceGroupManager", - "type": "string" - }, - "id": { - "description": "[Output Only] A unique identifier for this resource type. The server generates this identifier.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] The creation timestamp for this managed instance group in RFC3339 text format.", - "type": "string" - }, - "name": { - "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])?", - "annotations": { - "required": [ - "compute.instanceGroupManagers.insert", - "compute.regionInstanceGroupManagers.insert" - ] - }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource.", - "type": "string" - }, - "zone": { - "description": "[Output Only] The URL of a zone where the managed instance group is located (for zonal resources).", - "type": "string" - }, - "region": { - "description": "[Output Only] The URL of the region where the managed instance group resides (for regional resources).", - "type": "string" - }, - "distributionPolicy": { - "description": "Policy specifying the intended distribution of managed instances across zones in a regional managed instance group.", - "$ref": "DistributionPolicy" - }, - "instanceTemplate": { - "description": "The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.", - "type": "string" - }, - "versions": { - "description": "Specifies the instance templates used by this managed instance group to create instances. Each version is defined by an instanceTemplate and a name. Every version can appear at most once per instance group. This field overrides the top-level instanceTemplate field. Read more about the relationships between these fields. Exactly one version must leave the targetSize field unset. That version will be applied to all remaining instances. For more information, read about canary updates.", - "type": "array", - "items": { - "$ref": "InstanceGroupManagerVersion" - } - }, - "allInstancesConfig": { - "description": "Specifies configuration that overrides the instance template configuration for the group.", - "$ref": "InstanceGroupManagerAllInstancesConfig" - }, - "instanceGroup": { - "description": "[Output Only] The URL of the Instance Group resource.", - "type": "string" - }, - "targetPools": { - "description": "The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.", - "type": "array", - "items": { - "type": "string" - } - }, - "baseInstanceName": { - "description": "The base instance name is a prefix that you want to attach to the names of all VMs in a MIG. The maximum character length is 58 and the name must comply with RFC1035 format. When a VM is created in the group, the MIG appends a hyphen and a random four-character string to the base instance name. If you want the MIG to assign sequential numbers instead of a random string, then end the base instance name with a hyphen followed by one or more hash symbols. The hash symbols indicate the number of digits. For example, a base instance name of \"vm-###\" results in \"vm-001\" as a VM name. @pattern [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\\\[[0-9]{1,10}\\\\])?))", - "type": "string" - }, - "fingerprint": { - "description": "Fingerprint of this resource. This field may be used in optimistic locking. It will be ignored when inserting an InstanceGroupManager. An up-to-date fingerprint must be provided in order to update the InstanceGroupManager, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InstanceGroupManager.", - "type": "string", - "format": "byte" - }, - "currentActions": { - "description": "[Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.", - "$ref": "InstanceGroupManagerActionsSummary" - }, - "status": { - "description": "[Output Only] The status of this managed instance group.", - "$ref": "InstanceGroupManagerStatus" - }, - "targetSize": { - "description": "The target number of running instances for this managed instance group. You can reduce this number by using the instanceGroupManager deleteInstances or abandonInstances methods. Resizing the group also changes this number.", - "annotations": { - "required": [ - "compute.instanceGroupManagers.insert", - "compute.regionInstanceGroupManagers.insert" - ] - }, - "type": "integer", - "format": "int32" - }, - "listManagedInstancesResults": { - "description": "Pagination behavior of the listManagedInstances API method for this managed instance group.", - "type": "string", - "enumDescriptions": [ - "(Default) Pagination is disabled for the group's listManagedInstances API method. maxResults and pageToken query parameters are ignored and all instances are returned in a single response.", - "Pagination is enabled for the group's listManagedInstances API method. maxResults and pageToken query parameters are respected." - ], - "enum": [ - "PAGELESS", - "PAGINATED" - ] - }, - "selfLink": { - "description": "[Output Only] The URL for this managed instance group. The server defines this URL.", - "type": "string" - }, - "autoHealingPolicies": { - "description": "The autohealing policy for this managed instance group. You can specify only one value.", - "type": "array", - "items": { - "$ref": "InstanceGroupManagerAutoHealingPolicy" - } - }, - "updatePolicy": { - "description": "The update policy for this managed instance group.", - "$ref": "InstanceGroupManagerUpdatePolicy" - }, - "namedPorts": { - "description": "Named ports configured for the Instance Groups complementary to this Instance Group Manager.", - "type": "array", - "items": { - "$ref": "NamedPort" - } - }, - "statefulPolicy": { - "description": "Stateful configuration for this Instanced Group Manager", - "$ref": "StatefulPolicy" - }, - "instanceLifecyclePolicy": { - "description": "The repair policy for this managed instance group.", - "$ref": "InstanceGroupManagerInstanceLifecyclePolicy" - }, - "satisfiesPzi": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - } - } - }, - "DistributionPolicy": { - "id": "DistributionPolicy", - "type": "object", - "properties": { - "zones": { - "description": "Zones where the regional managed instance group will create and manage its instances.", - "type": "array", - "items": { - "$ref": "DistributionPolicyZoneConfiguration" - } - }, - "targetShape": { - "description": "The distribution shape to which the group converges either proactively or on resize events (depending on the value set in updatePolicy.instanceRedistributionType).", - "type": "string", - "enumDescriptions": [ - "The group picks zones for creating VM instances to fulfill the requested number of VMs within present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads that do not require high availability.", - "The group creates all VM instances within a single zone. The zone is selected based on the present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads with heavy interprocess communication.", - "The group prioritizes acquisition of resources, scheduling VMs in zones where resources are available while distributing VMs as evenly as possible across selected zones to minimize the impact of zonal failure. Recommended for highly available serving workloads.", - "The group schedules VM instance creation and deletion to achieve and maintain an even number of managed instances across the selected zones. The distribution is even when the number of managed instances does not differ by more than 1 between any two zones. Recommended for highly available serving workloads." - ], - "enum": [ - "ANY", - "ANY_SINGLE_ZONE", - "BALANCED", - "EVEN" - ] - } - } - }, - "DistributionPolicyZoneConfiguration": { - "id": "DistributionPolicyZoneConfiguration", - "type": "object", - "properties": { - "zone": { - "description": "The URL of the zone. The zone must exist in the region where the managed instance group is located.", - "annotations": { - "required": [ - "compute.regionInstanceGroupManagers.insert" - ] - }, - "type": "string" - } - } - }, - "InstanceGroupManagerVersion": { - "id": "InstanceGroupManagerVersion", - "type": "object", - "properties": { - "name": { - "description": "Name of the version. Unique among all versions in the scope of this managed instance group.", - "type": "string" - }, - "instanceTemplate": { - "description": "The URL of the instance template that is specified for this managed instance group. The group uses this template to create new instances in the managed instance group until the `targetSize` for this version is reached. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE; in those cases, existing instances are updated until the `targetSize` for this version is reached.", - "type": "string" - }, - "targetSize": { - "description": "Specifies the intended number of instances to be created from the instanceTemplate. The final number of instances created from the template will be equal to: - If expressed as a fixed number, the minimum of either targetSize.fixed or instanceGroupManager.targetSize is used. - if expressed as a percent, the targetSize would be (targetSize.percent/100 * InstanceGroupManager.targetSize) If there is a remainder, the number is rounded. If unset, this version will update any remaining instances not updated by another version. Read Starting a canary update for more information.", - "$ref": "FixedOrPercent" - } - } - }, - "FixedOrPercent": { - "id": "FixedOrPercent", - "description": "Encapsulates numeric value that can be either absolute or relative.", - "type": "object", - "properties": { - "fixed": { - "description": "Specifies a fixed number of VM instances. This must be a positive integer.", - "type": "integer", - "format": "int32" - }, - "percent": { - "description": "Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%.", - "type": "integer", - "format": "int32" - }, - "calculated": { - "description": "[Output Only] Absolute value of VM instances calculated based on the specific mode. - If the value is fixed, then the calculated value is equal to the fixed value. - If the value is a percent, then the calculated value is percent/100 * targetSize. For example, the calculated value of a 80% of a managed instance group with 150 instances would be (80/100 * 150) = 120 VM instances. If there is a remainder, the number is rounded. ", - "type": "integer", - "format": "int32" - } - } - }, - "InstanceGroupManagerAllInstancesConfig": { - "id": "InstanceGroupManagerAllInstancesConfig", - "type": "object", - "properties": { - "properties": { - "description": "Properties to set on all instances in the group. You can add or modify properties using the instanceGroupManagers.patch or regionInstanceGroupManagers.patch. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration. To apply the configuration, set the group's updatePolicy.type field to use proactive updates or use the applyUpdatesToInstances method.", - "$ref": "InstancePropertiesPatch" - } - } - }, - "InstancePropertiesPatch": { - "id": "InstancePropertiesPatch", - "description": "Represents the change that you want to make to the instance properties.", - "type": "object", - "properties": { - "metadata": { - "description": "The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labels": { - "description": "The label key-value pairs that you want to patch onto the instance.", - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } - }, - "InstanceGroupManagerActionsSummary": { - "id": "InstanceGroupManagerActionsSummary", - "type": "object", - "properties": { - "none": { - "description": "[Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.", - "type": "integer", - "format": "int32" - }, - "creating": { - "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully. If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.", - "type": "integer", - "format": "int32" - }, - "creatingWithoutRetries": { - "description": "[Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.", - "type": "integer", - "format": "int32" - }, - "verifying": { - "description": "[Output Only] The number of instances in the managed instance group that are being verified. See the managedInstances[].currentAction property in the listManagedInstances method documentation.", - "type": "integer", - "format": "int32" - }, - "recreating": { - "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.", - "type": "integer", - "format": "int32" - }, - "deleting": { - "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.", - "type": "integer", - "format": "int32" - }, - "abandoning": { - "description": "[Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.", - "type": "integer", - "format": "int32" - }, - "restarting": { - "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.", - "type": "integer", - "format": "int32" - }, - "refreshing": { - "description": "[Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.", - "type": "integer", - "format": "int32" - }, - "suspending": { - "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be suspended or are currently being suspended.", - "type": "integer", - "format": "int32" - }, - "resuming": { - "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be resumed or are currently being resumed.", - "type": "integer", - "format": "int32" - }, - "stopping": { - "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be stopped or are currently being stopped.", - "type": "integer", - "format": "int32" - }, - "starting": { - "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be started or are currently being started.", - "type": "integer", - "format": "int32" - } - } - }, - "InstanceGroupManagerStatus": { - "id": "InstanceGroupManagerStatus", - "type": "object", - "properties": { - "isStable": { - "description": "[Output Only] A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified.", - "type": "boolean" - }, - "allInstancesConfig": { - "description": "[Output only] Status of all-instances configuration on the group.", - "$ref": "InstanceGroupManagerStatusAllInstancesConfig" - }, - "versionTarget": { - "description": "[Output Only] A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.", - "$ref": "InstanceGroupManagerStatusVersionTarget" - }, - "stateful": { - "description": "[Output Only] Stateful status of the given Instance Group Manager.", - "$ref": "InstanceGroupManagerStatusStateful" - }, - "autoscaler": { - "description": "[Output Only] The URL of the Autoscaler that targets this instance group manager.", - "type": "string" - } - } - }, - "InstanceGroupManagerStatusAllInstancesConfig": { - "id": "InstanceGroupManagerStatusAllInstancesConfig", - "type": "object", - "properties": { - "effective": { - "description": "[Output Only] A bit indicating whether this configuration has been applied to all managed instances in the group.", - "type": "boolean" - }, - "currentRevision": { - "description": "[Output Only] Current all-instances configuration revision. This value is in RFC3339 text format.", - "type": "string" - } - } - }, - "InstanceGroupManagerStatusVersionTarget": { - "id": "InstanceGroupManagerStatusVersionTarget", - "type": "object", - "properties": { - "isReached": { - "description": "[Output Only] A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager.", - "type": "boolean" - } - } - }, - "InstanceGroupManagerStatusStateful": { - "id": "InstanceGroupManagerStatusStateful", - "type": "object", - "properties": { - "hasStatefulConfig": { - "description": "[Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful configuration even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.", - "type": "boolean" - }, - "perInstanceConfigs": { - "description": "[Output Only] Status of per-instance configurations on the instances.", - "$ref": "InstanceGroupManagerStatusStatefulPerInstanceConfigs" - } - } - }, - "InstanceGroupManagerStatusStatefulPerInstanceConfigs": { - "id": "InstanceGroupManagerStatusStatefulPerInstanceConfigs", - "type": "object", - "properties": { - "allEffective": { - "description": "A bit indicating if all of the group's per-instance configurations (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.", - "type": "boolean" - } - } - }, - "InstanceGroupManagerAutoHealingPolicy": { - "id": "InstanceGroupManagerAutoHealingPolicy", - "type": "object", - "properties": { - "healthCheck": { - "description": "The URL for the health check that signals autohealing.", - "type": "string" - }, - "initialDelaySec": { - "description": "The initial delay is the number of seconds that a new VM takes to initialize and run its startup script. During a VM's initial delay period, the MIG ignores unsuccessful health checks because the VM might be in the startup process. This prevents the MIG from prematurely recreating a VM. If the health check receives a healthy response during the initial delay, it indicates that the startup process is complete and the VM is ready. The value of initial delay must be between 0 and 3600 seconds. The default value is 0.", - "type": "integer", - "format": "int32" - } - } - }, - "InstanceGroupManagerUpdatePolicy": { - "id": "InstanceGroupManagerUpdatePolicy", - "type": "object", - "properties": { - "type": { - "description": "The type of update process. You can specify either PROACTIVE so that the MIG automatically updates VMs to the latest configurations or OPPORTUNISTIC so that you can select the VMs that you want to update.", - "type": "string", - "enumDescriptions": [ - "MIG will apply new configurations to existing VMs only when you selectively target specific or all VMs to be updated.", - "MIG will automatically apply new configurations to all or a subset of existing VMs and also to new VMs that are added to the group." - ], - "enum": [ - "OPPORTUNISTIC", - "PROACTIVE" - ] - }, - "instanceRedistributionType": { - "description": "The instance redistribution policy for regional managed instance groups. Valid values are: - PROACTIVE (default): The group attempts to maintain an even distribution of VM instances across zones in the region. - NONE: For non-autoscaled groups, proactive redistribution is disabled. ", - "type": "string", - "enumDescriptions": [ - "No action is being proactively performed in order to bring this IGM to its target instance distribution.", - "This IGM will actively converge to its target instance distribution." - ], - "enum": [ - "NONE", - "PROACTIVE" - ] - }, - "minimalAction": { - "description": "Minimal action to be taken on an instance. Use this option to minimize disruption as much as possible or to apply a more disruptive action than is necessary. - To limit disruption as much as possible, set the minimal action to REFRESH. If your update requires a more disruptive action, Compute Engine performs the necessary action to execute the update. - To apply a more disruptive action than is strictly necessary, set the minimal action to RESTART or REPLACE. For example, Compute Engine does not need to restart a VM to change its metadata. But if your application reads instance metadata only when a VM is restarted, you can set the minimal action to RESTART in order to pick up metadata changes. ", - "type": "string", - "enumDescriptions": [ - "Do not perform any action.", - "Do not stop the instance.", - "(Default.) Replace the instance according to the replacement method option.", - "Stop the instance and start it again." - ], - "enum": [ - "NONE", - "REFRESH", - "REPLACE", - "RESTART" - ] - }, - "mostDisruptiveAllowedAction": { - "description": "Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to avoid restarting the VM and to limit disruption as much as possible. RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all.", - "type": "string", - "enumDescriptions": [ - "Do not perform any action.", - "Do not stop the instance.", - "(Default.) Replace the instance according to the replacement method option.", - "Stop the instance and start it again." - ], - "enum": [ - "NONE", - "REFRESH", - "REPLACE", - "RESTART" - ] - }, - "maxSurge": { - "description": "The maximum number of instances that can be created above the specified targetSize during the update process. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxSurge is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxSurge.", - "$ref": "FixedOrPercent" - }, - "maxUnavailable": { - "description": "The maximum number of instances that can be unavailable during the update process. An instance is considered available if all of the following conditions are satisfied: - The instance's status is RUNNING. - If there is a health check on the instance group, the instance's health check status must be HEALTHY at least once. If there is no health check on the group, then the instance only needs to have a status of RUNNING to be considered available. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxUnavailable is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxUnavailable.", - "$ref": "FixedOrPercent" - }, - "replacementMethod": { - "description": "What action should be used to replace instances. See minimal_action.REPLACE", - "type": "string", - "enumDescriptions": [ - "Instances will be recreated (with the same name)", - "Default option: instances will be deleted and created (with a new name)" - ], - "enum": [ - "RECREATE", - "SUBSTITUTE" - ] - } - } - }, - "StatefulPolicy": { - "id": "StatefulPolicy", - "type": "object", - "properties": { - "preservedState": { - "$ref": "StatefulPolicyPreservedState" - } - } - }, - "StatefulPolicyPreservedState": { - "id": "StatefulPolicyPreservedState", - "description": "Configuration of preserved resources.", - "type": "object", - "properties": { - "disks": { - "description": "Disks created on the instances that will be preserved on instance delete, update, etc. This map is keyed with the device names of the disks.", - "type": "object", - "additionalProperties": { - "$ref": "StatefulPolicyPreservedStateDiskDevice" - } - }, - "internalIPs": { - "description": "Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name.", - "type": "object", - "additionalProperties": { - "$ref": "StatefulPolicyPreservedStateNetworkIp" - } - }, - "externalIPs": { - "description": "External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name.", - "type": "object", - "additionalProperties": { - "$ref": "StatefulPolicyPreservedStateNetworkIp" - } - } - } - }, - "StatefulPolicyPreservedStateDiskDevice": { - "id": "StatefulPolicyPreservedStateDiskDevice", - "type": "object", - "properties": { - "autoDelete": { - "description": "These stateful disks will never be deleted during autohealing, update or VM instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted.", - "type": "string", - "enumDescriptions": [ - "", - "" - ], - "enum": [ - "NEVER", - "ON_PERMANENT_INSTANCE_DELETION" - ] - } - } - }, - "StatefulPolicyPreservedStateNetworkIp": { - "id": "StatefulPolicyPreservedStateNetworkIp", - "type": "object", - "properties": { - "autoDelete": { - "description": "These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted.", - "type": "string", - "enumDescriptions": [ - "", - "" - ], - "enum": [ - "NEVER", - "ON_PERMANENT_INSTANCE_DELETION" - ] - } - } - }, - "InstanceGroupManagerInstanceLifecyclePolicy": { - "id": "InstanceGroupManagerInstanceLifecyclePolicy", - "type": "object", - "properties": { - "forceUpdateOnRepair": { - "description": "A bit indicating whether to forcefully apply the group's latest configuration when repairing a VM. Valid options are: - NO (default): If configuration updates are available, they are not forcefully applied during repair. Instead, configuration updates are applied according to the group's update policy. - YES: If configuration updates are available, they are applied during repair. ", - "type": "string", - "enumDescriptions": [ - "", - "" - ], - "enum": [ - "NO", - "YES" - ] - }, - "defaultActionOnFailure": { - "description": "The action that a MIG performs on a failed or an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are - REPAIR (default): MIG automatically repairs a failed or an unhealthy VM by recreating it. For more information, see About repairing VMs in a MIG. - DO_NOTHING: MIG does not repair a failed or an unhealthy VM. ", - "type": "string", - "enumDescriptions": [ - "MIG does not repair a failed or an unhealthy VM.", - "(Default) MIG automatically repairs a failed or an unhealthy VM by recreating it. For more information, see About repairing VMs in a MIG." - ], - "enum": [ - "DO_NOTHING", - "REPAIR" - ] - } - } - }, - "InstanceGroupManagerAggregatedList": { - "id": "InstanceGroupManagerAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#instanceGroupManagerAggregatedList for an aggregated list of managed instance groups.", - "default": "compute#instanceGroupManagerAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InstanceGroupManagersScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] The name of the scope that contains this set of managed instance groups.", - "$ref": "InstanceGroupManagersScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InstanceGroupManagersScopedList": { - "id": "InstanceGroupManagersScopedList", - "type": "object", - "properties": { - "instanceGroupManagers": { - "description": "[Output Only] The list of managed instance groups that are contained in the specified project and zone.", - "type": "array", - "items": { - "$ref": "InstanceGroupManager" - } - }, - "warning": { - "description": "[Output Only] The warning that replaces the list of managed instance groups when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "InstanceGroupManagersDeleteInstancesRequest": { - "id": "InstanceGroupManagersDeleteInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. Queued instances do not have URL and can be deleted only by name. One cannot specify both URLs and names in a single request.", - "type": "array", - "items": { - "type": "string" - } - }, - "skipInstancesOnValidationError": { - "description": "Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region.", - "type": "boolean" - } - } - }, - "InstanceGroupManagersAbandonInstancesRequest": { - "id": "InstanceGroupManagersAbandonInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InstanceGroupManagersRecreateInstancesRequest": { - "id": "InstanceGroupManagersRecreateInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InstanceGroupManagersSetInstanceTemplateRequest": { - "id": "InstanceGroupManagersSetInstanceTemplateRequest", - "type": "object", - "properties": { - "instanceTemplate": { - "description": "The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.", - "type": "string" - } - } - }, - "InstanceGroupManagersSetTargetPoolsRequest": { - "id": "InstanceGroupManagersSetTargetPoolsRequest", - "type": "object", - "properties": { - "targetPools": { - "description": "The list of target pool URLs that instances in this managed instance group belong to. The managed instance group applies these target pools to all of the instances in the group. Existing instances and new instances in the group all receive these target pool settings.", - "type": "array", - "items": { - "type": "string" - } - }, - "fingerprint": { - "description": "The fingerprint of the target pools information. Use this optional property to prevent conflicts when multiple users change the target pools settings concurrently. Obtain the fingerprint with the instanceGroupManagers.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request.", - "type": "string", - "format": "byte" - } - } - }, - "InstanceGroupManagersListManagedInstancesResponse": { - "id": "InstanceGroupManagersListManagedInstancesResponse", - "type": "object", - "properties": { - "managedInstances": { - "description": "[Output Only] The list of instances in the managed instance group.", - "type": "array", - "items": { - "$ref": "ManagedInstance" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - } - } - }, - "ManagedInstance": { - "id": "ManagedInstance", - "description": "A Managed Instance resource.", - "type": "object", - "properties": { - "name": { - "description": "[Output Only] The name of the instance. The name always exists even if the instance has not yet been created.", - "type": "string" - }, - "instance": { - "description": "[Output Only] The URL of the instance. The URL can exist even if the instance has not yet been created.", - "type": "string" - }, - "id": { - "description": "[Output only] The unique identifier for this resource. This field is empty when instance does not exist.", - "type": "string", - "format": "uint64" - }, - "instanceStatus": { - "description": "[Output Only] The status of the instance. This field is empty when the instance does not exist.", - "type": "string", - "enumDescriptions": [ - "The instance is halted and we are performing tear down tasks like network deprogramming, releasing quota, IP, tearing down disks etc.", - "Resources are being allocated for the instance.", - "The instance is in repair.", - "The instance is running.", - "All required resources have been allocated and the instance is being started.", - "The instance has stopped successfully.", - "The instance is currently stopping (either being deleted or killed).", - "The instance has suspended.", - "The instance is suspending.", - "The instance has stopped (either by explicit action or underlying failure)." - ], - "enum": [ - "DEPROVISIONING", - "PROVISIONING", - "REPAIRING", - "RUNNING", - "STAGING", - "STOPPED", - "STOPPING", - "SUSPENDED", - "SUSPENDING", - "TERMINATED" - ] - }, - "version": { - "description": "[Output Only] Intended version of this instance.", - "$ref": "ManagedInstanceVersion" - }, - "preservedStateFromPolicy": { - "description": "[Output Only] Preserved state generated based on stateful policy for this instance.", - "$ref": "PreservedState" - }, - "preservedStateFromConfig": { - "description": "[Output Only] Preserved state applied from per-instance config for this instance.", - "$ref": "PreservedState" - }, - "currentAction": { - "description": "[Output Only] The current action that the managed instance group has scheduled for the instance. Possible values: - NONE The instance is running, and the managed instance group does not have any scheduled actions for this instance. - CREATING The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased instead. - RECREATING The managed instance group is recreating this instance. - DELETING The managed instance group is permanently deleting this instance. - ABANDONING The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. - RESTARTING The managed instance group is restarting the instance. - REFRESHING The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. - VERIFYING The managed instance group has created the instance and it is in the process of being verified. ", - "type": "string", - "enumDescriptions": [ - "The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group.", - "The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful.", - "The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased.", - "The managed instance group is permanently deleting this instance.", - "The managed instance group has not scheduled any actions for this instance.", - "The managed instance group is recreating this instance.", - "The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance.", - "The managed instance group is restarting this instance.", - "The managed instance group is resuming this instance.", - "The managed instance group is starting this instance.", - "The managed instance group is stopping this instance.", - "The managed instance group is suspending this instance.", - "The managed instance group is verifying this already created instance. Verification happens every time the instance is (re)created or restarted and consists of: 1. Waiting until health check specified as part of this managed instance group's autohealing policy reports HEALTHY. Note: Applies only if autohealing policy has a health check specified 2. Waiting for addition verification steps performed as post-instance creation (subject to future extensions)." - ], - "enum": [ - "ABANDONING", - "CREATING", - "CREATING_WITHOUT_RETRIES", - "DELETING", - "NONE", - "RECREATING", - "REFRESHING", - "RESTARTING", - "RESUMING", - "STARTING", - "STOPPING", - "SUSPENDING", - "VERIFYING" - ] - }, - "instanceHealth": { - "description": "[Output Only] Health state of the instance per health-check.", - "type": "array", - "items": { - "$ref": "ManagedInstanceInstanceHealth" - } - }, - "lastAttempt": { - "description": "[Output Only] Information about the last attempt to create or delete the instance.", - "$ref": "ManagedInstanceLastAttempt" - } - } - }, - "ManagedInstanceVersion": { - "id": "ManagedInstanceVersion", - "type": "object", - "properties": { - "name": { - "description": "[Output Only] Name of the version.", - "type": "string" - }, - "instanceTemplate": { - "description": "[Output Only] The intended template of the instance. This field is empty when current_action is one of { DELETING, ABANDONING }.", - "type": "string" - } - } - }, - "PreservedState": { - "id": "PreservedState", - "description": "Preserved state for a given instance.", - "type": "object", - "properties": { - "disks": { - "description": "Preserved disks defined for this instance. This map is keyed with the device names of the disks.", - "type": "object", - "additionalProperties": { - "$ref": "PreservedStatePreservedDisk" - } - }, - "metadata": { - "description": "Preserved metadata defined for this instance.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "internalIPs": { - "description": "Preserved internal IPs defined for this instance. This map is keyed with the name of the network interface.", - "type": "object", - "additionalProperties": { - "$ref": "PreservedStatePreservedNetworkIp" - } - }, - "externalIPs": { - "description": "Preserved external IPs defined for this instance. This map is keyed with the name of the network interface.", - "type": "object", - "additionalProperties": { - "$ref": "PreservedStatePreservedNetworkIp" - } - } - } - }, - "PreservedStatePreservedDisk": { - "id": "PreservedStatePreservedDisk", - "type": "object", - "properties": { - "source": { - "description": "The URL of the disk resource that is stateful and should be attached to the VM instance.", - "type": "string" - }, - "mode": { - "description": "The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.", - "type": "string", - "enumDescriptions": [ - "Attaches this disk in read-only mode. Multiple VM instances can use a disk in READ_ONLY mode at a time.", - "*[Default]* Attaches this disk in READ_WRITE mode. Only one VM instance at a time can be attached to a disk in READ_WRITE mode." - ], - "enum": [ - "READ_ONLY", - "READ_WRITE" - ] - }, - "autoDelete": { - "description": "These stateful disks will never be deleted during autohealing, update, instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole MIG is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted.", - "type": "string", - "enumDescriptions": [ - "", - "" - ], - "enum": [ - "NEVER", - "ON_PERMANENT_INSTANCE_DELETION" - ] - } - } - }, - "PreservedStatePreservedNetworkIp": { - "id": "PreservedStatePreservedNetworkIp", - "type": "object", - "properties": { - "autoDelete": { - "description": "These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted.", - "type": "string", - "enumDescriptions": [ - "", - "" - ], - "enum": [ - "NEVER", - "ON_PERMANENT_INSTANCE_DELETION" - ] - }, - "ipAddress": { - "description": "Ip address representation", - "$ref": "PreservedStatePreservedNetworkIpIpAddress" - } - } - }, - "PreservedStatePreservedNetworkIpIpAddress": { - "id": "PreservedStatePreservedNetworkIpIpAddress", - "type": "object", - "properties": { - "literal": { - "description": "An IPv4 internal network address to assign to the instance for this network interface.", - "type": "string" - }, - "address": { - "description": "The URL of the reservation for this IP address.", - "type": "string" - } - } - }, - "ManagedInstanceInstanceHealth": { - "id": "ManagedInstanceInstanceHealth", - "type": "object", - "properties": { - "healthCheck": { - "description": "[Output Only] The URL for the health check that verifies whether the instance is healthy.", - "type": "string" - }, - "detailedHealthState": { - "description": "[Output Only] The current detailed instance health state.", - "type": "string", - "enumDescriptions": [ - "The instance is being drained. The existing connections to the instance have time to complete, but the new ones are being refused.", - "The instance is reachable i.e. a connection to the application health checking endpoint can be established, and conforms to the requirements defined by the health check.", - "The instance is unreachable i.e. a connection to the application health checking endpoint cannot be established, or the server does not respond within the specified timeout.", - "The instance is reachable, but does not conform to the requirements defined by the health check.", - "The health checking system is aware of the instance but its health is not known at the moment." - ], - "enum": [ - "DRAINING", - "HEALTHY", - "TIMEOUT", - "UNHEALTHY", - "UNKNOWN" - ] - } - } - }, - "ManagedInstanceLastAttempt": { - "id": "ManagedInstanceLastAttempt", - "type": "object", - "properties": { - "errors": { - "description": "[Output Only] Encountered errors during the last attempt to create or delete the instance.", - "type": "object", - "properties": { - "errors": { - "description": "[Output Only] The array of errors encountered while processing this operation.", - "type": "array", - "items": { - "type": "object", - "properties": { - "code": { - "description": "[Output Only] The error type identifier for this error.", - "type": "string" - }, - "location": { - "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", - "type": "string" - }, - "message": { - "description": "[Output Only] An optional, human-readable error message.", - "type": "string" - }, - "errorDetails": { - "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", - "type": "array", - "items": { - "type": "object", - "properties": { - "errorInfo": { - "$ref": "ErrorInfo" - }, - "quotaInfo": { - "$ref": "QuotaExceededInfo" - }, - "help": { - "$ref": "Help" - }, - "localizedMessage": { - "$ref": "LocalizedMessage" - } - } - } - } - } - } - } - } - } - } - }, - "InstanceGroupManagersListErrorsResponse": { - "id": "InstanceGroupManagersListErrorsResponse", - "type": "object", - "properties": { - "items": { - "description": "[Output Only] The list of errors of the managed instance group.", - "type": "array", - "items": { - "$ref": "InstanceManagedByIgmError" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - } - } - }, - "InstanceManagedByIgmError": { - "id": "InstanceManagedByIgmError", - "type": "object", - "properties": { - "error": { - "description": "[Output Only] Contents of the error.", - "$ref": "InstanceManagedByIgmErrorManagedInstanceError" - }, - "timestamp": { - "description": "[Output Only] The time that this error occurred. This value is in RFC3339 text format.", - "type": "string" - }, - "instanceActionDetails": { - "description": "[Output Only] Details of the instance action that triggered this error. May be null, if the error was not caused by an action on an instance. This field is optional.", - "$ref": "InstanceManagedByIgmErrorInstanceActionDetails" - } - } - }, - "InstanceManagedByIgmErrorManagedInstanceError": { - "id": "InstanceManagedByIgmErrorManagedInstanceError", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] Error code.", - "type": "string" - }, - "message": { - "description": "[Output Only] Error message.", - "type": "string" - } - } - }, - "InstanceManagedByIgmErrorInstanceActionDetails": { - "id": "InstanceManagedByIgmErrorInstanceActionDetails", - "type": "object", - "properties": { - "action": { - "description": "[Output Only] Action that managed instance group was executing on the instance when the error occurred. Possible values:", - "type": "string", - "enumDescriptions": [ - "The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group.", - "The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful.", - "The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased.", - "The managed instance group is permanently deleting this instance.", - "The managed instance group has not scheduled any actions for this instance.", - "The managed instance group is recreating this instance.", - "The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance.", - "The managed instance group is restarting this instance.", - "The managed instance group is resuming this instance.", - "The managed instance group is starting this instance.", - "The managed instance group is stopping this instance.", - "The managed instance group is suspending this instance.", - "The managed instance group is verifying this already created instance. Verification happens every time the instance is (re)created or restarted and consists of: 1. Waiting until health check specified as part of this managed instance group's autohealing policy reports HEALTHY. Note: Applies only if autohealing policy has a health check specified 2. Waiting for addition verification steps performed as post-instance creation (subject to future extensions)." - ], - "enum": [ - "ABANDONING", - "CREATING", - "CREATING_WITHOUT_RETRIES", - "DELETING", - "NONE", - "RECREATING", - "REFRESHING", - "RESTARTING", - "RESUMING", - "STARTING", - "STOPPING", - "SUSPENDING", - "VERIFYING" - ] - }, - "instance": { - "description": "[Output Only] The URL of the instance. The URL can be set even if the instance has not yet been created.", - "type": "string" - }, - "version": { - "description": "[Output Only] Version this instance was created from, or was being created from, but the creation failed. Corresponds to one of the versions that were set on the Instance Group Manager resource at the time this instance was being created.", - "$ref": "ManagedInstanceVersion" - } - } - }, - "InstanceGroupManagersListPerInstanceConfigsResp": { - "id": "InstanceGroupManagersListPerInstanceConfigsResp", - "type": "object", - "properties": { - "items": { - "description": "[Output Only] The list of PerInstanceConfig.", - "type": "array", - "items": { - "$ref": "PerInstanceConfig" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "PerInstanceConfig": { - "id": "PerInstanceConfig", - "type": "object", - "properties": { - "name": { - "description": "The name of a per-instance configuration and its corresponding instance. Serves as a merge key during UpdatePerInstanceConfigs operations, that is, if a per-instance configuration with the same name exists then it will be updated, otherwise a new one will be created for the VM instance with the same name. An attempt to create a per-instance configconfiguration for a VM instance that either doesn't exist or is not part of the group will result in an error.", - "type": "string" - }, - "preservedState": { - "description": "The intended preserved state for the given instance. Does not contain preserved state generated from a stateful policy.", - "$ref": "PreservedState" - }, - "status": { - "description": "The status of applying this per-instance configuration on the corresponding managed instance.", - "type": "string", - "enumDescriptions": [ - "The per-instance configuration is being applied to the instance, but is not yet effective, possibly waiting for the instance to, for example, REFRESH.", - "The per-instance configuration deletion is being applied on the instance, possibly waiting for the instance to, for example, REFRESH.", - "The per-instance configuration is effective on the instance, meaning that all disks, ips and metadata specified in this configuration are attached or set on the instance.", - "*[Default]* The default status, when no per-instance configuration exists.", - "The per-instance configuration is set on an instance but not been applied yet.", - "The per-instance configuration has been deleted, but the deletion is not yet applied." - ], - "enum": [ - "APPLYING", - "DELETING", - "EFFECTIVE", - "NONE", - "UNAPPLIED", - "UNAPPLIED_DELETION" - ] - }, - "fingerprint": { - "description": "Fingerprint of this per-instance config. This field can be used in optimistic locking. It is ignored when inserting a per-instance config. An up-to-date fingerprint must be provided in order to update an existing per-instance configuration or the field needs to be unset.", - "type": "string", - "format": "byte" - } - } - }, - "InstanceGroupManagersUpdatePerInstanceConfigsReq": { - "id": "InstanceGroupManagersUpdatePerInstanceConfigsReq", - "description": "InstanceGroupManagers.updatePerInstanceConfigs", - "type": "object", - "properties": { - "perInstanceConfigs": { - "description": "The list of per-instance configurations to insert or patch on this managed instance group.", - "type": "array", - "items": { - "$ref": "PerInstanceConfig" - } - } - } - }, - "InstanceGroupManagersPatchPerInstanceConfigsReq": { - "id": "InstanceGroupManagersPatchPerInstanceConfigsReq", - "description": "InstanceGroupManagers.patchPerInstanceConfigs", - "type": "object", - "properties": { - "perInstanceConfigs": { - "description": "The list of per-instance configurations to insert or patch on this managed instance group.", - "type": "array", - "items": { - "$ref": "PerInstanceConfig" - } - } - } - }, - "InstanceGroupManagersDeletePerInstanceConfigsReq": { - "id": "InstanceGroupManagersDeletePerInstanceConfigsReq", - "description": "InstanceGroupManagers.deletePerInstanceConfigs", - "type": "object", - "properties": { - "names": { - "description": "The list of instance names for which we want to delete per-instance configs on this managed instance group.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InstanceGroupManagersApplyUpdatesRequest": { - "id": "InstanceGroupManagersApplyUpdatesRequest", - "description": "InstanceGroupManagers.applyUpdatesToInstances", - "type": "object", - "properties": { - "instances": { - "description": "The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - }, - "minimalAction": { - "description": "The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update.", - "type": "string", - "enumDescriptions": [ - "Do not perform any action.", - "Do not stop the instance.", - "(Default.) Replace the instance according to the replacement method option.", - "Stop the instance and start it again." - ], - "enum": [ - "NONE", - "REFRESH", - "REPLACE", - "RESTART" - ] - }, - "mostDisruptiveAllowedAction": { - "description": "The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail.", - "type": "string", - "enumDescriptions": [ - "Do not perform any action.", - "Do not stop the instance.", - "(Default.) Replace the instance according to the replacement method option.", - "Stop the instance and start it again." - ], - "enum": [ - "NONE", - "REFRESH", - "REPLACE", - "RESTART" - ] - }, - "allInstances": { - "description": "Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request.", - "type": "boolean" - } - } - }, - "InstanceGroupManagersCreateInstancesRequest": { - "id": "InstanceGroupManagersCreateInstancesRequest", - "description": "InstanceGroupManagers.createInstances", - "type": "object", - "properties": { - "instances": { - "description": "[Required] List of specifications of per-instance configs.", - "type": "array", - "items": { - "$ref": "PerInstanceConfig" - } - } - } - }, - "InstanceGroupManagerResizeRequest": { - "id": "InstanceGroupManagerResizeRequest", - "description": "InstanceGroupManagerResizeRequest represents a request to create a number of VMs: either immediately or by queuing the request for the specified time. This resize request is nested under InstanceGroupManager and the VMs created by this request are added to the owning InstanceGroupManager.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#instanceGroupManagerResizeRequest for resize requests.", - "default": "compute#instanceGroupManagerResizeRequest", - "type": "string" - }, - "id": { - "description": "[Output Only] A unique identifier for this resource type. The server generates this identifier.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] The creation timestamp for this resize request in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "The name of this resize request. The name must be 1-63 characters long, and comply with RFC1035.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "annotations": { - "required": [ - "compute.instanceGroupManagerResizeRequests.insert" - ] - }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource.", - "type": "string" - }, - "zone": { - "description": "[Output Only] The URL of a zone where the resize request is located. Populated only for zonal resize requests.", - "type": "string" - }, - "resizeBy": { - "description": "The number of instances to be created by this resize request. The group's target size will be increased by this number. This field cannot be used together with 'instances'.", - "type": "integer", - "format": "int32" - }, - "requestedRunDuration": { - "description": "Requested run duration for instances that will be created by this request. At the end of the run duration instance will be deleted.", - "$ref": "Duration" - }, - "state": { - "description": "[Output only] Current state of the request.", - "type": "string", - "enumDescriptions": [ - "The request was created successfully and was accepted for provisioning when the capacity becomes available.", - "The request is cancelled.", - "Resize request is being created and may still fail creation.", - "The request failed before or during provisioning. If the request fails during provisioning, any VMs that were created during provisioning are rolled back and removed from the MIG.", - "Default value. This value should never be returned.", - "The request succeeded." - ], - "enum": [ - "ACCEPTED", - "CANCELLED", - "CREATING", - "FAILED", - "STATE_UNSPECIFIED", - "SUCCEEDED" - ] - }, - "status": { - "description": "[Output only] Status of the request.", - "$ref": "InstanceGroupManagerResizeRequestStatus" - }, - "selfLink": { - "description": "[Output Only] The URL for this resize request. The server defines this URL.", - "type": "string" - }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource with the resource id.", - "type": "string" - } - } - }, - "InstanceGroupManagerResizeRequestStatus": { - "id": "InstanceGroupManagerResizeRequestStatus", - "type": "object", - "properties": { - "error": { - "description": "[Output only] Fatal errors encountered during the queueing or provisioning phases of the ResizeRequest that caused the transition to the FAILED state. Contrary to the last_attempt errors, this field is final and errors are never removed from here, as the ResizeRequest is not going to retry.", - "type": "object", - "properties": { - "errors": { - "description": "[Output Only] The array of errors encountered while processing this operation.", - "type": "array", - "items": { - "type": "object", - "properties": { - "code": { - "description": "[Output Only] The error type identifier for this error.", - "type": "string" - }, - "location": { - "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", - "type": "string" - }, - "message": { - "description": "[Output Only] An optional, human-readable error message.", - "type": "string" - }, - "errorDetails": { - "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", - "type": "array", - "items": { - "type": "object", - "properties": { - "errorInfo": { - "$ref": "ErrorInfo" - }, - "quotaInfo": { - "$ref": "QuotaExceededInfo" - }, - "help": { - "$ref": "Help" - }, - "localizedMessage": { - "$ref": "LocalizedMessage" - } - } - } - } - } - } - } - } - }, - "lastAttempt": { - "description": "[Output only] Information about the last attempt to fulfill the request. The value is temporary since the ResizeRequest can retry, as long as it's still active and the last attempt value can either be cleared or replaced with a different error. Since ResizeRequest retries infrequently, the value may be stale and no longer show an active problem. The value is cleared when ResizeRequest transitions to the final state (becomes inactive). If the final state is FAILED the error describing it will be storred in the \"error\" field only.", - "$ref": "InstanceGroupManagerResizeRequestStatusLastAttempt" - } - } - }, - "InstanceGroupManagerResizeRequestStatusLastAttempt": { - "id": "InstanceGroupManagerResizeRequestStatusLastAttempt", - "type": "object", - "properties": { - "error": { - "description": "Errors that prevented the ResizeRequest to be fulfilled.", - "type": "object", - "properties": { - "errors": { - "description": "[Output Only] The array of errors encountered while processing this operation.", - "type": "array", - "items": { - "type": "object", - "properties": { - "code": { - "description": "[Output Only] The error type identifier for this error.", - "type": "string" - }, - "location": { - "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", - "type": "string" - }, - "message": { - "description": "[Output Only] An optional, human-readable error message.", - "type": "string" - }, - "errorDetails": { - "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", - "type": "array", - "items": { - "type": "object", - "properties": { - "errorInfo": { - "$ref": "ErrorInfo" - }, - "quotaInfo": { - "$ref": "QuotaExceededInfo" - }, - "help": { - "$ref": "Help" - }, - "localizedMessage": { - "$ref": "LocalizedMessage" - } - } - } - } - } - } - } - } - } - } - }, - "InstanceGroupManagerResizeRequestsListResponse": { - "id": "InstanceGroupManagerResizeRequestsListResponse", - "description": "[Output Only] A list of resize requests.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#instanceGroupManagerResizeRequestList for a list of resize requests.", - "default": "compute#instanceGroupManagerResizeRequestList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of resize request resources.", - "type": "array", - "items": { - "$ref": "InstanceGroupManagerResizeRequest" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "RegionInstanceGroupManagerList": { - "id": "RegionInstanceGroupManagerList", - "description": "Contains a list of managed instance groups.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups that exist in th regional scope.", - "default": "compute#regionInstanceGroupManagerList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InstanceGroupManager resources.", - "type": "array", - "items": { - "$ref": "InstanceGroupManager" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "RegionInstanceGroupManagersDeleteInstancesRequest": { - "id": "RegionInstanceGroupManagersDeleteInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - }, - "skipInstancesOnValidationError": { - "description": "Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region.", - "type": "boolean" - } - } - }, - "RegionInstanceGroupManagersAbandonInstancesRequest": { - "id": "RegionInstanceGroupManagersAbandonInstancesRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "RegionInstanceGroupManagersRecreateRequest": { - "id": "RegionInstanceGroupManagersRecreateRequest", - "type": "object", - "properties": { - "instances": { - "description": "The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "RegionInstanceGroupManagersSetTemplateRequest": { - "id": "RegionInstanceGroupManagersSetTemplateRequest", - "type": "object", - "properties": { - "instanceTemplate": { - "description": "URL of the InstanceTemplate resource from which all new instances will be created.", - "type": "string" - } - } - }, - "RegionInstanceGroupManagersSetTargetPoolsRequest": { - "id": "RegionInstanceGroupManagersSetTargetPoolsRequest", - "type": "object", - "properties": { - "targetPools": { - "description": "The URL of all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.", - "type": "array", - "items": { - "type": "string" - } - }, - "fingerprint": { - "description": "Fingerprint of the target pools information, which is a hash of the contents. This field is used for optimistic locking when you update the target pool entries. This field is optional.", - "type": "string", - "format": "byte" - } - } - }, - "RegionInstanceGroupManagersListInstancesResponse": { - "id": "RegionInstanceGroupManagersListInstancesResponse", - "type": "object", - "properties": { - "managedInstances": { - "description": "A list of managed instances.", - "type": "array", - "items": { - "$ref": "ManagedInstance" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - } - } - }, - "RegionInstanceGroupManagersListErrorsResponse": { - "id": "RegionInstanceGroupManagersListErrorsResponse", - "type": "object", - "properties": { - "items": { - "description": "[Output Only] The list of errors of the managed instance group.", - "type": "array", - "items": { - "$ref": "InstanceManagedByIgmError" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - } - } - }, - "RegionInstanceGroupManagersListInstanceConfigsResp": { - "id": "RegionInstanceGroupManagersListInstanceConfigsResp", - "type": "object", - "properties": { - "items": { - "description": "[Output Only] The list of PerInstanceConfig.", - "type": "array", - "items": { - "$ref": "PerInstanceConfig" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "RegionInstanceGroupManagerUpdateInstanceConfigReq": { - "id": "RegionInstanceGroupManagerUpdateInstanceConfigReq", - "description": "RegionInstanceGroupManagers.updatePerInstanceConfigs", - "type": "object", - "properties": { - "perInstanceConfigs": { - "description": "The list of per-instance configurations to insert or patch on this managed instance group.", - "type": "array", - "items": { - "$ref": "PerInstanceConfig" - } - } - } - }, - "RegionInstanceGroupManagerPatchInstanceConfigReq": { - "id": "RegionInstanceGroupManagerPatchInstanceConfigReq", - "description": "RegionInstanceGroupManagers.patchPerInstanceConfigs", - "type": "object", - "properties": { - "perInstanceConfigs": { - "description": "The list of per-instance configurations to insert or patch on this managed instance group.", - "type": "array", - "items": { - "$ref": "PerInstanceConfig" - } - } - } - }, - "RegionInstanceGroupManagerDeleteInstanceConfigReq": { - "id": "RegionInstanceGroupManagerDeleteInstanceConfigReq", - "description": "RegionInstanceGroupManagers.deletePerInstanceConfigs", - "type": "object", - "properties": { - "names": { - "description": "The list of instance names for which we want to delete per-instance configs on this managed instance group.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "RegionInstanceGroupManagersApplyUpdatesRequest": { - "id": "RegionInstanceGroupManagersApplyUpdatesRequest", - "description": "RegionInstanceGroupManagers.applyUpdatesToInstances", - "type": "object", - "properties": { - "instances": { - "description": "The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", - "type": "array", - "items": { - "type": "string" - } - }, - "minimalAction": { - "description": "The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update.", - "type": "string", - "enumDescriptions": [ - "Do not perform any action.", - "Do not stop the instance.", - "(Default.) Replace the instance according to the replacement method option.", - "Stop the instance and start it again." - ], - "enum": [ - "NONE", - "REFRESH", - "REPLACE", - "RESTART" - ] - }, - "mostDisruptiveAllowedAction": { - "description": "The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail.", - "type": "string", - "enumDescriptions": [ - "Do not perform any action.", - "Do not stop the instance.", - "(Default.) Replace the instance according to the replacement method option.", - "Stop the instance and start it again." - ], - "enum": [ - "NONE", - "REFRESH", - "REPLACE", - "RESTART" - ] - }, - "allInstances": { - "description": "Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request.", - "type": "boolean" - } - } - }, - "RegionInstanceGroupManagersCreateInstancesRequest": { - "id": "RegionInstanceGroupManagersCreateInstancesRequest", - "description": "RegionInstanceGroupManagers.createInstances", - "type": "object", - "properties": { - "instances": { - "description": "[Required] List of specifications of per-instance configs.", - "type": "array", - "items": { - "$ref": "PerInstanceConfig" - } - } - } - }, - "AutoscalerList": { - "id": "AutoscalerList", - "description": "Contains a list of Autoscaler resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#autoscalerList for lists of autoscalers.", - "default": "compute#autoscalerList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Autoscaler resources.", - "type": "array", - "items": { - "$ref": "Autoscaler" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "Autoscaler": { - "id": "Autoscaler", - "description": "Represents an Autoscaler resource. Google Compute Engine has two Autoscaler resources: * [Zonal](/compute/docs/reference/rest/v1/autoscalers) * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers) Use autoscalers to automatically add or delete instances from a managed instance group according to your defined autoscaling policy. For more information, read Autoscaling Groups of Instances. For zonal managed instance groups resource, use the autoscaler resource. For regional managed instance groups, use the regionAutoscalers resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#autoscaler for autoscalers.", - "default": "compute#autoscaler", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.autoscalers.insert" - ] - }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "target": { - "description": "URL of the managed instance group that this autoscaler will scale. This field is required when creating an autoscaler.", - "type": "string" - }, - "autoscalingPolicy": { - "description": "The configuration parameters for the autoscaling algorithm. You can define one or more signals for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization. If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%.", - "$ref": "AutoscalingPolicy" - }, - "zone": { - "description": "[Output Only] URL of the zone where the instance group resides (for autoscalers living in zonal scope).", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope).", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "status": { - "description": "[Output Only] The status of the autoscaler configuration. Current set of possible values: - PENDING: Autoscaler backend hasn't read new/updated configuration. - DELETING: Configuration is being deleted. - ACTIVE: Configuration is acknowledged to be effective. Some warnings might be present in the statusDetails field. - ERROR: Configuration has errors. Actionable for users. Details are present in the statusDetails field. New values might be added in the future.", - "type": "string", - "enumDescriptions": [ - "Configuration is acknowledged to be effective", - "Configuration is being deleted", - "Configuration has errors. Actionable for users.", - "Autoscaler backend hasn't read new/updated configuration" - ], - "enum": [ - "ACTIVE", - "DELETING", - "ERROR", - "PENDING" - ] - }, - "statusDetails": { - "description": "[Output Only] Human-readable details about the current state of the autoscaler. Read the documentation for Commonly returned status messages for examples of status messages you might encounter.", - "type": "array", - "items": { - "$ref": "AutoscalerStatusDetails" - } - }, - "recommendedSize": { - "description": "[Output Only] Target recommended MIG size (number of instances) computed by autoscaler. Autoscaler calculates the recommended MIG size even when the autoscaling policy mode is different from ON. This field is empty when autoscaler is not connected to an existing managed instance group or autoscaler did not generate its prediction.", - "type": "integer", - "format": "int32" - }, - "scalingScheduleStatus": { - "description": "[Output Only] Status information of existing scaling schedules.", - "type": "object", - "additionalProperties": { - "$ref": "ScalingScheduleStatus" - } - } - } - }, - "AutoscalingPolicy": { - "id": "AutoscalingPolicy", - "description": "Cloud Autoscaler policy.", - "type": "object", - "properties": { - "minNumReplicas": { - "description": "The minimum number of replicas that the autoscaler can scale in to. This cannot be less than 0. If not provided, autoscaler chooses a default value depending on maximum number of instances allowed.", - "type": "integer", - "format": "int32" - }, - "maxNumReplicas": { - "description": "The maximum number of instances that the autoscaler can scale out to. This is required when creating or updating an autoscaler. The maximum number of replicas must not be lower than minimal number of replicas.", - "type": "integer", - "format": "int32" - }, - "scaleInControl": { - "$ref": "AutoscalingPolicyScaleInControl" - }, - "coolDownPeriodSec": { - "description": "The number of seconds that your application takes to initialize on a VM instance. This is referred to as the [initialization period](/compute/docs/autoscaler#cool_down_period). Specifying an accurate initialization period improves autoscaler decisions. For example, when scaling out, the autoscaler ignores data from VMs that are still initializing because those VMs might not yet represent normal usage of your application. The default initialization period is 60 seconds. Initialization periods might vary because of numerous factors. We recommend that you test how long your application takes to initialize. To do this, create a VM and time your application's startup process.", - "type": "integer", - "format": "int32" - }, - "cpuUtilization": { - "description": "Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.", - "$ref": "AutoscalingPolicyCpuUtilization" - }, - "customMetricUtilizations": { - "description": "Configuration parameters of autoscaling based on a custom metric.", - "type": "array", - "items": { - "$ref": "AutoscalingPolicyCustomMetricUtilization" - } - }, - "loadBalancingUtilization": { - "description": "Configuration parameters of autoscaling based on load balancer.", - "$ref": "AutoscalingPolicyLoadBalancingUtilization" - }, - "mode": { - "description": "Defines the operating mode for this policy. The following modes are available: - OFF: Disables the autoscaler but maintains its configuration. - ONLY_SCALE_OUT: Restricts the autoscaler to add VM instances only. - ON: Enables all autoscaler activities according to its policy. For more information, see \"Turning off or restricting an autoscaler\"", - "type": "string", - "enumDescriptions": [ - "Do not automatically scale the MIG in or out. The recommended_size field contains the size of MIG that would be set if the actuation mode was enabled.", - "Automatically scale the MIG in and out according to the policy.", - "Automatically create VMs according to the policy, but do not scale the MIG in.", - "Automatically create VMs according to the policy, but do not scale the MIG in." - ], - "enum": [ - "OFF", - "ON", - "ONLY_SCALE_OUT", - "ONLY_UP" - ] - }, - "scalingSchedules": { - "description": "Scaling schedules defined for an autoscaler. Multiple schedules can be set on an autoscaler, and they can overlap. During overlapping periods the greatest min_required_replicas of all scaling schedules is applied. Up to 128 scaling schedules are allowed.", - "type": "object", - "additionalProperties": { - "$ref": "AutoscalingPolicyScalingSchedule" - } - } - } - }, - "AutoscalingPolicyScaleInControl": { - "id": "AutoscalingPolicyScaleInControl", - "description": "Configuration that allows for slower scale in so that even if Autoscaler recommends an abrupt scale in of a MIG, it will be throttled as specified by the parameters below.", - "type": "object", - "properties": { - "maxScaledInReplicas": { - "description": "Maximum allowed number (or %) of VMs that can be deducted from the peak recommendation during the window autoscaler looks at when computing recommendations. Possibly all these VMs can be deleted at once so user service needs to be prepared to lose that many VMs in one step.", - "$ref": "FixedOrPercent" - }, - "timeWindowSec": { - "description": "How far back autoscaling looks when computing recommendations to include directives regarding slower scale in, as described above.", - "type": "integer", - "format": "int32" - } - } - }, - "AutoscalingPolicyCpuUtilization": { - "id": "AutoscalingPolicyCpuUtilization", - "description": "CPU utilization policy.", - "type": "object", - "properties": { - "utilizationTarget": { - "description": "The target CPU utilization that the autoscaler maintains. Must be a float value in the range (0, 1]. If not specified, the default is 0.6. If the CPU level is below the target utilization, the autoscaler scales in the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization. If the average CPU is above the target utilization, the autoscaler scales out until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization.", - "type": "number", - "format": "double" - }, - "predictiveMethod": { - "description": "Indicates whether predictive autoscaling based on CPU metric is enabled. Valid values are: * NONE (default). No predictive method is used. The autoscaler scales the group to meet current demand based on real-time metrics. * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by monitoring daily and weekly load patterns and scaling out ahead of anticipated demand.", - "type": "string", - "enumDescriptions": [ - "No predictive method is used. The autoscaler scales the group to meet current demand based on real-time metrics", - "Predictive autoscaling improves availability by monitoring daily and weekly load patterns and scaling out ahead of anticipated demand." - ], - "enum": [ - "NONE", - "OPTIMIZE_AVAILABILITY" - ] - } - } - }, - "AutoscalingPolicyCustomMetricUtilization": { - "id": "AutoscalingPolicyCustomMetricUtilization", - "description": "Custom utilization metric policy.", - "type": "object", - "properties": { - "metric": { - "description": "The identifier (type) of the Stackdriver Monitoring metric. The metric cannot have negative values. The metric must have a value type of INT64 or DOUBLE.", - "type": "string" - }, - "filter": { - "description": "A filter string, compatible with a Stackdriver Monitoring filter string for TimeSeries.list API call. This filter is used to select a specific TimeSeries for the purpose of autoscaling and to determine whether the metric is exporting per-instance or per-group data. For the filter to be valid for autoscaling purposes, the following rules apply: - You can only use the AND operator for joining selectors. - You can only use direct equality comparison operator (=) without any functions for each selector. - You can specify the metric in both the filter string and in the metric field. However, if specified in both places, the metric must be identical. - The monitored resource type determines what kind of values are expected for the metric. If it is a gce_instance, the autoscaler expects the metric to include a separate TimeSeries for each instance in a group. In such a case, you cannot filter on resource labels. If the resource type is any other value, the autoscaler expects this metric to contain values that apply to the entire autoscaled instance group and resource label filtering can be performed to point autoscaler at the correct TimeSeries to scale upon. This is called a *per-group metric* for the purpose of autoscaling. If not specified, the type defaults to gce_instance. Try to provide a filter that is selective enough to pick just one TimeSeries for the autoscaled group or for each of the instances (if you are using gce_instance resource type). If multiple TimeSeries are returned upon the query execution, the autoscaler will sum their respective values to obtain its scaling value.", - "type": "string" - }, - "utilizationTarget": { - "description": "The target value of the metric that autoscaler maintains. This must be a positive value. A utilization metric scales number of virtual machines handling requests to increase or decrease proportionally to the metric. For example, a good metric to use as a utilization_target is https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. The autoscaler works to keep this value constant for each of the instances.", - "type": "number", - "format": "double" - }, - "singleInstanceAssignment": { - "description": "If scaling is based on a per-group metric value that represents the total amount of work to be done or resource usage, set this value to an amount assigned for a single instance of the scaled group. Autoscaler keeps the number of instances proportional to the value of this metric. The metric itself does not change value due to group resizing. A good metric to use with the target is for example pubsub.googleapis.com/subscription/num_undelivered_messages or a custom metric exporting the total number of requests coming to your instances. A bad example would be a metric exporting an average or median latency, since this value can't include a chunk assignable to a single instance, it could be better used with utilization_target instead.", - "type": "number", - "format": "double" - }, - "utilizationTargetType": { - "description": "Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE.", - "type": "string", - "enumDescriptions": [ - "Sets the utilization target value for a cumulative or delta metric, expressed as the rate of growth per minute.", - "Sets the utilization target value for a cumulative or delta metric, expressed as the rate of growth per second.", - "Sets the utilization target value for a gauge metric. The autoscaler will collect the average utilization of the virtual machines from the last couple of minutes, and compare the value to the utilization target value to perform autoscaling." - ], - "enum": [ - "DELTA_PER_MINUTE", - "DELTA_PER_SECOND", - "GAUGE" - ] - } - } - }, - "AutoscalingPolicyLoadBalancingUtilization": { - "id": "AutoscalingPolicyLoadBalancingUtilization", - "description": "Configuration parameters of autoscaling based on load balancing.", - "type": "object", - "properties": { - "utilizationTarget": { - "description": "Fraction of backend capacity utilization (set in HTTP(S) load balancing configuration) that the autoscaler maintains. Must be a positive float value. If not defined, the default is 0.8.", - "type": "number", - "format": "double" - } - } - }, - "AutoscalingPolicyScalingSchedule": { - "id": "AutoscalingPolicyScalingSchedule", - "description": "Scaling based on user-defined schedule. The message describes a single scaling schedule. A scaling schedule changes the minimum number of VM instances an autoscaler can recommend, which can trigger scaling out.", - "type": "object", - "properties": { - "minRequiredReplicas": { - "description": "The minimum number of VM instances that the autoscaler will recommend in time intervals starting according to schedule. This field is required.", - "type": "integer", - "format": "int32" - }, - "schedule": { - "description": "The start timestamps of time intervals when this scaling schedule is to provide a scaling signal. This field uses the extended cron format (with an optional year field). The expression can describe a single timestamp if the optional year is set, in which case the scaling schedule runs once. The schedule is interpreted with respect to time_zone. This field is required. Note: These timestamps only describe when autoscaler starts providing the scaling signal. The VMs need additional time to become serving.", - "type": "string" - }, - "timeZone": { - "description": "The time zone to use when interpreting the schedule. The value of this field must be a time zone name from the tz database: https://en.wikipedia.org/wiki/Tz_database. This field is assigned a default value of \"UTC\" if left empty.", - "type": "string" - }, - "durationSec": { - "description": "The duration of time intervals, in seconds, for which this scaling schedule is to run. The minimum allowed value is 300. This field is required.", - "type": "integer", - "format": "int32" - }, - "disabled": { - "description": "A boolean value that specifies whether a scaling schedule can influence autoscaler recommendations. If set to true, then a scaling schedule has no effect. This field is optional, and its value is false by default.", - "type": "boolean" - }, - "description": { - "description": "A description of a scaling schedule.", - "type": "string" - } - } - }, - "AutoscalerStatusDetails": { - "id": "AutoscalerStatusDetails", - "type": "object", - "properties": { - "message": { - "description": "The status message.", - "type": "string" - }, - "type": { - "description": "The type of error, warning, or notice returned. Current set of possible values: - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance group are unhealthy (not in RUNNING state). - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend service attached to the instance group. - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler recommends a size greater than maxNumReplicas. - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric samples are not exported often enough to be a credible base for autoscaling. - CUSTOM_METRIC_INVALID (ERROR): The custom metric that was specified does not exist or does not have the necessary labels. - MIN_EQUALS_MAX (WARNING): The minNumReplicas is equal to maxNumReplicas. This means the autoscaler cannot add or remove instances from the instance group. - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not receive any data from the custom metric configured for autoscaling. - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is configured to scale based on a load balancing signal but the instance group has not received any requests from the load balancer. - MODE_OFF (WARNING): Autoscaling is turned off. The number of instances in the group won't change automatically. The autoscaling configuration is preserved. - MODE_ONLY_UP (WARNING): Autoscaling is in the \"Autoscale only out\" mode. The autoscaler can add instances but not remove any. - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot be autoscaled because it has more than one backend service attached to it. - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient quota for the necessary resources, such as CPU or number of instances. - REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional autoscalers: there is a resource stockout in the chosen region. - SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled does not exist. - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): Autoscaling does not work with an HTTP/S load balancer that has been configured for maxRate. - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal autoscalers: there is a resource stockout in the chosen zone. For regional autoscalers: in at least one of the zones you're using there is a resource stockout. New values might be added in the future. Some of the values might not be available in all API versions.", - "type": "string", - "enumDescriptions": [ - "All instances in the instance group are unhealthy (not in RUNNING state).", - "There is no backend service attached to the instance group.", - "Autoscaler recommends a size greater than maxNumReplicas.", - "The custom metric samples are not exported often enough to be a credible base for autoscaling.", - "The custom metric that was specified does not exist or does not have the necessary labels.", - "The minNumReplicas is equal to maxNumReplicas. This means the autoscaler cannot add or remove instances from the instance group.", - "The autoscaler did not receive any data from the custom metric configured for autoscaling.", - "The autoscaler is configured to scale based on a load balancing signal but the instance group has not received any requests from the load balancer.", - "Autoscaling is turned off. The number of instances in the group won't change automatically. The autoscaling configuration is preserved.", - "Autoscaling is in the \"Autoscale only scale out\" mode. Instances in the group will be only added.", - "Autoscaling is in the \"Autoscale only out\" mode. Instances in the group will be only added.", - "The instance group cannot be autoscaled because it has more than one backend service attached to it.", - "There is insufficient quota for the necessary resources, such as CPU or number of instances.", - "Showed only for regional autoscalers: there is a resource stockout in the chosen region.", - "The target to be scaled does not exist.", - "For some scaling schedules minRequiredReplicas is greater than maxNumReplicas. Autoscaler always recommends at most maxNumReplicas instances.", - "For some scaling schedules minRequiredReplicas is less than minNumReplicas. Autoscaler always recommends at least minNumReplicas instances.", - "", - "Autoscaling does not work with an HTTP/S load balancer that has been configured for maxRate.", - "For zonal autoscalers: there is a resource stockout in the chosen zone. For regional autoscalers: in at least one of the zones you're using there is a resource stockout." - ], - "enum": [ - "ALL_INSTANCES_UNHEALTHY", - "BACKEND_SERVICE_DOES_NOT_EXIST", - "CAPPED_AT_MAX_NUM_REPLICAS", - "CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE", - "CUSTOM_METRIC_INVALID", - "MIN_EQUALS_MAX", - "MISSING_CUSTOM_METRIC_DATA_POINTS", - "MISSING_LOAD_BALANCING_DATA_POINTS", - "MODE_OFF", - "MODE_ONLY_SCALE_OUT", - "MODE_ONLY_UP", - "MORE_THAN_ONE_BACKEND_SERVICE", - "NOT_ENOUGH_QUOTA_AVAILABLE", - "REGION_RESOURCE_STOCKOUT", - "SCALING_TARGET_DOES_NOT_EXIST", - "SCHEDULED_INSTANCES_GREATER_THAN_AUTOSCALER_MAX", - "SCHEDULED_INSTANCES_LESS_THAN_AUTOSCALER_MIN", - "UNKNOWN", - "UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION", - "ZONE_RESOURCE_STOCKOUT" - ] - } - } - }, - "ScalingScheduleStatus": { - "id": "ScalingScheduleStatus", - "type": "object", - "properties": { - "nextStartTime": { - "description": "[Output Only] The next time the scaling schedule is to become active. Note: this is a timestamp when a schedule is planned to run, but the actual time might be slightly different. The timestamp is in RFC3339 text format.", - "type": "string" - }, - "lastStartTime": { - "description": "[Output Only] The last time the scaling schedule became active. Note: this is a timestamp when a schedule actually became active, not when it was planned to do so. The timestamp is in RFC3339 text format.", - "type": "string" - }, - "state": { - "description": "[Output Only] The current state of a scaling schedule.", - "type": "string", - "enumDescriptions": [ - "The current autoscaling recommendation is influenced by this scaling schedule.", - "This scaling schedule has been disabled by the user.", - "This scaling schedule will never become active again.", - "The current autoscaling recommendation is not influenced by this scaling schedule." - ], - "enum": [ - "ACTIVE", - "DISABLED", - "OBSOLETE", - "READY" - ] - } - } - }, - "AutoscalerAggregatedList": { - "id": "AutoscalerAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#autoscalerAggregatedList for aggregated lists of autoscalers.", - "default": "compute#autoscalerAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of AutoscalersScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of autoscalers.", - "$ref": "AutoscalersScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "AutoscalersScopedList": { - "id": "AutoscalersScopedList", - "type": "object", - "properties": { - "autoscalers": { - "description": "[Output Only] A list of autoscalers contained in this scope.", - "type": "array", - "items": { - "$ref": "Autoscaler" - } - }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of autoscalers when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "RegionAutoscalerList": { - "id": "RegionAutoscalerList", - "description": "Contains a list of autoscalers.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#regionAutoscalerList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Autoscaler resources.", - "type": "array", - "items": { - "$ref": "Autoscaler" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "BackendBucketList": { - "id": "BackendBucketList", - "description": "Contains a list of BackendBucket resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#backendBucketList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of BackendBucket resources.", - "type": "array", - "items": { - "$ref": "BackendBucket" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "BackendBucket": { - "id": "BackendBucket", - "description": "Represents a Cloud Storage Bucket resource. This Cloud Storage bucket resource is referenced by a URL map of a load balancer. For more information, read Backend Buckets.", - "type": "object", - "properties": { - "kind": { - "description": "Type of the resource.", - "default": "compute#backendBucket", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional textual description of the resource; provided by the client when the resource is created.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "bucketName": { - "description": "Cloud Storage bucket name.", - "type": "string" - }, - "enableCdn": { - "description": "If true, enable Cloud CDN for this BackendBucket.", - "type": "boolean" - }, - "cdnPolicy": { - "description": "Cloud CDN configuration for this BackendBucket.", - "$ref": "BackendBucketCdnPolicy" - }, - "customResponseHeaders": { - "description": "Headers that the Application Load Balancer should add to proxied responses.", - "type": "array", - "items": { - "type": "string" - } - }, - "edgeSecurityPolicy": { - "description": "[Output Only] The resource URL for the edge security policy associated with this backend bucket.", - "type": "string" - }, - "compressionMode": { - "description": "Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header.", - "type": "string", - "enumDescriptions": [ - "Automatically uses the best compression based on the Accept-Encoding header sent by the client.", - "Disables compression. Existing compressed responses cached by Cloud CDN will not be served to clients." - ], - "enum": [ - "AUTOMATIC", - "DISABLED" - ] - }, - "usedBy": { - "description": "[Output Only] List of resources referencing that backend bucket.", - "type": "array", - "items": { - "$ref": "BackendBucketUsedBy" - } - } - } - }, - "BackendBucketCdnPolicy": { - "id": "BackendBucketCdnPolicy", - "description": "Message containing Cloud CDN configuration for a backend bucket.", - "type": "object", - "properties": { - "signedUrlKeyNames": { - "description": "[Output Only] Names of the keys for signing request URLs.", - "type": "array", - "items": { - "type": "string" - } - }, - "signedUrlCacheMaxAgeSec": { - "description": "Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a \"Cache-Control: public, max-age=[TTL]\" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.", - "type": "string", - "format": "int64" - }, - "requestCoalescing": { - "description": "If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin.", - "type": "boolean" - }, - "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", - "type": "string", - "enumDescriptions": [ - "Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", - "Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content.", - "", - "Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server." - ], - "enum": [ - "CACHE_ALL_STATIC", - "FORCE_CACHE_ALL", - "INVALID_CACHE_MODE", - "USE_ORIGIN_HEADERS" - ] - }, - "defaultTtl": { - "description": "Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-max-age). Setting a TTL of \"0\" means \"always revalidate\". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", - "type": "integer", - "format": "int32" - }, - "maxTtl": { - "description": "Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of \"0\" means \"always revalidate\". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", - "type": "integer", - "format": "int32" - }, - "clientTtl": { - "description": "Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a \"public\" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a \"public\" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year).", - "type": "integer", - "format": "int32" - }, - "negativeCaching": { - "description": "Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 421 (Misdirected Request), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy.", - "type": "boolean" - }, - "negativeCachingPolicy": { - "description": "Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists.", - "type": "array", - "items": { - "$ref": "BackendBucketCdnPolicyNegativeCachingPolicy" - } - }, - "bypassCacheOnRequestHeaders": { - "description": "Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings.", - "type": "array", - "items": { - "$ref": "BackendBucketCdnPolicyBypassCacheOnRequestHeader" - } - }, - "serveWhileStale": { - "description": "Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default \"max-stale\" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-max-age) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale.", - "type": "integer", - "format": "int32" - }, - "cacheKeyPolicy": { - "description": "The CacheKeyPolicy for this CdnPolicy.", - "$ref": "BackendBucketCdnPolicyCacheKeyPolicy" - } - } - }, - "BackendBucketCdnPolicyNegativeCachingPolicy": { - "id": "BackendBucketCdnPolicyNegativeCachingPolicy", - "description": "Specify CDN TTLs for response error codes.", - "type": "object", - "properties": { - "code": { - "description": "The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once.", - "type": "integer", - "format": "int32" - }, - "ttl": { - "description": "The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", - "type": "integer", - "format": "int32" - } - } - }, - "BackendBucketCdnPolicyBypassCacheOnRequestHeader": { - "id": "BackendBucketCdnPolicyBypassCacheOnRequestHeader", - "description": "Bypass the cache when the specified request headers are present, e.g. Pragma or Authorization headers. Values are case insensitive. The presence of such a header overrides the cache_mode setting.", - "type": "object", - "properties": { - "headerName": { - "description": "The header field name to match on when bypassing cache. Values are case-insensitive.", - "type": "string" - } - } - }, - "BackendBucketCdnPolicyCacheKeyPolicy": { - "id": "BackendBucketCdnPolicyCacheKeyPolicy", - "description": "Message containing what to include in the cache key for a request for Cloud CDN.", - "type": "object", - "properties": { - "queryStringWhitelist": { - "description": "Names of query string parameters to include in cache keys. Default parameters are always included. '&' and '=' will be percent encoded and not treated as delimiters.", - "type": "array", - "items": { - "type": "string" - } - }, - "includeHttpHeaders": { - "description": "Allows HTTP request headers (by name) to be used in the cache key.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "BackendBucketUsedBy": { - "id": "BackendBucketUsedBy", - "type": "object", - "properties": { - "reference": { - "description": "[Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.", - "type": "string" - } - } - }, - "SignedUrlKey": { - "id": "SignedUrlKey", - "description": "Represents a customer-supplied Signing Key used by Cloud CDN Signed URLs", - "type": "object", - "properties": { - "keyName": { - "description": "Name of the key. 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" - }, - "keyValue": { - "description": "128-bit key value used for signing the URL. The key value must be a valid RFC 4648 Section 5 base64url encoded string.", - "type": "string" - } - } - }, - "SecurityPolicyReference": { - "id": "SecurityPolicyReference", - "type": "object", - "properties": { - "securityPolicy": { - "type": "string" - } - } - }, - "BackendServiceList": { - "id": "BackendServiceList", - "description": "Contains a list of BackendService resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#backendServiceList for lists of backend services.", - "default": "compute#backendServiceList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of BackendService resources.", - "type": "array", - "items": { - "$ref": "BackendService" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "BackendService": { - "id": "BackendService", - "description": "Represents a Backend Service resource. A backend service defines how Google Cloud load balancers distribute traffic. The backend service configuration contains a set of values, such as the protocol used to connect to backends, various distribution and session settings, health checks, and timeouts. These settings provide fine-grained control over how your load balancer behaves. Most of the settings have default values that allow for easy configuration if you need to get started quickly. Backend services in Google Compute Engine can be either regionally or globally scoped. * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices) For more information, see Backend Services.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#backendService for backend services.", - "default": "compute#backendService", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "backends": { - "description": "The list of backends that serve this BackendService.", - "type": "array", - "items": { - "$ref": "Backend" - } - }, - "healthChecks": { - "description": "The list of URLs to the healthChecks, httpHealthChecks (legacy), or httpsHealthChecks (legacy) resource for health checking this backend service. Not all backend services support legacy health checks. See Load balancer guide. Currently, at most one health check can be specified for each backend service. Backend services with instance group or zonal NEG backends must have a health check. Backend services with internet or serverless NEG backends must not have a health check.", - "type": "array", - "items": { - "type": "string" - } - }, - "timeoutSec": { - "description": "The backend service timeout has a different meaning depending on the type of load balancer. For more information see, Backend service settings. The default is 30 seconds. The full range of timeout values allowed goes from 1 through 2,147,483,647 seconds. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. Instead, use maxStreamDuration.", - "type": "integer", - "format": "int32" - }, - "port": { - "description": "Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port.", - "deprecated": true, - "type": "integer", - "format": "int32" - }, - "protocol": { - "description": "The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy.", - "type": "string", - "enumDescriptions": [ - "gRPC (available for Traffic Director).", - "", - "HTTP/2 with SSL.", - "", - "TCP proxying with SSL.", - "TCP proxying or TCP pass-through.", - "UDP.", - "If a Backend Service has UNSPECIFIED as its protocol, it can be used with any L3/L4 Forwarding Rules." - ], - "enum": [ - "GRPC", - "HTTP", - "HTTP2", - "HTTPS", - "SSL", - "TCP", - "UDP", - "UNSPECIFIED" - ] - }, - "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 BackendService. An up-to-date fingerprint must be provided in order to update the BackendService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a BackendService.", - "type": "string", - "format": "byte" - }, - "portName": { - "description": "A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name.", - "type": "string" - }, - "enableCDN": { - "description": "If true, enables Cloud CDN for the backend service of a global external Application Load Balancer.", - "type": "boolean" - }, - "sessionAffinity": { - "description": "Type of session affinity to use. The default is NONE. Only NONE and HEADER_FIELD are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. For more details, see: [Session Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).", - "type": "string", - "enumDescriptions": [ - "2-tuple hash on packet's source and destination IP addresses. Connections from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy.", - "1-tuple hash only on packet's source IP address. Connections from the same source IP address will be served by the same backend VM while that VM remains healthy. This option can only be used for Internal TCP/UDP Load Balancing.", - "5-tuple hash on packet's source and destination IP addresses, IP protocol, and source and destination ports. Connections for the same IP protocol from the same source IP address and port to the same destination IP address and port will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing.", - "3-tuple hash on packet's source and destination IP addresses, and IP protocol. Connections for the same IP protocol from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing.", - "Hash based on a cookie generated by the L7 loadbalancer. Only valid for HTTP(S) load balancing.", - "The hash is based on a user specified header field.", - "The hash is based on a user provided cookie.", - "No session affinity. Connections from the same client IP may go to any instance in the pool." - ], - "enum": [ - "CLIENT_IP", - "CLIENT_IP_NO_DESTINATION", - "CLIENT_IP_PORT_PROTO", - "CLIENT_IP_PROTO", - "GENERATED_COOKIE", - "HEADER_FIELD", - "HTTP_COOKIE", - "NONE" - ] - }, - "affinityCookieTtlSec": { - "description": "Lifetime of cookies in seconds. This setting is applicable to Application Load Balancers and Traffic Director and requires GENERATED_COOKIE or HTTP_COOKIE session affinity. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value is two weeks (1,209,600). Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", - "type": "integer", - "format": "int32" - }, - "region": { - "description": "[Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "failoverPolicy": { - "description": "Requires at least one backend instance group to be defined as a backup (failover) backend. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).", - "$ref": "BackendServiceFailoverPolicy" - }, - "loadBalancingScheme": { - "description": "Specifies the load balancer type. A backend service created for one type of load balancer cannot be used with another. For more information, refer to Choosing a load balancer.", - "type": "string", - "enumDescriptions": [ - "Signifies that this will be used for classic Application Load Balancers, global external proxy Network Load Balancers, or external passthrough Network Load Balancers.", - "Signifies that this will be used for global external Application Load Balancers, regional external Application Load Balancers, or regional external proxy Network Load Balancers.", - "Signifies that this will be used for internal passthrough Network Load Balancers.", - "Signifies that this will be used for internal Application Load Balancers.", - "Signifies that this will be used by Traffic Director.", - "" - ], - "enum": [ - "EXTERNAL", - "EXTERNAL_MANAGED", - "INTERNAL", - "INTERNAL_MANAGED", - "INTERNAL_SELF_MANAGED", - "INVALID_LOAD_BALANCING_SCHEME" - ] - }, - "connectionDraining": { - "$ref": "ConnectionDraining" - }, - "iap": { - "description": "The configurations for Identity-Aware Proxy on this resource. Not available for internal passthrough Network Load Balancers and external passthrough Network Load Balancers.", - "$ref": "BackendServiceIAP" - }, - "cdnPolicy": { - "description": "Cloud CDN configuration for this BackendService. Only available for specified load balancer types.", - "$ref": "BackendServiceCdnPolicy" - }, - "customRequestHeaders": { - "description": "Headers that the load balancer adds to proxied requests. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers).", - "type": "array", - "items": { - "type": "string" - } - }, - "customResponseHeaders": { - "description": "Headers that the load balancer adds to proxied responses. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers).", - "type": "array", - "items": { - "type": "string" - } - }, - "securityPolicy": { - "description": "[Output Only] The resource URL for the security policy associated with this backend service.", - "type": "string" - }, - "edgeSecurityPolicy": { - "description": "[Output Only] The resource URL for the edge security policy associated with this backend service.", - "type": "string" - }, - "logConfig": { - "description": "This field denotes the logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Stackdriver.", - "$ref": "BackendServiceLogConfig" - }, - "securitySettings": { - "description": "This field specifies the security settings that apply to this backend service. This field is applicable to a global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED.", - "$ref": "SecuritySettings" - }, - "localityLbPolicy": { - "description": "The load balancing algorithm used within the scope of the locality. The possible values are: - ROUND_ROBIN: This is a simple policy in which each healthy backend is selected in round robin order. This is the default. - LEAST_REQUEST: An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. - RING_HASH: The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. - RANDOM: The load balancer selects a random healthy host. - ORIGINAL_DESTINATION: Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. - MAGLEV: used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see https://ai.google/research/pubs/pub44824 This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or EXTERNAL_MANAGED. If sessionAffinity is not configured—that is, if session affinity remains at the default value of NONE—then the default value for localityLbPolicy is ROUND_ROBIN. If session affinity is set to a value other than NONE, then the default value for localityLbPolicy is MAGLEV. Only ROUND_ROBIN and RING_HASH are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", - "type": "string", - "enumDescriptions": [ - "", - "An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests.", - "This algorithm implements consistent hashing to backends. Maglev can be used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see https://ai.google/research/pubs/pub44824", - "Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer.", - "The load balancer selects a random healthy host.", - "The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests.", - "This is a simple policy in which each healthy backend is selected in round robin order. This is the default.", - "Per-instance weighted Load Balancing via health check reported weights. If set, the Backend Service must configure a non legacy HTTP-based Health Check, and health check replies are expected to contain non-standard HTTP response header field X-Load-Balancing-Endpoint-Weight to specify the per-instance weights. If set, Load Balancing is weighted based on the per-instance weights reported in the last processed health check replies, as long as every instance either reported a valid weight or had UNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight. This option is only supported in Network Load Balancing." - ], - "enum": [ - "INVALID_LB_POLICY", - "LEAST_REQUEST", - "MAGLEV", - "ORIGINAL_DESTINATION", - "RANDOM", - "RING_HASH", - "ROUND_ROBIN", - "WEIGHTED_MAGLEV" - ] - }, - "consistentHash": { - "description": "Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. This load balancing policy is applicable only for HTTP connections. The affinity to a particular destination host will be lost when one or more hosts are added/removed from the destination service. This field specifies parameters that control consistent hashing. This field is only applicable when localityLbPolicy is set to MAGLEV or RING_HASH. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. ", - "$ref": "ConsistentHashLoadBalancerSettings" - }, - "circuitBreakers": { - "$ref": "CircuitBreakers" - }, - "outlierDetection": { - "description": "Settings controlling the ejection of unhealthy backend endpoints from the load balancing pool of each individual proxy instance that processes the traffic for the given backend service. If not set, this feature is considered disabled. Results of the outlier detection algorithm (ejection of endpoints from the load balancing pool and returning them back to the pool) are executed independently by each proxy instance of the load balancer. In most cases, more than one proxy instance handles the traffic received by a backend service. Thus, it is possible that an unhealthy endpoint is detected and ejected by only some of the proxies, and while this happens, other proxies may continue to send requests to the same unhealthy endpoint until they detect and eject the unhealthy endpoint. Applicable backend endpoints can be: - VM instances in an Instance Group - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT) - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT) - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud Functions Services - Private Service Connect NEGs, that resolve to Google-managed regional API endpoints or managed services published using Private Service Connect Applicable backend service types can be: - A global backend service with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. - A regional backend service with the serviceProtocol set to HTTP, HTTPS, or HTTP2, and loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not supported for Serverless NEGs. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", - "$ref": "OutlierDetection" - }, - "network": { - "description": "The URL of the network to which this backend service belongs. This field can only be specified when the load balancing scheme is set to INTERNAL.", - "type": "string" - }, - "subsetting": { - "$ref": "Subsetting" - }, - "connectionTrackingPolicy": { - "description": "Connection Tracking configuration for this BackendService. Connection tracking policy settings are only available for external passthrough Network Load Balancers and internal passthrough Network Load Balancers.", - "$ref": "BackendServiceConnectionTrackingPolicy" - }, - "maxStreamDuration": { - "description": "Specifies the default maximum duration (timeout) for streams to this service. Duration is computed from the beginning of the stream until the response has been completely processed, including all retries. A stream that does not complete in this duration is closed. If not specified, there will be no timeout limit, i.e. the maximum duration is infinite. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. This field is only allowed when the loadBalancingScheme of the backend service is INTERNAL_SELF_MANAGED.", - "$ref": "Duration" - }, - "compressionMode": { - "description": "Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header.", - "type": "string", - "enumDescriptions": [ - "Automatically uses the best compression based on the Accept-Encoding header sent by the client.", - "Disables compression. Existing compressed responses cached by Cloud CDN will not be served to clients." - ], - "enum": [ - "AUTOMATIC", - "DISABLED" - ] - }, - "serviceLbPolicy": { - "description": "URL to networkservices.ServiceLbPolicy resource. Can only be set if load balancing scheme is EXTERNAL, EXTERNAL_MANAGED, INTERNAL_MANAGED or INTERNAL_SELF_MANAGED and the scope is global.", - "type": "string" - }, - "serviceBindings": { - "description": "URLs of networkservices.ServiceBinding resources. Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED. If set, lists of backends and health checks must be both empty.", - "type": "array", - "items": { - "type": "string" - } - }, - "localityLbPolicies": { - "description": "A list of locality load-balancing policies to be used in order of preference. When you use localityLbPolicies, you must set at least one value for either the localityLbPolicies[].policy or the localityLbPolicies[].customPolicy field. localityLbPolicies overrides any value set in the localityLbPolicy field. For an example of how to use this field, see Define a list of preferred policies. Caution: This field and its children are intended for use in a service mesh that includes gRPC clients only. Envoy proxies can't use backend services that have this configuration.", - "type": "array", - "items": { - "$ref": "BackendServiceLocalityLoadBalancingPolicyConfig" - } - }, - "metadatas": { - "description": "Deployment metadata associated with the resource to be set by a GKE hub controller and read by the backend RCTH", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "usedBy": { - "description": "[Output Only] List of resources referencing given backend service.", - "type": "array", - "items": { - "$ref": "BackendServiceUsedBy" - } - } - } - }, - "Backend": { - "id": "Backend", - "description": "Message containing information of one individual backend.", - "type": "object", - "properties": { - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "group": { - "description": "The fully-qualified URL of an instance group or network endpoint group (NEG) resource. To determine what types of backends a load balancer supports, see the [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service#backends). You must use the *fully-qualified* URL (starting with https://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported.", - "type": "string" - }, - "balancingMode": { - "description": "Specifies how to determine whether the backend of a load balancer can handle additional traffic or is fully loaded. For usage guidelines, see Connection balancing mode. Backends must use compatible balancing modes. For more information, see Supported balancing modes and target capacity settings and Restrictions and guidance for instance groups. Note: Currently, if you use the API to configure incompatible balancing modes, the configuration might be accepted even though it has no impact and is ignored. Specifically, Backend.maxUtilization is ignored when Backend.balancingMode is RATE. In the future, this incompatible combination will be rejected.", - "type": "string", - "enumDescriptions": [ - "Balance based on the number of simultaneous connections.", - "Balance based on requests per second (RPS).", - "Balance based on the backend utilization." - ], - "enum": [ - "CONNECTION", - "RATE", - "UTILIZATION" - ] - }, - "maxUtilization": { - "description": "Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.", - "type": "number", - "format": "float" - }, - "maxRate": { - "description": "Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.", - "type": "integer", - "format": "int32" - }, - "maxRatePerInstance": { - "description": "Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.", - "type": "number", - "format": "float" - }, - "maxRatePerEndpoint": { - "description": "Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.", - "type": "number", - "format": "float" - }, - "maxConnections": { - "description": "Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.", - "type": "integer", - "format": "int32" - }, - "maxConnectionsPerInstance": { - "description": "Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.", - "type": "integer", - "format": "int32" - }, - "maxConnectionsPerEndpoint": { - "description": "Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.", - "type": "integer", - "format": "int32" - }, - "capacityScaler": { - "description": "A multiplier applied to the backend's target capacity of its balancing mode. The default value is 1, which means the group serves up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot configure a setting larger than 0 and smaller than 0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service. Not available with backends that don't support using a balancingMode. This includes backends such as global internet NEGs, regional serverless NEGs, and PSC NEGs.", - "type": "number", - "format": "float" - }, - "failover": { - "description": "This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.", - "type": "boolean" - }, - "preference": { - "description": "This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default ", - "type": "string", - "enumDescriptions": [ - "No preference.", - "If preference is unspecified, we set it to the DEFAULT value", - "Traffic will be sent to this backend first." - ], - "enum": [ - "DEFAULT", - "PREFERENCE_UNSPECIFIED", - "PREFERRED" - ] - } - } - }, - "BackendServiceFailoverPolicy": { - "id": "BackendServiceFailoverPolicy", - "description": "For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). On failover or failback, this field indicates whether connection draining will be honored. Google Cloud has a fixed connection draining timeout of 10 minutes. A setting of true terminates existing TCP connections to the active pool during failover and failback, immediately draining traffic. A setting of false allows existing TCP connections to persist, even on VMs no longer in the active pool, for up to the duration of the connection draining timeout (10 minutes).", - "type": "object", - "properties": { - "disableConnectionDrainOnFailover": { - "description": "This can be set to true only if the protocol is TCP. The default is false.", - "type": "boolean" - }, - "dropTrafficIfUnhealthy": { - "description": "If set to true, connections to the load balancer are dropped when all primary and all backup backend VMs are unhealthy.If set to false, connections are distributed among all primary VMs when all primary and all backup backend VMs are unhealthy. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). The default is false.", - "type": "boolean" - }, - "failoverRatio": { - "description": "The value of the field must be in the range [0, 1]. If the value is 0, the load balancer performs a failover when the number of healthy primary VMs equals zero. For all other values, the load balancer performs a failover when the total number of healthy primary VMs is less than this ratio. For load balancers that have configurable failover: [Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).", - "type": "number", - "format": "float" - } - } - }, - "ConnectionDraining": { - "id": "ConnectionDraining", - "description": "Message containing connection draining configuration.", - "type": "object", - "properties": { - "drainingTimeoutSec": { - "description": "Configures a duration timeout for existing requests on a removed backend instance. For supported load balancers and protocols, as described in Enabling connection draining.", - "type": "integer", - "format": "int32" - } - } - }, - "BackendServiceIAP": { - "id": "BackendServiceIAP", - "description": "Identity-Aware Proxy", - "type": "object", - "properties": { - "enabled": { - "description": "Whether the serving infrastructure will authenticate and authorize all incoming requests.", - "type": "boolean" - }, - "oauth2ClientId": { - "description": "OAuth2 client ID to use for the authentication flow.", - "type": "string" - }, - "oauth2ClientSecret": { - "description": "OAuth2 client secret to use for the authentication flow. For security reasons, this value cannot be retrieved via the API. Instead, the SHA-256 hash of the value is returned in the oauth2ClientSecretSha256 field. @InputOnly", - "type": "string" - }, - "oauth2ClientSecretSha256": { - "description": "[Output Only] SHA256 hash value for the field oauth2_client_secret above.", - "type": "string" - } - } - }, - "BackendServiceCdnPolicy": { - "id": "BackendServiceCdnPolicy", - "description": "Message containing Cloud CDN configuration for a backend service.", - "type": "object", - "properties": { - "cacheKeyPolicy": { - "description": "The CacheKeyPolicy for this CdnPolicy.", - "$ref": "CacheKeyPolicy" - }, - "signedUrlKeyNames": { - "description": "[Output Only] Names of the keys for signing request URLs.", - "type": "array", - "items": { - "type": "string" - } - }, - "signedUrlCacheMaxAgeSec": { - "description": "Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a \"Cache-Control: public, max-age=[TTL]\" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.", - "type": "string", - "format": "int64" - }, - "requestCoalescing": { - "description": "If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin.", - "type": "boolean" - }, - "cacheMode": { - "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", - "type": "string", - "enumDescriptions": [ - "Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", - "Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content.", - "", - "Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server." - ], - "enum": [ - "CACHE_ALL_STATIC", - "FORCE_CACHE_ALL", - "INVALID_CACHE_MODE", - "USE_ORIGIN_HEADERS" - ] - }, - "defaultTtl": { - "description": "Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-max-age). Setting a TTL of \"0\" means \"always revalidate\". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", - "type": "integer", - "format": "int32" - }, - "maxTtl": { - "description": "Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of \"0\" means \"always revalidate\". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", - "type": "integer", - "format": "int32" - }, - "clientTtl": { - "description": "Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a \"public\" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a \"public\" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year).", - "type": "integer", - "format": "int32" - }, - "negativeCaching": { - "description": "Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 421 (Misdirected Request), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy.", - "type": "boolean" - }, - "negativeCachingPolicy": { - "description": "Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists.", - "type": "array", - "items": { - "$ref": "BackendServiceCdnPolicyNegativeCachingPolicy" - } - }, - "bypassCacheOnRequestHeaders": { - "description": "Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings.", - "type": "array", - "items": { - "$ref": "BackendServiceCdnPolicyBypassCacheOnRequestHeader" - } - }, - "serveWhileStale": { - "description": "Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default \"max-stale\" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-max-age) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale.", - "type": "integer", - "format": "int32" - } - } - }, - "CacheKeyPolicy": { - "id": "CacheKeyPolicy", - "description": "Message containing what to include in the cache key for a request for Cloud CDN.", - "type": "object", - "properties": { - "includeProtocol": { - "description": "If true, http and https requests will be cached separately.", - "type": "boolean" - }, - "includeHost": { - "description": "If true, requests to different hosts will be cached separately.", - "type": "boolean" - }, - "includeQueryString": { - "description": "If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.", - "type": "boolean" - }, - "queryStringWhitelist": { - "description": "Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.", - "type": "array", - "items": { - "type": "string" - } - }, - "queryStringBlacklist": { - "description": "Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.", - "type": "array", - "items": { - "type": "string" - } - }, - "includeHttpHeaders": { - "description": "Allows HTTP request headers (by name) to be used in the cache key.", - "type": "array", - "items": { - "type": "string" - } - }, - "includeNamedCookies": { - "description": "Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "BackendServiceCdnPolicyNegativeCachingPolicy": { - "id": "BackendServiceCdnPolicyNegativeCachingPolicy", - "description": "Specify CDN TTLs for response error codes.", - "type": "object", - "properties": { - "code": { - "description": "The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once.", - "type": "integer", - "format": "int32" - }, - "ttl": { - "description": "The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", - "type": "integer", - "format": "int32" - } - } - }, - "BackendServiceCdnPolicyBypassCacheOnRequestHeader": { - "id": "BackendServiceCdnPolicyBypassCacheOnRequestHeader", - "description": "Bypass the cache when the specified request headers are present, e.g. Pragma or Authorization headers. Values are case insensitive. The presence of such a header overrides the cache_mode setting.", - "type": "object", - "properties": { - "headerName": { - "description": "The header field name to match on when bypassing cache. Values are case-insensitive.", - "type": "string" - } - } - }, - "BackendServiceLogConfig": { - "id": "BackendServiceLogConfig", - "description": "The available logging options for the load balancer traffic served by this backend service.", - "type": "object", - "properties": { - "enable": { - "description": "Denotes whether to enable logging for the load balancer traffic served by this backend service. The default value is false.", - "type": "boolean" - }, - "sampleRate": { - "description": "This field can only be specified if logging is enabled for this backend service. The value of the field must be in [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no logged requests are reported. The default value is 1.0.", - "type": "number", - "format": "float" - }, - "optionalMode": { - "description": "This field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.", - "type": "string", - "enumDescriptions": [ - "A subset of optional fields.", - "None optional fields.", - "All optional fields." - ], - "enum": [ - "CUSTOM", - "EXCLUDE_ALL_OPTIONAL", - "INCLUDE_ALL_OPTIONAL" - ] - }, - "optionalFields": { - "description": "This field can only be specified if logging is enabled for this backend service and \"logConfig.optionalMode\" was set to CUSTOM. Contains a list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, serverGkeDetails.pod.podNamespace", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "SecuritySettings": { - "id": "SecuritySettings", - "description": "The authentication and authorization settings for a BackendService.", - "type": "object", - "properties": { - "clientTlsPolicy": { - "description": "Optional. A URL referring to a networksecurity.ClientTlsPolicy resource that describes how clients should authenticate with this service's backends. clientTlsPolicy only applies to a global BackendService with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. If left blank, communications are not encrypted.", - "type": "string" - }, - "subjectAltNames": { - "description": "Optional. A list of Subject Alternative Names (SANs) that the client verifies during a mutual TLS handshake with an server/endpoint for this BackendService. When the server presents its X.509 certificate to the client, the client inspects the certificate's subjectAltName field. If the field contains one of the specified values, the communication continues. Otherwise, it fails. This additional check enables the client to verify that the server is authorized to run the requested service. Note that the contents of the server certificate's subjectAltName field are configured by the Public Key Infrastructure which provisions server identities. Only applies to a global BackendService with loadBalancingScheme set to INTERNAL_SELF_MANAGED. Only applies when BackendService has an attached clientTlsPolicy with clientCertificate (mTLS mode).", - "type": "array", - "items": { - "type": "string" - } - }, - "awsV4Authentication": { - "description": "The configuration needed to generate a signature for access to private storage buckets that support AWS's Signature Version 4 for authentication. Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.", - "$ref": "AWSV4Signature" - } - } - }, - "AWSV4Signature": { - "id": "AWSV4Signature", - "description": "Contains the configurations necessary to generate a signature for access to private storage buckets that support Signature Version 4 for authentication. The service name for generating the authentication header will always default to 's3'.", - "type": "object", - "properties": { - "accessKeyId": { - "description": "The identifier of an access key used for s3 bucket authentication.", - "type": "string" - }, - "accessKey": { - "description": "The access key used for s3 bucket authentication. Required for updating or creating a backend that uses AWS v4 signature authentication, but will not be returned as part of the configuration when queried with a REST API GET request. @InputOnly", - "type": "string" - }, - "accessKeyVersion": { - "description": "The optional version identifier for the access key. You can use this to keep track of different iterations of your access key.", - "type": "string" - }, - "originRegion": { - "description": "The name of the cloud region of your origin. This is a free-form field with the name of the region your cloud uses to host your origin. For example, \"us-east-1\" for AWS or \"us-ashburn-1\" for OCI.", - "type": "string" - } - } - }, - "ConsistentHashLoadBalancerSettings": { - "id": "ConsistentHashLoadBalancerSettings", - "description": "This message defines settings for a consistent hash style load balancer.", - "type": "object", - "properties": { - "httpCookie": { - "description": "Hash is based on HTTP Cookie. This field describes a HTTP cookie that will be used as the hash key for the consistent hash load balancer. If the cookie is not present, it will be generated. This field is applicable if the sessionAffinity is set to HTTP_COOKIE. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", - "$ref": "ConsistentHashLoadBalancerSettingsHttpCookie" - }, - "httpHeaderName": { - "description": "The hash based on the value of the specified header field. This field is applicable if the sessionAffinity is set to HEADER_FIELD.", - "type": "string" - }, - "minimumRingSize": { - "description": "The minimum number of virtual nodes to use for the hash ring. Defaults to 1024. Larger ring sizes result in more granular load distributions. If the number of hosts in the load balancing pool is larger than the ring size, each host will be assigned a single virtual node.", - "type": "string", - "format": "int64" - } - } - }, - "ConsistentHashLoadBalancerSettingsHttpCookie": { - "id": "ConsistentHashLoadBalancerSettingsHttpCookie", - "description": "The information about the HTTP Cookie on which the hash function is based for load balancing policies that use a consistent hash.", - "type": "object", - "properties": { - "name": { - "description": "Name of the cookie.", - "type": "string" - }, - "path": { - "description": "Path to set for the cookie.", - "type": "string" - }, - "ttl": { - "description": "Lifetime of the cookie.", - "$ref": "Duration" - } - } - }, - "CircuitBreakers": { - "id": "CircuitBreakers", - "description": "Settings controlling the volume of requests, connections and retries to this backend service.", - "type": "object", - "properties": { - "maxRequestsPerConnection": { - "description": "Maximum requests for a single connection to the backend service. This parameter is respected by both the HTTP/1.1 and HTTP/2 implementations. If not specified, there is no limit. Setting this parameter to 1 will effectively disable keep alive. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", - "type": "integer", - "format": "int32" - }, - "maxConnections": { - "description": "The maximum number of connections to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", - "type": "integer", - "format": "int32" - }, - "maxPendingRequests": { - "description": "The maximum number of pending requests allowed to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", - "type": "integer", - "format": "int32" - }, - "maxRequests": { - "description": "The maximum number of parallel requests that allowed to the backend service. If not specified, there is no limit.", - "type": "integer", - "format": "int32" - }, - "maxRetries": { - "description": "The maximum number of parallel retries allowed to the backend cluster. If not specified, the default is 1. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", - "type": "integer", - "format": "int32" - } - } - }, - "OutlierDetection": { - "id": "OutlierDetection", - "description": "Settings controlling the eviction of unhealthy hosts from the load balancing pool for the backend service.", - "type": "object", - "properties": { - "consecutiveErrors": { - "description": "Number of consecutive errors before a backend endpoint is ejected from the load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx return code qualifies as an error. Defaults to 5.", - "type": "integer", - "format": "int32" - }, - "interval": { - "description": "Time interval between ejection analysis sweeps. This can result in both new ejections and backend endpoints being returned to service. The interval is equal to the number of seconds as defined in outlierDetection.interval.seconds plus the number of nanoseconds as defined in outlierDetection.interval.nanos. Defaults to 1 second.", - "$ref": "Duration" - }, - "baseEjectionTime": { - "description": "The base time that a backend endpoint is ejected for. Defaults to 30000ms or 30s. After a backend endpoint is returned back to the load balancing pool, it can be ejected again in another ejection analysis. Thus, the total ejection time is equal to the base ejection time multiplied by the number of times the backend endpoint has been ejected. Defaults to 30000ms or 30s.", - "$ref": "Duration" - }, - "maxEjectionPercent": { - "description": "Maximum percentage of backend endpoints in the load balancing pool for the backend service that can be ejected if the ejection conditions are met. Defaults to 50%.", - "type": "integer", - "format": "int32" - }, - "enforcingConsecutiveErrors": { - "description": "The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive 5xx. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 0.", - "type": "integer", - "format": "int32" - }, - "enforcingSuccessRate": { - "description": "The percentage chance that a backend endpoint will be ejected when an outlier status is detected through success rate statistics. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. Not supported when the backend service uses Serverless NEG.", - "type": "integer", - "format": "int32" - }, - "successRateMinimumHosts": { - "description": "The number of backend endpoints in the load balancing pool that must have enough request volume to detect success rate outliers. If the number of backend endpoints is fewer than this setting, outlier detection via success rate statistics is not performed for any backend endpoint in the load balancing pool. Defaults to 5. Not supported when the backend service uses Serverless NEG.", - "type": "integer", - "format": "int32" - }, - "successRateRequestVolume": { - "description": "The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG.", - "type": "integer", - "format": "int32" - }, - "successRateStdevFactor": { - "description": "This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG.", - "type": "integer", - "format": "int32" - }, - "consecutiveGatewayFailure": { - "description": "The number of consecutive gateway failures (502, 503, 504 status or connection errors that are mapped to one of those status codes) before a consecutive gateway failure ejection occurs. Defaults to 3.", - "type": "integer", - "format": "int32" - }, - "enforcingConsecutiveGatewayFailure": { - "description": "The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive gateway failures. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100.", - "type": "integer", - "format": "int32" - } - } - }, - "Subsetting": { - "id": "Subsetting", - "description": "Subsetting configuration for this BackendService. Currently this is applicable only for Internal TCP/UDP load balancing, Internal HTTP(S) load balancing and Traffic Director.", - "type": "object", - "properties": { - "policy": { - "type": "string", - "enumDescriptions": [ - "Subsetting based on consistent hashing. For Traffic Director, the number of backends per backend group (the subset size) is based on the `subset_size` parameter. For Internal HTTP(S) load balancing, the number of backends per backend group (the subset size) is dynamically adjusted in two cases: - As the number of proxy instances participating in Internal HTTP(S) load balancing increases, the subset size decreases. - When the total number of backends in a network exceeds the capacity of a single proxy instance, subset sizes are reduced automatically for each service that has backend subsetting enabled.", - "No Subsetting. Clients may open connections and send traffic to all backends of this backend service. This can lead to performance issues if there is substantial imbalance in the count of clients and backends." - ], - "enum": [ - "CONSISTENT_HASH_SUBSETTING", - "NONE" - ] - } - } - }, - "BackendServiceConnectionTrackingPolicy": { - "id": "BackendServiceConnectionTrackingPolicy", - "description": "Connection Tracking configuration for this BackendService.", - "type": "object", - "properties": { - "trackingMode": { - "description": "Specifies the key used for connection tracking. There are two options: - PER_CONNECTION: This is the default mode. The Connection Tracking is performed as per the Connection Key (default Hash Method) for the specific protocol. - PER_SESSION: The Connection Tracking is performed as per the configured Session Affinity. It matches the configured Session Affinity. For more details, see [Tracking Mode for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) and [Tracking Mode for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).", - "type": "string", - "enumDescriptions": [ - "", - "", - "" - ], - "enum": [ - "INVALID_TRACKING_MODE", - "PER_CONNECTION", - "PER_SESSION" - ] - }, - "connectionPersistenceOnUnhealthyBackends": { - "description": "Specifies connection persistence when backends are unhealthy. The default value is DEFAULT_FOR_PROTOCOL. If set to DEFAULT_FOR_PROTOCOL, the existing connections persist on unhealthy backends only for connection-oriented protocols (TCP and SCTP) and only if the Tracking Mode is PER_CONNECTION (default tracking mode) or the Session Affinity is configured for 5-tuple. They do not persist for UDP. If set to NEVER_PERSIST, after a backend becomes unhealthy, the existing connections on the unhealthy backend are never persisted on the unhealthy backend. They are always diverted to newly selected healthy backends (unless all backends are unhealthy). If set to ALWAYS_PERSIST, existing connections always persist on unhealthy backends regardless of protocol and session affinity. It is generally not recommended to use this mode overriding the default. For more details, see [Connection Persistence for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) and [Connection Persistence for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).", - "type": "string", - "enumDescriptions": [ - "", - "", - "" - ], - "enum": [ - "ALWAYS_PERSIST", - "DEFAULT_FOR_PROTOCOL", - "NEVER_PERSIST" - ] - }, - "idleTimeoutSec": { - "description": "Specifies how long to keep a Connection Tracking entry while there is no matching traffic (in seconds). For internal passthrough Network Load Balancers: - The minimum (default) is 10 minutes and the maximum is 16 hours. - It can be set only if Connection Tracking is less than 5-tuple (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION, CLIENT_IP or CLIENT_IP_PROTO, and Tracking Mode is PER_SESSION). For external passthrough Network Load Balancers the default is 60 seconds. This option is not available publicly.", - "type": "integer", - "format": "int32" - }, - "enableStrongAffinity": { - "description": "Enable Strong Session Affinity for external passthrough Network Load Balancers. This option is not available publicly.", - "type": "boolean" - } - } - }, - "BackendServiceLocalityLoadBalancingPolicyConfig": { - "id": "BackendServiceLocalityLoadBalancingPolicyConfig", - "description": "Container for either a built-in LB policy supported by gRPC or Envoy or a custom one implemented by the end user.", - "type": "object", - "properties": { - "policy": { - "$ref": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy" - }, - "customPolicy": { - "$ref": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy" - } - } - }, - "BackendServiceLocalityLoadBalancingPolicyConfigPolicy": { - "id": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy", - "description": "The configuration for a built-in load balancing policy.", - "type": "object", - "properties": { - "name": { - "description": "The name of a locality load-balancing policy. Valid values include ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information about these values, see the description of localityLbPolicy. Do not specify the same policy more than once for a backend. If you do, the configuration is rejected.", - "type": "string", - "enumDescriptions": [ - "", - "An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests.", - "This algorithm implements consistent hashing to backends. Maglev can be used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see https://ai.google/research/pubs/pub44824", - "Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer.", - "The load balancer selects a random healthy host.", - "The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests.", - "This is a simple policy in which each healthy backend is selected in round robin order. This is the default.", - "Per-instance weighted Load Balancing via health check reported weights. If set, the Backend Service must configure a non legacy HTTP-based Health Check, and health check replies are expected to contain non-standard HTTP response header field X-Load-Balancing-Endpoint-Weight to specify the per-instance weights. If set, Load Balancing is weighted based on the per-instance weights reported in the last processed health check replies, as long as every instance either reported a valid weight or had UNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight. This option is only supported in Network Load Balancing." - ], - "enum": [ - "INVALID_LB_POLICY", - "LEAST_REQUEST", - "MAGLEV", - "ORIGINAL_DESTINATION", - "RANDOM", - "RING_HASH", - "ROUND_ROBIN", - "WEIGHTED_MAGLEV" - ] - } - } - }, - "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy": { - "id": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy", - "description": "The configuration for a custom policy implemented by the user and deployed with the client.", - "type": "object", - "properties": { - "name": { - "description": "Identifies the custom policy. The value should match the name of a custom implementation registered on the gRPC clients. It should follow protocol buffer message naming conventions and include the full path (for example, myorg.CustomLbPolicy). The maximum length is 256 characters. Do not specify the same custom policy more than once for a backend. If you do, the configuration is rejected. For an example of how to use this field, see Use a custom policy.", - "type": "string" - }, - "data": { - "description": "An optional, arbitrary JSON object with configuration data, understood by a locally installed custom policy implementation.", - "type": "string" - } - } - }, - "BackendServiceUsedBy": { - "id": "BackendServiceUsedBy", - "type": "object", - "properties": { - "reference": { - "description": "[Output Only] Server-defined URL for resources referencing given BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies and ForwardingRule.", - "type": "string" - } - } - }, - "BackendServiceAggregatedList": { - "id": "BackendServiceAggregatedList", - "description": "Contains a list of BackendServicesScopedList.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#backendServiceAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of BackendServicesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of BackendServices.", - "$ref": "BackendServicesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "BackendServicesScopedList": { - "id": "BackendServicesScopedList", - "type": "object", - "properties": { - "backendServices": { - "description": "A list of BackendServices contained in this scope.", - "type": "array", - "items": { - "$ref": "BackendService" - } - }, - "warning": { - "description": "Informational warning which replaces the list of backend services when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "BackendServiceListUsable": { - "id": "BackendServiceListUsable", - "description": "Contains a list of usable BackendService resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#usableBackendServiceList for lists of usable backend services.", - "default": "compute#usableBackendServiceList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of BackendService resources.", - "type": "array", - "items": { - "$ref": "BackendService" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "ResourceGroupReference": { - "id": "ResourceGroupReference", - "type": "object", - "properties": { - "group": { - "description": "A URI referencing one of the instance groups or network endpoint groups listed in the backend service.", - "type": "string" - } - } - }, - "BackendServiceGroupHealth": { - "id": "BackendServiceGroupHealth", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#backendServiceGroupHealth for the health of backend services.", - "default": "compute#backendServiceGroupHealth", - "type": "string" - }, - "healthStatus": { - "description": "Health state of the backend instances or endpoints in requested instance or network endpoint group, determined based on configured health checks.", - "type": "array", - "items": { - "$ref": "HealthStatus" - } - }, - "annotations": { - "description": "Metadata defined as annotations on the network endpoint group.", - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } - }, - "HealthStatus": { - "id": "HealthStatus", - "type": "object", - "properties": { - "ipAddress": { - "description": "For target pool based Network Load Balancing, it indicates the forwarding rule's IP address assigned to this instance. For other types of load balancing, the field indicates VM internal ip.", - "type": "string" - }, - "port": { - "description": "The named port of the instance group, not necessarily the port that is health-checked.", - "type": "integer", - "format": "int32" - }, - "instance": { - "description": "URL of the instance resource.", - "type": "string" - }, - "healthState": { - "description": "Health state of the IPv4 address of the instance.", - "type": "string", - "enumDescriptions": [ - "", - "" - ], - "enum": [ - "HEALTHY", - "UNHEALTHY" - ] - }, - "annotations": { - "description": "Metadata defined as annotations for network endpoint.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "weight": { - "type": "string" - }, - "weightError": { - "type": "string", - "enumDescriptions": [ - "The response to a Health Check probe had the HTTP response header field X-Load-Balancing-Endpoint-Weight, but its content was invalid (i.e., not a non-negative single-precision floating-point number in decimal string representation).", - "The response to a Health Check probe did not have the HTTP response header field X-Load-Balancing-Endpoint-Weight.", - "This is the value when the accompanied health status is either TIMEOUT (i.e.,the Health Check probe was not able to get a response in time) or UNKNOWN. For the latter, it should be typically because there has not been sufficient time to parse and report the weight for a new backend (which is with 0.0.0.0 ip address). However, it can be also due to an outage case for which the health status is explicitly reset to UNKNOWN.", - "This is the default value when WeightReportMode is DISABLE, and is also the initial value when WeightReportMode has just updated to ENABLE or DRY_RUN and there has not been sufficient time to parse and report the backend weight." - ], - "enum": [ - "INVALID_WEIGHT", - "MISSING_WEIGHT", - "UNAVAILABLE_WEIGHT", - "WEIGHT_NONE" - ] - }, - "forwardingRuleIp": { - "description": "A forwarding rule IP address assigned to this instance.", - "type": "string" - }, - "forwardingRule": { - "description": "URL of the forwarding rule associated with the health status of the instance.", - "type": "string" - } - } - }, - "CommitmentList": { - "id": "CommitmentList", - "description": "Contains a list of Commitment resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#commitmentList for lists of commitments.", - "default": "compute#commitmentList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Commitment resources.", - "type": "array", - "items": { - "$ref": "Commitment" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "Commitment": { - "id": "Commitment", - "description": "Represents a regional Commitment resource. Creating a commitment resource means that you are purchasing a committed use contract with an explicit start and end time. You can create commitments based on vCPUs and memory usage and receive discounted rates. For full details, read Signing Up for Committed Use Discounts.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#commitment for commitments.", - "default": "compute#commitment", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where this commitment may be used.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "status": { - "description": "[Output Only] Status of the commitment with regards to eventual expiration (each commitment has an end date defined). One of the following values: NOT_YET_ACTIVE, ACTIVE, EXPIRED.", - "type": "string", - "enumDescriptions": [ - "", - "Deprecate CANCELED status. Will use separate status to differentiate cancel by mergeCud or manual cancellation.", - "", - "", - "" - ], - "enum": [ - "ACTIVE", - "CANCELLED", - "CREATING", - "EXPIRED", - "NOT_YET_ACTIVE" - ] - }, - "statusMessage": { - "description": "[Output Only] An optional, human-readable explanation of the status.", - "type": "string" - }, - "plan": { - "description": "The plan for this commitment, which determines duration and discount rate. The currently supported plans are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years).", - "type": "string", - "enumDescriptions": [ - "", - "", - "" - ], - "enum": [ - "INVALID", - "THIRTY_SIX_MONTH", - "TWELVE_MONTH" - ] - }, - "startTimestamp": { - "description": "[Output Only] Commitment start time in RFC3339 text format.", - "type": "string" - }, - "endTimestamp": { - "description": "[Output Only] Commitment end time in RFC3339 text format.", - "type": "string" - }, - "resources": { - "description": "A list of commitment amounts for particular resources. Note that VCPU and MEMORY resource commitments must occur together.", - "type": "array", - "items": { - "$ref": "ResourceCommitment" - } - }, - "type": { - "description": "The type of commitment, which affects the discount rate and the eligible resources. Type MEMORY_OPTIMIZED specifies a commitment that will only apply to memory optimized machines. Type ACCELERATOR_OPTIMIZED specifies a commitment that will only apply to accelerator optimized machines.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" - ], - "enum": [ - "ACCELERATOR_OPTIMIZED", - "ACCELERATOR_OPTIMIZED_A3", - "ACCELERATOR_OPTIMIZED_A3_MEGA", - "COMPUTE_OPTIMIZED", - "COMPUTE_OPTIMIZED_C2D", - "COMPUTE_OPTIMIZED_C3", - "COMPUTE_OPTIMIZED_C3D", - "COMPUTE_OPTIMIZED_H3", - "GENERAL_PURPOSE", - "GENERAL_PURPOSE_C4", - "GENERAL_PURPOSE_E2", - "GENERAL_PURPOSE_N2", - "GENERAL_PURPOSE_N2D", - "GENERAL_PURPOSE_N4", - "GENERAL_PURPOSE_T2D", - "GRAPHICS_OPTIMIZED", - "MEMORY_OPTIMIZED", - "MEMORY_OPTIMIZED_M3", - "STORAGE_OPTIMIZED_Z3", - "TYPE_UNSPECIFIED" - ] - }, - "reservations": { - "description": "List of create-on-create reservations for this commitment.", - "type": "array", - "items": { - "$ref": "Reservation" - } - }, - "category": { - "description": "The category of the commitment. Category MACHINE specifies commitments composed of machine resources such as VCPU or MEMORY, listed in resources. Category LICENSE specifies commitments composed of software licenses, listed in licenseResources. Note that only MACHINE commitments should have a Type specified.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" - ], - "enum": [ - "CATEGORY_UNSPECIFIED", - "LICENSE", - "MACHINE" - ] - }, - "licenseResource": { - "description": "The license specification required as part of a license commitment.", - "$ref": "LicenseResourceCommitment" - }, - "autoRenew": { - "description": "Specifies whether to enable automatic renewal for the commitment. The default value is false if not specified. The field can be updated until the day of the commitment expiration at 12:00am PST. If the field is set to true, the commitment will be automatically renewed for either one or three years according to the terms of the existing commitment.", - "type": "boolean" - }, - "mergeSourceCommitments": { - "description": "List of source commitments to be merged into a new commitment.", - "type": "array", - "items": { - "type": "string" - } - }, - "splitSourceCommitment": { - "description": "Source commitment to be split into a new commitment.", - "type": "string" - }, - "existingReservations": { - "description": "Specifies the already existing reservations to attach to the Commitment. This field is optional, and it can be a full or partial URL. For example, the following are valid URLs to an reservation: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /reservations/reservation - projects/project/zones/zone/reservations/reservation ", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ResourceCommitment": { - "id": "ResourceCommitment", - "description": "Commitment for a particular resource (a Commitment is composed of one or more of these).", - "type": "object", - "properties": { - "type": { - "description": "Type of resource for which this commitment applies. Possible values are VCPU, MEMORY, LOCAL_SSD, and ACCELERATOR.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" - ], - "enum": [ - "ACCELERATOR", - "LOCAL_SSD", - "MEMORY", - "UNSPECIFIED", - "VCPU" - ] - }, - "amount": { - "description": "The amount of the resource purchased (in a type-dependent unit, such as bytes). For vCPUs, this can just be an integer. For memory, this must be provided in MB. Memory must be a multiple of 256 MB, with up to 6.5GB of memory per every vCPU.", - "type": "string", - "format": "int64" - }, - "acceleratorType": { - "description": "Name of the accelerator type resource. Applicable only when the type is ACCELERATOR.", - "type": "string" - } - } - }, - "LicenseResourceCommitment": { - "id": "LicenseResourceCommitment", - "description": "Commitment for a particular license resource.", - "type": "object", - "properties": { - "license": { - "description": "Any applicable license URI.", - "type": "string" - }, - "amount": { - "description": "The number of licenses purchased.", - "type": "string", - "format": "int64" - }, - "coresPerLicense": { - "description": "Specifies the core range of the instance for which this license applies.", - "type": "string" - } - } - }, - "CommitmentAggregatedList": { - "id": "CommitmentAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#commitmentAggregatedList for aggregated lists of commitments.", - "default": "compute#commitmentAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of CommitmentsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of commitments.", - "$ref": "CommitmentsScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "CommitmentsScopedList": { - "id": "CommitmentsScopedList", - "type": "object", - "properties": { - "commitments": { - "description": "[Output Only] A list of commitments contained in this scope.", - "type": "array", - "items": { - "$ref": "Commitment" - } - }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of commitments when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "DiskTypeList": { - "id": "DiskTypeList", - "description": "Contains a list of disk types.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#diskTypeList for disk types.", - "default": "compute#diskTypeList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of DiskType resources.", - "type": "array", - "items": { - "$ref": "DiskType" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "DiskType": { - "id": "DiskType", - "description": "Represents a Disk Type resource. Google Compute Engine has two Disk Type resources: * [Regional](/compute/docs/reference/rest/v1/regionDiskTypes) * [Zonal](/compute/docs/reference/rest/v1/diskTypes) You can choose from a variety of disk types based on your needs. For more information, read Storage options. The diskTypes resource represents disk types for a zonal persistent disk. For more information, read Zonal persistent disks. The regionDiskTypes resource represents disk types for a regional persistent disk. For more information, read Regional persistent disks.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#diskType for disk types.", - "default": "compute#diskType", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "[Output Only] Name of the resource.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - }, - "description": { - "description": "[Output Only] An optional description of this resource.", - "type": "string" - }, - "validDiskSize": { - "description": "[Output Only] An optional textual description of the valid disk size, such as \"10GB-10TB\".", - "type": "string" - }, - "deprecated": { - "description": "[Output Only] The deprecation status associated with this disk type.", - "$ref": "DeprecationStatus" - }, - "zone": { - "description": "[Output Only] URL of the zone where the disk type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "defaultDiskSizeGb": { - "description": "[Output Only] Server-defined default disk size in GB.", - "type": "string", - "format": "int64" - }, - "region": { - "description": "[Output Only] URL of the region where the disk type resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - } - } - }, - "DiskTypeAggregatedList": { - "id": "DiskTypeAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#diskTypeAggregatedList.", - "default": "compute#diskTypeAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of DiskTypesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of disk types.", - "$ref": "DiskTypesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "DiskTypesScopedList": { - "id": "DiskTypesScopedList", - "type": "object", - "properties": { - "diskTypes": { - "description": "[Output Only] A list of disk types contained in this scope.", - "type": "array", - "items": { - "$ref": "DiskType" - } - }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of disk types when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "RegionDiskTypeList": { - "id": "RegionDiskTypeList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#regionDiskTypeList for region disk types.", - "default": "compute#regionDiskTypeList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of DiskType resources.", - "type": "array", - "items": { - "$ref": "DiskType" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "ExternalVpnGateway": { - "id": "ExternalVpnGateway", - "description": "Represents an external VPN gateway. External VPN gateway is the on-premises VPN gateway(s) or another cloud provider's VPN gateway that connects to your Google Cloud VPN gateway. To create a highly available VPN from Google Cloud Platform to your VPN gateway or another cloud provider's VPN gateway, you must create a external VPN gateway resource with information about the other gateway. For more information about using external VPN gateways, see Creating an HA VPN gateway and tunnel pair to a peer VPN.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#externalVpnGateway for externalVpnGateways.", - "default": "compute#externalVpnGateway", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.externalVpnGateways.insert" - ] - }, - "type": "string" - }, - "redundancyType": { - "description": "Indicates the user-supplied redundancy type of this external VPN gateway.", - "type": "string", - "enumDescriptions": [ - "The external VPN gateway has four public IP addresses; at the time of writing this API, the AWS virtual private gateway is an example which has four public IP addresses for high availability connections; there should be two VPN connections in the AWS virtual private gateway , each AWS VPN connection has two public IP addresses; please make sure to put two public IP addresses from one AWS VPN connection into interfaces 0 and 1 of this external VPN gateway, and put the other two public IP addresses from another AWS VPN connection into interfaces 2 and 3 of this external VPN gateway. When displaying highly available configuration status for the VPN tunnels connected to FOUR_IPS_REDUNDANCY external VPN gateway, Google will always detect whether interfaces 0 and 1 are connected on one interface of HA Cloud VPN gateway, and detect whether interfaces 2 and 3 are connected to another interface of the HA Cloud VPN gateway.", - "The external VPN gateway has only one public IP address which internally provide redundancy or failover.", - "The external VPN gateway has two public IP addresses which are redundant with each other, the following two types of setup on your on-premises side would have this type of redundancy: (1) Two separate on-premises gateways, each with one public IP address, the two on-premises gateways are redundant with each other. (2) A single on-premise gateway with two public IP addresses that are redundant with eatch other." - ], - "enum": [ - "FOUR_IPS_REDUNDANCY", - "SINGLE_IP_INTERNALLY_REDUNDANT", - "TWO_IPS_REDUNDANCY" - ] - }, - "interfaces": { - "description": "A list of interfaces for this external VPN gateway. If your peer-side gateway is an on-premises gateway and non-AWS cloud providers' gateway, at most two interfaces can be provided for an external VPN gateway. If your peer side is an AWS virtual private gateway, four interfaces should be provided for an external VPN gateway.", - "type": "array", - "items": { - "$ref": "ExternalVpnGatewayInterface" - } - }, - "labels": { - "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this ExternalVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an ExternalVpnGateway.", - "type": "string", - "format": "byte" - } - } - }, - "ExternalVpnGatewayInterface": { - "id": "ExternalVpnGatewayInterface", - "description": "The interface for the external VPN gateway.", - "type": "object", - "properties": { - "id": { - "description": "The numeric ID of this interface. The allowed input values for this id for different redundancy types of external VPN gateway: - SINGLE_IP_INTERNALLY_REDUNDANT - 0 - TWO_IPS_REDUNDANCY - 0, 1 - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 ", - "type": "integer", - "format": "uint32" - }, - "ipAddress": { - "description": "IP address of the interface in the external VPN gateway. Only IPv4 is supported. This IP address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine.", - "type": "string" - }, - "ipv6Address": { - "description": "IPv6 address of the interface in the external VPN gateway. This IPv6 address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine. Must specify an IPv6 address (not IPV4-mapped) using any format described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).", - "type": "string" - } - } - }, - "ExternalVpnGatewayList": { - "id": "ExternalVpnGatewayList", - "description": "Response to the list request, and contains a list of externalVpnGateways.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#externalVpnGatewayList for lists of externalVpnGateways.", - "default": "compute#externalVpnGatewayList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of ExternalVpnGateway resources.", - "type": "array", - "items": { - "$ref": "ExternalVpnGateway" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "etag": { - "type": "string" - } - } - }, - "ForwardingRuleList": { - "id": "ForwardingRuleList", - "description": "Contains a list of ForwardingRule resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#forwardingRuleList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of ForwardingRule resources.", - "type": "array", - "items": { - "$ref": "ForwardingRule" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "ForwardingRule": { - "id": "ForwardingRule", - "description": "Represents a Forwarding Rule resource. Forwarding rule resources in Google Cloud can be either regional or global in scope: * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules) * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules) A forwarding rule and its corresponding IP address represent the frontend configuration of a Google Cloud load balancer. Forwarding rules can also reference target instances and Cloud VPN Classic gateways (targetVpnGateway). For more information, read Forwarding rule concepts and Using protocol forwarding.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#forwardingRule for forwarding rule resources.", - "default": "compute#forwardingRule", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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. For Private Service Connect forwarding rules that forward traffic to Google APIs, the forwarding rule name must be a 1-20 characters string with lowercase letters and numbers and must start with a letter.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "IPAddress": { - "description": "IP address for which this forwarding rule accepts traffic. When a client sends traffic to this IP address, the forwarding rule directs the traffic to the referenced target or backendService. While creating a forwarding rule, specifying an IPAddress is required under the following circumstances: - When the target is set to targetGrpcProxy and validateForProxyless is set to true, the IPAddress should be set to 0.0.0.0. - When the target is a Private Service Connect Google APIs bundle, you must specify an IPAddress. Otherwise, you can optionally specify an IP address that references an existing static (reserved) IP address resource. When omitted, Google Cloud assigns an ephemeral IP address. Use one of the following formats to specify an IP address while creating a forwarding rule: * IP address number, as in `100.1.2.3` * IPv6 address range, as in `2600:1234::/96` * Full resource URL, as in https://www.googleapis.com/compute/v1/projects/ project_id/regions/region/addresses/address-name * Partial URL or by name, as in: - projects/project_id/regions/region/addresses/address-name - regions/region/addresses/address-name - global/addresses/address-name - address-name The forwarding rule's target or backendService, and in most cases, also the loadBalancingScheme, determine the type of IP address that you can use. For detailed information, see [IP address specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). When reading an IPAddress, the API always returns the IP address number.", - "type": "string" - }, - "IPProtocol": { - "description": "The IP protocol to which this rule applies. For protocol forwarding, valid options are TCP, UDP, ESP, AH, SCTP, ICMP and L3_DEFAULT. The valid IP protocols are different for different load balancing products as described in [Load balancing features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "" - ], - "enum": [ - "AH", - "ESP", - "ICMP", - "L3_DEFAULT", - "SCTP", - "TCP", - "UDP" - ] - }, - "portRange": { - "description": "The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The portRange field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: external passthrough Network Load Balancers, internal and external proxy Network Load Balancers, internal and external Application Load Balancers, external protocol forwarding, and Classic VPN. - Some products have restrictions on what ports can be used. See port specifications for details. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. @pattern: \\\\d+(?:-\\\\d+)?", - "type": "string" - }, - "ports": { - "description": "The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The ports field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal protocol forwarding. - You can specify a list of up to five ports by number, separated by commas. The ports can be contiguous or discontiguous. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. @pattern: \\\\d+(?:-\\\\d+)?", - "type": "array", - "items": { - "type": "string" - } - }, - "target": { - "description": "The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must be in the same region as the forwarding rule. For global forwarding rules, this target must be a global load balancing resource. The forwarded traffic must be of a type appropriate to the target object. - For load balancers, see the \"Target\" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle: - vpc-sc - APIs that support VPC Service Controls. - all-apis - All supported Google APIs. - For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment. ", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "loadBalancingScheme": { - "description": "Specifies the forwarding rule type. For more information about forwarding rules, refer to Forwarding rule concepts.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "" - ], - "enum": [ - "EXTERNAL", - "EXTERNAL_MANAGED", - "INTERNAL", - "INTERNAL_MANAGED", - "INTERNAL_SELF_MANAGED", - "INVALID" - ] - }, - "subnetwork": { - "description": "This field identifies the subnetwork that the load balanced IP should belong to for this forwarding rule, used with internal load balancers and external passthrough Network Load Balancers with IPv6. If the network specified is in auto subnet mode, this field is optional. However, a subnetwork must be specified if the network is in custom subnet mode or when creating external forwarding rule with IPv6.", - "type": "string" - }, - "network": { - "description": "This field is not used for global external load balancing. For internal passthrough Network Load Balancers, this field identifies the network that the load balanced IP should belong to for this forwarding rule. If the subnetwork is specified, the network of the subnetwork will be used. If neither subnetwork nor this field is specified, the default network will be used. For Private Service Connect forwarding rules that forward traffic to Google APIs, a network must be provided.", - "type": "string" - }, - "backendService": { - "description": "Identifies the backend service to which the forwarding rule sends traffic. Required for internal and external passthrough Network Load Balancers; must be omitted for all other load balancer types.", - "type": "string" - }, - "serviceDirectoryRegistrations": { - "description": "Service Directory resources to register this forwarding rule with. Currently, only supports a single Service Directory resource.", - "type": "array", - "items": { - "$ref": "ForwardingRuleServiceDirectoryRegistration" - } - }, - "serviceLabel": { - "description": "An optional prefix to the service name for this forwarding rule. If specified, the prefix is the first label of the fully qualified service name. The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label 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. This field is only used for internal load balancing.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - }, - "serviceName": { - "description": "[Output Only] The internal fully qualified service name for this forwarding rule. This field is only used for internal load balancing.", - "type": "string" - }, - "networkTier": { - "description": "This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM, STANDARD. For regional ForwardingRule, the valid values are PREMIUM and STANDARD. For GlobalForwardingRule, the valid value is PREMIUM. If this field is not specified, it is assumed to be PREMIUM. If IPAddress is specified, this value must be equal to the networkTier of the Address.", - "type": "string", - "enumDescriptions": [ - "Public internet quality with fixed bandwidth.", - "High quality, Google-grade network tier, support for all networking products.", - "Public internet quality, only limited support for other networking products.", - "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." - ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" - ] - }, - "labels": { - "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this resource, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule.", - "type": "string", - "format": "byte" - }, - "ipVersion": { - "description": "The IP Version that will be used by this forwarding rule. Valid options are IPV4 or IPV6.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" - ], - "enum": [ - "IPV4", - "IPV6", - "UNSPECIFIED_VERSION" - ] - }, - "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 ForwardingRule. Include the fingerprint in patch request to ensure that you do not overwrite changes that were applied from another concurrent request. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule.", - "type": "string", - "format": "byte" - }, - "allPorts": { - "description": "The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The allPorts field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, SCTP, or L3_DEFAULT. - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal and external protocol forwarding. - Set this field to true to allow packets addressed to any port or packets lacking destination port information (for example, UDP fragments after the first fragment) to be forwarded to the backends configured with this forwarding rule. The L3_DEFAULT protocol requires allPorts be set to true. ", - "type": "boolean" - }, - "allowGlobalAccess": { - "description": "If set to true, clients can access the internal passthrough Network Load Balancers, the regional internal Application Load Balancer, and the regional internal proxy Network Load Balancer from all regions. If false, only allows access from the local region the load balancer is located at. Note that for INTERNAL_MANAGED forwarding rules, this field cannot be changed after the forwarding rule is created.", - "type": "boolean" - }, - "metadataFilters": { - "description": "Opaque filter criteria used by load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to load balancer, xDS clients present node metadata. When there is a match, the relevant configuration is made available to those proxies. Otherwise, all the resources (e.g. TargetHttpProxy, UrlMap) referenced by the ForwardingRule are not visible to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadataFilters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here will be applifed before those specified in the UrlMap that this ForwardingRule references. metadataFilters only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED.", - "type": "array", - "items": { - "$ref": "MetadataFilter" - } - }, - "isMirroringCollector": { - "description": "Indicates whether or not this load balancer can be used as a collector for packet mirroring. To prevent mirroring loops, instances behind this load balancer will not have their traffic mirrored even if a PacketMirroring rule applies to them. This can only be set to true for load balancers that have their loadBalancingScheme set to INTERNAL.", - "type": "boolean" - }, - "sourceIpRanges": { - "description": "If not empty, this forwarding rule will only forward the traffic when the source IP address matches one of the IP addresses or CIDR ranges set here. Note that a forwarding rule can only have up to 64 source IP ranges, and this field can only be used with a regional forwarding rule whose scheme is EXTERNAL. Each source_ip_range entry should be either an IP address (for example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).", - "type": "array", - "items": { - "type": "string" - } - }, - "pscConnectionId": { - "description": "[Output Only] The PSC connection id of the PSC forwarding rule.", - "type": "string", - "format": "uint64" - }, - "pscConnectionStatus": { - "type": "string", - "enumDescriptions": [ - "The connection has been accepted by the producer.", - "The connection has been closed by the producer and will not serve traffic going forward.", - "The connection has been accepted by the producer, but the producer needs to take further action before the forwarding rule can serve traffic.", - "The connection is pending acceptance by the producer.", - "The connection has been rejected by the producer.", - "" - ], - "enum": [ - "ACCEPTED", - "CLOSED", - "NEEDS_ATTENTION", - "PENDING", - "REJECTED", - "STATUS_UNSPECIFIED" - ] - }, - "baseForwardingRule": { - "description": "[Output Only] The URL for the corresponding base forwarding rule. By base forwarding rule, we mean the forwarding rule that has the same IP address, protocol, and port settings with the current forwarding rule, but without sourceIPRanges specified. Always empty if the current forwarding rule does not have sourceIPRanges specified.", - "type": "string" - }, - "allowPscGlobalAccess": { - "description": "This is used in PSC consumer ForwardingRule to control whether the PSC endpoint can be accessed from another region.", - "type": "boolean" - }, - "noAutomateDnsZone": { - "description": "This is used in PSC consumer ForwardingRule to control whether it should try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use this field. Once set, this field is not mutable.", - "type": "boolean" - }, - "ipCollection": { - "description": "Resource reference of a PublicDelegatedPrefix. The PDP must be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. Use one of the following formats to specify a sub-PDP when creating an IPv6 NetLB forwarding rule using BYOIP: Full resource URL, as in https://www.googleapis.com/compute/v1/projects/project_id/regions/region /publicDelegatedPrefixes/sub-pdp-name Partial URL, as in: - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name ", - "type": "string" - } - } - }, - "ForwardingRuleServiceDirectoryRegistration": { - "id": "ForwardingRuleServiceDirectoryRegistration", - "description": "Describes the auto-registration of the forwarding rule to Service Directory. The region and project of the Service Directory resource generated from this registration will be the same as this forwarding rule.", - "type": "object", - "properties": { - "namespace": { - "description": "Service Directory namespace to register the forwarding rule under.", - "type": "string" - }, - "service": { - "description": "Service Directory service to register the forwarding rule under.", - "type": "string" - }, - "serviceDirectoryRegion": { - "description": "[Optional] Service Directory region to register this global forwarding rule under. Default to \"us-central1\". Only used for PSC for Google APIs. All PSC for Google APIs forwarding rules on the same network should use the same Service Directory region.", - "type": "string" - } - } - }, - "MetadataFilter": { - "id": "MetadataFilter", - "description": "Opaque filter criteria used by load balancers to restrict routing configuration to a limited set of load balancing proxies. Proxies and sidecars involved in load balancing would typically present metadata to the load balancers that need to match criteria specified here. If a match takes place, the relevant configuration is made available to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. An example for using metadataFilters would be: if load balancing involves Envoys, they receive routing configuration when values in metadataFilters match values supplied in of their XDS requests to loadbalancers.", - "type": "object", - "properties": { - "filterMatchCriteria": { - "description": "Specifies how individual filter label matches within the list of filterLabels and contributes toward the overall metadataFilter match. Supported values are: - MATCH_ANY: at least one of the filterLabels must have a matching label in the provided metadata. - MATCH_ALL: all filterLabels must have matching labels in the provided metadata. ", - "type": "string", - "enumDescriptions": [ - "Specifies that all filterLabels must match for the metadataFilter to be considered a match.", - "Specifies that any filterLabel must match for the metadataFilter to be considered a match.", - "Indicates that the match criteria was not set. A metadataFilter must never be created with this value." - ], - "enum": [ - "MATCH_ALL", - "MATCH_ANY", - "NOT_SET" - ] - }, - "filterLabels": { - "description": "The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list must not be empty and can have at the most 64 entries.", - "type": "array", - "items": { - "$ref": "MetadataFilterLabelMatch" - } - } - } - }, - "MetadataFilterLabelMatch": { - "id": "MetadataFilterLabelMatch", - "description": "MetadataFilter label name value pairs that are expected to match corresponding labels presented as metadata to the load balancer.", - "type": "object", - "properties": { - "name": { - "description": "Name of metadata label. The name can have a maximum length of 1024 characters and must be at least 1 character long.", - "type": "string" - }, - "value": { - "description": "The value of the label must match the specified value. value can have a maximum length of 1024 characters.", - "type": "string" - } - } - }, - "TargetReference": { - "id": "TargetReference", - "type": "object", - "properties": { - "target": { - "type": "string" - } - } - }, - "ForwardingRuleAggregatedList": { - "id": "ForwardingRuleAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#forwardingRuleAggregatedList for lists of forwarding rules.", - "default": "compute#forwardingRuleAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of ForwardingRulesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of addresses.", - "$ref": "ForwardingRulesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ForwardingRulesScopedList": { - "id": "ForwardingRulesScopedList", - "type": "object", - "properties": { - "forwardingRules": { - "description": "A list of forwarding rules contained in this scope.", - "type": "array", - "items": { - "$ref": "ForwardingRule" - } - }, - "warning": { - "description": "Informational warning which replaces the list of forwarding rules when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "FutureReservation": { - "id": "FutureReservation", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#futureReservation for future reservations.", - "default": "compute#futureReservation", - "type": "string" - }, - "id": { - "description": "[Output Only] A unique identifier for this future reservation. The server defines this identifier.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] The creation timestamp for this future reservation in RFC3339 text format.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined fully-qualified URL for this resource.", - "type": "string" - }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource with the resource id.", - "type": "string" - }, - "zone": { - "description": "[Output Only] URL of the Zone where this future reservation resides.", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the future reservation.", - "type": "string" - }, - "name": { - "description": "The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "annotations": { - "required": [ - "compute.instances.insert" - ] - }, - "type": "string" - }, - "specificSkuProperties": { - "description": "Future Reservation configuration to indicate instance properties and total count.", - "$ref": "FutureReservationSpecificSKUProperties" - }, - "timeWindow": { - "description": "Time window for this Future Reservation.", - "$ref": "FutureReservationTimeWindow" - }, - "shareSettings": { - "description": "List of Projects/Folders to share with.", - "$ref": "ShareSettings" - }, - "namePrefix": { - "description": "Name prefix for the reservations to be created at the time of delivery. The name prefix must comply with RFC1035. Maximum allowed length for name prefix is 20. Automatically created reservations name format will be -date-####.", - "type": "string" - }, - "status": { - "description": "[Output only] Status of the Future Reservation", - "$ref": "FutureReservationStatus" - }, - "planningStatus": { - "description": "Planning state before being submitted for evaluation", - "type": "string", - "enumDescriptions": [ - "Future Reservation is being drafted.", - "", - "Future Reservation has been submitted for evaluation by GCP." - ], - "enum": [ - "DRAFT", - "PLANNING_STATUS_UNSPECIFIED", - "SUBMITTED" - ] - }, - "autoCreatedReservationsDeleteTime": { - "description": "Future timestamp when the FR auto-created reservations will be deleted by Compute Engine. Format of this field must be a valid href=\"https://www.ietf.org/rfc/rfc3339.txt\"\u003eRFC3339 value.", - "type": "string" - }, - "autoCreatedReservationsDuration": { - "description": "Specifies the duration of auto-created reservations. It represents relative time to future reservation start_time when auto-created reservations will be automatically deleted by Compute Engine. Duration time unit is represented as a count of seconds and fractions of seconds at nanosecond resolution.", - "$ref": "Duration" - }, - "autoDeleteAutoCreatedReservations": { - "description": "Setting for enabling or disabling automatic deletion for auto-created reservation. If set to true, auto-created reservations will be deleted at Future Reservation's end time (default) or at user's defined timestamp if any of the [auto_created_reservations_delete_time, auto_created_reservations_duration] values is specified. For keeping auto-created reservation indefinitely, this value should be set to false.", - "type": "boolean" - } - } - }, - "FutureReservationSpecificSKUProperties": { - "id": "FutureReservationSpecificSKUProperties", - "type": "object", - "properties": { - "instanceProperties": { - "description": "Properties of the SKU instances being reserved.", - "$ref": "AllocationSpecificSKUAllocationReservedInstanceProperties" - }, - "totalCount": { - "description": "Total number of instances for which capacity assurance is requested at a future time period.", - "type": "string", - "format": "int64" - }, - "sourceInstanceTemplate": { - "description": "The instance template that will be used to populate the ReservedInstanceProperties of the future reservation", - "type": "string" - } - } - }, - "FutureReservationTimeWindow": { - "id": "FutureReservationTimeWindow", - "type": "object", - "properties": { - "startTime": { - "description": "Start time of the Future Reservation. The start_time is an RFC3339 string.", - "type": "string" - }, - "endTime": { - "type": "string" - }, - "duration": { - "$ref": "Duration" - } - } - }, - "FutureReservationStatus": { - "id": "FutureReservationStatus", - "description": "[Output only] Represents status related to the future reservation.", - "type": "object", - "properties": { - "procurementStatus": { - "description": "Current state of this Future Reservation", - "type": "string", - "enumDescriptions": [ - "Future reservation is approved by GCP.", - "Future reservation is cancelled by the customer.", - "Future reservation is committed by the customer.", - "Future reservation is rejected by GCP.", - "Related status for PlanningStatus.Draft. Transitions to PENDING_APPROVAL upon user submitting FR.", - "Future reservation failed. No additional reservations were provided.", - "Future reservation is partially fulfilled. Additional reservations were provided but did not reach total_count reserved instance slots.", - "Future reservation is fulfilled completely.", - "An Amendment to the Future Reservation has been requested. If the Amendment is declined, the Future Reservation will be restored to the last known good state.", - "Future reservation is pending approval by GCP.", - "", - "Future reservation is being procured by GCP. Beyond this point, Future reservation is locked and no further modifications are allowed.", - "Future reservation capacity is being provisioned. This state will be entered after start_time, while reservations are being created to provide total_count reserved instance slots. This state will not persist past start_time + 24h." - ], - "enum": [ - "APPROVED", - "CANCELLED", - "COMMITTED", - "DECLINED", - "DRAFTING", - "FAILED", - "FAILED_PARTIALLY_FULFILLED", - "FULFILLED", - "PENDING_AMENDMENT_APPROVAL", - "PENDING_APPROVAL", - "PROCUREMENT_STATUS_UNSPECIFIED", - "PROCURING", - "PROVISIONING" - ] - }, - "lockTime": { - "description": "Time when Future Reservation would become LOCKED, after which no modifications to Future Reservation will be allowed. Applicable only after the Future Reservation is in the APPROVED state. The lock_time is an RFC3339 string. The procurement_status will transition to PROCURING state at this time.", - "type": "string" - }, - "autoCreatedReservations": { - "description": "Fully qualified urls of the automatically created reservations at start_time.", - "type": "array", - "items": { - "type": "string" - } - }, - "fulfilledCount": { - "description": "This count indicates the fulfilled capacity so far. This is set during \"PROVISIONING\" state. This count also includes capacity delivered as part of existing matching reservations.", - "type": "string", - "format": "int64" - }, - "specificSkuProperties": { - "$ref": "FutureReservationStatusSpecificSKUProperties" - }, - "amendmentStatus": { - "description": "[Output Only] The current status of the requested amendment.", - "type": "string", - "enumDescriptions": [ - "The requested amendment to the Future Resevation has been approved and applied by GCP.", - "The requested amendment to the Future Reservation has been declined by GCP and the original state was restored.", - "The requested amendment to the Future Reservation is currently being reviewd by GCP.", - "" - ], - "enum": [ - "AMENDMENT_APPROVED", - "AMENDMENT_DECLINED", - "AMENDMENT_IN_REVIEW", - "AMENDMENT_STATUS_UNSPECIFIED" - ] - }, - "lastKnownGoodState": { - "description": "[Output Only] This field represents the future reservation before an amendment was requested. If the amendment is declined, the Future Reservation will be reverted to the last known good state. The last known good state is not set when updating a future reservation whose Procurement Status is DRAFTING.", - "$ref": "FutureReservationStatusLastKnownGoodState" - }, - "existingMatchingUsageInfo": { - "description": "[Output Only] Represents the existing matching usage for the future reservation.", - "$ref": "FutureReservationStatusExistingMatchingUsageInfo" - } - } - }, - "FutureReservationStatusSpecificSKUProperties": { - "id": "FutureReservationStatusSpecificSKUProperties", - "description": "Properties to be set for the Future Reservation.", - "type": "object", - "properties": { - "sourceInstanceTemplateId": { - "description": "ID of the instance template used to populate the Future Reservation properties.", - "type": "string" - } - } - }, - "FutureReservationStatusLastKnownGoodState": { - "id": "FutureReservationStatusLastKnownGoodState", - "description": "The state that the future reservation will be reverted to should the amendment be declined.", - "type": "object", - "properties": { - "futureReservationSpecs": { - "$ref": "FutureReservationStatusLastKnownGoodStateFutureReservationSpecs" - }, - "procurementStatus": { - "description": "[Output Only] The status of the last known good state for the Future Reservation.", - "type": "string", - "enumDescriptions": [ - "Future reservation is approved by GCP.", - "Future reservation is cancelled by the customer.", - "Future reservation is committed by the customer.", - "Future reservation is rejected by GCP.", - "Related status for PlanningStatus.Draft. Transitions to PENDING_APPROVAL upon user submitting FR.", - "Future reservation failed. No additional reservations were provided.", - "Future reservation is partially fulfilled. Additional reservations were provided but did not reach total_count reserved instance slots.", - "Future reservation is fulfilled completely.", - "An Amendment to the Future Reservation has been requested. If the Amendment is declined, the Future Reservation will be restored to the last known good state.", - "Future reservation is pending approval by GCP.", - "", - "Future reservation is being procured by GCP. Beyond this point, Future reservation is locked and no further modifications are allowed.", - "Future reservation capacity is being provisioned. This state will be entered after start_time, while reservations are being created to provide total_count reserved instance slots. This state will not persist past start_time + 24h." - ], - "enum": [ - "APPROVED", - "CANCELLED", - "COMMITTED", - "DECLINED", - "DRAFTING", - "FAILED", - "FAILED_PARTIALLY_FULFILLED", - "FULFILLED", - "PENDING_AMENDMENT_APPROVAL", - "PENDING_APPROVAL", - "PROCUREMENT_STATUS_UNSPECIFIED", - "PROCURING", - "PROVISIONING" - ] - }, - "namePrefix": { - "description": "[Output Only] The name prefix of the Future Reservation before an amendment was requested.", - "type": "string" - }, - "description": { - "description": "[Output Only] The description of the FutureReservation before an amendment was requested.", - "type": "string" - }, - "lockTime": { - "description": "[Output Only] The lock time of the FutureReservation before an amendment was requested.", - "type": "string" - }, - "existingMatchingUsageInfo": { - "description": "[Output Only] Represents the matching usage for the future reservation before an amendment was requested.", - "$ref": "FutureReservationStatusExistingMatchingUsageInfo" - } - } - }, - "FutureReservationStatusLastKnownGoodStateFutureReservationSpecs": { - "id": "FutureReservationStatusLastKnownGoodStateFutureReservationSpecs", - "description": "The properties of the last known good state for the Future Reservation.", - "type": "object", - "properties": { - "specificSkuProperties": { - "description": "[Output Only] The previous instance related properties of the Future Reservation.", - "$ref": "FutureReservationSpecificSKUProperties" - }, - "timeWindow": { - "description": "[Output Only] The previous time window of the Future Reservation.", - "$ref": "FutureReservationTimeWindow" - }, - "shareSettings": { - "description": "[Output Only] The previous share settings of the Future Reservation.", - "$ref": "ShareSettings" - } - } - }, - "FutureReservationStatusExistingMatchingUsageInfo": { - "id": "FutureReservationStatusExistingMatchingUsageInfo", - "description": "[Output Only] Represents the existing matching usage for the future reservation.", - "type": "object", - "properties": { - "count": { - "description": "Count to represent min(FR total_count, matching_reserved_capacity+matching_unreserved_instances)", - "type": "string", - "format": "int64" - }, - "timestamp": { - "description": "Timestamp when the matching usage was calculated", - "type": "string" - } - } - }, - "FutureReservationsListResponse": { - "id": "FutureReservationsListResponse", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource.Always compute#FutureReservationsListResponse for lists of reservations", - "default": "compute#futureReservationsListResponse", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string" - }, - "items": { - "description": "[Output Only] A list of future reservation resources.", - "type": "array", - "items": { - "$ref": "FutureReservation" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "id": "compute.instances.aggregatedList", + "path": "projects/{project}/aggregated/instances", + "flatPath": "projects/{project}/aggregated/instances", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" } - } - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "etag": { - "type": "string" - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "FutureReservationsAggregatedListResponse": { - "id": "FutureReservationsAggregatedListResponse", - "description": "Contains a list of future reservations.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#futureReservationsAggregatedListResponse for future resevation aggregated list response.", - "default": "compute#futureReservationsAggregatedListResponse", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Future reservation resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of future reservations.", - "$ref": "FutureReservationsScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "InstanceAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of all of the instances in your project across all regions and zones. The performance of this method degrades when a filter is specified on a project that has a very large number of instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listReferrers": { + "id": "compute.instances.listReferrers", + "path": "projects/{project}/zones/{zone}/instances/{instance}/referrers", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/referrers", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "instance": { + "description": "Name of the target instance scoping this request, or '-' if the request should span over all instances in the container.", + "pattern": "-|[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - }, - "etag": { - "type": "string" - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "FutureReservationsScopedList": { - "id": "FutureReservationsScopedList", - "type": "object", - "properties": { - "futureReservations": { - "description": "A list of future reservations contained in this scope.", - "type": "array", - "items": { - "$ref": "FutureReservation" - } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "response": { + "$ref": "InstanceListReferrers" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of resources that refer to the VM instance specified in the request. For example, if the VM instance is part of a managed or unmanaged instance group, the referrers list includes the instance group. For more information, read Viewing referrers to VM instances." }, - "warning": { - "description": "Informational warning which replaces the list of future reservations when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "id": "compute.instances.get", + "path": "projects/{project}/zones/{zone}/instances/{instance}", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}", + "httpMethod": "GET", + "parameters": { + "instance": { + "description": "Name of the instance resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "HealthCheckServicesList": { - "id": "HealthCheckServicesList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#healthCheckServicesList for lists of HealthCheckServices.", - "default": "compute#healthCheckServicesList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of HealthCheckService resources.", - "type": "array", - "items": { - "$ref": "HealthCheckService" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "response": { + "$ref": "Instance" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified Instance resource." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.instances.insert", + "path": "projects/{project}/zones/{zone}/instances", + "flatPath": "projects/{project}/zones/{zone}/instances", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "sourceInstanceTemplate": { + "description": "Specifies instance template to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate ", + "location": "query", + "type": "string" + }, + "sourceMachineImage": { + "description": "Specifies the machine image to use to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to a machine image: - https://www.googleapis.com/compute/v1/projects/project/global/global /machineImages/machineImage - projects/project/global/global/machineImages/machineImage - global/machineImages/machineImage ", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "HealthCheckService": { - "id": "HealthCheckService", - "description": "Represents a Health-Check as a Service resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output only] Type of the resource. Always compute#healthCheckServicefor health check services.", - "default": "compute#healthCheckService", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "name": { - "description": "Name of the resource. 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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the health check service resides. This field is not applicable to global health check services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "healthStatusAggregationPolicy": { - "description": "Optional. Policy for how the results from multiple health checks for the same endpoint are aggregated. Defaults to NO_AGGREGATION if unspecified. - NO_AGGREGATION. An EndpointHealth message is returned for each pair in the health check service. - AND. If any health check of an endpoint reports UNHEALTHY, then UNHEALTHY is the HealthState of the endpoint. If all health checks report HEALTHY, the HealthState of the endpoint is HEALTHY. . This is only allowed with regional HealthCheckService.", - "type": "string", - "enumDescriptions": [ - "If any backend's health check reports UNHEALTHY, then UNHEALTHY is the HealthState of the entire health check service. If all backend's are healthy, the HealthState of the health check service is HEALTHY.", - "An EndpointHealth message is returned for each backend in the health check service." + }, + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "AND", - "NO_AGGREGATION" - ] - }, - "healthChecks": { - "description": "A list of URLs to the HealthCheck resources. Must have at least one HealthCheck, and not more than 10 for regional HealthCheckService, and not more than 1 for global HealthCheckService. HealthCheck resources must have portSpecification=USE_SERVING_PORT or portSpecification=USE_FIXED_PORT. For regional HealthCheckService, the HealthCheck must be regional and in the same region. For global HealthCheckService, HealthCheck must be global. Mix of regional and global HealthChecks is not supported. Multiple regional HealthChecks must belong to the same region. Regional HealthChecks must belong to the same region as zones of NetworkEndpointGroups. For global HealthCheckService using global INTERNET_IP_PORT NetworkEndpointGroups, the global HealthChecks must specify sourceRegions, and HealthChecks that specify sourceRegions can only be used with global INTERNET_IP_PORT NetworkEndpointGroups.", - "type": "array", - "items": { - "type": "string" - } - }, - "networkEndpointGroups": { - "description": "A list of URLs to the NetworkEndpointGroup resources. Must not have more than 100. For regional HealthCheckService, NEGs must be in zones in the region of the HealthCheckService. For global HealthCheckServices, the NetworkEndpointGroups must be global INTERNET_IP_PORT.", - "type": "array", - "items": { - "type": "string" - } - }, - "notificationEndpoints": { - "description": "A list of URLs to the NotificationEndpoint resources. Must not have more than 10. A list of endpoints for receiving notifications of change in health status. For regional HealthCheckService, NotificationEndpoint must be regional and in the same region. For global HealthCheckService, NotificationEndpoint must be global.", - "type": "array", - "items": { - "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 HealthCheckService. An up-to-date fingerprint must be provided in order to patch/update the HealthCheckService; Otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the HealthCheckService.", - "type": "string", - "format": "byte" - } - } - }, - "HealthCheckList": { - "id": "HealthCheckList", - "description": "Contains a list of HealthCheck resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#healthCheckList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of HealthCheck resources.", - "type": "array", - "items": { - "$ref": "HealthCheck" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "request": { + "$ref": "Instance" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates an instance resource in the specified project using the data included in the request." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "delete": { + "id": "compute.instances.delete", + "path": "projects/{project}/zones/{zone}/instances/{instance}", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}", + "httpMethod": "DELETE", + "parameters": { + "instance": { + "description": "Name of the instance resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified Instance resource. For more information, see Deleting an instance." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "reset": { + "id": "compute.instances.reset", + "path": "projects/{project}/zones/{zone}/instances/{instance}/reset", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/reset", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "HealthCheck": { - "id": "HealthCheck", - "description": "Represents a health check resource. Google Compute Engine has two health check resources: * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks) * [Global](/compute/docs/reference/rest/v1/healthChecks) These health check resources can be used for load balancing and for autohealing VMs in a managed instance group (MIG). **Load balancing** Health check requirements vary depending on the type of load balancer. For details about the type of health check supported for each load balancer and corresponding backend type, see Health checks overview: Load balancer guide. **Autohealing in MIGs** The health checks that you use for autohealing VMs in a MIG can be either regional or global. For more information, see Set up an application health check and autohealing. For more information, see Health checks overview.", - "type": "object", - "properties": { - "kind": { - "description": "Type of the resource.", - "default": "compute#healthCheck", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in 3339 text format.", - "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. For example, a name that is 1-63 characters long, matches the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with RFC1035. This regular expression describes a name where the first character is a lowercase letter, and all following characters are a dash, lowercase letter, or digit, except the last character, which isn't a dash.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "checkIntervalSec": { - "description": "How often (in seconds) to send a health check. The default value is 5 seconds.", - "type": "integer", - "format": "int32" - }, - "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.", - "type": "integer", - "format": "int32" - }, - "unhealthyThreshold": { - "description": "A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.", - "type": "integer", - "format": "int32" - }, - "healthyThreshold": { - "description": "A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.", - "type": "integer", - "format": "int32" - }, - "type": { - "description": "Specifies the type of the healthCheck, either TCP, SSL, HTTP, HTTPS, HTTP2 or GRPC. Exactly one of the protocol-specific health check fields must be specified, which must match type field.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "" + }, + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "GRPC", - "HTTP", - "HTTP2", - "HTTPS", - "INVALID", - "SSL", - "TCP" - ] - }, - "tcpHealthCheck": { - "$ref": "TCPHealthCheck" - }, - "sslHealthCheck": { - "$ref": "SSLHealthCheck" - }, - "httpHealthCheck": { - "$ref": "HTTPHealthCheck" - }, - "httpsHealthCheck": { - "$ref": "HTTPSHealthCheck" - }, - "http2HealthCheck": { - "$ref": "HTTP2HealthCheck" - }, - "grpcHealthCheck": { - "$ref": "GRPCHealthCheck" - }, - "sourceRegions": { - "description": "The list of cloud regions from which health checks are performed. If any regions are specified, then exactly 3 regions should be specified. The region names must be valid names of Google Cloud regions. This can only be set for global health check. If this list is non-empty, then there are restrictions on what other health check fields are supported and what other resources can use this health check: - SSL, HTTP2, and GRPC protocols are not supported. - The TCP request field is not supported. - The proxyHeader field for HTTP, HTTPS, and TCP is not supported. - The checkIntervalSec field must be at least 30. - The health check cannot be used with BackendService nor with managed instance group auto-healing. ", - "type": "array", - "items": { - "type": "string" - } - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] Region where the health check resides. Not applicable to global health checks.", - "type": "string" - }, - "logConfig": { - "description": "Configure logging on this health check.", - "$ref": "HealthCheckLogConfig" - } - } - }, - "TCPHealthCheck": { - "id": "TCPHealthCheck", - "type": "object", - "properties": { - "port": { - "description": "The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535.", - "type": "integer", - "format": "int32" - }, - "portName": { - "description": "Not supported.", - "type": "string" - }, - "portSpecification": { - "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", - "type": "string", - "enumDescriptions": [ - "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", - "Not supported.", - "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" - ] - }, - "request": { - "description": "Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection.", - "type": "string" - }, - "response": { - "description": "Creates a content-based TCP health check. In addition to establishing a TCP connection, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp", - "type": "string" + "description": "Performs a reset on the instance. This is a hard reset. The VM does not do a graceful shutdown. For more information, see Resetting an instance." }, - "proxyHeader": { - "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", - "type": "string", - "enumDescriptions": [ - "", - "" + "simulateMaintenanceEvent": { + "id": "compute.instances.simulateMaintenanceEvent", + "path": "projects/{project}/zones/{zone}/instances/{instance}/simulateMaintenanceEvent", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/simulateMaintenanceEvent", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "withExtendedNotifications": { + "description": "Determines whether the customers receive notifications before migration. Only applicable to SF vms.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "NONE", - "PROXY_V1" - ] - } - } - }, - "SSLHealthCheck": { - "id": "SSLHealthCheck", - "type": "object", - "properties": { - "port": { - "description": "The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535.", - "type": "integer", - "format": "int32" - }, - "portName": { - "description": "Not supported.", - "type": "string" - }, - "portSpecification": { - "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", - "type": "string", - "enumDescriptions": [ - "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", - "Not supported.", - "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" - ] - }, - "request": { - "description": "Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection and SSL handshake.", - "type": "string" - }, - "response": { - "description": "Creates a content-based SSL health check. In addition to establishing a TCP connection and the TLS handshake, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp", - "type": "string" + "description": "Simulates a host maintenance event on a VM. For more information, see Simulate a host maintenance event." }, - "proxyHeader": { - "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", - "type": "string", - "enumDescriptions": [ - "", - "" + "performMaintenance": { + "id": "compute.instances.performMaintenance", + "path": "projects/{project}/zones/{zone}/instances/{instance}/performMaintenance", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/performMaintenance", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "NONE", - "PROXY_V1" - ] - } - } - }, - "HTTPHealthCheck": { - "id": "HTTPHealthCheck", - "type": "object", - "properties": { - "port": { - "description": "The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535.", - "type": "integer", - "format": "int32" - }, - "portName": { - "description": "Not supported.", - "type": "string" - }, - "portSpecification": { - "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Also supported in legacy HTTP health checks for target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for pass-through load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", - "type": "string", - "enumDescriptions": [ - "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", - "Not supported.", - "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" - ] - }, - "host": { - "description": "The value of the host header in the HTTP health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", - "type": "string" - }, - "requestPath": { - "description": "The request path of the HTTP health check request. The default value is /. Must comply with RFC3986.", - "type": "string" + "description": "Perform a manual maintenance on the instance." }, - "proxyHeader": { - "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", - "type": "string", - "enumDescriptions": [ - "", - "" + "addAccessConfig": { + "id": "compute.instances.addAccessConfig", + "path": "projects/{project}/zones/{zone}/instances/{instance}/addAccessConfig", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addAccessConfig", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "The instance name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "networkInterface": { + "description": "The name of the network interface to add to this instance.", + "location": "query", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance", + "networkInterface" ], - "enum": [ - "NONE", - "PROXY_V1" - ] - }, - "response": { - "description": "Creates a content-based HTTP health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", - "type": "string" - } - } - }, - "HTTPSHealthCheck": { - "id": "HTTPSHealthCheck", - "type": "object", - "properties": { - "port": { - "description": "The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535.", - "type": "integer", - "format": "int32" - }, - "portName": { - "description": "Not supported.", - "type": "string" - }, - "portSpecification": { - "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", - "type": "string", - "enumDescriptions": [ - "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", - "Not supported.", - "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." + "request": { + "$ref": "AccessConfig" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" - ] - }, - "host": { - "description": "The value of the host header in the HTTPS health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", - "type": "string" - }, - "requestPath": { - "description": "The request path of the HTTPS health check request. The default value is /. Must comply with RFC3986.", - "type": "string" + "description": "Adds an access config to an instance's network interface." }, - "proxyHeader": { - "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", - "type": "string", - "enumDescriptions": [ - "", - "" + "deleteAccessConfig": { + "id": "compute.instances.deleteAccessConfig", + "path": "projects/{project}/zones/{zone}/instances/{instance}/deleteAccessConfig", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/deleteAccessConfig", + "httpMethod": "POST", + "parameters": { + "accessConfig": { + "description": "The name of the access config to delete.", + "location": "query", + "required": true, + "type": "string" + }, + "instance": { + "description": "The instance name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "networkInterface": { + "description": "The name of the network interface.", + "location": "query", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance", + "accessConfig", + "networkInterface" ], - "enum": [ - "NONE", - "PROXY_V1" - ] - }, - "response": { - "description": "Creates a content-based HTTPS health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", - "type": "string" - } - } - }, - "HTTP2HealthCheck": { - "id": "HTTP2HealthCheck", - "type": "object", - "properties": { - "port": { - "description": "The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535.", - "type": "integer", - "format": "int32" - }, - "portName": { - "description": "Not supported.", - "type": "string" - }, - "portSpecification": { - "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", - "type": "string", - "enumDescriptions": [ - "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", - "Not supported.", - "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" - ] - }, - "host": { - "description": "The value of the host header in the HTTP/2 health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", - "type": "string" - }, - "requestPath": { - "description": "The request path of the HTTP/2 health check request. The default value is /. Must comply with RFC3986.", - "type": "string" + "description": "Deletes an access config from an instance's network interface." }, - "proxyHeader": { - "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", - "type": "string", - "enumDescriptions": [ - "", - "" + "updateAccessConfig": { + "id": "compute.instances.updateAccessConfig", + "path": "projects/{project}/zones/{zone}/instances/{instance}/updateAccessConfig", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateAccessConfig", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "The instance name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "networkInterface": { + "description": "The name of the network interface where the access config is attached.", + "location": "query", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance", + "networkInterface" ], - "enum": [ - "NONE", - "PROXY_V1" - ] - }, - "response": { - "description": "Creates a content-based HTTP/2 health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", - "type": "string" - } - } - }, - "GRPCHealthCheck": { - "id": "GRPCHealthCheck", - "type": "object", - "properties": { - "port": { - "description": "The TCP port number to which the health check prober sends packets. Valid values are 1 through 65535.", - "type": "integer", - "format": "int32" - }, - "portName": { - "description": "Not supported.", - "type": "string" - }, - "portSpecification": { - "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", - "type": "string", - "enumDescriptions": [ - "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", - "Not supported.", - "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." + "request": { + "$ref": "AccessConfig" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "USE_FIXED_PORT", - "USE_NAMED_PORT", - "USE_SERVING_PORT" - ] - }, - "grpcServiceName": { - "description": "The gRPC service name for the health check. This field is optional. The value of grpc_service_name has the following meanings by convention: - Empty service_name means the overall status of all services at the backend. - Non-empty service_name means the health of that gRPC service, as defined by the owner of the service. The grpc_service_name can only be ASCII.", - "type": "string" - } - } - }, - "HealthCheckLogConfig": { - "id": "HealthCheckLogConfig", - "description": "Configuration of logging on a health check. If logging is enabled, logs will be exported to Stackdriver.", - "type": "object", - "properties": { - "enable": { - "description": "Indicates whether or not to export logs. This is false by default, which means no health check logging will be done.", - "type": "boolean" - } - } - }, - "HealthChecksAggregatedList": { - "id": "HealthChecksAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#healthChecksAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of HealthChecksScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of HealthChecks.", - "$ref": "HealthChecksScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "description": "Updates the specified access config from an instance's network interface with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "updateNetworkInterface": { + "id": "compute.instances.updateNetworkInterface", + "path": "projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface", + "httpMethod": "PATCH", + "parameters": { + "instance": { + "description": "The instance name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "networkInterface": { + "description": "The name of the network interface to update.", + "location": "query", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "HealthChecksScopedList": { - "id": "HealthChecksScopedList", - "type": "object", - "properties": { - "healthChecks": { - "description": "A list of HealthChecks contained in this scope.", - "type": "array", - "items": { - "$ref": "HealthCheck" - } + }, + "parameterOrder": [ + "project", + "zone", + "instance", + "networkInterface" + ], + "request": { + "$ref": "NetworkInterface" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates an instance's network interface. This method can only update an interface's alias IP range and attached network. See Modifying alias IP ranges for an existing instance for instructions on changing alias IP ranges. See Migrating a VM between networks for instructions on migrating an interface. This method follows PATCH semantics." }, - "warning": { - "description": "Informational warning which replaces the list of backend services when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setScheduling": { + "id": "compute.instances.setScheduling", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setScheduling", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setScheduling", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Instance name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "HttpHealthCheckList": { - "id": "HttpHealthCheckList", - "description": "Contains a list of HttpHealthCheck resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#httpHealthCheckList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of HttpHealthCheck resources.", - "type": "array", - "items": { - "$ref": "HttpHealthCheck" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "Scheduling" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets an instance's scheduling options. You can only call this method on a stopped instance, that is, a VM instance that is in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states. For more information about setting scheduling options for a VM, see Set VM host maintenance policy." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getSerialPortOutput": { + "id": "compute.instances.getSerialPortOutput", + "path": "projects/{project}/zones/{zone}/instances/{instance}/serialPort", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/serialPort", + "httpMethod": "GET", + "parameters": { + "instance": { + "description": "Name of the instance for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "port": { + "description": "Specifies which COM or serial port to retrieve data from.", + "default": "1", + "minimum": "1", + "maximum": "4", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "start": { + "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console.", + "location": "query", + "type": "string", + "format": "int64" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "HttpHealthCheck": { - "id": "HttpHealthCheck", - "description": "Represents a legacy HTTP Health Check resource. Legacy HTTP health checks are now only required by target pool-based network load balancers. For all other load balancers, including backend service-based network load balancers, and for managed instance group auto-healing, you must use modern (non-legacy) health checks. For more information, see Health checks overview .", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#httpHealthCheck for HTTP health checks.", - "default": "compute#httpHealthCheck", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "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" - }, - "requestPath": { - "description": "The request path of the HTTP health check request. The default value is /. This field does not support query parameters. Must comply with RFC3986.", - "type": "string" - }, - "port": { - "description": "The TCP port number for the HTTP health check request. The default value is 80.", - "type": "integer", - "format": "int32" - }, - "checkIntervalSec": { - "description": "How often (in seconds) to send a health check. The default value is 5 seconds.", - "type": "integer", - "format": "int32" - }, - "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.", - "type": "integer", - "format": "int32" - }, - "unhealthyThreshold": { - "description": "A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.", - "type": "integer", - "format": "int32" - }, - "healthyThreshold": { - "description": "A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.", - "type": "integer", - "format": "int32" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - } - } - }, - "HttpsHealthCheckList": { - "id": "HttpsHealthCheckList", - "description": "Contains a list of HttpsHealthCheck resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#httpsHealthCheckList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of HttpsHealthCheck resources.", - "type": "array", - "items": { - "$ref": "HttpsHealthCheck" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "response": { + "$ref": "SerialPortOutput" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the last 1 MB of serial port output from the specified instance." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "getScreenshot": { + "id": "compute.instances.getScreenshot", + "path": "projects/{project}/zones/{zone}/instances/{instance}/screenshot", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/screenshot", + "httpMethod": "GET", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "response": { + "$ref": "Screenshot" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the screenshot from the specified instance." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "sendDiagnosticInterrupt": { + "id": "compute.instances.sendDiagnosticInterrupt", + "path": "projects/{project}/zones/{zone}/instances/{instance}/sendDiagnosticInterrupt", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/sendDiagnosticInterrupt", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sends diagnostic interrupt to the instance." + }, + "getGuestAttributes": { + "id": "compute.instances.getGuestAttributes", + "path": "projects/{project}/zones/{zone}/instances/{instance}/getGuestAttributes", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getGuestAttributes", + "httpMethod": "GET", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "queryPath": { + "description": "Specifies the guest attributes path to be queried.", + "location": "query", + "type": "string" + }, + "variableKey": { + "description": "Specifies the key for the guest attributes entry.", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "HttpsHealthCheck": { - "id": "HttpsHealthCheck", - "description": "Represents a legacy HTTPS Health Check resource. Legacy HTTPS health checks have been deprecated. If you are using a target pool-based network load balancer, you must use a legacy HTTP (not HTTPS) health check. For all other load balancers, including backend service-based network load balancers, and for managed instance group auto-healing, you must use modern (non-legacy) health checks. For more information, see Health checks overview .", - "type": "object", - "properties": { - "kind": { - "description": "Type of the resource.", - "default": "compute#httpsHealthCheck", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "host": { - "description": "The value of the host header in the HTTPS 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" - }, - "requestPath": { - "description": "The request path of the HTTPS health check request. The default value is \"/\". Must comply with RFC3986.", - "type": "string" - }, - "port": { - "description": "The TCP port number for the HTTPS health check request. The default value is 443.", - "type": "integer", - "format": "int32" - }, - "checkIntervalSec": { - "description": "How often (in seconds) to send a health check. The default value is 5 seconds.", - "type": "integer", - "format": "int32" - }, - "timeoutSec": { - "description": "How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have a greater value than checkIntervalSec.", - "type": "integer", - "format": "int32" - }, - "unhealthyThreshold": { - "description": "A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.", - "type": "integer", - "format": "int32" - }, - "healthyThreshold": { - "description": "A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.", - "type": "integer", - "format": "int32" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - } - } - }, - "InstanceTemplateList": { - "id": "InstanceTemplateList", - "description": "A list of instance templates.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#instanceTemplatesListResponse for instance template lists.", - "default": "compute#instanceTemplateList", - "type": "string" + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "response": { + "$ref": "GuestAttributes" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified guest attributes entry." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "attachDisk": { + "id": "compute.instances.attachDisk", + "path": "projects/{project}/zones/{zone}/instances/{instance}/attachDisk", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/attachDisk", + "httpMethod": "POST", + "parameters": { + "forceAttach": { + "description": "Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error.", + "location": "query", + "type": "boolean" + }, + "instance": { + "description": "The instance name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "AttachedDisk" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Attaches an existing Disk resource to an instance. You must first create the disk before you can attach it. It is not possible to create and attach a disk at the same time. For more information, read Adding a persistent disk to your instance." }, - "items": { - "description": "A list of InstanceTemplate resources.", - "type": "array", - "items": { - "$ref": "InstanceTemplate" - } + "detachDisk": { + "id": "compute.instances.detachDisk", + "path": "projects/{project}/zones/{zone}/instances/{instance}/detachDisk", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/detachDisk", + "httpMethod": "POST", + "parameters": { + "deviceName": { + "description": "The device name of the disk to detach. Make a get() request on the instance to view currently attached disks and device names.", + "location": "query", + "required": true, + "type": "string" + }, + "instance": { + "description": "Instance name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance", + "deviceName" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Detaches a disk from an instance." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "setMachineResources": { + "id": "compute.instances.setMachineResources", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setMachineResources", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMachineResources", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "InstancesSetMachineResourcesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the number and/or type of accelerator for a stopped instance to the values specified in the request." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "setMachineType": { + "id": "compute.instances.setMachineType", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setMachineType", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMachineType", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "InstancesSetMachineTypeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the machine type for a stopped instance to the machine type specified in the request." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setMetadata": { + "id": "compute.instances.setMetadata", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setMetadata", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMetadata", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "Metadata" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets metadata for the specified instance to the data included in the request." + }, + "setMinCpuPlatform": { + "id": "compute.instances.setMinCpuPlatform", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setMinCpuPlatform", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMinCpuPlatform", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "InstanceTemplate": { - "id": "InstanceTemplate", - "description": "Represents an Instance Template resource. Google Compute Engine has two Instance Template resources: * [Global](/compute/docs/reference/rest/v1/instanceTemplates) * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates) You can reuse a global instance template in different regions whereas you can use a regional instance template in a specified region only. If you want to reduce cross-region dependency or achieve data residency, use a regional instance template. To create VMs, managed instance groups, and reservations, you can use either global or regional instance templates. For more information, read Instance Templates.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#instanceTemplate for instance templates.", - "default": "compute#instanceTemplate", - "type": "string" - }, - "id": { - "description": "[Output Only] A unique identifier for this instance template. The server defines this identifier.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] The creation timestamp for this instance template in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.instanceTemplates.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "properties": { - "description": "The instance properties for this instance template.", - "$ref": "InstanceProperties" - }, - "selfLink": { - "description": "[Output Only] The URL for this instance template. The server defines this URL.", - "type": "string" - }, - "sourceInstance": { - "description": "The source instance used to create the template. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance ", - "type": "string" - }, - "sourceInstanceParams": { - "description": "The source instance params to use to create this instance template.", - "$ref": "SourceInstanceParams" - }, - "region": { - "description": "[Output Only] URL of the region where the instance template resides. Only applicable for regional resources.", - "type": "string" - } - } - }, - "SourceInstanceParams": { - "id": "SourceInstanceParams", - "description": "A specification of the parameters to use when creating the instance template from a source instance.", - "type": "object", - "properties": { - "diskConfigs": { - "description": "Attached disks configuration. If not provided, defaults are applied: For boot disk and any other R/W disks, the source images for each disk will be used. For read-only disks, they will be attached in read-only mode. Local SSD disks will be created as blank volumes.", - "type": "array", - "items": { - "$ref": "DiskInstantiationConfig" - } - } - } - }, - "DiskInstantiationConfig": { - "id": "DiskInstantiationConfig", - "description": "A specification of the desired way to instantiate a disk in the instance template when its created from a source instance.", - "type": "object", - "properties": { - "deviceName": { - "description": "Specifies the device name of the disk to which the configurations apply to.", - "type": "string" - }, - "instantiateFrom": { - "description": "Specifies whether to include the disk and what image to use. Possible values are: - source-image: to use the same image that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - source-image-family: to use the same image family that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - custom-image: to use a user-provided image url for disk creation. Applicable to the boot disk and additional read-write disks. - attach-read-only: to attach a read-only disk. Applicable to read-only disks. - do-not-include: to exclude a disk from the template. Applicable to additional read-write disks, local SSDs, and read-only disks. ", - "type": "string", - "enumDescriptions": [ - "Attach the existing disk in read-only mode. The request will fail if the disk was attached in read-write mode on the source instance. Applicable to: read-only disks.", - "Create a blank disk. The disk will be created unformatted. Applicable to: additional read-write disks, local SSDs.", - "Use the custom image specified in the custom_image field. Applicable to: boot disk, additional read-write disks.", - "Use the default instantiation option for the corresponding type of disk. For boot disk and any other R/W disks, new custom images will be created from each disk. For read-only disks, they will be attached in read-only mode. Local SSD disks will be created as blank volumes.", - "Do not include the disk in the instance template. Applicable to: additional read-write disks, local SSDs, read-only disks.", - "Use the same source image used for creation of the source instance's corresponding disk. The request will fail if the source VM's disk was created from a snapshot. Applicable to: boot disk, additional read-write disks.", - "Use the same source image family used for creation of the source instance's corresponding disk. The request will fail if the source image of the source disk does not belong to any image family. Applicable to: boot disk, additional read-write disks." + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "ATTACH_READ_ONLY", - "BLANK", - "CUSTOM_IMAGE", - "DEFAULT", - "DO_NOT_INCLUDE", - "SOURCE_IMAGE", - "SOURCE_IMAGE_FAMILY" - ] - }, - "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" - }, - "customImage": { - "description": "The custom source image to be used to restore this disk when instantiating this instance template.", - "type": "string" - } - } - }, - "InstanceTemplateAggregatedList": { - "id": "InstanceTemplateAggregatedList", - "description": "Contains a list of InstanceTemplatesScopedList.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#instanceTemplateAggregatedList", - "type": "string" + "request": { + "$ref": "InstancesSetMinCpuPlatformRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the minimum CPU platform that this instance should use. This method can only be called on a stopped instance. For more information, read Specifying a Minimum CPU Platform." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "setTags": { + "id": "compute.instances.setTags", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setTags", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setTags", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "Tags" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets network tags for the specified instance to the data included in the request." }, - "items": { - "description": "A list of InstanceTemplatesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "The name of the scope that contains this set of instance templates.", - "$ref": "InstanceTemplatesScopedList" - } + "setLabels": { + "id": "compute.instances.setLabels", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setLabels", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setLabels", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "InstancesSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets labels on an instance. To learn more about labels, read the Labeling Resources documentation." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "setName": { + "id": "compute.instances.setName", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setName", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setName", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "The instance name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "InstancesSetNameRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets name of an instance." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "setDiskAutoDelete": { + "id": "compute.instances.setDiskAutoDelete", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setDiskAutoDelete", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setDiskAutoDelete", + "httpMethod": "POST", + "parameters": { + "autoDelete": { + "description": "Whether to auto-delete the disk when the instance is deleted.", + "location": "query", + "required": true, + "type": "boolean" + }, + "deviceName": { + "description": "The device name of the disk to modify. Make a get() request on the instance to view currently attached disks and device names.", + "pattern": "\\w[\\w.-]{0,254}", + "location": "query", + "required": true, + "type": "string" + }, + "instance": { + "description": "The instance name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance", + "autoDelete", + "deviceName" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the auto-delete flag for a disk attached to an instance." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "start": { + "id": "compute.instances.start", + "path": "projects/{project}/zones/{zone}/instances/{instance}/start", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/start", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance resource to start.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "InstanceTemplatesScopedList": { - "id": "InstanceTemplatesScopedList", - "type": "object", - "properties": { - "instanceTemplates": { - "description": "[Output Only] A list of instance templates that are contained within the specified project and zone.", - "type": "array", - "items": { - "$ref": "InstanceTemplate" - } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance." }, - "warning": { - "description": "[Output Only] An informational warning that replaces the list of instance templates when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "startWithEncryptionKey": { + "id": "compute.instances.startWithEncryptionKey", + "path": "projects/{project}/zones/{zone}/instances/{instance}/startWithEncryptionKey", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/startWithEncryptionKey", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance resource to start.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "InstanceSettings": { - "id": "InstanceSettings", - "description": "Represents a Instance Settings resource. You can use instance settings to configure default settings for Compute Engine VM instances. For example, you can use it to configure default machine type of Compute Engine VM instances.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#instance_settings for instance settings.", - "default": "compute#instanceSettings", - "type": "string" - }, - "fingerprint": { - "description": "Specifies a fingerprint for instance settings, which is essentially a hash of the instance settings resource's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance settings resource. You must always provide an up-to-date fingerprint hash in order to update or change the resource, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource.", - "type": "string", - "format": "byte" - }, - "metadata": { - "description": "The metadata key/value pairs assigned to all the instances in the corresponding scope.", - "$ref": "InstanceSettingsMetadata" - }, - "zone": { - "description": "[Output Only] URL of the zone where the resource resides You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - } - } - }, - "InstanceSettingsMetadata": { - "id": "InstanceSettingsMetadata", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#metadata for metadata.", - "default": "compute#metadata", - "type": "string" - }, - "items": { - "description": "A metadata key/value items map. The total size of all keys and values must be less than 512KB.", - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } - }, - "InstantSnapshotList": { - "id": "InstantSnapshotList", - "description": "Contains a list of InstantSnapshot resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#instantSnapshotList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InstantSnapshot resources.", - "type": "array", - "items": { - "$ref": "InstantSnapshot" - } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "InstancesStartWithEncryptionKeyRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "stop": { + "id": "compute.instances.stop", + "path": "projects/{project}/zones/{zone}/instances/{instance}/stop", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/stop", + "httpMethod": "POST", + "parameters": { + "discardLocalSsd": { + "description": "This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded.", + "location": "query", + "type": "boolean" + }, + "instance": { + "description": "Name of the instance resource to stop.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Stops a running instance, shutting it down cleanly, and allows you to restart the instance at a later time. Stopped instances do not incur VM usage charges while they are stopped. However, resources that the VM is using, such as persistent disks and static IP addresses, will continue to be charged until they are deleted. For more information, see Stopping an instance." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "getIamPolicy": { + "id": "compute.instances.getIamPolicy", + "path": "projects/{project}/zones/{zone}/instances/{resource}/getIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setIamPolicy": { + "id": "compute.instances.setIamPolicy", + "path": "projects/{project}/zones/{zone}/instances/{resource}/setIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "InstantSnapshot": { - "id": "InstantSnapshot", - "description": "Represents a InstantSnapshot resource. You can use instant snapshots to create disk rollback points quickly..", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#instantSnapshot for InstantSnapshot resources.", - "default": "compute#instantSnapshot", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "status": { - "description": "[Output Only] The status of the instantSnapshot. This can be CREATING, DELETING, FAILED, or READY.", - "type": "string", - "enumDescriptions": [ - "InstantSnapshot creation is in progress.", - "InstantSnapshot is currently being deleted.", - "InstantSnapshot creation failed.", - "InstantSnapshot has been created successfully.", - "InstantSnapshot is currently unavailable and cannot be used for Disk restoration" + }, + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY", - "UNAVAILABLE" - ] - }, - "sourceDisk": { - "description": "URL of the source disk used to create this instant snapshot. Note that the source disk must be in the same zone/region as the instant snapshot to be created. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk ", - "type": "string" - }, - "sourceDiskId": { - "description": "[Output Only] The ID value of the disk used to create this InstantSnapshot. This value may be used to determine whether the InstantSnapshot was taken from the current or a previous instance of a given disk name.", - "type": "string" - }, - "diskSizeGb": { - "description": "[Output Only] Size of the source disk, specified in GB.", - "type": "string", - "format": "int64" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource's resource id.", - "type": "string" - }, - "labels": { - "description": "Labels to apply to this InstantSnapshot. These can be later modified by the setLabels method. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this InstantSnapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a InstantSnapshot.", - "type": "string", - "format": "byte" - }, - "zone": { - "description": "[Output Only] URL of the zone where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - }, - "architecture": { - "description": "[Output Only] The architecture of the instant snapshot. Valid values are ARM64 or X86_64.", - "type": "string", - "enumDescriptions": [ - "Default value indicating Architecture is not set.", - "Machines with architecture ARM64", - "Machines with architecture X86_64" + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" - ] - }, - "resourceStatus": { - "description": "[Output Only] Status information for the instant snapshot resource.", - "$ref": "InstantSnapshotResourceStatus" - }, - "satisfiesPzi": { - "description": "Output only. Reserved for future use.", - "readOnly": true, - "type": "boolean" - } - } - }, - "InstantSnapshotResourceStatus": { - "id": "InstantSnapshotResourceStatus", - "type": "object", - "properties": { - "storageSizeBytes": { - "description": "[Output Only] The storage size of this instant snapshot.", - "type": "string", - "format": "int64" - } - } - }, - "InstantSnapshotAggregatedList": { - "id": "InstantSnapshotAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#instantSnapshotAggregatedList for aggregated lists of instantSnapshots.", - "default": "compute#instantSnapshotAggregatedList", - "type": "string" + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "testIamPermissions": { + "id": "compute.instances.testIamPermissions", + "path": "projects/{project}/zones/{zone}/instances/{resource}/testIamPermissions", + "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." }, - "items": { - "description": "A list of InstantSnapshotsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of instantSnapshots.", - "$ref": "InstantSnapshotsScopedList" - } + "setServiceAccount": { + "id": "compute.instances.setServiceAccount", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setServiceAccount", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setServiceAccount", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance resource to start.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "InstancesSetServiceAccountRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the service account on the instance. For more information, read Changing the service account and access scopes for an instance." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "setDeletionProtection": { + "id": "compute.instances.setDeletionProtection", + "path": "projects/{project}/zones/{zone}/instances/{resource}/setDeletionProtection", + "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/setDeletionProtection", + "httpMethod": "POST", + "parameters": { + "deletionProtection": { + "description": "Whether the resource should be protected against deletion.", + "default": "true", + "location": "query", + "type": "boolean" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets deletion protection on the instance." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "suspend": { + "id": "compute.instances.suspend", + "path": "projects/{project}/zones/{zone}/instances/{instance}/suspend", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/suspend", + "httpMethod": "POST", + "parameters": { + "discardLocalSsd": { + "description": "This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded.", + "location": "query", + "type": "boolean" + }, + "instance": { + "description": "Name of the instance resource to suspend.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "This method suspends a running instance, saving its state to persistent storage, and allows you to resume the instance at a later time. Suspended instances have no compute costs (cores or RAM), and incur only storage charges for the saved VM memory and localSSD data. Any charged resources the virtual machine was using, such as persistent disks and static IP addresses, will continue to be charged while the instance is suspended. For more information, see Suspending and resuming an instance." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "resume": { + "id": "compute.instances.resume", + "path": "projects/{project}/zones/{zone}/instances/{instance}/resume", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/resume", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the instance resource to resume.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Resumes an instance that was suspended using the instances().suspend method." + }, + "addResourcePolicies": { + "id": "compute.instances.addResourcePolicies", + "path": "projects/{project}/zones/{zone}/instances/{instance}/addResourcePolicies", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addResourcePolicies", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "The instance name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "InstancesAddResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Adds existing resource policies to an instance. You can only add one policy right now which will be applied to this instance for scheduling live migrations." }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InstantSnapshotsScopedList": { - "id": "InstantSnapshotsScopedList", - "type": "object", - "properties": { - "instantSnapshots": { - "description": "[Output Only] A list of instantSnapshots contained in this scope.", - "type": "array", - "items": { - "$ref": "InstantSnapshot" - } + "removeResourcePolicies": { + "id": "compute.instances.removeResourcePolicies", + "path": "projects/{project}/zones/{zone}/instances/{instance}/removeResourcePolicies", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/removeResourcePolicies", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "The instance name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "InstancesRemoveResourcePoliciesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Removes resource policies from an instance." }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of instantSnapshots when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "update": { + "id": "compute.instances.update", + "path": "projects/{project}/zones/{zone}/instances/{instance}", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}", + "httpMethod": "PUT", + "parameters": { + "instance": { + "description": "Name of the instance resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "minimalAction": { + "description": "Specifies the action to take when updating an instance even if the updated properties do not require it. If not specified, then Compute Engine acts based on the minimum action that the updated properties require.", + "location": "query", "type": "string", "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false + "", + "No changes can be made to the instance.", + "The instance will not restart.", + "The instance will restart." ], "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" + "INVALID", + "NO_EFFECT", + "REFRESH", + "RESTART" ] }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "InterconnectAttachmentList": { - "id": "InterconnectAttachmentList", - "description": "Response to the list request, and contains a list of interconnect attachments.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#interconnectAttachmentList for lists of interconnect attachments.", - "default": "compute#interconnectAttachmentList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InterconnectAttachment resources.", - "type": "array", - "items": { - "$ref": "InterconnectAttachment" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "mostDisruptiveAllowedAction": { + "description": "Specifies the most disruptive action that can be taken on the instance as part of the update. Compute Engine returns an error if the instance properties require a more disruptive action as part of the instance update. Valid options from lowest to highest are NO_EFFECT, REFRESH, and RESTART.", + "location": "query", "type": "string", "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false + "", + "No changes can be made to the instance.", + "The instance will not restart.", + "The instance will restart." ], "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" + "INVALID", + "NO_EFFECT", + "REFRESH", + "RESTART" ] }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "Instance" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates an instance only if the necessary resources are available. This method can update only a specific set of instance properties. See Updating a running instance for a list of updatable instance properties." + }, + "updateShieldedInstanceConfig": { + "id": "compute.instances.updateShieldedInstanceConfig", + "path": "projects/{project}/zones/{zone}/instances/{instance}/updateShieldedInstanceConfig", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateShieldedInstanceConfig", + "httpMethod": "PATCH", + "parameters": { + "instance": { + "description": "Name or id of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" + ], + "request": { + "$ref": "ShieldedInstanceConfig" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the Shielded Instance config for an instance. You can only use this method on a stopped instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + }, + "updateDisplayDevice": { + "id": "compute.instances.updateDisplayDevice", + "path": "projects/{project}/zones/{zone}/instances/{instance}/updateDisplayDevice", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateDisplayDevice", + "httpMethod": "PATCH", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "InterconnectAttachment": { - "id": "InterconnectAttachment", - "description": "Represents an Interconnect Attachment (VLAN) resource. You can use Interconnect attachments (VLANS) to connect your Virtual Private Cloud networks to your on-premises networks through an Interconnect. For more information, read Creating VLAN Attachments.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#interconnectAttachment for interconnect attachments.", - "default": "compute#interconnectAttachment", - "type": "string" - }, - "description": { - "description": "An optional description of this resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "interconnect": { - "description": "URL of the underlying Interconnect object that this attachment's traffic will traverse through.", - "type": "string" - }, - "router": { - "description": "URL of the Cloud Router to be used for dynamic routing. This router must be in the same region as this InterconnectAttachment. The InterconnectAttachment will automatically connect the Interconnect to the network & region within which the Cloud Router is configured.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the regional interconnect attachment resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "googleReferenceId": { - "description": "[Output Only] Google reference ID, to be used when raising support tickets with Google or otherwise to debug backend connectivity issues. [Deprecated] This field is not used.", - "deprecated": true, - "type": "string" - }, - "mtu": { - "description": "Maximum Transmission Unit (MTU), in bytes, of packets passing through this interconnect attachment. Only 1440 and 1500 are allowed. If not specified, the value will default to 1440.", - "type": "integer", - "format": "int32" - }, - "privateInterconnectInfo": { - "description": "[Output Only] Information specific to an InterconnectAttachment. This property is populated if the interconnect that this is attached to is of type DEDICATED.", - "$ref": "InterconnectAttachmentPrivateInfo" - }, - "operationalStatus": { - "description": "[Output Only] The current status of whether or not this interconnect attachment is functional, which can take one of the following values: - OS_ACTIVE: The attachment has been turned up and is ready to use. - OS_UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. ", - "type": "string", - "enumDescriptions": [ - "Indicates that attachment has been turned up and is ready to use.", - "Indicates that attachment is not ready to use yet, because turnup is not complete." + }, + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "OS_ACTIVE", - "OS_UNPROVISIONED" - ] - }, - "cloudRouterIpAddress": { - "description": "[Output Only] IPv4 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment.", - "type": "string" - }, - "customerRouterIpAddress": { - "description": "[Output Only] IPv4 address + prefix length to be configured on the customer router subinterface for this interconnect attachment.", - "type": "string" - }, - "type": { - "description": "The type of interconnect attachment this is, which can take one of the following values: - DEDICATED: an attachment to a Dedicated Interconnect. - PARTNER: an attachment to a Partner Interconnect, created by the customer. - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by the partner. ", - "type": "string", - "enumDescriptions": [ - "Attachment to a dedicated interconnect.", - "Attachment to a partner interconnect, created by the customer.", - "Attachment to a partner interconnect, created by the partner." + "request": { + "$ref": "DisplayDevice" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "DEDICATED", - "PARTNER", - "PARTNER_PROVIDER" - ] - }, - "pairingKey": { - "description": "[Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not present for DEDICATED]. The opaque identifier of a PARTNER attachment used to initiate provisioning with a selected partner. Of the form \"XXXXX/region/domain\"", - "type": "string" - }, - "adminEnabled": { - "description": "Determines whether this Attachment will carry packets. Not present for PARTNER_PROVIDER.", - "type": "boolean" - }, - "vlanTag8021q": { - "description": "The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. Only specified at creation time.", - "type": "integer", - "format": "int32" + "description": "Updates the Display config for a VM instance. You can only use this method on a stopped VM instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." }, - "edgeAvailabilityDomain": { - "description": "Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "setShieldedInstanceIntegrityPolicy": { + "id": "compute.instances.setShieldedInstanceIntegrityPolicy", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setShieldedInstanceIntegrityPolicy", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setShieldedInstanceIntegrityPolicy", + "httpMethod": "PATCH", + "parameters": { + "instance": { + "description": "Name or id of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "AVAILABILITY_DOMAIN_1", - "AVAILABILITY_DOMAIN_2", - "AVAILABILITY_DOMAIN_ANY" - ] - }, - "candidateSubnets": { - "description": "Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space.", - "type": "array", - "items": { - "type": "string" - } - }, - "bandwidth": { - "description": "Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s ", - "type": "string", - "enumDescriptions": [ - "100 Mbit/s", - "10 Gbit/s", - "1 Gbit/s", - "200 Mbit/s", - "20 Gbit/s", - "2 Gbit/s", - "300 Mbit/s", - "400 Mbit/s", - "500 Mbit/s", - "50 Gbit/s", - "50 Mbit/s", - "5 Gbit/s" + "request": { + "$ref": "ShieldedInstanceIntegrityPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "BPS_100M", - "BPS_10G", - "BPS_1G", - "BPS_200M", - "BPS_20G", - "BPS_2G", - "BPS_300M", - "BPS_400M", - "BPS_500M", - "BPS_50G", - "BPS_50M", - "BPS_5G" - ] - }, - "partnerMetadata": { - "description": "Informational metadata about Partner attachments from Partners to display to customers. Output only for PARTNER type, mutable for PARTNER_PROVIDER, not available for DEDICATED.", - "$ref": "InterconnectAttachmentPartnerMetadata" - }, - "labels": { - "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this InterconnectAttachment, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InterconnectAttachment.", - "type": "string", - "format": "byte" + "description": "Sets the Shielded Instance integrity policy for an instance. You can only use this method on a running instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." }, - "state": { - "description": "[Output Only] The current state of this attachment's functionality. Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used for only PARTNER and PARTNER_PROVIDER interconnect attachments. This state can take one of the following values: - ACTIVE: The attachment has been turned up and is ready to use. - UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet been configured on the Partner side. - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of provisioning after a PARTNER_PROVIDER attachment was created that references it. - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER attachment that is waiting for a customer to activate it. - DEFUNCT: The attachment was deleted externally and is no longer functional. This could be because the associated Interconnect was removed, or because the other side of a Partner attachment was deleted. ", - "type": "string", - "enumDescriptions": [ - "Indicates that attachment has been turned up and is ready to use.", - "The attachment was deleted externally and is no longer functional. This could be because the associated Interconnect was wiped out, or because the other side of a Partner attachment was deleted.", - "A PARTNER attachment is in the process of provisioning after a PARTNER_PROVIDER attachment was created that references it.", - "PARTNER or PARTNER_PROVIDER attachment that is waiting for the customer to activate.", - "A newly created PARTNER attachment that has not yet been configured on the Partner side.", - "", - "Indicates that attachment is not ready to use yet, because turnup is not complete." + "setSecurityPolicy": { + "id": "compute.instances.setSecurityPolicy", + "path": "projects/{project}/zones/{zone}/instances/{instance}/setSecurityPolicy", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setSecurityPolicy", + "httpMethod": "POST", + "parameters": { + "instance": { + "description": "Name of the Instance resource to which the security policy should be set. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "ACTIVE", - "DEFUNCT", - "PARTNER_REQUEST_RECEIVED", - "PENDING_CUSTOMER", - "PENDING_PARTNER", - "STATE_UNSPECIFIED", - "UNPROVISIONED" - ] - }, - "partnerAsn": { - "description": "Optional BGP ASN for the router supplied by a Layer 3 Partner if they configured BGP on behalf of the customer. Output only for PARTNER type, input only for PARTNER_PROVIDER, not available for DEDICATED.", - "type": "string", - "format": "int64" - }, - "encryption": { - "description": "Indicates the user-supplied encryption option of this VLAN attachment (interconnectAttachment). Can only be specified at attachment creation for PARTNER or DEDICATED attachments. Possible values are: - NONE - This is the default value, which means that the VLAN attachment carries unencrypted traffic. VMs are able to send traffic to, or receive traffic from, such a VLAN attachment. - IPSEC - The VLAN attachment carries only encrypted traffic that is encrypted by an IPsec device, such as an HA VPN gateway or third-party IPsec VPN. VMs cannot directly send traffic to, or receive traffic from, such a VLAN attachment. To use *HA VPN over Cloud Interconnect*, the VLAN attachment must be created with this option. ", - "type": "string", - "enumDescriptions": [ - "The interconnect attachment will carry only encrypted traffic that is encrypted by an IPsec device such as HA VPN gateway; VMs cannot directly send traffic to or receive traffic from such an interconnect attachment. To use HA VPN over Cloud Interconnect, the interconnect attachment must be created with this option.", - "This is the default value, which means the Interconnect Attachment will carry unencrypted traffic. VMs will be able to send traffic to or receive traffic from such interconnect attachment." + "request": { + "$ref": "InstancesSetSecurityPolicyRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "IPSEC", - "NONE" - ] - }, - "ipsecInternalAddresses": { - "description": "A list of URLs of addresses that have been reserved for the VLAN attachment. Used only for the VLAN attachment that has the encryption option as IPSEC. The addresses must be regional internal IP address ranges. When creating an HA VPN gateway over the VLAN attachment, if the attachment is configured to use a regional internal IP address, then the VPN gateway's IP address is allocated from the IP address range specified here. For example, if the HA VPN gateway's interface 0 is paired to this VLAN attachment, then a regional internal IP address for the VPN gateway interface 0 will be allocated from the IP address specified for this VLAN attachment. If this field is not specified when creating the VLAN attachment, then later on when creating an HA VPN gateway on this VLAN attachment, the HA VPN gateway's IP address is allocated from the regional external IP address pool.", - "type": "array", - "items": { - "type": "string" - } - }, - "dataplaneVersion": { - "description": "[Output Only] Dataplane version for this InterconnectAttachment. This field is only present for Dataplane version 2 and higher. Absence of this field in the API output indicates that the Dataplane is version 1.", - "type": "integer", - "format": "int32" - }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" + "description": "Sets the Google Cloud Armor security policy for the specified instance. For more information, see Google Cloud Armor Overview" }, - "stackType": { - "description": "The stack type for this interconnect attachment to identify whether the IPv6 feature is enabled or not. If not specified, IPV4_ONLY will be used. This field can be both set at interconnect attachments creation and update interconnect attachment operations.", - "type": "string", - "enumDescriptions": [ - "The interconnect attachment can have both IPv4 and IPv6 addresses.", - "The interconnect attachment will only be assigned IPv4 addresses." + "getShieldedInstanceIdentity": { + "id": "compute.instances.getShieldedInstanceIdentity", + "path": "projects/{project}/zones/{zone}/instances/{instance}/getShieldedInstanceIdentity", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getShieldedInstanceIdentity", + "httpMethod": "GET", + "parameters": { + "instance": { + "description": "Name or id of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance" ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY" - ] - }, - "cloudRouterIpv6Address": { - "description": "[Output Only] IPv6 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment.", - "type": "string" - }, - "customerRouterIpv6Address": { - "description": "[Output Only] IPv6 address + prefix length to be configured on the customer router subinterface for this interconnect attachment.", - "type": "string" - }, - "candidateIpv6Subnets": { - "description": "This field is not available.", - "type": "array", - "items": { - "type": "string" - } - }, - "cloudRouterIpv6InterfaceId": { - "description": "This field is not available.", - "type": "string" - }, - "customerRouterIpv6InterfaceId": { - "description": "This field is not available.", - "type": "string" - }, - "subnetLength": { - "description": "Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. ", - "type": "integer", - "format": "int32" - }, - "remoteService": { - "description": "[Output Only] If the attachment is on a Cross-Cloud Interconnect connection, this field contains the interconnect's remote location service provider. Example values: \"Amazon Web Services\" \"Microsoft Azure\". The field is set only for attachments on Cross-Cloud Interconnect connections. Its value is copied from the InterconnectRemoteLocation remoteService field.", - "type": "string" - }, - "configurationConstraints": { - "description": "[Output Only] Constraints for this attachment, if any. The attachment does not work if these constraints are not met.", - "$ref": "InterconnectAttachmentConfigurationConstraints" - } - } - }, - "InterconnectAttachmentPrivateInfo": { - "id": "InterconnectAttachmentPrivateInfo", - "description": "Information for an interconnect attachment when this belongs to an interconnect of type DEDICATED.", - "type": "object", - "properties": { - "tag8021q": { - "description": "[Output Only] 802.1q encapsulation tag to be used for traffic between Google and the customer, going to and from this network and region.", - "type": "integer", - "format": "uint32" - } - } - }, - "InterconnectAttachmentPartnerMetadata": { - "id": "InterconnectAttachmentPartnerMetadata", - "description": "Informational metadata about Partner attachments from Partners to display to customers. These fields are propagated from PARTNER_PROVIDER attachments to their corresponding PARTNER attachments.", - "type": "object", - "properties": { - "partnerName": { - "description": "Plain text name of the Partner providing this attachment. This value may be validated to match approved Partner values.", - "type": "string" - }, - "interconnectName": { - "description": "Plain text name of the Interconnect this attachment is connected to, as displayed in the Partner's portal. For instance \"Chicago 1\". This value may be validated to match approved Partner values.", - "type": "string" - }, - "portalUrl": { - "description": "URL of the Partner's portal for this Attachment. Partners may customise this to be a deep link to the specific resource on the Partner portal. This value may be validated to match approved Partner values.", - "type": "string" - } - } - }, - "InterconnectAttachmentConfigurationConstraints": { - "id": "InterconnectAttachmentConfigurationConstraints", - "type": "object", - "properties": { - "bgpMd5": { - "description": "[Output Only] Whether the attachment's BGP session requires/allows/disallows BGP MD5 authentication. This can take one of the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. For example, a Cross-Cloud Interconnect connection to a remote cloud provider that requires BGP MD5 authentication has the interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 field set to MD5_REQUIRED, and that property is propagated to the attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is returned if MD5 is requested.", - "type": "string", - "enumDescriptions": [ - "MD5_OPTIONAL: BGP MD5 authentication is supported and can optionally be configured.", - "MD5_REQUIRED: BGP MD5 authentication must be configured.", - "MD5_UNSUPPORTED: BGP MD5 authentication must not be configured" + "response": { + "$ref": "ShieldedInstanceIdentity" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "MD5_OPTIONAL", - "MD5_REQUIRED", - "MD5_UNSUPPORTED" - ] + "description": "Returns the Shielded Instance Identity of an instance" }, - "bgpPeerAsnRanges": { - "description": "[Output Only] List of ASN ranges that the remote location is known to support. Formatted as an array of inclusive ranges {min: min-value, max: max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] allows the peer ASN to be 123 or anything in the range 64512-65534. This field is only advisory. Although the API accepts other ranges, these are the ranges that we recommend.", - "type": "array", - "items": { - "$ref": "InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange" - } + "bulkInsert": { + "id": "compute.instances.bulkInsert", + "path": "projects/{project}/zones/{zone}/instances/bulkInsert", + "flatPath": "projects/{project}/zones/{zone}/instances/bulkInsert", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { + "$ref": "BulkInsertInstanceResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates multiple instances. Count specifies the number of instances to create. For more information, see About bulk creation of VMs." + }, + "getEffectiveFirewalls": { + "id": "compute.instances.getEffectiveFirewalls", + "path": "projects/{project}/zones/{zone}/instances/{instance}/getEffectiveFirewalls", + "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getEffectiveFirewalls", + "httpMethod": "GET", + "parameters": { + "instance": { + "description": "Name of the instance scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "networkInterface": { + "description": "The name of the network interface to get the effective firewalls.", + "location": "query", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instance", + "networkInterface" + ], + "response": { + "$ref": "InstancesGetEffectiveFirewallsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns effective firewalls applied to an interface of the instance." } } }, - "InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange": { - "id": "InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange", - "type": "object", - "properties": { - "min": { - "type": "integer", - "format": "uint32" - }, - "max": { - "type": "integer", - "format": "uint32" + "regionInstances": { + "methods": { + "bulkInsert": { + "id": "compute.regionInstances.bulkInsert", + "path": "projects/{project}/regions/{region}/instances/bulkInsert", + "flatPath": "projects/{project}/regions/{region}/instances/bulkInsert", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "BulkInsertInstanceResource" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates multiple instances in a given region. Count specifies the number of instances to create." } } }, - "InterconnectAttachmentAggregatedList": { - "id": "InterconnectAttachmentAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#interconnectAttachmentAggregatedList for aggregated lists of interconnect attachments.", - "default": "compute#interconnectAttachmentAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "reservations": { + "methods": { + "list": { + "id": "compute.reservations.list", + "path": "projects/{project}/zones/{zone}/reservations", + "flatPath": "projects/{project}/zones/{zone}/reservations", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "ReservationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "A list of all the reservations that have been configured for the specified project in specified zone." }, - "items": { - "description": "A list of InterconnectAttachmentsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of interconnect attachments.", - "$ref": "InterconnectAttachmentsScopedList" - } + "aggregatedList": { + "id": "compute.reservations.aggregatedList", + "path": "projects/{project}/aggregated/reservations", + "flatPath": "projects/{project}/aggregated/reservations", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "ReservationAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of reservations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "get": { + "id": "compute.reservations.get", + "path": "projects/{project}/zones/{zone}/reservations/{reservation}", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "reservation": { + "description": "Name of the reservation to retrieve.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "reservation" + ], + "response": { + "$ref": "Reservation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves information about the specified reservation." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "insert": { + "id": "compute.reservations.insert", + "path": "projects/{project}/zones/{zone}/reservations", + "flatPath": "projects/{project}/zones/{zone}/reservations", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { + "$ref": "Reservation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a new reservation. For more information, read Reserving zonal resources." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "id": "compute.reservations.delete", + "path": "projects/{project}/zones/{zone}/reservations/{reservation}", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "reservation": { + "description": "Name of the reservation to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "InterconnectAttachmentsScopedList": { - "id": "InterconnectAttachmentsScopedList", - "type": "object", - "properties": { - "interconnectAttachments": { - "description": "A list of interconnect attachments contained in this scope.", - "type": "array", - "items": { - "$ref": "InterconnectAttachment" - } + }, + "parameterOrder": [ + "project", + "zone", + "reservation" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified reservation." }, - "warning": { - "description": "Informational warning which replaces the list of addresses when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "resize": { + "id": "compute.reservations.resize", + "path": "projects/{project}/zones/{zone}/reservations/{reservation}/resize", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/resize", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "reservation": { + "description": "Name of the reservation to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "Interconnect": { - "id": "Interconnect", - "description": "Represents an Interconnect resource. An Interconnect resource is a dedicated connection between the Google Cloud network and your on-premises network. For more information, read the Dedicated Interconnect Overview.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#interconnect for interconnects.", - "default": "compute#interconnect", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.interconnects.insert" - ] }, - "type": "string" - }, - "location": { - "description": "URL of the InterconnectLocation object that represents where this connection is to be provisioned.", - "type": "string" - }, - "linkType": { - "description": "Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle.", - "type": "string", - "enumDescriptions": [ - "100G Ethernet, LR Optics.", - "10G Ethernet, LR Optics. [(rate_bps) = 10000000000];" + "parameterOrder": [ + "project", + "zone", + "reservation" ], - "enum": [ - "LINK_TYPE_ETHERNET_100G_LR", - "LINK_TYPE_ETHERNET_10G_LR" - ] - }, - "requestedLinkCount": { - "description": "Target number of physical links in the link bundle, as requested by the customer.", - "type": "integer", - "format": "int32" - }, - "interconnectType": { - "description": "Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED.", - "type": "string", - "enumDescriptions": [ - "A dedicated physical interconnection with the customer.", - "[Deprecated] A private, physical interconnection with the customer.", - "A partner-managed interconnection shared between customers via partner." + "request": { + "$ref": "ReservationsResizeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "DEDICATED", - "IT_PRIVATE", - "PARTNER" - ] - }, - "adminEnabled": { - "description": "Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true.", - "type": "boolean" - }, - "nocContactEmail": { - "description": "Email address to contact the customer NOC for operations and maintenance notifications regarding this Interconnect. If specified, this will be used for notifications in addition to all other forms described, such as Cloud Monitoring logs alerting and Cloud Notifications. This field is required for users who sign up for Cloud Interconnect using workforce identity federation.", - "type": "string" - }, - "customerName": { - "description": "Customer name, to put in the Letter of Authorization as the party authorized to request a crossconnect.", - "type": "string" + "description": "Resizes the reservation (applicable to standalone reservations only). For more information, read Modifying reservations." }, - "operationalStatus": { - "description": "[Output Only] The current status of this Interconnect's functionality, which can take one of the following values: - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to use. Attachments may be provisioned on this Interconnect. - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No attachments may be provisioned on this Interconnect. - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. ", - "type": "string", - "enumDescriptions": [ - "The interconnect is valid, turned up, and ready to use. Attachments may be provisioned on this interconnect.", - "The interconnect has not completed turnup. No attachments may be provisioned on this interconnect." + "update": { + "id": "compute.reservations.update", + "path": "projects/{project}/zones/{zone}/reservations/{reservation}", + "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", + "httpMethod": "PATCH", + "parameters": { + "paths": { + "location": "query", + "repeated": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "reservation": { + "description": "Name of the reservation to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "Update_mask indicates fields to be updated as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "reservation" ], - "enum": [ - "OS_ACTIVE", - "OS_UNPROVISIONED" - ] - }, - "provisionedLinkCount": { - "description": "[Output Only] Number of links actually provisioned in this interconnect.", - "type": "integer", - "format": "int32" - }, - "interconnectAttachments": { - "description": "[Output Only] A list of the URLs of all InterconnectAttachments configured to use this Interconnect.", - "type": "array", - "items": { - "type": "string" - } - }, - "peerIpAddress": { - "description": "[Output Only] IP address configured on the customer side of the Interconnect link. The customer should configure this IP address during turnup when prompted by Google NOC. This can be used only for ping tests.", - "type": "string" - }, - "googleIpAddress": { - "description": "[Output Only] IP address configured on the Google side of the Interconnect link. This can be used only for ping tests.", - "type": "string" - }, - "googleReferenceId": { - "description": "[Output Only] Google reference ID to be used when raising support tickets with Google or otherwise to debug backend connectivity issues.", - "type": "string" - }, - "expectedOutages": { - "description": "[Output Only] A list of outages expected for this Interconnect.", - "type": "array", - "items": { - "$ref": "InterconnectOutageNotification" - } - }, - "circuitInfos": { - "description": "[Output Only] A list of CircuitInfo objects, that describe the individual circuits in this LAG.", - "type": "array", - "items": { - "$ref": "InterconnectCircuitInfo" - } - }, - "labels": { - "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this Interconnect, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Interconnect.", - "type": "string", - "format": "byte" - }, - "state": { - "description": "[Output Only] The current state of Interconnect functionality, which can take one of the following values: - ACTIVE: The Interconnect is valid, turned up and ready to use. Attachments may be provisioned on this Interconnect. - UNPROVISIONED: The Interconnect has not completed turnup. No attachments may be provisioned on this Interconnect. - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. ", - "type": "string", - "enumDescriptions": [ - "The interconnect is valid, turned up, and ready to use. Attachments may be provisioned on this interconnect.", - "The interconnect has not completed turnup. No attachments may be provisioned on this interconnect." + "request": { + "$ref": "Reservation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "ACTIVE", - "UNPROVISIONED" - ] - }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - }, - "macsec": { - "description": "Configuration that enables Media Access Control security (MACsec) on the Cloud Interconnect connection between Google and your on-premises router.", - "$ref": "InterconnectMacsec" - }, - "macsecEnabled": { - "description": "Enable or disable MACsec on this Interconnect connection. MACsec enablement fails if the MACsec object is not specified.", - "type": "boolean" - }, - "remoteLocation": { - "description": "Indicates that this is a Cross-Cloud Interconnect. This field specifies the location outside of Google's network that the interconnect is connected to.", - "type": "string" - }, - "requestedFeatures": { - "description": "Optional. List of features requested for this Interconnect connection, which can take one of the following values: - MACSEC If specified then the connection is created on MACsec capable hardware ports. If not specified, the default value is false, which allocates non-MACsec capable ports first if available. This parameter can be provided only with Interconnect INSERT. It isn't valid for Interconnect PATCH.", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "Media Access Control security (MACsec)" - ], - "enum": [ - "IF_MACSEC" - ] - } - }, - "availableFeatures": { - "description": "[Output only] List of features available for this Interconnect connection, which can take one of the following values: - MACSEC If present then the Interconnect connection is provisioned on MACsec capable hardware ports. If not present then the Interconnect connection is provisioned on non-MACsec capable ports and MACsec isn't supported and enabling MACsec fails.", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "Media Access Control security (MACsec)" - ], - "enum": [ - "IF_MACSEC" - ] - } - } - } - }, - "InterconnectOutageNotification": { - "id": "InterconnectOutageNotification", - "description": "Description of a planned outage on this Interconnect.", - "type": "object", - "properties": { - "name": { - "description": "Unique identifier for this outage notification.", - "type": "string" - }, - "description": { - "description": "A description about the purpose of the outage.", - "type": "string" + "description": "Update share settings of the reservation." }, - "source": { - "description": "The party that generated this notification, which can take the following value: - GOOGLE: this notification as generated by Google. Note that the value of NSRC_GOOGLE has been deprecated in favor of GOOGLE.", - "type": "string", - "enumDescriptions": [ - "This notification was generated by Google.", - "[Deprecated] This notification was generated by Google." + "getIamPolicy": { + "id": "compute.reservations.getIamPolicy", + "path": "projects/{project}/zones/{zone}/reservations/{resource}/getIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "GOOGLE", - "NSRC_GOOGLE" - ] - }, - "state": { - "description": "State of this notification, which can take one of the following values: - ACTIVE: This outage notification is active. The event could be in the past, present, or future. See start_time and end_time for scheduling. - CANCELLED: The outage associated with this notification was cancelled before the outage was due to start. - COMPLETED: The outage associated with this notification is complete. Note that the versions of this enum prefixed with \"NS_\" have been deprecated in favor of the unprefixed values.", - "type": "string", - "enumDescriptions": [ - "This outage notification is active. The event could be in the future, present, or past. See start_time and end_time for scheduling.", - "The outage associated with this notification was cancelled before the outage was due to start.", - "The outage associated with this notification is complete.", - "[Deprecated] This outage notification is active. The event could be in the future, present, or past. See start_time and end_time for scheduling.", - "[Deprecated] The outage associated with this notification was canceled before the outage was due to start." + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ACTIVE", - "CANCELLED", - "COMPLETED", - "NS_ACTIVE", - "NS_CANCELED" - ] + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "issueType": { - "description": "Form this outage is expected to take, which can take one of the following values: - OUTAGE: The Interconnect may be completely out of service for some or all of the specified window. - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole should remain up, but with reduced bandwidth. Note that the versions of this enum prefixed with \"IT_\" have been deprecated in favor of the unprefixed values.", - "type": "string", - "enumDescriptions": [ - "[Deprecated] The Interconnect may be completely out of service for some or all of the specified window.", - "[Deprecated] Some circuits comprising the Interconnect will be out of service during the expected window. The interconnect as a whole should remain up, albeit with reduced bandwidth.", - "The Interconnect may be completely out of service for some or all of the specified window.", - "Some circuits comprising the Interconnect will be out of service during the expected window. The interconnect as a whole should remain up, albeit with reduced bandwidth." + "setIamPolicy": { + "id": "compute.reservations.setIamPolicy", + "path": "projects/{project}/zones/{zone}/reservations/{resource}/setIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "IT_OUTAGE", - "IT_PARTIAL_OUTAGE", - "OUTAGE", - "PARTIAL_OUTAGE" - ] - }, - "affectedCircuits": { - "description": "If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit IDs that will be affected.", - "type": "array", - "items": { - "type": "string" - } - }, - "startTime": { - "description": "Scheduled start time for the outage (milliseconds since Unix epoch).", - "type": "string", - "format": "int64" - }, - "endTime": { - "description": "Scheduled end time for the outage (milliseconds since Unix epoch).", - "type": "string", - "format": "int64" - } - } - }, - "InterconnectCircuitInfo": { - "id": "InterconnectCircuitInfo", - "description": "Describes a single physical circuit between the Customer and Google. CircuitInfo objects are created by Google, so all fields are output only.", - "type": "object", - "properties": { - "googleCircuitId": { - "description": "Google-assigned unique ID for this circuit. Assigned at circuit turn-up.", - "type": "string" - }, - "googleDemarcId": { - "description": "Google-side demarc ID for this circuit. Assigned at circuit turn-up and provided by Google to the customer in the LOA.", - "type": "string" - }, - "customerDemarcId": { - "description": "Customer-side demarc ID for this circuit.", - "type": "string" - } - } - }, - "InterconnectMacsec": { - "id": "InterconnectMacsec", - "description": "Configuration information for enabling Media Access Control security (MACsec) on this Cloud Interconnect connection between Google and your on-premises router.", - "type": "object", - "properties": { - "preSharedKeys": { - "description": "Required. A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link.", - "type": "array", - "items": { - "$ref": "InterconnectMacsecPreSharedKey" - } - }, - "failOpen": { - "description": "If set to true, the Interconnect connection is configured with a should-secure MACsec security policy, that allows the Google router to fallback to cleartext traffic if the MKA session cannot be established. By default, the Interconnect connection is configured with a must-secure security policy that drops all traffic if the MKA session cannot be established with your router.", - "type": "boolean" - } - } - }, - "InterconnectMacsecPreSharedKey": { - "id": "InterconnectMacsecPreSharedKey", - "description": "Describes a pre-shared key used to setup MACsec in static connectivity association key (CAK) mode.", - "type": "object", - "properties": { - "name": { - "description": "Required. A name for this pre-shared key. 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.", - "type": "string" + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "startTime": { - "description": "A RFC3339 timestamp on or after which the key is valid. startTime can be in the future. If the keychain has a single key, startTime can be omitted. If the keychain has multiple keys, startTime is mandatory for each key. The start times of keys must be in increasing order. The start times of two consecutive keys must be at least 6 hours apart.", - "type": "string" + "testIamPermissions": { + "id": "compute.reservations.testIamPermissions", + "path": "projects/{project}/zones/{zone}/reservations/{resource}/testIamPermissions", + "flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "InterconnectList": { - "id": "InterconnectList", - "description": "Response to the list request, and contains a list of interconnects.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#interconnectList for lists of interconnects.", - "default": "compute#interconnectList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Interconnect resources.", - "type": "array", - "items": { - "$ref": "Interconnect" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "instanceGroups": { + "methods": { + "list": { + "id": "compute.instanceGroups.list", + "path": "projects/{project}/zones/{zone}/instanceGroups", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone where the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "InstanceGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of zonal instance group resources contained within the specified zone. For managed instance groups, use the instanceGroupManagers or regionInstanceGroupManagers methods instead." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "aggregatedList": { + "id": "compute.instanceGroups.aggregatedList", + "path": "projects/{project}/aggregated/instanceGroups", + "flatPath": "projects/{project}/aggregated/instanceGroups", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "InstanceGroupAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of instance groups and sorts them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + }, + "get": { + "id": "compute.instanceGroups.get", + "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", + "httpMethod": "GET", + "parameters": { + "instanceGroup": { + "description": "The name of the instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone where the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroup" + ], + "response": { + "$ref": "InstanceGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified zonal instance group. Get a list of available zonal instance groups by making a list() request. For managed instance groups, use the instanceGroupManagers or regionInstanceGroupManagers methods instead." + }, + "insert": { + "id": "compute.instanceGroups.insert", + "path": "projects/{project}/zones/{zone}/instanceGroups", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone where you want to create the instance group.", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "InterconnectsGetDiagnosticsResponse": { - "id": "InterconnectsGetDiagnosticsResponse", - "description": "Response for the InterconnectsGetDiagnosticsRequest.", - "type": "object", - "properties": { - "result": { - "$ref": "InterconnectDiagnostics" - } - } - }, - "InterconnectDiagnostics": { - "id": "InterconnectDiagnostics", - "description": "Diagnostics information about the Interconnect connection, which contains detailed and current technical information about Google's side of the connection.", - "type": "object", - "properties": { - "macAddress": { - "description": "The MAC address of the Interconnect's bundle interface.", - "type": "string" - }, - "arpCaches": { - "description": "A list of InterconnectDiagnostics.ARPEntry objects, describing individual neighbors currently seen by the Google router in the ARP cache for the Interconnect. This will be empty when the Interconnect is not bundled.", - "type": "array", - "items": { - "$ref": "InterconnectDiagnosticsARPEntry" - } - }, - "links": { - "description": "A list of InterconnectDiagnostics.LinkStatus objects, describing the status for each link on the Interconnect.", - "type": "array", - "items": { - "$ref": "InterconnectDiagnosticsLinkStatus" - } - }, - "bundleOperationalStatus": { - "description": "The operational status of the bundle interface.", - "type": "string", - "enumDescriptions": [ - "If bundleAggregationType is LACP: LACP is not established and/or all links in the bundle have DOWN operational status. If bundleAggregationType is STATIC: one or more links in the bundle has DOWN operational status.", - "If bundleAggregationType is LACP: LACP is established and at least one link in the bundle has UP operational status. If bundleAggregationType is STATIC: all links in the bundle (typically just one) have UP operational status." + }, + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "BUNDLE_OPERATIONAL_STATUS_DOWN", - "BUNDLE_OPERATIONAL_STATUS_UP" - ] - }, - "bundleAggregationType": { - "description": "The aggregation type of the bundle interface.", - "type": "string", - "enumDescriptions": [ - "LACP is enabled.", - "LACP is disabled." + "request": { + "$ref": "InstanceGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "BUNDLE_AGGREGATION_TYPE_LACP", - "BUNDLE_AGGREGATION_TYPE_STATIC" - ] - } - } - }, - "InterconnectDiagnosticsARPEntry": { - "id": "InterconnectDiagnosticsARPEntry", - "description": "Describing the ARP neighbor entries seen on this link", - "type": "object", - "properties": { - "macAddress": { - "description": "The MAC address of this ARP neighbor.", - "type": "string" - }, - "ipAddress": { - "description": "The IP address of this ARP neighbor.", - "type": "string" - } - } - }, - "InterconnectDiagnosticsLinkStatus": { - "id": "InterconnectDiagnosticsLinkStatus", - "type": "object", - "properties": { - "circuitId": { - "description": "The unique ID for this link assigned during turn up by Google.", - "type": "string" - }, - "googleDemarc": { - "description": "The Demarc address assigned by Google and provided in the LoA.", - "type": "string" - }, - "receivingOpticalPower": { - "description": "An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the received light level.", - "$ref": "InterconnectDiagnosticsLinkOpticalPower" - }, - "transmittingOpticalPower": { - "description": "An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the transmitted light level.", - "$ref": "InterconnectDiagnosticsLinkOpticalPower" - }, - "lacpStatus": { - "$ref": "InterconnectDiagnosticsLinkLACPStatus" + "description": "Creates an instance group in the specified project using the parameters that are included in the request." }, - "operationalStatus": { - "description": "The operational status of the link.", - "type": "string", - "enumDescriptions": [ - "The interface is unable to communicate with the remote end.", - "The interface has low level communication with the remote end." + "delete": { + "id": "compute.instanceGroups.delete", + "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", + "httpMethod": "DELETE", + "parameters": { + "instanceGroup": { + "description": "The name of the instance group to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroup" ], - "enum": [ - "LINK_OPERATIONAL_STATUS_DOWN", - "LINK_OPERATIONAL_STATUS_UP" - ] - }, - "arpCaches": { - "description": "A list of InterconnectDiagnostics.ARPEntry objects, describing the ARP neighbor entries seen on this link. This will be empty if the link is bundled", - "type": "array", - "items": { - "$ref": "InterconnectDiagnosticsARPEntry" - } - }, - "macsec": { - "description": "Describes the status of MACsec encryption on this link.", - "$ref": "InterconnectDiagnosticsMacsecStatus" - } - } - }, - "InterconnectDiagnosticsLinkOpticalPower": { - "id": "InterconnectDiagnosticsLinkOpticalPower", - "type": "object", - "properties": { - "value": { - "description": "Value of the current receiving or transmitting optical power, read in dBm. Take a known good optical value, give it a 10% margin and trigger warnings relative to that value. In general, a -7dBm warning and a -11dBm alarm are good optical value estimates for most links.", - "type": "number", - "format": "float" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information." }, - "state": { - "description": "The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include: - OK: The value has not crossed a warning threshold. - LOW_WARNING: The value has crossed below the low warning threshold. - HIGH_WARNING: The value has crossed above the high warning threshold. - LOW_ALARM: The value has crossed below the low alarm threshold. - HIGH_ALARM: The value has crossed above the high alarm threshold. ", - "type": "string", - "enumDescriptions": [ - "The value has crossed above the high alarm threshold.", - "The value of the current optical power has crossed above the high warning threshold.", - "The value of the current optical power has crossed below the low alarm threshold.", - "The value of the current optical power has crossed below the low warning threshold.", - "The value of the current optical power has not crossed a warning threshold." + "addInstances": { + "id": "compute.instanceGroups.addInstances", + "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/addInstances", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/addInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroup": { + "description": "The name of the instance group where you are adding instances.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroup" ], - "enum": [ - "HIGH_ALARM", - "HIGH_WARNING", - "LOW_ALARM", - "LOW_WARNING", - "OK" - ] - } - } - }, - "InterconnectDiagnosticsLinkLACPStatus": { - "id": "InterconnectDiagnosticsLinkLACPStatus", - "type": "object", - "properties": { - "state": { - "description": "The state of a LACP link, which can take one of the following values: - ACTIVE: The link is configured and active within the bundle. - DETACHED: The link is not configured within the bundle. This means that the rest of the object should be empty. ", - "type": "string", - "enumDescriptions": [ - "The link is configured and active within the bundle.", - "The link is not configured within the bundle, this means the rest of the object should be empty." + "request": { + "$ref": "InstanceGroupsAddInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "ACTIVE", - "DETACHED" - ] - }, - "googleSystemId": { - "description": "System ID of the port on Google's side of the LACP exchange.", - "type": "string" - }, - "neighborSystemId": { - "description": "System ID of the port on the neighbor's side of the LACP exchange.", - "type": "string" - } - } - }, - "InterconnectDiagnosticsMacsecStatus": { - "id": "InterconnectDiagnosticsMacsecStatus", - "description": "Describes the status of MACsec encryption on the link.", - "type": "object", - "properties": { - "operational": { - "description": "Indicates whether or not MACsec is operational on this link.", - "type": "boolean" - }, - "ckn": { - "description": "Indicates the Connectivity Association Key Name (CKN) currently being used if MACsec is operational.", - "type": "string" - } - } - }, - "InterconnectsGetMacsecConfigResponse": { - "id": "InterconnectsGetMacsecConfigResponse", - "description": "Response for the InterconnectsGetMacsecConfigRequest.", - "type": "object", - "properties": { - "result": { - "$ref": "InterconnectMacsecConfig" - }, - "etag": { - "description": "end_interface: MixerGetResponseWithEtagBuilder", - "type": "string" - } - } - }, - "InterconnectMacsecConfig": { - "id": "InterconnectMacsecConfig", - "description": "MACsec configuration information for the Interconnect connection. Contains the generated Connectivity Association Key Name (CKN) and the key (CAK) for this Interconnect connection.", - "type": "object", - "properties": { - "preSharedKeys": { - "description": "A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link.", - "type": "array", - "items": { - "$ref": "InterconnectMacsecConfigPreSharedKey" - } - } - } - }, - "InterconnectMacsecConfigPreSharedKey": { - "id": "InterconnectMacsecConfigPreSharedKey", - "description": "Describes a pre-shared key used to setup MACsec in static connectivity association key (CAK) mode.", - "type": "object", - "properties": { - "name": { - "description": "User provided name for this pre-shared key.", - "type": "string" - }, - "ckn": { - "description": "An auto-generated Connectivity Association Key Name (CKN) for this key.", - "type": "string" - }, - "cak": { - "description": "An auto-generated Connectivity Association Key (CAK) for this key.", - "type": "string" - }, - "startTime": { - "description": "User provided timestamp on or after which this key is valid.", - "type": "string" - } - } - }, - "InterconnectLocationList": { - "id": "InterconnectLocationList", - "description": "Response to the list request, and contains a list of interconnect locations.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#interconnectLocationList for lists of interconnect locations.", - "default": "compute#interconnectLocationList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InterconnectLocation resources.", - "type": "array", - "items": { - "$ref": "InterconnectLocation" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "description": "Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "removeInstances": { + "id": "compute.instanceGroups.removeInstances", + "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/removeInstances", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/removeInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroup": { + "description": "The name of the instance group where the specified instances will be removed.", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the instance group is located.", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "InterconnectLocation": { - "id": "InterconnectLocation", - "description": "Represents an Interconnect Attachment (VLAN) Location resource. You can use this resource to find location details about an Interconnect attachment (VLAN). For more information about interconnect attachments, read Creating VLAN Attachments.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#interconnectLocation for interconnect locations.", - "default": "compute#interconnectLocation", - "type": "string" - }, - "description": { - "description": "[Output Only] An optional description of the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "[Output Only] Name of the resource.", - "type": "string" - }, - "peeringdbFacilityId": { - "description": "[Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb).", - "type": "string" - }, - "address": { - "description": "[Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character.", - "type": "string" - }, - "facilityProvider": { - "description": "[Output Only] The name of the provider for this facility (e.g., EQUINIX).", - "type": "string" - }, - "facilityProviderFacilityId": { - "description": "[Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1).", - "type": "string" - }, - "regionInfos": { - "description": "[Output Only] A list of InterconnectLocation.RegionInfo objects, that describe parameters pertaining to the relation between this InterconnectLocation and various Google Cloud regions.", - "type": "array", - "items": { - "$ref": "InterconnectLocationRegionInfo" - } - }, - "continent": { - "description": "[Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA ", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroup" ], - "enum": [ - "AFRICA", - "ASIA_PAC", - "C_AFRICA", - "C_ASIA_PAC", - "C_EUROPE", - "C_NORTH_AMERICA", - "C_SOUTH_AMERICA", - "EUROPE", - "NORTH_AMERICA", - "SOUTH_AMERICA" - ] - }, - "city": { - "description": "[Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: \"Chicago, IL\", \"Amsterdam, Netherlands\".", - "type": "string" - }, - "availabilityZone": { - "description": "[Output Only] Availability zone for this InterconnectLocation. Within a metropolitan area (metro), maintenance will not be simultaneously scheduled in more than one availability zone. Example: \"zone1\" or \"zone2\".", - "type": "string" - }, - "status": { - "description": "[Output Only] The status of this InterconnectLocation, which can take one of the following values: - CLOSED: The InterconnectLocation is closed and is unavailable for provisioning new Interconnects. - AVAILABLE: The InterconnectLocation is available for provisioning new Interconnects. ", - "type": "string", - "enumDescriptions": [ - "The InterconnectLocation is available for provisioning new Interconnects.", - "The InterconnectLocation is closed for provisioning new Interconnects." + "request": { + "$ref": "InstanceGroupsRemoveInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "AVAILABLE", - "CLOSED" - ] - }, - "supportsPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - }, - "availableFeatures": { - "description": "[Output only] List of features available at this InterconnectLocation, which can take one of the following values: - MACSEC ", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "Media Access Control security (MACsec)" - ], - "enum": [ - "IF_MACSEC" - ] - } - }, - "availableLinkTypes": { - "description": "[Output only] List of link types available at this InterconnectLocation, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR - LINK_TYPE_ETHERNET_100G_LR ", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "100G Ethernet, LR Optics.", - "10G Ethernet, LR Optics. [(rate_bps) = 10000000000];" - ], - "enum": [ - "LINK_TYPE_ETHERNET_100G_LR", - "LINK_TYPE_ETHERNET_10G_LR" - ] - } - } - } - }, - "InterconnectLocationRegionInfo": { - "id": "InterconnectLocationRegionInfo", - "description": "Information about any potential InterconnectAttachments between an Interconnect at a specific InterconnectLocation, and a specific Cloud Region.", - "type": "object", - "properties": { - "region": { - "description": "URL for the region of this location.", - "type": "string" + "description": "Removes one or more instances from the specified instance group, but does not delete those instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration before the VM instance is removed or deleted." }, - "expectedRttMs": { - "description": "Expected round-trip time in milliseconds, from this InterconnectLocation to a VM in this region.", - "type": "string", - "format": "int64" + "listInstances": { + "id": "compute.instanceGroups.listInstances", + "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances", + "httpMethod": "POST", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "instanceGroup": { + "description": "The name of the instance group from which you want to generate a list of included instances.", + "location": "path", + "required": true, + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone where the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroup" + ], + "request": { + "$ref": "InstanceGroupsListInstancesRequest" + }, + "response": { + "$ref": "InstanceGroupsListInstances" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the instances in the specified instance group. The orderBy query parameter is not supported. The filter query parameter is supported, but only for expressions that use `eq` (equal) or `ne` (not equal) operators." }, - "locationPresence": { - "description": "Identifies the network presence of this location.", - "type": "string", - "enumDescriptions": [ - "This region is not in any common network presence with this InterconnectLocation.", - "This region shares the same regional network presence as this InterconnectLocation.", - "[Deprecated] This region is not in any common network presence with this InterconnectLocation.", - "[Deprecated] This region shares the same regional network presence as this InterconnectLocation." + "setNamedPorts": { + "id": "compute.instanceGroups.setNamedPorts", + "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/setNamedPorts", + "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/setNamedPorts", + "httpMethod": "POST", + "parameters": { + "instanceGroup": { + "description": "The name of the instance group where the named ports are updated.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroup" ], - "enum": [ - "GLOBAL", - "LOCAL_REGION", - "LP_GLOBAL", - "LP_LOCAL_REGION" - ] + "request": { + "$ref": "InstanceGroupsSetNamedPortsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the named ports for the specified instance group." } } }, - "InterconnectRemoteLocationList": { - "id": "InterconnectRemoteLocationList", - "description": "Response to the list request, and contains a list of interconnect remote locations.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#interconnectRemoteLocationList for lists of interconnect remote locations.", - "default": "compute#interconnectRemoteLocationList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of InterconnectRemoteLocation resources.", - "type": "array", - "items": { - "$ref": "InterconnectRemoteLocation" - } + "regionInstanceGroups": { + "methods": { + "list": { + "id": "compute.regionInstanceGroups.list", + "path": "projects/{project}/regions/{region}/instanceGroups", + "flatPath": "projects/{project}/regions/{region}/instanceGroups", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "RegionInstanceGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of instance group resources contained within the specified region." }, - "nextPageToken": { - "description": "[Output Only] This token lets you get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "get": { + "id": "compute.regionInstanceGroups.get", + "path": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}", + "flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}", + "httpMethod": "GET", + "parameters": { + "instanceGroup": { + "description": "Name of the instance group resource to return.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroup" + ], + "response": { + "$ref": "InstanceGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified instance group resource." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "listInstances": { + "id": "compute.regionInstanceGroups.listInstances", + "path": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/listInstances", + "flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/listInstances", + "httpMethod": "POST", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "instanceGroup": { + "description": "Name of the regional instance group for which we want to list the instances.", + "location": "path", + "required": true, + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroup" + ], + "request": { + "$ref": "RegionInstanceGroupsListInstancesRequest" + }, + "response": { + "$ref": "RegionInstanceGroupsListInstances" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the instances in the specified instance group and displays information about the named ports. Depending on the specified options, this method can list all instances or only the instances that are running. The orderBy query parameter is not supported." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setNamedPorts": { + "id": "compute.regionInstanceGroups.setNamedPorts", + "path": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/setNamedPorts", + "flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/setNamedPorts", + "httpMethod": "POST", + "parameters": { + "instanceGroup": { + "description": "The name of the regional instance group where the named ports are updated.", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroup" + ], + "request": { + "$ref": "RegionInstanceGroupsSetNamedPortsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the named ports for the specified regional instance group." } } }, - "InterconnectRemoteLocation": { - "id": "InterconnectRemoteLocation", - "description": "Represents a Cross-Cloud Interconnect Remote Location resource. You can use this resource to find remote location details about an Interconnect attachment (VLAN).", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#interconnectRemoteLocation for interconnect remote locations.", - "default": "compute#interconnectRemoteLocation", - "type": "string" - }, - "description": { - "description": "[Output Only] An optional description of the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "[Output Only] Name of the resource.", - "type": "string" - }, - "peeringdbFacilityId": { - "description": "[Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb).", - "type": "string" - }, - "address": { - "description": "[Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character.", - "type": "string" - }, - "facilityProvider": { - "description": "[Output Only] The name of the provider for this facility (e.g., EQUINIX).", - "type": "string" - }, - "facilityProviderFacilityId": { - "description": "[Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1).", - "type": "string" - }, - "continent": { - "description": "[Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA ", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" + "instanceGroupManagers": { + "methods": { + "list": { + "id": "compute.instanceGroupManagers.list", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "AFRICA", - "ASIA_PAC", - "EUROPE", - "NORTH_AMERICA", - "SOUTH_AMERICA" - ] - }, - "city": { - "description": "[Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: \"Chicago, IL\", \"Amsterdam, Netherlands\".", - "type": "string" - }, - "status": { - "description": "[Output Only] The status of this InterconnectRemoteLocation, which can take one of the following values: - CLOSED: The InterconnectRemoteLocation is closed and is unavailable for provisioning new Cross-Cloud Interconnects. - AVAILABLE: The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects. ", - "type": "string", - "enumDescriptions": [ - "The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects.", - "The InterconnectRemoteLocation is closed for provisioning new Cross-Cloud Interconnects." + "response": { + "$ref": "InstanceGroupManagerList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "AVAILABLE", - "CLOSED" - ] - }, - "remoteService": { - "description": "[Output Only] Indicates the service provider present at the remote location. Example values: \"Amazon Web Services\", \"Microsoft Azure\".", - "type": "string" - }, - "permittedConnections": { - "description": "[Output Only] Permitted connections.", - "type": "array", - "items": { - "$ref": "InterconnectRemoteLocationPermittedConnections" - } - }, - "constraints": { - "description": "[Output Only] Constraints on the parameters for creating Cross-Cloud Interconnect and associated InterconnectAttachments.", - "$ref": "InterconnectRemoteLocationConstraints" - }, - "attachmentConfigurationConstraints": { - "description": "[Output Only] Subset of fields from InterconnectAttachment's |configurationConstraints| field that apply to all attachments for this remote location.", - "$ref": "InterconnectAttachmentConfigurationConstraints" + "description": "Retrieves a list of managed instance groups that are contained within the specified project and zone." }, - "lacp": { - "description": "[Output Only] Link Aggregation Control Protocol (LACP) constraints, which can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED", - "type": "string", - "enumDescriptions": [ - "LACP_SUPPORTED: LACP is supported, and enabled by default on the Cross-Cloud Interconnect.", - "LACP_UNSUPPORTED: LACP is not supported and is not be enabled on this port. GetDiagnostics shows bundleAggregationType as \"static\". GCP does not support LAGs without LACP, so requestedLinkCount must be 1." + "aggregatedList": { + "id": "compute.instanceGroupManagers.aggregatedList", + "path": "projects/{project}/aggregated/instanceGroupManagers", + "flatPath": "projects/{project}/aggregated/instanceGroupManagers", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" ], - "enum": [ - "LACP_SUPPORTED", - "LACP_UNSUPPORTED" - ] - }, - "maxLagSize100Gbps": { - "description": "[Output Only] The maximum number of 100 Gbps ports supported in a link aggregation group (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed max_lag_size_100_gbps.", - "type": "integer", - "format": "int32" + "response": { + "$ref": "InstanceGroupManagerAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of managed instance groups and groups them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "maxLagSize10Gbps": { - "description": "[Output Only] The maximum number of 10 Gbps ports supported in a link aggregation group (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed max_lag_size_10_gbps.", - "type": "integer", - "format": "int32" - } - } - }, - "InterconnectRemoteLocationPermittedConnections": { - "id": "InterconnectRemoteLocationPermittedConnections", - "type": "object", - "properties": { - "interconnectLocation": { - "description": "[Output Only] URL of an Interconnect location that is permitted to connect to this Interconnect remote location.", - "type": "string" - } - } - }, - "InterconnectRemoteLocationConstraints": { - "id": "InterconnectRemoteLocationConstraints", - "type": "object", - "properties": { - "subnetLengthRange": { - "description": "[Output Only] [min-length, max-length] The minimum and maximum value (inclusive) for the IPv4 subnet length. For example, an interconnectRemoteLocation for Azure has {min: 30, max: 30} because Azure requires /30 subnets. This range specifies the values supported by both cloud providers. Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a remote cloud has no constraint on IPv4 subnet length, the range would thus be {min: 29, max: 30}. ", - "$ref": "InterconnectRemoteLocationConstraintsSubnetLengthRange" + "get": { + "id": "compute.instanceGroupManagers.get", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "GET", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "response": { + "$ref": "InstanceGroupManager" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns all of the details about the specified managed instance group." }, - "portPairVlan": { - "description": "[Output Only] Port pair VLAN constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN", - "type": "string", - "enumDescriptions": [ - "If PORT_PAIR_MATCHING_VLAN, the Interconnect for this attachment is part of a pair of ports that should have matching VLAN allocations. This occurs with Cross-Cloud Interconnect to Azure remote locations. While GCP's API does not explicitly group pairs of ports, the UI uses this field to ensure matching VLAN ids when configuring a redundant VLAN pair.", - "PORT_PAIR_UNCONSTRAINED_VLAN means there is no constraint." + "insert": { + "id": "compute.instanceGroupManagers.insert", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where you want to create the managed instance group.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "PORT_PAIR_MATCHING_VLAN", - "PORT_PAIR_UNCONSTRAINED_VLAN" - ] - }, - "portPairRemoteLocation": { - "description": "[Output Only] Port pair remote location constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, PORT_PAIR_MATCHING_REMOTE_LOCATION. Google Cloud API refers only to individual ports, but the UI uses this field when ordering a pair of ports, to prevent users from accidentally ordering something that is incompatible with their cloud provider. Specifically, when ordering a redundant pair of Cross-Cloud Interconnect ports, and one of them uses a remote location with portPairMatchingRemoteLocation set to matching, the UI requires that both ports use the same remote location.", - "type": "string", - "enumDescriptions": [ - "If PORT_PAIR_MATCHING_REMOTE_LOCATION, the remote cloud provider allocates ports in pairs, and the user should choose the same remote location for both ports.", - "If PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, a user may opt to provision a redundant pair of Cross-Cloud Interconnects using two different remote locations in the same city." + "request": { + "$ref": "InstanceGroupManager" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "PORT_PAIR_MATCHING_REMOTE_LOCATION", - "PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION" - ] - } - } - }, - "InterconnectRemoteLocationConstraintsSubnetLengthRange": { - "id": "InterconnectRemoteLocationConstraintsSubnetLengthRange", - "type": "object", - "properties": { - "min": { - "type": "integer", - "format": "int32" - }, - "max": { - "type": "integer", - "format": "int32" - } - } - }, - "LicenseCode": { - "id": "LicenseCode", - "description": "Represents a License Code resource. A License Code is a unique identifier used to represent a license resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. ", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#licenseCode for licenses.", - "default": "compute#licenseCode", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" + "description": "Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method. A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit." }, - "name": { - "description": "[Output Only] Name of the resource. The name is 1-20 characters long and must be a valid 64 bit integer.", - "pattern": "[0-9]{0,20}?", - "annotations": { - "required": [ - "compute.licenses.insert" - ] + "patch": { + "id": "compute.instanceGroupManagers.patch", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "PATCH", + "parameters": { + "instanceGroupManager": { + "description": "The name of the instance group manager.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where you want to create the managed instance group.", + "location": "path", + "required": true, + "type": "string" + } }, - "type": "string" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "description": { - "description": "[Output Only] Description of this License Code.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "transferable": { - "description": "[Output Only] If true, the license will remain attached when creating images or snapshots from disks. Otherwise, the license is not transferred.", - "type": "boolean" - }, - "state": { - "description": "[Output Only] Current state of this License Code.", - "type": "string", - "enumDescriptions": [ - "Machines are not allowed to attach boot disks with this License Code. Requests to create new resources with this license will be rejected.", - "Use is allowed for anyone with USE_READ_ONLY access to this License Code.", - "Use of this license is limited to a project whitelist.", - "", - "Reserved state." + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "DISABLED", - "ENABLED", - "RESTRICTED", - "STATE_UNSPECIFIED", - "TERMINATED" - ] - }, - "licenseAlias": { - "description": "[Output Only] URL and description aliases of Licenses with the same License Code.", - "type": "array", - "items": { - "$ref": "LicenseCodeLicenseAlias" - } - } - } - }, - "LicenseCodeLicenseAlias": { - "id": "LicenseCodeLicenseAlias", - "type": "object", - "properties": { - "selfLink": { - "description": "[Output Only] URL of license corresponding to this License Code.", - "type": "string" - }, - "description": { - "description": "[Output Only] Description of this License Code.", - "type": "string" - } - } - }, - "License": { - "id": "License", - "description": "Represents a License resource. A License represents billing and aggregate usage data for public and marketplace images. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. ", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#license for licenses.", - "default": "compute#license", - "type": "string" - }, - "name": { - "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])?", - "annotations": { - "required": [ - "compute.images.insert" - ] + "request": { + "$ref": "InstanceGroupManager" }, - "type": "string" - }, - "chargesUseFee": { - "description": "[Output Only] Deprecated. This field no longer reflects whether a license charges a usage fee.", - "type": "boolean" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "licenseCode": { - "description": "[Output Only] The unique code used to attach this license to images, snapshots, and disks.", - "type": "string", - "format": "uint64" - }, - "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" - }, - "transferable": { - "description": "If false, licenses will not be copied from the source resource when creating an image from a disk, disk from snapshot, or snapshot from disk.", - "type": "boolean" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "resourceRequirements": { - "$ref": "LicenseResourceRequirements" - } - } - }, - "LicenseResourceRequirements": { - "id": "LicenseResourceRequirements", - "type": "object", - "properties": { - "minGuestCpuCount": { - "description": "Minimum number of guest cpus required to use the Instance. Enforced at Instance creation and Instance start.", - "type": "integer", - "format": "int32" - }, - "minMemoryMb": { - "description": "Minimum memory required to use the Instance. Enforced at Instance creation and Instance start.", - "type": "integer", - "format": "int32" - } - } - }, - "LicensesListResponse": { - "id": "LicensesListResponse", - "type": "object", - "properties": { - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listManagedInstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. If you update your group to specify a new template or instance configuration, it's possible that your intended specification for each VM in the group is different from the current state of that VM. To learn how to apply an updated configuration to the VMs in a MIG, see Updating instances in a MIG." }, - "items": { - "description": "A list of License resources.", - "type": "array", - "items": { - "$ref": "License" - } + "delete": { + "id": "compute.instanceGroupManagers.delete", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "DELETE", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified managed instance group and all of the instances in that group. Note that the instance group must not belong to a backend service. Read Deleting an instance group for more information." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "deleteInstances": { + "id": "compute.instanceGroupManagers.deleteInstances", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "request": { + "$ref": "InstanceGroupManagersDeleteInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Flags the specified instances in the managed instance group for immediate deletion. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "abandonInstances": { + "id": "compute.instanceGroupManagers.abandonInstances", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "request": { + "$ref": "InstanceGroupManagersAbandonInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Flags the specified instances to be removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "recreateInstances": { + "id": "compute.instanceGroupManagers.recreateInstances", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "zone": { + "description": "The name of the zone where the managed instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "request": { + "$ref": "InstanceGroupManagersRecreateInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Flags the specified VM instances in the managed instance group to be immediately recreated. Each instance is recreated using the group's current configuration. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." + }, + "resize": { + "id": "compute.instanceGroupManagers.resize", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resize", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resize", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "size": { + "description": "The number of running instances that the managed instance group should maintain at any given time. The group automatically adds or removes instances to maintain the number of instances specified by this parameter.", + "location": "query", + "required": true, + "type": "integer", + "format": "int32" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located.", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "MachineImageList": { - "id": "MachineImageList", - "description": "A list of machine images.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#machineImagesListResponse for machine image lists.", - "default": "compute#machineImageList", - "type": "string" + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager", + "size" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method. When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the selection including: + The status of the VM instance. + The health of the VM instance. + The instance template version the VM is based on. + For regional managed instance groups, the location of the VM instance. This list is subject to change. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "setInstanceTemplate": { + "id": "compute.instanceGroupManagers.setInstanceTemplate", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "request": { + "$ref": "InstanceGroupManagersSetInstanceTemplateRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE." }, - "items": { - "description": "A list of MachineImage resources.", - "type": "array", - "items": { - "$ref": "MachineImage" - } + "setTargetPools": { + "id": "compute.instanceGroupManagers.setTargetPools", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "request": { + "$ref": "InstanceGroupManagersSetTargetPoolsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Modifies the target pools to which all instances in this managed instance group are assigned. The target pools automatically apply to all of the instances in the managed instance group. This operation is marked DONE when you make the request even if the instances have not yet been added to their target pools. The change might take some time to apply to all of the instances in the group depending on the size of the group." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "listManagedInstances": { + "id": "compute.instanceGroupManagers.listManagedInstances", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", + "httpMethod": "POST", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "response": { + "$ref": "InstanceGroupManagersListManagedInstancesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "listErrors": { + "id": "compute.instanceGroupManagers.listErrors", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listErrors", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listErrors", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "instanceGroupManager": { + "description": "The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}.", + "location": "path", + "required": true, + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "response": { + "$ref": "InstanceGroupManagersListErrorsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all errors thrown by actions on instances for a given managed instance group. The filter and orderBy query parameters are not supported." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listPerInstanceConfigs": { + "id": "compute.instanceGroupManagers.listPerInstanceConfigs", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", + "httpMethod": "POST", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "instanceGroupManager": { + "description": "The name of the managed instance group. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "response": { + "$ref": "InstanceGroupManagersListPerInstanceConfigsResp" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported." + }, + "updatePerInstanceConfigs": { + "id": "compute.instanceGroupManagers.updatePerInstanceConfigs", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "MachineImage": { - "id": "MachineImage", - "description": "Represents a machine image resource. A machine image is a Compute Engine resource that stores all the configuration, metadata, permissions, and data from one or more disks required to create a Virtual machine (VM) instance. For more information, see Machine images.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#machineImage for machine image.", - "default": "compute#machineImage", - "type": "string" - }, - "id": { - "description": "[Output Only] A unique identifier for this machine image. The server defines this identifier.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] The creation timestamp for this machine image in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.machineImages.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] The URL for this machine image. The server defines this URL.", - "type": "string" - }, - "sourceInstance": { - "description": "The source instance used to create the machine image. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance ", - "type": "string" - }, - "status": { - "description": "[Output Only] The status of the machine image. One of the following values: INVALID, CREATING, READY, DELETING, and UPLOADING.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY", - "UPLOADING" - ] - }, - "sourceInstanceProperties": { - "description": "[Output Only] DEPRECATED: Please use instance_properties instead for source instance related properties. New properties will not be added to this field.", - "$ref": "SourceInstanceProperties" - }, - "instanceProperties": { - "description": "[Output Only] Properties of source instance", - "$ref": "InstanceProperties" - }, - "savedDisks": { - "description": "An array of Machine Image specific properties for disks attached to the source instance", - "type": "array", - "items": { - "$ref": "SavedDisk" - } - }, - "storageLocations": { - "description": "The regional or multi-regional Cloud Storage bucket location where the machine image is stored.", - "type": "array", - "items": { - "type": "string" - } - }, - "machineImageEncryptionKey": { - "description": "Encrypts the machine image using a customer-supplied encryption key. After you encrypt a machine image using a customer-supplied key, you must provide the same key if you use the machine image later. For example, you must provide the encryption key when you create an instance from the encrypted machine image in a future request. Customer-supplied encryption keys do not protect access to metadata of the machine image. If you do not provide an encryption key when creating the machine image, then the machine image will be encrypted using an automatically generated key and you do not need to provide a key to use the machine image later.", - "$ref": "CustomerEncryptionKey" - }, - "guestFlush": { - "description": "[Input Only] Whether to attempt an application consistent machine image by informing the OS to prepare for the snapshot process.", - "type": "boolean" - }, - "sourceDiskEncryptionKeys": { - "description": "[Input Only] The customer-supplied encryption key of the disks attached to the source instance. Required if the source disk is protected by a customer-supplied encryption key.", - "type": "array", - "items": { - "$ref": "SourceDiskEncryptionKey" - } - }, - "totalStorageBytes": { - "description": "[Output Only] Total size of the storage used by the machine image.", - "type": "string", - "format": "int64" - }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - }, - "satisfiesPzi": { - "description": "Output only. Reserved for future use.", - "readOnly": true, - "type": "boolean" - } - } - }, - "SourceInstanceProperties": { - "id": "SourceInstanceProperties", - "description": "DEPRECATED: Please use compute#instanceProperties instead. New properties will not be added to this field.", - "type": "object", - "properties": { - "description": { - "description": "An optional text description for the instances that are created from this machine image.", - "type": "string" - }, - "tags": { - "description": "A list of tags to apply to the instances that are created from this machine image. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035.", - "$ref": "Tags" - }, - "machineType": { - "description": "The machine type to use for instances that are created from this machine image.", - "type": "string" - }, - "canIpForward": { - "description": "Enables instances created based on this machine image to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information.", - "type": "boolean" - }, - "networkInterfaces": { - "description": "An array of network access configurations for this interface.", - "type": "array", - "items": { - "$ref": "NetworkInterface" - } - }, - "disks": { - "description": "An array of disks that are associated with the instances that are created from this machine image.", - "type": "array", - "items": { - "$ref": "SavedAttachedDisk" - } - }, - "metadata": { - "description": "The metadata key/value pairs to assign to instances that are created from this machine image. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information.", - "$ref": "Metadata" - }, - "serviceAccounts": { - "description": "A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from this machine image. Use metadata queries to obtain the access tokens for these instances.", - "type": "array", - "items": { - "$ref": "ServiceAccount" - } - }, - "scheduling": { - "description": "Specifies the scheduling options for the instances that are created from this machine image.", - "$ref": "Scheduling" - }, - "labels": { - "description": "Labels to apply to instances that are created from this machine image.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "guestAccelerators": { - "description": "A list of guest accelerator cards' type and count to use for instances created from this machine image.", - "type": "array", - "items": { - "$ref": "AcceleratorConfig" - } - }, - "minCpuPlatform": { - "description": "Minimum cpu/platform to be used by instances created from this machine image. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: \"Intel Haswell\" or minCpuPlatform: \"Intel Sandy Bridge\". For more information, read Specifying a Minimum CPU Platform.", - "type": "string" - }, - "deletionProtection": { - "description": "Whether the instance created from this machine image should be protected against deletion.", - "type": "boolean" - }, - "keyRevocationActionType": { - "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and \"NONE\". The default value is \"NONE\" if it is not specified.", - "type": "string", - "enumDescriptions": [ - "Default value. This value is unused.", - "Indicates user chose no operation.", - "Indicates user chose to opt for VM shutdown on key revocation." + "request": { + "$ref": "InstanceGroupManagersUpdatePerInstanceConfigsReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", - "NONE", - "STOP" - ] - } - } - }, - "SavedAttachedDisk": { - "id": "SavedAttachedDisk", - "description": "DEPRECATED: Please use compute#savedDisk instead. An instance-attached disk resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#attachedDisk for attached disks.", - "default": "compute#savedAttachedDisk", - "type": "string" + "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch." }, - "type": { - "description": "Specifies the type of the attached disk, either SCRATCH or PERSISTENT.", - "type": "string", - "enumDescriptions": [ - "", - "" + "patchPerInstanceConfigs": { + "id": "compute.instanceGroupManagers.patchPerInstanceConfigs", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "PERSISTENT", - "SCRATCH" - ] - }, - "mode": { - "description": "The mode in which this disk is attached to the source instance, either READ_WRITE or READ_ONLY.", - "type": "string", - "enumDescriptions": [ - "Attaches this disk in read-only mode. Multiple virtual machines can use a disk in read-only mode at a time.", - "*[Default]* Attaches this disk in read-write mode. Only one virtual machine at a time can be attached to a disk in read-write mode." + "request": { + "$ref": "InstanceGroupManagersPatchPerInstanceConfigsReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "READ_ONLY", - "READ_WRITE" - ] - }, - "source": { - "description": "Specifies a URL of the disk attached to the source instance.", - "type": "string" - }, - "deviceName": { - "description": "Specifies the name of the disk attached to the source instance.", - "type": "string" - }, - "index": { - "description": "Specifies zero-based index of the disk that is attached to the source instance.", - "type": "integer", - "format": "int32" - }, - "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" - }, - "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" - }, - "licenses": { - "description": "[Output Only] Any valid publicly visible licenses.", - "type": "array", - "items": { - "type": "string" - } + "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch." }, - "interface": { - "description": "Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME.", - "type": "string", - "enumDescriptions": [ - "", - "" + "deletePerInstanceConfigs": { + "id": "compute.instanceGroupManagers.deletePerInstanceConfigs", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "NVME", - "SCSI" - ] - }, - "guestOsFeatures": { - "description": "A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options.", - "type": "array", - "items": { - "$ref": "GuestOsFeature" - } - }, - "diskEncryptionKey": { - "description": "The encryption key for the disk.", - "$ref": "CustomerEncryptionKey" - }, - "diskSizeGb": { - "description": "The size of the disk in base-2 GB.", - "type": "string", - "format": "int64" + "request": { + "$ref": "InstanceGroupManagersDeletePerInstanceConfigsReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes selected per-instance configurations for the managed instance group." }, - "storageBytes": { - "description": "[Output Only] A size of the storage used by the disk's snapshot by this machine image.", - "type": "string", - "format": "int64" + "applyUpdatesToInstances": { + "id": "compute.instanceGroupManagers.applyUpdatesToInstances", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group, should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located. Should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "request": { + "$ref": "InstanceGroupManagersApplyUpdatesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Applies changes to selected instances on the managed instance group. This method can be used to apply new overrides and/or new versions." }, - "storageBytesStatus": { - "description": "[Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date.", - "type": "string", - "enumDescriptions": [ - "", - "" + "createInstances": { + "id": "compute.instanceGroupManagers.createInstances", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "UPDATING", - "UP_TO_DATE" - ] - }, - "diskType": { - "description": "[Output Only] URL of the disk type resource. For example: projects/project /zones/zone/diskTypes/pd-standard or pd-ssd", - "type": "string" + "request": { + "$ref": "InstanceGroupManagersCreateInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates instances with per-instance configurations in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method." } } }, - "SavedDisk": { - "id": "SavedDisk", - "description": "An instance-attached disk resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#savedDisk for attached disks.", - "default": "compute#savedDisk", - "type": "string" - }, - "sourceDisk": { - "description": "Specifies a URL of the disk attached to the source instance.", - "type": "string" + "instanceGroupManagerResizeRequests": { + "methods": { + "get": { + "id": "compute.instanceGroupManagerResizeRequests.get", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", + "httpMethod": "GET", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group. Name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resizeRequest": { + "description": "The name of the resize request. Name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the href=\"/compute/docs/regions-zones/#available\"\u003ezone scoping this request. Name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager", + "resizeRequest" + ], + "response": { + "$ref": "InstanceGroupManagerResizeRequest" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns all of the details about the specified resize request." }, - "storageBytes": { - "description": "[Output Only] Size of the individual disk snapshot used by this machine image.", - "type": "string", - "format": "int64" + "insert": { + "id": "compute.instanceGroupManagerResizeRequests.insert", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group to which the resize request will be added. Name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located and where the resize request will be created. Name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" + ], + "request": { + "$ref": "InstanceGroupManagerResizeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a new resize request that starts provisioning VMs immediately or queues VM creation." }, - "storageBytesStatus": { - "description": "[Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date.", - "type": "string", - "enumDescriptions": [ - "", - "" + "list": { + "id": "compute.instanceGroupManagerResizeRequests.list", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "instanceGroupManager": { + "description": "The name of the managed instance group. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager" ], - "enum": [ - "UPDATING", - "UP_TO_DATE" - ] + "response": { + "$ref": "InstanceGroupManagerResizeRequestsListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of resize requests that are contained in the managed instance group." }, - "architecture": { - "description": "[Output Only] The architecture of the attached disk.", - "type": "string", - "enumDescriptions": [ - "Default value indicating Architecture is not set.", - "Machines with architecture ARM64", - "Machines with architecture X86_64" + "cancel": { + "id": "compute.instanceGroupManagerResizeRequests.cancel", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group. The name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resizeRequest": { + "description": "The name of the resize request to cancel. The name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager", + "resizeRequest" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" - ] - } - } - }, - "SourceDiskEncryptionKey": { - "id": "SourceDiskEncryptionKey", - "type": "object", - "properties": { - "sourceDisk": { - "description": "URL of the disk attached to the source instance. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk ", - "type": "string" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Cancels the specified resize request and removes it from the queue. Cancelled resize request does no longer wait for the resources to be provisioned. Cancel is only possible for requests that are accepted in the queue." }, - "diskEncryptionKey": { - "description": "The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key.", - "$ref": "CustomerEncryptionKey" + "delete": { + "id": "compute.instanceGroupManagerResizeRequests.delete", + "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", + "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", + "httpMethod": "DELETE", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group. The name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resizeRequest": { + "description": "The name of the resize request to delete. The name should conform to RFC1035 or be a resource ID.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone where the managed instance group is located. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instanceGroupManager", + "resizeRequest" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified, inactive resize request. Requests that are still active cannot be deleted. Deleting request does not delete instances that were provisioned previously." } } }, - "MachineTypeList": { - "id": "MachineTypeList", - "description": "Contains a list of machine types.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#machineTypeList for lists of machine types.", - "default": "compute#machineTypeList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of MachineType resources.", - "type": "array", - "items": { - "$ref": "MachineType" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "regionInstanceGroupManagers": { + "methods": { + "list": { + "id": "compute.regionInstanceGroupManagers.list", + "path": "projects/{project}/regions/{region}/instanceGroupManagers", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "MachineType": { - "id": "MachineType", - "description": "Represents a Machine Type resource. You can use specific machine types for your VM instances based on performance and pricing requirements. For more information, read Machine Types.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The type of the resource. Always compute#machineType for machine types.", - "default": "compute#machineType", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "[Output Only] Name of the resource.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - }, - "description": { - "description": "[Output Only] An optional textual description of the resource.", - "type": "string" - }, - "guestCpus": { - "description": "[Output Only] The number of virtual CPUs that are available to the instance.", - "type": "integer", - "format": "int32" - }, - "memoryMb": { - "description": "[Output Only] The amount of physical memory available to the instance, defined in MB.", - "type": "integer", - "format": "int32" - }, - "imageSpaceGb": { - "description": "[Deprecated] This property is deprecated and will never be populated with any relevant values.", - "type": "integer", - "format": "int32" + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "RegionInstanceGroupManagerList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of managed instance groups that are contained within the specified region." }, - "scratchDisks": { - "description": "[Output Only] A list of extended scratch disks assigned to the instance.", - "type": "array", - "items": { - "type": "object", - "properties": { - "diskGb": { - "description": "Size of the scratch disk, defined in GB.", - "type": "integer", - "format": "int32" - } + "get": { + "id": "compute.regionInstanceGroupManagers.get", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "GET", + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group to return.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" } - } - }, - "maximumPersistentDisks": { - "description": "[Output Only] Maximum persistent disks allowed.", - "type": "integer", - "format": "int32" - }, - "maximumPersistentDisksSizeGb": { - "description": "[Output Only] Maximum total persistent disks size (GB) allowed.", - "type": "string", - "format": "int64" - }, - "deprecated": { - "description": "[Output Only] The deprecation status associated with this machine type. Only applicable if the machine type is unavailable.", - "$ref": "DeprecationStatus" - }, - "zone": { - "description": "[Output Only] The name of the zone where the machine type resides, such as us-central1-a.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "isSharedCpu": { - "description": "[Output Only] Whether this machine type has a shared CPU. See Shared-core machine types for more information.", - "type": "boolean" + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "response": { + "$ref": "InstanceGroupManager" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns all of the details about the specified managed instance group." }, - "accelerators": { - "description": "[Output Only] A list of accelerator configurations assigned to this machine type.", - "type": "array", - "items": { - "type": "object", - "properties": { - "guestAcceleratorType": { - "description": "The accelerator type resource name, not a full URL, e.g. nvidia-tesla-t4.", - "type": "string" - }, - "guestAcceleratorCount": { - "description": "Number of accelerator cards exposed to the guest.", - "type": "integer", - "format": "int32" - } + "insert": { + "id": "compute.regionInstanceGroupManagers.insert", + "path": "projects/{project}/regions/{region}/instanceGroupManagers", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "architecture": { - "description": "[Output Only] The architecture of the machine type.", - "type": "string", - "enumDescriptions": [ - "Default value indicating Architecture is not set.", - "Machines with architecture ARM64", - "Machines with architecture X86_64" + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ARCHITECTURE_UNSPECIFIED", - "ARM64", - "X86_64" - ] - } - } - }, - "MachineTypeAggregatedList": { - "id": "MachineTypeAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#machineTypeAggregatedList for aggregated lists of machine types.", - "default": "compute#machineTypeAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "request": { + "$ref": "InstanceGroupManager" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method. A regional managed instance group can contain up to 2000 instances." }, - "items": { - "description": "A list of MachineTypesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of machine types.", - "$ref": "MachineTypesScopedList" - } + "patch": { + "id": "compute.regionInstanceGroupManagers.patch", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "PATCH", + "parameters": { + "instanceGroupManager": { + "description": "The name of the instance group manager.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "request": { + "$ref": "InstanceGroupManager" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listmanagedinstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. If you update your group to specify a new template or instance configuration, it's possible that your intended specification for each VM in the group is different from the current state of that VM. To learn how to apply an updated configuration to the VMs in a MIG, see Updating instances in a MIG." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "delete": { + "id": "compute.regionInstanceGroupManagers.delete", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", + "httpMethod": "DELETE", + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified managed instance group and all of the instances in that group." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "deleteInstances": { + "id": "compute.regionInstanceGroupManagers.deleteInstances", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "request": { + "$ref": "RegionInstanceGroupManagersDeleteInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Flags the specified instances in the managed instance group to be immediately deleted. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. The deleteInstances operation is marked DONE if the deleteInstances request is successful. The underlying actions take additional time. You must separately verify the status of the deleting action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "abandonInstances": { + "id": "compute.regionInstanceGroupManagers.abandonInstances", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "MachineTypesScopedList": { - "id": "MachineTypesScopedList", - "type": "object", - "properties": { - "machineTypes": { - "description": "[Output Only] A list of machine types contained in this scope.", - "type": "array", - "items": { - "$ref": "MachineType" - } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "request": { + "$ref": "RegionInstanceGroupManagersAbandonInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Flags the specified instances to be immediately removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." }, - "warning": { - "description": "[Output Only] An informational warning that appears when the machine types list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "recreateInstances": { + "id": "compute.regionInstanceGroupManagers.recreateInstances", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "NetworkAttachmentAggregatedList": { - "id": "NetworkAttachmentAggregatedList", - "description": "Contains a list of NetworkAttachmentsScopedList.", - "type": "object", - "properties": { - "kind": { - "default": "compute#networkAttachmentAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "request": { + "$ref": "RegionInstanceGroupManagersRecreateRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Flags the specified VM instances in the managed instance group to be immediately recreated. Each instance is recreated using the group's current configuration. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." }, - "items": { - "description": "A list of NetworkAttachmentsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of NetworkAttachments.", - "$ref": "NetworkAttachmentsScopedList" - } + "resize": { + "id": "compute.regionInstanceGroupManagers.resize", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resize", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resize", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "size": { + "description": "Number of instances that should exist in this instance group manager.", + "minimum": "0", + "location": "query", + "required": true, + "type": "integer", + "format": "int32" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager", + "size" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the intended size of the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes one or more instances. The resize operation is marked DONE if the resize request is successful. The underlying actions take additional time. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "setInstanceTemplate": { + "id": "compute.regionInstanceGroupManagers.setInstanceTemplate", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "request": { + "$ref": "RegionInstanceGroupManagersSetTemplateRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the instance template to use when creating new instances or recreating instances in this group. Existing instances are not affected." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "setTargetPools": { + "id": "compute.regionInstanceGroupManagers.setTargetPools", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "Name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "request": { + "$ref": "RegionInstanceGroupManagersSetTargetPoolsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Modifies the target pools to which all new instances in this group are assigned. Existing instances in the group are not affected." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listManagedInstances": { + "id": "compute.regionInstanceGroupManagers.listManagedInstances", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", + "httpMethod": "POST", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "instanceGroupManager": { + "description": "The name of the managed instance group.", + "location": "path", + "required": true, + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } - } - } - } - }, - "NetworkAttachmentsScopedList": { - "id": "NetworkAttachmentsScopedList", - "type": "object", - "properties": { - "networkAttachments": { - "description": "A list of NetworkAttachments contained in this scope.", - "type": "array", - "items": { - "$ref": "NetworkAttachment" - } - }, - "warning": { - "description": "Informational warning which replaces the list of network attachments when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "NetworkAttachment": { - "id": "NetworkAttachment", - "description": "NetworkAttachments A network attachment resource ...", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource.", - "default": "compute#networkAttachment", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.networkAttachments.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource's resource id.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the network attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "connectionPreference": { - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" ], - "enum": [ - "ACCEPT_AUTOMATIC", - "ACCEPT_MANUAL", - "INVALID" - ] - }, - "connectionEndpoints": { - "description": "[Output Only] An array of connections for all the producers connected to this network attachment.", - "type": "array", - "items": { - "$ref": "NetworkAttachmentConnectedEndpoint" - } - }, - "subnetworks": { - "description": "An array of URLs where each entry is the URL of a subnet provided by the service consumer to use for endpoints in the producers that connect to this network attachment.", - "type": "array", - "items": { - "type": "string" - } - }, - "producerRejectLists": { - "description": "Projects that are not allowed to connect to this network attachment. The project can be specified using its id or number.", - "type": "array", - "items": { - "type": "string" - } - }, - "producerAcceptLists": { - "description": "Projects that are allowed to connect to this network attachment. The project can be specified using its id or number.", - "type": "array", - "items": { - "type": "string" - } - }, - "fingerprint": { - "description": "Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. An up-to-date fingerprint must be provided in order to patch.", - "type": "string", - "format": "byte" - }, - "network": { - "description": "[Output Only] The URL of the network which the Network Attachment belongs to. Practically it is inferred by fetching the network of the first subnetwork associated. Because it is required that all the subnetworks must be from the same network, it is assured that the Network Attachment belongs to the same network as all the subnetworks.", - "type": "string" - } - } - }, - "NetworkAttachmentConnectedEndpoint": { - "id": "NetworkAttachmentConnectedEndpoint", - "description": "[Output Only] A connection connected to this network attachment.", - "type": "object", - "properties": { - "status": { - "description": "The status of a connected endpoint to this network attachment.", - "type": "string", - "enumDescriptions": [ - "The consumer allows traffic from the producer to reach its VPC.", - "The consumer network attachment no longer exists.", - "The consumer needs to take further action before traffic can be served.", - "The consumer neither allows nor prohibits traffic from the producer to reach its VPC.", - "The consumer prohibits traffic from the producer to reach its VPC.", - "" + "response": { + "$ref": "RegionInstanceGroupManagersListInstancesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ACCEPTED", - "CLOSED", - "NEEDS_ATTENTION", - "PENDING", - "REJECTED", - "STATUS_UNSPECIFIED" - ] - }, - "projectIdOrNum": { - "description": "The project id or number of the interface to which the IP was assigned.", - "type": "string" - }, - "subnetwork": { - "description": "The subnetwork used to assign the IP to the producer instance network interface.", - "type": "string" - }, - "ipAddress": { - "description": "The IPv4 address assigned to the producer instance network interface. This value will be a range in case of Serverless.", - "type": "string" - }, - "ipv6Address": { - "description": "The IPv6 address assigned to the producer instance network interface. This is only assigned when the stack types of both the instance network interface and the consumer subnet are IPv4_IPv6.", - "type": "string" - }, - "secondaryIpCidrRanges": { - "description": "Alias IP ranges from the same subnetwork.", - "type": "array", - "items": { - "type": "string" - } - }, - "subnetworkCidrRange": { - "description": "[Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from.", - "type": "string" - } - } - }, - "NetworkAttachmentList": { - "id": "NetworkAttachmentList", - "type": "object", - "properties": { - "kind": { - "default": "compute#networkAttachmentList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of NetworkAttachment resources.", - "type": "array", - "items": { - "$ref": "NetworkAttachment" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "description": "Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listErrors": { + "id": "compute.regionInstanceGroupManagers.listErrors", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listErrors", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listErrors", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "instanceGroupManager": { + "description": "The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}.", + "location": "path", + "required": true, + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request. This should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "response": { + "$ref": "RegionInstanceGroupManagersListErrorsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all errors thrown by actions on instances for a given regional managed instance group. The filter and orderBy query parameters are not supported." + }, + "listPerInstanceConfigs": { + "id": "compute.regionInstanceGroupManagers.listPerInstanceConfigs", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", + "httpMethod": "POST", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "instanceGroupManager": { + "description": "The name of the managed instance group. It should conform to RFC1035.", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request, should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "NetworkEdgeSecurityService": { - "id": "NetworkEdgeSecurityService", - "description": "Represents a Google Cloud Armor network edge security service resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output only] Type of the resource. Always compute#networkEdgeSecurityService for NetworkEdgeSecurityServices", - "default": "compute#networkEdgeSecurityService", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "response": { + "$ref": "RegionInstanceGroupManagersListInstanceConfigsResp" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" + "updatePerInstanceConfigs": { + "id": "compute.regionInstanceGroupManagers.updatePerInstanceConfigs", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request, should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "request": { + "$ref": "RegionInstanceGroupManagerUpdateInstanceConfigReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch." }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource with the resource id.", - "type": "string" + "patchPerInstanceConfigs": { + "id": "compute.regionInstanceGroupManagers.patchPerInstanceConfigs", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request, should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "request": { + "$ref": "RegionInstanceGroupManagerPatchInstanceConfigReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch." }, - "region": { - "description": "[Output Only] URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" + "deletePerInstanceConfigs": { + "id": "compute.regionInstanceGroupManagers.deletePerInstanceConfigs", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request, should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "request": { + "$ref": "RegionInstanceGroupManagerDeleteInstanceConfigReq" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes selected per-instance configurations for the managed instance group." }, - "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 NetworkEdgeSecurityService. An up-to-date fingerprint must be provided in order to update the NetworkEdgeSecurityService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a NetworkEdgeSecurityService.", - "type": "string", - "format": "byte" + "applyUpdatesToInstances": { + "id": "compute.regionInstanceGroupManagers.applyUpdatesToInstances", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group, should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request, should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "request": { + "$ref": "RegionInstanceGroupManagersApplyUpdatesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Apply updates to selected instances the managed instance group." }, - "securityPolicy": { - "description": "The resource URL for the network edge security service associated with this network edge security service.", - "type": "string" + "createInstances": { + "id": "compute.regionInstanceGroupManagers.createInstances", + "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", + "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", + "httpMethod": "POST", + "parameters": { + "instanceGroupManager": { + "description": "The name of the managed instance group. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where the managed instance group is located. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceGroupManager" + ], + "request": { + "$ref": "RegionInstanceGroupManagersCreateInstancesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates instances with per-instance configurations in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method." } } }, - "NetworkEdgeSecurityServiceAggregatedList": { - "id": "NetworkEdgeSecurityServiceAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#networkEdgeSecurityServiceAggregatedList for lists of Network Edge Security Services.", - "default": "compute#networkEdgeSecurityServiceAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of NetworkEdgeSecurityServicesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of security policies.", - "$ref": "NetworkEdgeSecurityServicesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "autoscalers": { + "methods": { + "list": { + "id": "compute.autoscalers.list", + "path": "projects/{project}/zones/{zone}/autoscalers", + "flatPath": "projects/{project}/zones/{zone}/autoscalers", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - }, - "etag": { - "type": "string" - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "NetworkEdgeSecurityServicesScopedList": { - "id": "NetworkEdgeSecurityServicesScopedList", - "type": "object", - "properties": { - "networkEdgeSecurityServices": { - "description": "A list of NetworkEdgeSecurityServices contained in this scope.", - "type": "array", - "items": { - "$ref": "NetworkEdgeSecurityService" - } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "AutoscalerList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of autoscalers contained within the specified zone." }, - "warning": { - "description": "Informational warning which replaces the list of security policies when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "id": "compute.autoscalers.aggregatedList", + "path": "projects/{project}/aggregated/autoscalers", + "flatPath": "projects/{project}/aggregated/autoscalers", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" } - } - } - } - }, - "NetworkEndpointGroupList": { - "id": "NetworkEndpointGroupList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#networkEndpointGroupList for network endpoint group lists.", - "default": "compute#networkEndpointGroupList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of NetworkEndpointGroup resources.", - "type": "array", - "items": { - "$ref": "NetworkEndpointGroup" - } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "AutoscalerAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of autoscalers. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "get": { + "id": "compute.autoscalers.get", + "path": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", + "flatPath": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", + "httpMethod": "GET", + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "autoscaler" + ], + "response": { + "$ref": "Autoscaler" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified autoscaler resource." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "insert": { + "id": "compute.autoscalers.insert", + "path": "projects/{project}/zones/{zone}/autoscalers", + "flatPath": "projects/{project}/zones/{zone}/autoscalers", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates an autoscaler in the specified project using the data included in the request." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "update": { + "id": "compute.autoscalers.update", + "path": "projects/{project}/zones/{zone}/autoscalers", + "flatPath": "projects/{project}/zones/{zone}/autoscalers", + "httpMethod": "PUT", + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates an autoscaler in the specified project using the data included in the request." + }, + "patch": { + "id": "compute.autoscalers.patch", + "path": "projects/{project}/zones/{zone}/autoscalers", + "flatPath": "projects/{project}/zones/{zone}/autoscalers", + "httpMethod": "PATCH", + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "NetworkEndpointGroup": { - "id": "NetworkEndpointGroup", - "description": "Represents a collection of network endpoints. A network endpoint group (NEG) defines how a set of endpoints should be reached, whether they are reachable, and where they are located. For more information about using NEGs for different use cases, see Network endpoint groups overview.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#networkEndpointGroup for network endpoint group.", - "default": "compute#networkEndpointGroup", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for 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. 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.", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "networkEndpointType": { - "description": "Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.", - "type": "string", - "enumDescriptions": [ - "The network endpoint is represented by an IP address.", - "The network endpoint is represented by IP address and port pair.", - "The network endpoint is represented by an IP, Port and Client Destination Port.", - "The network endpoint is represented by fully qualified domain name and port.", - "The network endpoint is represented by an internet IP address and port.", - "The network endpoint is represented by an IP address and port. The endpoint belongs to a VM or pod running in a customer's on-premises.", - "The network endpoint is either public Google APIs or services exposed by other GCP Project with a Service Attachment. The connection is set up by private service connect", - "The network endpoint is handled by specified serverless infrastructure." + }, + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "GCE_VM_IP", - "GCE_VM_IP_PORT", - "GCE_VM_IP_PORTMAP", - "INTERNET_FQDN_PORT", - "INTERNET_IP_PORT", - "NON_GCP_PRIVATE_IP_PORT", - "PRIVATE_SERVICE_CONNECT", - "SERVERLESS" - ] - }, - "size": { - "description": "[Output only] Number of network endpoints in the network endpoint group.", - "type": "integer", - "format": "int32" - }, - "region": { - "description": "[Output Only] The URL of the region where the network endpoint group is located.", - "type": "string" - }, - "zone": { - "description": "[Output Only] The URL of the zone where the network endpoint group is located.", - "type": "string" - }, - "network": { - "description": "The URL of the network to which all network endpoints in the NEG belong. Uses default project network if unspecified.", - "type": "string" - }, - "subnetwork": { - "description": "Optional URL of the subnetwork to which all network endpoints in the NEG belong.", - "type": "string" - }, - "defaultPort": { - "description": "The default port used if the port number is not specified in the network endpoint. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified.", - "type": "integer", - "format": "int32" - }, - "annotations": { - "description": "Metadata defined as annotations on the network endpoint group.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "cloudRun": { - "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set.", - "$ref": "NetworkEndpointGroupCloudRun" - }, - "appEngine": { - "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set.", - "$ref": "NetworkEndpointGroupAppEngine" - }, - "cloudFunction": { - "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set.", - "$ref": "NetworkEndpointGroupCloudFunction" - }, - "pscTargetService": { - "description": "The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: asia-northeast3-cloudkms.googleapis.com", - "type": "string" - }, - "pscData": { - "$ref": "NetworkEndpointGroupPscData" - } - } - }, - "NetworkEndpointGroupCloudRun": { - "id": "NetworkEndpointGroupCloudRun", - "description": "Configuration for a Cloud Run network endpoint group (NEG). The service must be provided explicitly or in the URL mask. The tag is optional, may be provided explicitly or in the URL mask. Note: Cloud Run service must be in the same project and located in the same region as the Serverless NEG.", - "type": "object", - "properties": { - "service": { - "description": "Cloud Run service is the main resource of Cloud Run. The service must be 1-63 characters long, and comply with RFC1035. Example value: \"run-service\".", - "type": "string" - }, - "tag": { - "description": "Optional Cloud Run tag represents the \"named-revision\" to provide additional fine-grained traffic routing information. The tag must be 1-63 characters long, and comply with RFC1035. Example value: \"revision-0010\".", - "type": "string" + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." }, - "urlMask": { - "description": "An URL mask is one of the main components of the Cloud Function. A template to parse \u003cservice\u003e and \u003ctag\u003e fields from a request URL. URL mask allows for routing to multiple Run services without having to create multiple network endpoint groups and backend services. For example, request URLs foo1.domain.com/bar1 and foo1.domain.com/bar2 can be backed by the same Serverless Network Endpoint Group (NEG) with URL mask \u003ctag\u003e.domain.com/\u003cservice\u003e. The URL mask will parse them to { service=\"bar1\", tag=\"foo1\" } and { service=\"bar2\", tag=\"foo2\" } respectively.", - "type": "string" + "delete": { + "id": "compute.autoscalers.delete", + "path": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", + "flatPath": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", + "httpMethod": "DELETE", + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "autoscaler" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified autoscaler." } } }, - "NetworkEndpointGroupAppEngine": { - "id": "NetworkEndpointGroupAppEngine", - "description": "Configuration for an App Engine network endpoint group (NEG). The service is optional, may be provided explicitly or in the URL mask. The version is optional and can only be provided explicitly or in the URL mask when service is present. Note: App Engine service must be in the same project and located in the same region as the Serverless NEG.", - "type": "object", - "properties": { - "service": { - "description": "Optional serving service. The service name is case-sensitive and must be 1-63 characters long. Example value: default, my-service.", - "type": "string" - }, - "version": { - "description": "Optional serving version. The version name is case-sensitive and must be 1-100 characters long. Example value: v1, v2.", - "type": "string" + "regionAutoscalers": { + "methods": { + "list": { + "id": "compute.regionAutoscalers.list", + "path": "projects/{project}/regions/{region}/autoscalers", + "flatPath": "projects/{project}/regions/{region}/autoscalers", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "RegionAutoscalerList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of autoscalers contained within the specified region." }, - "urlMask": { - "description": "An URL mask is one of the main components of the Cloud Function. 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. For 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 \u003cservice\u003e-dot-appname.appspot.com/\u003cversion\u003e. The URL mask will parse them to { service = \"foo1\", version = \"v1\" } and { service = \"foo1\", version = \"v2\" } respectively.", - "type": "string" - } - } - }, - "NetworkEndpointGroupCloudFunction": { - "id": "NetworkEndpointGroupCloudFunction", - "description": "Configuration for a Cloud Function network endpoint group (NEG). The function must be provided explicitly or in the URL mask. Note: Cloud Function must be in the same project and located in the same region as the Serverless NEG.", - "type": "object", - "properties": { - "function": { - "description": "A user-defined name of the Cloud Function. The function name is case-sensitive and must be 1-63 characters long. Example value: func1.", - "type": "string" + "get": { + "id": "compute.regionAutoscalers.get", + "path": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", + "flatPath": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", + "httpMethod": "GET", + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "autoscaler" + ], + "response": { + "$ref": "Autoscaler" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified autoscaler." }, - "urlMask": { - "description": "An URL mask is one of the main components of the Cloud Function. A template to parse function field from a request URL. URL mask allows for routing to multiple Cloud Functions without having to create multiple Network Endpoint Groups and backend services. For example, request URLs mydomain.com/function1 and mydomain.com/function2 can be backed by the same Serverless NEG with URL mask /\u003cfunction\u003e. The URL mask will parse them to { function = \"function1\" } and { function = \"function2\" } respectively.", - "type": "string" - } - } - }, - "NetworkEndpointGroupPscData": { - "id": "NetworkEndpointGroupPscData", - "description": "All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.", - "type": "object", - "properties": { - "consumerPscAddress": { - "description": "[Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.", - "type": "string" + "insert": { + "id": "compute.regionAutoscalers.insert", + "path": "projects/{project}/regions/{region}/autoscalers", + "flatPath": "projects/{project}/regions/{region}/autoscalers", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates an autoscaler in the specified project using the data included in the request." }, - "pscConnectionId": { - "description": "[Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.", - "type": "string", - "format": "uint64" + "update": { + "id": "compute.regionAutoscalers.update", + "path": "projects/{project}/regions/{region}/autoscalers", + "flatPath": "projects/{project}/regions/{region}/autoscalers", + "httpMethod": "PUT", + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates an autoscaler in the specified project using the data included in the request." }, - "pscConnectionStatus": { - "description": "[Output Only] The connection status of the PSC Forwarding Rule.", - "type": "string", - "enumDescriptions": [ - "The connection has been accepted by the producer.", - "The connection has been closed by the producer and will not serve traffic going forward.", - "The connection has been accepted by the producer, but the producer needs to take further action before the forwarding rule can serve traffic.", - "The connection is pending acceptance by the producer.", - "The connection has been rejected by the producer.", - "" + "patch": { + "id": "compute.regionAutoscalers.patch", + "path": "projects/{project}/regions/{region}/autoscalers", + "flatPath": "projects/{project}/regions/{region}/autoscalers", + "httpMethod": "PATCH", + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ACCEPTED", - "CLOSED", - "NEEDS_ATTENTION", - "PENDING", - "REJECTED", - "STATUS_UNSPECIFIED" - ] + "request": { + "$ref": "Autoscaler" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." }, - "producerPort": { - "description": "The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type", - "type": "integer", - "format": "int32" + "delete": { + "id": "compute.regionAutoscalers.delete", + "path": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", + "flatPath": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", + "httpMethod": "DELETE", + "parameters": { + "autoscaler": { + "description": "Name of the autoscaler to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "autoscaler" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified autoscaler." } } }, - "NetworkEndpointGroupAggregatedList": { - "id": "NetworkEndpointGroupAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#networkEndpointGroupAggregatedList for aggregated lists of network endpoint groups.", - "default": "compute#networkEndpointGroupAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of NetworkEndpointGroupsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "The name of the scope that contains this set of network endpoint groups.", - "$ref": "NetworkEndpointGroupsScopedList" - } + "backendBuckets": { + "methods": { + "list": { + "id": "compute.backendBuckets.list", + "path": "projects/{project}/global/backendBuckets", + "flatPath": "projects/{project}/global/backendBuckets", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "BackendBucketList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of BackendBucket resources available to the specified project." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "get": { + "id": "compute.backendBuckets.get", + "path": "projects/{project}/global/backendBuckets/{backendBucket}", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", + "httpMethod": "GET", + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendBucket" + ], + "response": { + "$ref": "BackendBucket" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified BackendBucket resource." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "insert": { + "id": "compute.backendBuckets.insert", + "path": "projects/{project}/global/backendBuckets", + "flatPath": "projects/{project}/global/backendBuckets", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "BackendBucket" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a BackendBucket resource in the specified project using the data included in the request." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "id": "compute.backendBuckets.delete", + "path": "projects/{project}/global/backendBuckets/{backendBucket}", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", + "httpMethod": "DELETE", + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "NetworkEndpointGroupsScopedList": { - "id": "NetworkEndpointGroupsScopedList", - "type": "object", - "properties": { - "networkEndpointGroups": { - "description": "[Output Only] The list of network endpoint groups that are contained in this scope.", - "type": "array", - "items": { - "$ref": "NetworkEndpointGroup" - } + }, + "parameterOrder": [ + "project", + "backendBucket" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified BackendBucket resource." }, - "warning": { - "description": "[Output Only] An informational warning that replaces the list of network endpoint groups when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "update": { + "id": "compute.backendBuckets.update", + "path": "projects/{project}/global/backendBuckets/{backendBucket}", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", + "httpMethod": "PUT", + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "NetworkEndpointGroupsAttachEndpointsRequest": { - "id": "NetworkEndpointGroupsAttachEndpointsRequest", - "type": "object", - "properties": { - "networkEndpoints": { - "description": "The list of network endpoints to be attached.", - "type": "array", - "items": { - "$ref": "NetworkEndpoint" - } - } - } - }, - "NetworkEndpoint": { - "id": "NetworkEndpoint", - "description": "The network endpoint.", - "type": "object", - "properties": { - "ipAddress": { - "description": "Optional IPv4 address of network endpoint. The IP address must belong to a VM in Compute Engine (either the primary IP or as part of an aliased IP range). If the IP address is not specified, then the primary IP address for the VM instance in the network that the network endpoint group belongs to will be used. This field is redundant and need not be set for network endpoints of type GCE_VM_IP. If set, it must be set to the primary internal IP address of the attached VM instance that matches the subnetwork of the NEG. The primary internal IP address from any NIC of a multi-NIC VM instance can be added to a NEG as long as it matches the NEG subnetwork.", - "type": "string" - }, - "fqdn": { - "description": "Optional fully qualified domain name of network endpoint. This can only be specified when NetworkEndpointGroup.network_endpoint_type is NON_GCP_FQDN_PORT.", - "type": "string" - }, - "port": { - "description": "Optional port number of network endpoint. If not specified, the defaultPort for the network endpoint group will be used. This field can not be set for network endpoints of type GCE_VM_IP.", - "type": "integer", - "format": "int32" - }, - "clientDestinationPort": { - "description": "Represents the port number to which PSC consumer sends packets. Only valid for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type.", - "type": "integer", - "format": "int32" - }, - "instance": { - "description": "The name or a URL of VM instance of this network endpoint. This field is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group (for zonal NEGs) or in the zone within the region of the NEG (for regional NEGs). If the ipAddress is specified, it must belongs to the VM instance. The name must be 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to an existing instance.", - "type": "string" - }, - "annotations": { - "description": "Metadata defined as annotations on the network endpoint.", - "type": "object", - "additionalProperties": { - "type": "string" - } - } - } - }, - "NetworkEndpointGroupsDetachEndpointsRequest": { - "id": "NetworkEndpointGroupsDetachEndpointsRequest", - "type": "object", - "properties": { - "networkEndpoints": { - "description": "The list of network endpoints to be detached.", - "type": "array", - "items": { - "$ref": "NetworkEndpoint" - } - } - } - }, - "NetworkEndpointGroupsListEndpointsRequest": { - "id": "NetworkEndpointGroupsListEndpointsRequest", - "type": "object", - "properties": { - "healthStatus": { - "description": "Optional query parameter for showing the health status of each network endpoint. Valid options are SKIP or SHOW. If you don't specify this parameter, the health status of network endpoints will not be provided.", - "type": "string", - "enumDescriptions": [ - "Show the health status for each network endpoint. Impacts latency of the call.", - "Health status for network endpoints will not be provided." + }, + "parameterOrder": [ + "project", + "backendBucket" ], - "enum": [ - "SHOW", - "SKIP" - ] - } - } - }, - "NetworkEndpointGroupsListNetworkEndpoints": { - "id": "NetworkEndpointGroupsListNetworkEndpoints", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute#networkEndpointGroupsListNetworkEndpoints for the list of network endpoints in the specified network endpoint group.", - "default": "compute#networkEndpointGroupsListNetworkEndpoints", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of NetworkEndpointWithHealthStatus resources.", - "type": "array", - "items": { - "$ref": "NetworkEndpointWithHealthStatus" - } + "request": { + "$ref": "BackendBucket" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified BackendBucket resource with the data included in the request." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "patch": { + "id": "compute.backendBuckets.patch", + "path": "projects/{project}/global/backendBuckets/{backendBucket}", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", + "httpMethod": "PATCH", + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendBucket" + ], + "request": { + "$ref": "BackendBucket" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified BackendBucket resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "addSignedUrlKey": { + "id": "compute.backendBuckets.addSignedUrlKey", + "path": "projects/{project}/global/backendBuckets/{backendBucket}/addSignedUrlKey", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/addSignedUrlKey", + "httpMethod": "POST", + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "NetworkEndpointWithHealthStatus": { - "id": "NetworkEndpointWithHealthStatus", - "type": "object", - "properties": { - "networkEndpoint": { - "description": "[Output only] The network endpoint;", - "$ref": "NetworkEndpoint" + }, + "parameterOrder": [ + "project", + "backendBucket" + ], + "request": { + "$ref": "SignedUrlKey" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Adds a key for validating requests with signed URLs for this backend bucket." }, - "healths": { - "description": "[Output only] The health status of network endpoint;", - "type": "array", - "items": { - "$ref": "HealthStatusForNetworkEndpoint" - } - } - } - }, - "HealthStatusForNetworkEndpoint": { - "id": "HealthStatusForNetworkEndpoint", - "type": "object", - "properties": { - "forwardingRule": { - "description": "URL of the forwarding rule associated with the health state of the network endpoint.", - "$ref": "ForwardingRuleReference" + "deleteSignedUrlKey": { + "id": "compute.backendBuckets.deleteSignedUrlKey", + "path": "projects/{project}/global/backendBuckets/{backendBucket}/deleteSignedUrlKey", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/deleteSignedUrlKey", + "httpMethod": "POST", + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "keyName": { + "description": "The name of the Signed URL Key to delete.", + "location": "query", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendBucket", + "keyName" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes a key for validating requests with signed URLs for this backend bucket." }, - "backendService": { - "description": "URL of the backend service associated with the health state of the network endpoint.", - "$ref": "BackendServiceReference" + "setEdgeSecurityPolicy": { + "id": "compute.backendBuckets.setEdgeSecurityPolicy", + "path": "projects/{project}/global/backendBuckets/{backendBucket}/setEdgeSecurityPolicy", + "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/setEdgeSecurityPolicy", + "httpMethod": "POST", + "parameters": { + "backendBucket": { + "description": "Name of the BackendBucket resource to which the security policy should be set. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendBucket" + ], + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the edge security policy for the specified backend bucket." }, - "healthCheck": { - "description": "URL of the health check associated with the health state of the network endpoint.", - "$ref": "HealthCheckReference" + "getIamPolicy": { + "id": "compute.backendBuckets.getIamPolicy", + "path": "projects/{project}/global/backendBuckets/{resource}/getIamPolicy", + "flatPath": "projects/{project}/global/backendBuckets/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "healthCheckService": { - "description": "URL of the health check service associated with the health state of the network endpoint.", - "$ref": "HealthCheckServiceReference" + "setIamPolicy": { + "id": "compute.backendBuckets.setIamPolicy", + "path": "projects/{project}/global/backendBuckets/{resource}/setIamPolicy", + "flatPath": "projects/{project}/global/backendBuckets/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "healthState": { - "description": "Health state of the network endpoint determined based on the health checks configured.", - "type": "string", - "enumDescriptions": [ - "Endpoint is being drained.", - "Endpoint is healthy.", - "Endpoint is unhealthy.", - "Health status of the endpoint is unknown." + "testIamPermissions": { + "id": "compute.backendBuckets.testIamPermissions", + "path": "projects/{project}/global/backendBuckets/{resource}/testIamPermissions", + "flatPath": "projects/{project}/global/backendBuckets/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" ], - "enum": [ - "DRAINING", - "HEALTHY", - "UNHEALTHY", - "UNKNOWN" - ] - } - } - }, - "ForwardingRuleReference": { - "id": "ForwardingRuleReference", - "type": "object", - "properties": { - "forwardingRule": { - "type": "string" - } - } - }, - "BackendServiceReference": { - "id": "BackendServiceReference", - "type": "object", - "properties": { - "backendService": { - "type": "string" - } - } - }, - "HealthCheckReference": { - "id": "HealthCheckReference", - "description": "A full or valid partial URL to a health check. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check - projects/project-id/global/httpHealthChecks/health-check - global/httpHealthChecks/health-check ", - "type": "object", - "properties": { - "healthCheck": { - "type": "string" - } - } - }, - "HealthCheckServiceReference": { - "id": "HealthCheckServiceReference", - "description": "A full or valid partial URL to a health check service. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service - projects/project-id/regions/us-west1/healthCheckServices/health-check-service - regions/us-west1/healthCheckServices/health-check-service ", - "type": "object", - "properties": { - "healthCheckService": { - "type": "string" - } - } - }, - "GlobalNetworkEndpointGroupsAttachEndpointsRequest": { - "id": "GlobalNetworkEndpointGroupsAttachEndpointsRequest", - "type": "object", - "properties": { - "networkEndpoints": { - "description": "The list of network endpoints to be attached.", - "type": "array", - "items": { - "$ref": "NetworkEndpoint" - } - } - } - }, - "GlobalNetworkEndpointGroupsDetachEndpointsRequest": { - "id": "GlobalNetworkEndpointGroupsDetachEndpointsRequest", - "type": "object", - "properties": { - "networkEndpoints": { - "description": "The list of network endpoints to be detached.", - "type": "array", - "items": { - "$ref": "NetworkEndpoint" - } - } - } - }, - "RegionNetworkEndpointGroupsAttachEndpointsRequest": { - "id": "RegionNetworkEndpointGroupsAttachEndpointsRequest", - "type": "object", - "properties": { - "networkEndpoints": { - "description": "The list of network endpoints to be attached.", - "type": "array", - "items": { - "$ref": "NetworkEndpoint" - } - } - } - }, - "RegionNetworkEndpointGroupsDetachEndpointsRequest": { - "id": "RegionNetworkEndpointGroupsDetachEndpointsRequest", - "type": "object", - "properties": { - "networkEndpoints": { - "description": "The list of network endpoints to be detached.", - "type": "array", - "items": { - "$ref": "NetworkEndpoint" - } + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "NetworkList": { - "id": "NetworkList", - "description": "Contains a list of networks.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#networkList for lists of networks.", - "default": "compute#networkList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "backendServices": { + "methods": { + "list": { + "id": "compute.backendServices.list", + "path": "projects/{project}/global/backendServices", + "flatPath": "projects/{project}/global/backendServices", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "BackendServiceList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of BackendService resources available to the specified project." }, - "items": { - "description": "A list of Network resources.", - "type": "array", - "items": { - "$ref": "Network" - } + "aggregatedList": { + "id": "compute.backendServices.aggregatedList", + "path": "projects/{project}/aggregated/backendServices", + "flatPath": "projects/{project}/aggregated/backendServices", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "BackendServiceAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of all BackendService resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "listUsable": { + "id": "compute.backendServices.listUsable", + "path": "projects/{project}/global/backendServices/listUsable", + "flatPath": "projects/{project}/global/backendServices/listUsable", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "BackendServiceListUsable" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of all usable backend services in the specified project." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "id": "compute.backendServices.get", + "path": "projects/{project}/global/backendServices/{backendService}", + "flatPath": "projects/{project}/global/backendServices/{backendService}", + "httpMethod": "GET", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendService" + ], + "response": { + "$ref": "BackendService" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified BackendService resource." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.backendServices.insert", + "path": "projects/{project}/global/backendServices", + "flatPath": "projects/{project}/global/backendServices", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "BackendService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview ." + }, + "delete": { + "id": "compute.backendServices.delete", + "path": "projects/{project}/global/backendServices/{backendService}", + "flatPath": "projects/{project}/global/backendServices/{backendService}", + "httpMethod": "DELETE", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "Network": { - "id": "Network", - "description": "Represents a VPC Network resource. Networks connect resources to each other and to the internet. For more information, read Virtual Private Cloud (VPC) Network.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#network for networks.", - "default": "compute#network", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "annotations": { - "required": [ - "compute.networks.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this field when you create the resource.", - "type": "string" - }, - "IPv4Range": { - "description": "Deprecated in favor of subnet mode networks. The range of internal addresses that are legal on this network. This range is a CIDR specification, for example: 192.168.0.0/16. Provided by the client when the network is created.", - "pattern": "[0-9]{1,3}(?:\\.[0-9]{1,3}){3}/[0-9]{1,2}", - "deprecated": true, - "type": "string" - }, - "gatewayIPv4": { - "description": "[Output Only] The gateway address for default routing out of the network, selected by Google Cloud.", - "pattern": "[0-9]{1,3}(?:\\.[0-9]{1,3}){3}", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource with the resource id.", - "type": "string" - }, - "autoCreateSubnetworks": { - "description": "Must be set to create a VPC network. If not set, a legacy network is created. When set to true, the VPC network is created in auto mode. When set to false, the VPC network is created in custom mode. An auto mode VPC network starts with one subnet per region. Each subnet has a predetermined range as described in Auto mode VPC network IP ranges. For custom mode VPC networks, you can add subnets using the subnetworks insert method.", - "type": "boolean" - }, - "subnetworks": { - "description": "[Output Only] Server-defined fully-qualified URLs for all subnetworks in this VPC network.", - "type": "array", - "items": { - "type": "string" - } - }, - "peerings": { - "description": "[Output Only] A list of network peerings for the resource.", - "type": "array", - "items": { - "$ref": "NetworkPeering" - } - }, - "routingConfig": { - "description": "The network-level routing configuration for this network. Used by Cloud Router to determine what type of network-wide routing behavior to enforce.", - "$ref": "NetworkRoutingConfig" - }, - "mtu": { - "description": "Maximum Transmission Unit in bytes. The minimum value for this field is 1300 and the maximum value is 8896. The suggested value is 1500, which is the default MTU used on the Internet, or 8896 if you want to use Jumbo frames. If unspecified, the value defaults to 1460.", - "type": "integer", - "format": "int32" - }, - "firewallPolicy": { - "description": "[Output Only] URL of the firewall policy the network is associated with.", - "type": "string" - }, - "networkFirewallPolicyEnforcementOrder": { - "description": "The network firewall policy enforcement order. Can be either AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to AFTER_CLASSIC_FIREWALL if the field is not specified.", - "type": "string", - "enumDescriptions": [ - "", - "" + "parameterOrder": [ + "project", + "backendService" ], - "enum": [ - "AFTER_CLASSIC_FIREWALL", - "BEFORE_CLASSIC_FIREWALL" - ] - }, - "enableUlaInternalIpv6": { - "description": "Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20. .", - "type": "boolean" - }, - "internalIpv6Range": { - "description": "When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field. .", - "type": "string" - } - } - }, - "NetworkPeering": { - "id": "NetworkPeering", - "description": "A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering.", - "type": "object", - "properties": { - "name": { - "description": "Name of this peering. Provided by the client when the peering is created. The name must comply with RFC1035. Specifically, the name must be 1-63 characters long and match regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all the following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", - "type": "string" - }, - "network": { - "description": "The URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network.", - "type": "string" - }, - "state": { - "description": "[Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network.", - "type": "string", - "enumDescriptions": [ - "Matching configuration exists on the peer.", - "There is no matching configuration on the peer, including the case when peer does not exist." + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "ACTIVE", - "INACTIVE" - ] - }, - "stateDetails": { - "description": "[Output Only] Details about the current state of the peering.", - "type": "string" - }, - "autoCreateRoutes": { - "description": "This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE.", - "type": "boolean" - }, - "exportCustomRoutes": { - "description": "Whether to export the custom routes to peer network. The default value is false.", - "type": "boolean" - }, - "importCustomRoutes": { - "description": "Whether to import the custom routes from peer network. The default value is false.", - "type": "boolean" - }, - "exchangeSubnetRoutes": { - "description": "Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE.", - "type": "boolean" - }, - "exportSubnetRoutesWithPublicIp": { - "description": "Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field.", - "type": "boolean" - }, - "importSubnetRoutesWithPublicIp": { - "description": "Whether subnet routes with public IP range are imported. The default value is false. IPv4 special-use ranges are always imported from peers and are not controlled by this field.", - "type": "boolean" - }, - "peerMtu": { - "description": "Maximum Transmission Unit in bytes.", - "type": "integer", - "format": "int32" + "description": "Deletes the specified BackendService resource." }, - "stackType": { - "description": "Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY.", - "type": "string", - "enumDescriptions": [ - "This Peering will allow IPv4 traffic and routes to be exchanged. Additionally if the matching peering is IPV4_IPV6, IPv6 traffic and routes will be exchanged as well.", - "This Peering will only allow IPv4 traffic and routes to be exchanged, even if the matching peering is IPV4_IPV6." - ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY" - ] - } - } - }, - "NetworkRoutingConfig": { - "id": "NetworkRoutingConfig", - "description": "A routing configuration attached to a network resource. The message includes the list of routers associated with the network, and a flag indicating the type of routing behavior to enforce network-wide.", - "type": "object", - "properties": { - "routingMode": { - "description": "The network-wide routing mode to use. If set to REGIONAL, this network's Cloud Routers will only advertise routes with subnets of this network in the same region as the router. If set to GLOBAL, this network's Cloud Routers will advertise routes with all subnets of this network, across regions.", - "type": "string", - "enumDescriptions": [ - "", - "" + "update": { + "id": "compute.backendServices.update", + "path": "projects/{project}/global/backendServices/{backendService}", + "flatPath": "projects/{project}/global/backendServices/{backendService}", + "httpMethod": "PUT", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendService" ], - "enum": [ - "GLOBAL", - "REGIONAL" - ] - } - } - }, - "NetworksUpdatePeeringRequest": { - "id": "NetworksUpdatePeeringRequest", - "type": "object", - "properties": { - "networkPeering": { - "$ref": "NetworkPeering" - } - } - }, - "NetworksAddPeeringRequest": { - "id": "NetworksAddPeeringRequest", - "type": "object", - "properties": { - "name": { - "description": "Name of the peering, which should conform to RFC1035.", - "annotations": { - "required": [ - "compute.networks.addPeering" - ] + "request": { + "$ref": "BackendService" }, - "type": "string" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified BackendService resource with the data included in the request. For more information, see Backend services overview." }, - "peerNetwork": { - "description": "URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network.", - "type": "string" + "patch": { + "id": "compute.backendServices.patch", + "path": "projects/{project}/global/backendServices/{backendService}", + "flatPath": "projects/{project}/global/backendServices/{backendService}", + "httpMethod": "PATCH", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendService" + ], + "request": { + "$ref": "BackendService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified BackendService resource with the data included in the request. For more information, see Backend services overview. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." }, - "autoCreateRoutes": { - "description": "This field will be deprecated soon. Use exchange_subnet_routes in network_peering instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE.", - "type": "boolean" + "addSignedUrlKey": { + "id": "compute.backendServices.addSignedUrlKey", + "path": "projects/{project}/global/backendServices/{backendService}/addSignedUrlKey", + "flatPath": "projects/{project}/global/backendServices/{backendService}/addSignedUrlKey", + "httpMethod": "POST", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendService" + ], + "request": { + "$ref": "SignedUrlKey" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Adds a key for validating requests with signed URLs for this backend service." }, - "networkPeering": { - "description": "Network peering parameters. In order to specify route policies for peering using import and export custom routes, you must specify all peering related parameters (name, peer network, exchange_subnet_routes) in the network_peering field. The corresponding fields in NetworksAddPeeringRequest will be deprecated soon.", - "$ref": "NetworkPeering" - } - } - }, - "NetworksRemovePeeringRequest": { - "id": "NetworksRemovePeeringRequest", - "type": "object", - "properties": { - "name": { - "description": "Name of the peering, which should conform to RFC1035.", - "type": "string" - } - } - }, - "NetworksGetEffectiveFirewallsResponse": { - "id": "NetworksGetEffectiveFirewallsResponse", - "type": "object", - "properties": { - "firewalls": { - "description": "Effective firewalls on the network.", - "type": "array", - "items": { - "$ref": "Firewall" - } + "deleteSignedUrlKey": { + "id": "compute.backendServices.deleteSignedUrlKey", + "path": "projects/{project}/global/backendServices/{backendService}/deleteSignedUrlKey", + "flatPath": "projects/{project}/global/backendServices/{backendService}/deleteSignedUrlKey", + "httpMethod": "POST", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "keyName": { + "description": "The name of the Signed URL Key to delete.", + "location": "query", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendService", + "keyName" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes a key for validating requests with signed URLs for this backend service." }, - "firewallPolicys": { - "description": "Effective firewalls from firewall policy.", - "type": "array", - "items": { - "$ref": "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy" - } - } - } - }, - "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { - "id": "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy", - "type": "object", - "properties": { - "name": { - "description": "[Output Only] The name of the firewall policy.", - "type": "string" + "setSecurityPolicy": { + "id": "compute.backendServices.setSecurityPolicy", + "path": "projects/{project}/global/backendServices/{backendService}/setSecurityPolicy", + "flatPath": "projects/{project}/global/backendServices/{backendService}/setSecurityPolicy", + "httpMethod": "POST", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendService" + ], + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview" }, - "type": { - "description": "[Output Only] The type of the firewall policy.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "setEdgeSecurityPolicy": { + "id": "compute.backendServices.setEdgeSecurityPolicy", + "path": "projects/{project}/global/backendServices/{backendService}/setEdgeSecurityPolicy", + "flatPath": "projects/{project}/global/backendServices/{backendService}/setEdgeSecurityPolicy", + "httpMethod": "POST", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the edge security policy should be set. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendService" ], - "enum": [ - "HIERARCHY", - "NETWORK", - "SYSTEM", - "UNSPECIFIED" - ] + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the edge security policy for the specified backend service." }, - "shortName": { - "description": "[Output Only] The short name of the firewall policy.", - "type": "string" + "getHealth": { + "id": "compute.backendServices.getHealth", + "path": "projects/{project}/global/backendServices/{backendService}/getHealth", + "flatPath": "projects/{project}/global/backendServices/{backendService}/getHealth", + "httpMethod": "POST", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the queried instance belongs.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "backendService" + ], + "request": { + "$ref": "ResourceGroupReference" + }, + "response": { + "$ref": "BackendServiceGroupHealth" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the most recent health check results for this BackendService. Example request body: { \"group\": \"/zones/us-east1-b/instanceGroups/lb-backend-example\" }" }, - "displayName": { - "description": "[Output Only] Deprecated, please use short name instead. The display name of the firewall policy.", - "deprecated": true, - "type": "string" + "getIamPolicy": { + "id": "compute.backendServices.getIamPolicy", + "path": "projects/{project}/global/backendServices/{resource}/getIamPolicy", + "flatPath": "projects/{project}/global/backendServices/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "rules": { - "description": "The rules that apply to the network.", - "type": "array", - "items": { - "$ref": "FirewallPolicyRule" - } + "setIamPolicy": { + "id": "compute.backendServices.setIamPolicy", + "path": "projects/{project}/global/backendServices/{resource}/setIamPolicy", + "flatPath": "projects/{project}/global/backendServices/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "priority": { - "description": "[Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY.", - "type": "integer", - "format": "int32" + "testIamPermissions": { + "id": "compute.backendServices.testIamPermissions", + "path": "projects/{project}/global/backendServices/{resource}/testIamPermissions", + "flatPath": "projects/{project}/global/backendServices/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "ExchangedPeeringRoutesList": { - "id": "ExchangedPeeringRoutesList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#exchangedPeeringRoutesList for exchanged peering routes lists.", - "default": "compute#exchangedPeeringRoutesList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of ExchangedPeeringRoute resources.", - "type": "array", - "items": { - "$ref": "ExchangedPeeringRoute" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "regionBackendServices": { + "methods": { + "list": { + "id": "compute.regionBackendServices.list", + "path": "projects/{project}/regions/{region}/backendServices", + "flatPath": "projects/{project}/regions/{region}/backendServices", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "BackendServiceList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of regional BackendService resources available to the specified project in the given region." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "listUsable": { + "id": "compute.regionBackendServices.listUsable", + "path": "projects/{project}/regions/{region}/backendServices/listUsable", + "flatPath": "projects/{project}/regions/{region}/backendServices/listUsable", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request. It must be a string that meets the requirements in RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "BackendServiceListUsable" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of all usable backend services in the specified project in the given region." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "id": "compute.regionBackendServices.get", + "path": "projects/{project}/regions/{region}/backendServices/{backendService}", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", + "httpMethod": "GET", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "response": { + "$ref": "BackendService" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified regional BackendService resource." + }, + "insert": { + "id": "compute.regionBackendServices.insert", + "path": "projects/{project}/regions/{region}/backendServices", + "flatPath": "projects/{project}/regions/{region}/backendServices", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "ExchangedPeeringRoute": { - "id": "ExchangedPeeringRoute", - "type": "object", - "properties": { - "destRange": { - "description": "The destination range of the route.", - "type": "string" - }, - "type": { - "description": "The type of the peering route.", - "type": "string", - "enumDescriptions": [ - "For routes exported from local network.", - "The peering route.", - "The peering route corresponding to subnetwork range." + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "DYNAMIC_PEERING_ROUTE", - "STATIC_PEERING_ROUTE", - "SUBNET_PEERING_ROUTE" - ] - }, - "nextHopRegion": { - "description": "The region of peering route next hop, only applies to dynamic routes.", - "type": "string" - }, - "priority": { - "description": "The priority of the peering route.", - "type": "integer", - "format": "uint32" + "request": { + "$ref": "BackendService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a regional BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview." }, - "imported": { - "description": "True if the peering route has been imported from a peer. The actual import happens if the field networkPeering.importCustomRoutes is true for this network, and networkPeering.exportCustomRoutes is true for the peer network, and the import does not result in a route conflict.", - "type": "boolean" - } - } - }, - "NodeGroupList": { - "id": "NodeGroupList", - "description": "Contains a list of nodeGroups.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource.Always compute#nodeGroupList for lists of node groups.", - "default": "compute#nodeGroupList", - "type": "string" + "delete": { + "id": "compute.regionBackendServices.delete", + "path": "projects/{project}/regions/{region}/backendServices/{backendService}", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", + "httpMethod": "DELETE", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified regional BackendService resource." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "update": { + "id": "compute.regionBackendServices.update", + "path": "projects/{project}/regions/{region}/backendServices/{backendService}", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", + "httpMethod": "PUT", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "request": { + "$ref": "BackendService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified regional BackendService resource with the data included in the request. For more information, see Backend services overview ." }, - "items": { - "description": "A list of NodeGroup resources.", - "type": "array", - "items": { - "$ref": "NodeGroup" - } + "patch": { + "id": "compute.regionBackendServices.patch", + "path": "projects/{project}/regions/{region}/backendServices/{backendService}", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", + "httpMethod": "PATCH", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "request": { + "$ref": "BackendService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified regional BackendService resource with the data included in the request. For more information, see Understanding backend services This method supports PATCH semantics and uses the JSON merge patch format and processing rules." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "setSecurityPolicy": { + "id": "compute.regionBackendServices.setSecurityPolicy", + "path": "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy", + "httpMethod": "POST", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview" }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "getHealth": { + "id": "compute.regionBackendServices.getHealth", + "path": "projects/{project}/regions/{region}/backendServices/{backendService}/getHealth", + "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}/getHealth", + "httpMethod": "POST", + "parameters": { + "backendService": { + "description": "Name of the BackendService resource for which to get health.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "backendService" + ], + "request": { + "$ref": "ResourceGroupReference" + }, + "response": { + "$ref": "BackendServiceGroupHealth" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the most recent health check results for this regional BackendService." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getIamPolicy": { + "id": "compute.regionBackendServices.getIamPolicy", + "path": "projects/{project}/regions/{region}/backendServices/{resource}/getIamPolicy", + "flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + }, + "setIamPolicy": { + "id": "compute.regionBackendServices.setIamPolicy", + "path": "projects/{project}/regions/{region}/backendServices/{resource}/setIamPolicy", + "flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "NodeGroup": { - "id": "NodeGroup", - "description": "Represents a sole-tenant Node Group resource. A sole-tenant node is a physical server that is dedicated to hosting VM instances only for your specific project. Use sole-tenant nodes to keep your instances physically separated from instances in other projects, or to group your instances together on the same host hardware. For more information, read Sole-tenant nodes.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The type of the resource. Always compute#nodeGroup for node group.", - "default": "compute#nodeGroup", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "nodeTemplate": { - "description": "URL of the node template to create the node group from.", - "type": "string" - }, - "zone": { - "description": "[Output Only] The name of the zone where the node group resides, such as us-central1-a.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "status": { - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + }, + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY" - ] - }, - "size": { - "description": "[Output Only] The total number of nodes in the node group.", - "type": "integer", - "format": "int32" - }, - "autoscalingPolicy": { - "description": "Specifies how autoscaling should behave.", - "$ref": "NodeGroupAutoscalingPolicy" - }, - "maintenancePolicy": { - "description": "Specifies how to handle instances when a node in the group undergoes maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more information, see Maintenance policies.", - "type": "string", - "enumDescriptions": [ - "Allow the node and corresponding instances to retain default maintenance behavior.", - "", - "When maintenance must be done on a node, the instances on that node will be moved to other nodes in the group. Instances with onHostMaintenance = MIGRATE will live migrate to their destinations while instances with onHostMaintenance = TERMINATE will terminate and then restart on their destination nodes if automaticRestart = true.", - "Instances in this group will restart on the same node when maintenance has completed. Instances must have onHostMaintenance = TERMINATE, and they will only restart if automaticRestart = true." + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "DEFAULT", - "MAINTENANCE_POLICY_UNSPECIFIED", - "MIGRATE_WITHIN_NODE_GROUP", - "RESTART_IN_PLACE" - ] - }, - "locationHint": { - "description": "An opaque location hint used to place the Node close to other resources. This field is for use by internal tools that use the public API. The location hint here on the NodeGroup overrides any location_hint present in the NodeTemplate.", - "type": "string" - }, - "fingerprint": { - "type": "string", - "format": "byte" - }, - "maintenanceWindow": { - "$ref": "NodeGroupMaintenanceWindow" - }, - "shareSettings": { - "description": "Share-settings for the node group", - "$ref": "ShareSettings" + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "maintenanceInterval": { - "description": "Specifies the frequency of planned maintenance events. The accepted values are: `AS_NEEDED` and `RECURRENT`.", - "type": "string", - "enumDescriptions": [ - "VMs are eligible to receive infrastructure and hypervisor updates as they become available. This may result in more maintenance operations (live migrations or terminations) for the VM than the PERIODIC and RECURRENT options.", - "VMs receive infrastructure and hypervisor updates on a periodic basis, minimizing the number of maintenance operations (live migrations or terminations) on an individual VM. This may mean a VM will take longer to receive an update than if it was configured for AS_NEEDED. Security updates will still be applied as soon as they are available. RECURRENT is used for GEN3 and Slice of Hardware VMs." + "testIamPermissions": { + "id": "compute.regionBackendServices.testIamPermissions", + "path": "projects/{project}/regions/{region}/backendServices/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "AS_NEEDED", - "RECURRENT" - ] - } - } - }, - "NodeGroupAutoscalingPolicy": { - "id": "NodeGroupAutoscalingPolicy", - "type": "object", - "properties": { - "mode": { - "description": "The autoscaling mode. Set to one of: ON, OFF, or ONLY_SCALE_OUT. For more information, see Autoscaler modes.", - "type": "string", - "enumDescriptions": [ - "", - "Autoscaling is disabled.", - "Autocaling is fully enabled.", - "Autoscaling will only scale out and will not remove nodes." + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "MODE_UNSPECIFIED", - "OFF", - "ON", - "ONLY_SCALE_OUT" - ] - }, - "minNodes": { - "description": "The minimum number of nodes that the group should have.", - "type": "integer", - "format": "int32" - }, - "maxNodes": { - "description": "The maximum number of nodes that the group should have. Must be set if autoscaling is enabled. Maximum value allowed is 100.", - "type": "integer", - "format": "int32" - } - } - }, - "NodeGroupMaintenanceWindow": { - "id": "NodeGroupMaintenanceWindow", - "description": "Time window specified for daily maintenance operations. GCE's internal maintenance will be performed within this window.", - "type": "object", - "properties": { - "startTime": { - "description": "Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid.", - "type": "string" - }, - "maintenanceDuration": { - "description": "[Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario.", - "$ref": "Duration" + "description": "Returns permissions that a caller has on the specified resource." } } }, - "NodeGroupAggregatedList": { - "id": "NodeGroupAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource.Always compute#nodeGroupAggregatedList for aggregated lists of node groups.", - "default": "compute#nodeGroupAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of NodeGroupsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of node groups.", - "$ref": "NodeGroupsScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "regionCommitments": { + "methods": { + "list": { + "id": "compute.regionCommitments.list", + "path": "projects/{project}/regions/{region}/commitments", + "flatPath": "projects/{project}/regions/{region}/commitments", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "CommitmentList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of commitments contained within the specified region." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "aggregatedList": { + "id": "compute.regionCommitments.aggregatedList", + "path": "projects/{project}/aggregated/commitments", + "flatPath": "projects/{project}/aggregated/commitments", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "CommitmentAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of commitments by region. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + }, + "get": { + "id": "compute.regionCommitments.get", + "path": "projects/{project}/regions/{region}/commitments/{commitment}", + "flatPath": "projects/{project}/regions/{region}/commitments/{commitment}", + "httpMethod": "GET", + "parameters": { + "commitment": { + "description": "Name of the commitment to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "region", + "commitment" + ], + "response": { + "$ref": "Commitment" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified commitment resource." }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "NodeGroupsScopedList": { - "id": "NodeGroupsScopedList", - "type": "object", - "properties": { - "nodeGroups": { - "description": "[Output Only] A list of node groups contained in this scope.", - "type": "array", - "items": { - "$ref": "NodeGroup" - } + "insert": { + "id": "compute.regionCommitments.insert", + "path": "projects/{project}/regions/{region}/commitments", + "flatPath": "projects/{project}/regions/{region}/commitments", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "Commitment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a commitment in the specified project using the data included in the request." }, - "warning": { - "description": "[Output Only] An informational warning that appears when the nodeGroup list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "update": { + "id": "compute.regionCommitments.update", + "path": "projects/{project}/regions/{region}/commitments/{commitment}", + "flatPath": "projects/{project}/regions/{region}/commitments/{commitment}", + "httpMethod": "PATCH", + "parameters": { + "commitment": { + "description": "Name of the commitment for which auto renew is being updated.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "paths": { + "location": "query", + "repeated": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" } - } - } - } - }, - "NodeGroupsAddNodesRequest": { - "id": "NodeGroupsAddNodesRequest", - "type": "object", - "properties": { - "additionalNodeCount": { - "description": "Count of additional nodes to be added to the node group.", - "type": "integer", - "format": "int32" - } - } - }, - "NodeGroupsDeleteNodesRequest": { - "id": "NodeGroupsDeleteNodesRequest", - "type": "object", - "properties": { - "nodes": { - "description": "Names of the nodes to delete.", - "type": "array", - "items": { - "type": "string" - } + }, + "parameterOrder": [ + "project", + "region", + "commitment" + ], + "request": { + "$ref": "Commitment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified commitment with the data included in the request. Update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: auto_renew." } } }, - "NodeGroupsListNodes": { - "id": "NodeGroupsListNodes", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The resource type, which is always compute.nodeGroupsListNodes for the list of nodes in the specified node group.", - "default": "compute#nodeGroupsListNodes", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Node resources.", - "type": "array", - "items": { - "$ref": "NodeGroupNode" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "diskTypes": { + "methods": { + "list": { + "id": "compute.diskTypes.list", + "path": "projects/{project}/zones/{zone}/diskTypes", + "flatPath": "projects/{project}/zones/{zone}/diskTypes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "DiskTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of disk types available to the specified project." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "id": "compute.diskTypes.aggregatedList", + "path": "projects/{project}/aggregated/diskTypes", + "flatPath": "projects/{project}/aggregated/diskTypes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" } - } - } - } - }, - "NodeGroupNode": { - "id": "NodeGroupNode", - "type": "object", - "properties": { - "name": { - "description": "The name of the node.", - "type": "string" - }, - "status": { - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" + }, + "parameterOrder": [ + "project" ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY", - "REPAIRING" - ] - }, - "nodeType": { - "description": "The type of this node.", - "type": "string" - }, - "serverBinding": { - "description": "Binding properties for the physical server.", - "$ref": "ServerBinding" - }, - "serverId": { - "description": "Server ID associated with this node.", - "type": "string" - }, - "disks": { - "description": "Local disk configurations.", - "type": "array", - "items": { - "$ref": "LocalDisk" - } - }, - "accelerators": { - "description": "Accelerators for this node.", - "type": "array", - "items": { - "$ref": "AcceleratorConfig" - } - }, - "instances": { - "description": "Instances scheduled on this node.", - "type": "array", - "items": { - "type": "string" - } - }, - "instanceConsumptionData": { - "description": "Instance data that shows consumed resources on the node.", - "type": "array", - "items": { - "$ref": "InstanceConsumptionData" - } - }, - "consumedResources": { - "description": "Node resources that are reserved by all instances.", - "$ref": "InstanceConsumptionInfo" - }, - "totalResources": { - "description": "Total amount of available resources on the node.", - "$ref": "InstanceConsumptionInfo" - }, - "cpuOvercommitType": { - "description": "CPU overcommit.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "response": { + "$ref": "DiskTypeAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "CPU_OVERCOMMIT_TYPE_UNSPECIFIED", - "ENABLED", - "NONE" - ] - }, - "satisfiesPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" + "description": "Retrieves an aggregated list of disk types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "upcomingMaintenance": { - "description": "[Output Only] The information about an upcoming maintenance event.", - "$ref": "UpcomingMaintenance" - } - } - }, - "ServerBinding": { - "id": "ServerBinding", - "type": "object", - "properties": { - "type": { - "type": "string", - "enumDescriptions": [ - "Node may associate with any physical server over its lifetime.", - "Node may associate with minimal physical servers over its lifetime.", - "" + "get": { + "id": "compute.diskTypes.get", + "path": "projects/{project}/zones/{zone}/diskTypes/{diskType}", + "flatPath": "projects/{project}/zones/{zone}/diskTypes/{diskType}", + "httpMethod": "GET", + "parameters": { + "diskType": { + "description": "Name of the disk type to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "diskType" ], - "enum": [ - "RESTART_NODE_ON_ANY_SERVER", - "RESTART_NODE_ON_MINIMAL_SERVERS", - "SERVER_BINDING_TYPE_UNSPECIFIED" - ] - } - } - }, - "LocalDisk": { - "id": "LocalDisk", - "type": "object", - "properties": { - "diskType": { - "description": "Specifies the desired disk type on the node. This disk type must be a local storage type (e.g.: local-ssd). Note that for nodeTemplates, this should be the name of the disk type and not its URL.", - "type": "string" - }, - "diskSizeGb": { - "description": "Specifies the size of the disk in base-2 GB.", - "type": "integer", - "format": "int32" - }, - "diskCount": { - "description": "Specifies the number of such disks.", - "type": "integer", - "format": "int32" - } - } - }, - "InstanceConsumptionData": { - "id": "InstanceConsumptionData", - "type": "object", - "properties": { - "instance": { - "description": "Server-defined URL for the instance.", - "type": "string" - }, - "consumptionInfo": { - "description": "Resources consumed by the instance.", - "$ref": "InstanceConsumptionInfo" - } - } - }, - "InstanceConsumptionInfo": { - "id": "InstanceConsumptionInfo", - "type": "object", - "properties": { - "minNodeCpus": { - "description": "The minimal guaranteed number of virtual CPUs that are reserved.", - "type": "integer", - "format": "int32" - }, - "guestCpus": { - "description": "The number of virtual CPUs that are available to the instance.", - "type": "integer", - "format": "int32" - }, - "memoryMb": { - "description": "The amount of physical memory available to the instance, defined in MiB.", - "type": "integer", - "format": "int32" - }, - "localSsdGb": { - "description": "The amount of local SSD storage available to the instance, defined in GiB.", - "type": "integer", - "format": "int32" - } - } - }, - "NodeGroupsSetNodeTemplateRequest": { - "id": "NodeGroupsSetNodeTemplateRequest", - "type": "object", - "properties": { - "nodeTemplate": { - "description": "Full or partial URL of the node template resource to be updated for this node group.", - "type": "string" - } - } - }, - "NodeGroupsSimulateMaintenanceEventRequest": { - "id": "NodeGroupsSimulateMaintenanceEventRequest", - "type": "object", - "properties": { - "nodes": { - "description": "Names of the nodes to go under maintenance simulation.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "NodeGroupsPerformMaintenanceRequest": { - "id": "NodeGroupsPerformMaintenanceRequest", - "type": "object", - "properties": { - "nodes": { - "description": "[Required] List of nodes affected by the call.", - "type": "array", - "items": { - "type": "string" - } - }, - "startTime": { - "description": "The start time of the schedule. The timestamp is an RFC3339 string.", - "type": "string" + "response": { + "$ref": "DiskType" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified disk type." } } }, - "NodeTemplateList": { - "id": "NodeTemplateList", - "description": "Contains a list of node templates.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource.Always compute#nodeTemplateList for lists of node templates.", - "default": "compute#nodeTemplateList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of NodeTemplate resources.", - "type": "array", - "items": { - "$ref": "NodeTemplate" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "regionDiskTypes": { + "methods": { + "list": { + "id": "compute.regionDiskTypes.list", + "path": "projects/{project}/regions/{region}/diskTypes", + "flatPath": "projects/{project}/regions/{region}/diskTypes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "RegionDiskTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of regional disk types available to the specified project." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "id": "compute.regionDiskTypes.get", + "path": "projects/{project}/regions/{region}/diskTypes/{diskType}", + "flatPath": "projects/{project}/regions/{region}/diskTypes/{diskType}", + "httpMethod": "GET", + "parameters": { + "diskType": { + "description": "Name of the disk type to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "NodeTemplate": { - "id": "NodeTemplate", - "description": "Represent a sole-tenant Node Template resource. You can use a template to define properties for nodes in a node group. For more information, read Creating node groups and instances.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The type of the resource. Always compute#nodeTemplate for node templates.", - "default": "compute#nodeTemplate", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "nodeType": { - "description": "The node type to use for nodes group that are created from this template.", - "type": "string" - }, - "nodeAffinityLabels": { - "description": "Labels to use for node affinity, which will be used in instance scheduling.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "status": { - "description": "[Output Only] The status of the node template. One of the following values: CREATING, READY, and DELETING.", - "type": "string", - "enumDescriptions": [ - "Resources are being allocated.", - "The node template is currently being deleted.", - "Invalid status.", - "The node template is ready." + }, + "parameterOrder": [ + "project", + "region", + "diskType" ], - "enum": [ - "CREATING", - "DELETING", - "INVALID", - "READY" - ] - }, - "statusMessage": { - "description": "[Output Only] An optional, human-readable explanation of the status.", - "type": "string" - }, - "region": { - "description": "[Output Only] The name of the region where the node template resides, such as us-central1.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "nodeTypeFlexibility": { - "description": "Do not use. Instead, use the node_type property.", - "$ref": "NodeTemplateNodeTypeFlexibility" - }, - "serverBinding": { - "description": "Sets the binding properties for the physical server. Valid values include: - *[Default]* RESTART_NODE_ON_ANY_SERVER: Restarts VMs on any available physical server - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same physical server whenever possible See Sole-tenant node options for more information.", - "$ref": "ServerBinding" - }, - "disks": { - "type": "array", - "items": { - "$ref": "LocalDisk" - } - }, - "accelerators": { - "type": "array", - "items": { - "$ref": "AcceleratorConfig" - } - }, - "cpuOvercommitType": { - "description": "CPU overcommit.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "response": { + "$ref": "DiskType" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "CPU_OVERCOMMIT_TYPE_UNSPECIFIED", - "ENABLED", - "NONE" - ] - } - } - }, - "NodeTemplateNodeTypeFlexibility": { - "id": "NodeTemplateNodeTypeFlexibility", - "type": "object", - "properties": { - "cpus": { - "type": "string" - }, - "memory": { - "type": "string" - }, - "localSsd": { - "type": "string" + "description": "Returns the specified regional disk type." } } }, - "NodeTemplateAggregatedList": { - "id": "NodeTemplateAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource.Always compute#nodeTemplateAggregatedList for aggregated lists of node templates.", - "default": "compute#nodeTemplateAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "externalVpnGateways": { + "methods": { + "insert": { + "id": "compute.externalVpnGateways.insert", + "path": "projects/{project}/global/externalVpnGateways", + "flatPath": "projects/{project}/global/externalVpnGateways", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "ExternalVpnGateway" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a ExternalVpnGateway in the specified project using the data included in the request." }, - "items": { - "description": "A list of NodeTemplatesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of node templates.", - "$ref": "NodeTemplatesScopedList" - } + "list": { + "id": "compute.externalVpnGateways.list", + "path": "projects/{project}/global/externalVpnGateways", + "flatPath": "projects/{project}/global/externalVpnGateways", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "ExternalVpnGatewayList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of ExternalVpnGateway available to the specified project." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "get": { + "id": "compute.externalVpnGateways.get", + "path": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", + "flatPath": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", + "httpMethod": "GET", + "parameters": { + "externalVpnGateway": { + "description": "Name of the externalVpnGateway to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "externalVpnGateway" + ], + "response": { + "$ref": "ExternalVpnGateway" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified externalVpnGateway. Get a list of available externalVpnGateways by making a list() request." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "delete": { + "id": "compute.externalVpnGateways.delete", + "path": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", + "flatPath": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", + "httpMethod": "DELETE", + "parameters": { + "externalVpnGateway": { + "description": "Name of the externalVpnGateways to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "externalVpnGateway" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified externalVpnGateway." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "id": "compute.externalVpnGateways.testIamPermissions", + "path": "projects/{project}/global/externalVpnGateways/{resource}/testIamPermissions", + "flatPath": "projects/{project}/global/externalVpnGateways/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." + }, + "setLabels": { + "id": "compute.externalVpnGateways.setLabels", + "path": "projects/{project}/global/externalVpnGateways/{resource}/setLabels", + "flatPath": "projects/{project}/global/externalVpnGateways/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on an ExternalVpnGateway. To learn more about labels, read the Labeling Resources documentation." } } }, - "NodeTemplatesScopedList": { - "id": "NodeTemplatesScopedList", - "type": "object", - "properties": { - "nodeTemplates": { - "description": "[Output Only] A list of node templates contained in this scope.", - "type": "array", - "items": { - "$ref": "NodeTemplate" - } - }, - "warning": { - "description": "[Output Only] An informational warning that appears when the node templates list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "globalForwardingRules": { + "methods": { + "list": { + "id": "compute.globalForwardingRules.list", + "path": "projects/{project}/global/forwardingRules", + "flatPath": "projects/{project}/global/forwardingRules", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "NodeTypeList": { - "id": "NodeTypeList", - "description": "Contains a list of node types.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource.Always compute#nodeTypeList for lists of node types.", - "default": "compute#nodeTypeList", - "type": "string" + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "ForwardingRuleList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of GlobalForwardingRule resources available to the specified project." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "get": { + "id": "compute.globalForwardingRules.get", + "path": "projects/{project}/global/forwardingRules/{forwardingRule}", + "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", + "httpMethod": "GET", + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "forwardingRule" + ], + "response": { + "$ref": "ForwardingRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified GlobalForwardingRule resource. Gets a list of available forwarding rules by making a list() request." }, - "items": { - "description": "A list of NodeType resources.", - "type": "array", - "items": { - "$ref": "NodeType" - } + "insert": { + "id": "compute.globalForwardingRules.insert", + "path": "projects/{project}/global/forwardingRules", + "flatPath": "projects/{project}/global/forwardingRules", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "ForwardingRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a GlobalForwardingRule resource in the specified project using the data included in the request." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "delete": { + "id": "compute.globalForwardingRules.delete", + "path": "projects/{project}/global/forwardingRules/{forwardingRule}", + "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", + "httpMethod": "DELETE", + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "forwardingRule" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified GlobalForwardingRule resource." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "setTarget": { + "id": "compute.globalForwardingRules.setTarget", + "path": "projects/{project}/global/forwardingRules/{forwardingRule}/setTarget", + "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}/setTarget", + "httpMethod": "POST", + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource in which target is to be set.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "forwardingRule" + ], + "request": { + "$ref": "TargetReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes target URL for the GlobalForwardingRule resource. The new target should be of the same type as the old target." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "id": "compute.globalForwardingRules.patch", + "path": "projects/{project}/global/forwardingRules/{forwardingRule}", + "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", + "httpMethod": "PATCH", + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "forwardingRule" + ], + "request": { + "$ref": "ForwardingRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified forwarding rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. Currently, you can only patch the network_tier field." + }, + "setLabels": { + "id": "compute.globalForwardingRules.setLabels", + "path": "projects/{project}/global/forwardingRules/{resource}/setLabels", + "flatPath": "projects/{project}/global/forwardingRules/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "NodeType": { - "id": "NodeType", - "description": "Represent a sole-tenant Node Type resource. Each node within a node group must have a node type. A node type specifies the total amount of cores and memory for that node. Currently, the only available node type is n1-node-96-624 node type that has 96 vCPUs and 624 GB of memory, available in multiple zones. For more information read Node types.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The type of the resource. Always compute#nodeType for node types.", - "default": "compute#nodeType", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "[Output Only] Name of the resource.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - }, - "description": { - "description": "[Output Only] An optional textual description of the resource.", - "type": "string" - }, - "cpuPlatform": { - "description": "[Output Only] The CPU platform used by this node type.", - "type": "string" - }, - "guestCpus": { - "description": "[Output Only] The number of virtual CPUs that are available to the node type.", - "type": "integer", - "format": "int32" - }, - "memoryMb": { - "description": "[Output Only] The amount of physical memory available to the node type, defined in MB.", - "type": "integer", - "format": "int32" - }, - "localSsdGb": { - "description": "[Output Only] Local SSD available to the node type, defined in GB.", - "type": "integer", - "format": "int32" - }, - "deprecated": { - "description": "[Output Only] The deprecation status associated with this node type.", - "$ref": "DeprecationStatus" - }, - "zone": { - "description": "[Output Only] The name of the zone where the node type resides, such as us-central1-a.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on the specified resource. To learn more about labels, read the Labeling resources documentation." } } }, - "NodeTypeAggregatedList": { - "id": "NodeTypeAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource.Always compute#nodeTypeAggregatedList for aggregated lists of node types.", - "default": "compute#nodeTypeAggregatedList", - "type": "string" + "forwardingRules": { + "methods": { + "list": { + "id": "compute.forwardingRules.list", + "path": "projects/{project}/regions/{region}/forwardingRules", + "flatPath": "projects/{project}/regions/{region}/forwardingRules", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "ForwardingRuleList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of ForwardingRule resources available to the specified project and region." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "aggregatedList": { + "id": "compute.forwardingRules.aggregatedList", + "path": "projects/{project}/aggregated/forwardingRules", + "flatPath": "projects/{project}/aggregated/forwardingRules", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "ForwardingRuleAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of forwarding rules. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "items": { - "description": "A list of NodeTypesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of node types.", - "$ref": "NodeTypesScopedList" - } + "get": { + "id": "compute.forwardingRules.get", + "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "httpMethod": "GET", + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "forwardingRule" + ], + "response": { + "$ref": "ForwardingRule" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified ForwardingRule resource." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "insert": { + "id": "compute.forwardingRules.insert", + "path": "projects/{project}/regions/{region}/forwardingRules", + "flatPath": "projects/{project}/regions/{region}/forwardingRules", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "ForwardingRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a ForwardingRule resource in the specified project and region using the data included in the request." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "delete": { + "id": "compute.forwardingRules.delete", + "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "httpMethod": "DELETE", + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "forwardingRule" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified ForwardingRule resource." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setTarget": { + "id": "compute.forwardingRules.setTarget", + "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}/setTarget", + "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}/setTarget", + "httpMethod": "POST", + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource in which target is to be set.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "NodeTypesScopedList": { - "id": "NodeTypesScopedList", - "type": "object", - "properties": { - "nodeTypes": { - "description": "[Output Only] A list of node types contained in this scope.", - "type": "array", - "items": { - "$ref": "NodeType" - } + }, + "parameterOrder": [ + "project", + "region", + "forwardingRule" + ], + "request": { + "$ref": "TargetReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes target URL for forwarding rule. The new target should be of the same type as the old target." }, - "warning": { - "description": "[Output Only] An informational warning that appears when the node types list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "id": "compute.forwardingRules.patch", + "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", + "httpMethod": "PATCH", + "parameters": { + "forwardingRule": { + "description": "Name of the ForwardingRule resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "NotificationEndpointList": { - "id": "NotificationEndpointList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints.", - "default": "compute#notificationEndpointList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of NotificationEndpoint resources.", - "type": "array", - "items": { - "$ref": "NotificationEndpoint" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + }, + "parameterOrder": [ + "project", + "region", + "forwardingRule" + ], + "request": { + "$ref": "ForwardingRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified forwarding rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. Currently, you can only patch the network_tier field." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setLabels": { + "id": "compute.forwardingRules.setLabels", + "path": "projects/{project}/regions/{region}/forwardingRules/{resource}/setLabels", + "flatPath": "projects/{project}/regions/{region}/forwardingRules/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "NotificationEndpoint": { - "id": "NotificationEndpoint", - "description": "Represents a notification endpoint. A notification endpoint resource defines an endpoint to receive notifications when there are status changes detected by the associated health check service. For more information, see Health checks overview.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints.", - "default": "compute#notificationEndpoint", - "type": "string" - }, - "id": { - "description": "[Output Only] A unique identifier for this resource type. The server generates this identifier.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the notification endpoint resides. This field applies only to the regional resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "grpcSettings": { - "description": "Settings of the gRPC notification endpoint including the endpoint URL and the retry duration.", - "$ref": "NotificationEndpointGrpcSettings" - } - } - }, - "NotificationEndpointGrpcSettings": { - "id": "NotificationEndpointGrpcSettings", - "description": "Represents a gRPC setting that describes one gRPC notification endpoint and the retry duration attempting to send notification to this endpoint.", - "type": "object", - "properties": { - "endpoint": { - "description": "Endpoint to which gRPC notifications are sent. This must be a valid gRPCLB DNS name.", - "type": "string" - }, - "retryDurationSec": { - "description": "How much time (in seconds) is spent attempting notification retries until a successful response is received. Default is 30s. Limit is 20m (1200s). Must be a positive number.", - "type": "integer", - "format": "uint32" - }, - "payloadName": { - "description": "Optional. If specified, this field is used to populate the \"name\" field in gRPC requests.", - "type": "string" - }, - "authority": { - "description": "Optional. If specified, this field is used to set the authority header by the sender of notifications. See https://tools.ietf.org/html/rfc7540#section-8.1.2.3", - "type": "string" - }, - "resendInterval": { - "description": "Optional. This field is used to configure how often to send a full update of all non-healthy backends. If unspecified, full updates are not sent. If specified, must be in the range between 600 seconds to 3600 seconds. Nanos are disallowed. Can only be set for regional notification endpoints.", - "$ref": "Duration" - } - } - }, - "PacketMirroring": { - "id": "PacketMirroring", - "description": "Represents a Packet Mirroring resource. Packet Mirroring clones the traffic of specified instances in your Virtual Private Cloud (VPC) network and forwards it to a collector destination, such as an instance group of an internal TCP/UDP load balancer, for analysis or examination. For more information about setting up Packet Mirroring, see Using Packet Mirroring.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#packetMirroring for packet mirrorings.", - "default": "compute#packetMirroring", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for 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. 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])?", - "annotations": { - "required": [ - "compute.packetMirrorings.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URI of the region where the packetMirroring resides.", - "type": "string" - }, - "network": { - "description": "Specifies the mirrored VPC network. Only packets in this network will be mirrored. All mirrored VMs should have a NIC in the given network. All mirrored subnetworks should belong to the given network.", - "annotations": { - "required": [ - "compute.packetMirrorings.insert" - ] + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" }, - "$ref": "PacketMirroringNetworkInfo" - }, - "priority": { - "description": "The priority of applying this configuration. Priority is used to break ties in cases where there is more than one matching rule. In the case of two rules that apply for a given Instance, the one with the lowest-numbered priority value wins. Default value is 1000. Valid range is 0 through 65535.", - "type": "integer", - "format": "uint32" - }, - "collectorIlb": { - "description": "The Forwarding Rule resource of type loadBalancingScheme=INTERNAL that will be used as collector for mirrored traffic. The specified forwarding rule must have isMirroringCollector set to true.", - "$ref": "PacketMirroringForwardingRuleInfo" - }, - "mirroredResources": { - "description": "PacketMirroring mirroredResourceInfos. MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks and/or tags for which traffic from/to all VM instances will be mirrored.", - "$ref": "PacketMirroringMirroredResourceInfo" - }, - "filter": { - "description": "Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored.", - "$ref": "PacketMirroringFilter" - }, - "enable": { - "description": "Indicates whether or not this packet mirroring takes effect. If set to FALSE, this packet mirroring policy will not be enforced on the network. The default is TRUE.", - "type": "string", - "enumDescriptions": [ - "", - "" + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "FALSE", - "TRUE" - ] + "description": "Sets the labels on the specified resource. To learn more about labels, read the Labeling Resources documentation." } } }, - "PacketMirroringNetworkInfo": { - "id": "PacketMirroringNetworkInfo", - "type": "object", - "properties": { - "url": { - "description": "URL of the network resource.", - "type": "string" + "regionHealthCheckServices": { + "methods": { + "list": { + "id": "compute.regionHealthCheckServices.list", + "path": "projects/{project}/regions/{region}/healthCheckServices", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "HealthCheckServicesList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all the HealthCheckService resources that have been configured for the specified project in the given region." }, - "canonicalUrl": { - "description": "[Output Only] Unique identifier for the network; defined by the server.", - "type": "string" - } - } - }, - "PacketMirroringForwardingRuleInfo": { - "id": "PacketMirroringForwardingRuleInfo", - "type": "object", - "properties": { - "url": { - "description": "Resource URL to the forwarding rule representing the ILB configured as destination of the mirrored traffic.", - "type": "string" + "get": { + "id": "compute.regionHealthCheckServices.get", + "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "httpMethod": "GET", + "parameters": { + "healthCheckService": { + "description": "Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "healthCheckService" + ], + "response": { + "$ref": "HealthCheckService" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified regional HealthCheckService resource." }, - "canonicalUrl": { - "description": "[Output Only] Unique identifier for the forwarding rule; defined by the server.", - "type": "string" - } - } - }, - "PacketMirroringMirroredResourceInfo": { - "id": "PacketMirroringMirroredResourceInfo", - "type": "object", - "properties": { - "subnetworks": { - "description": "A set of subnetworks for which traffic from/to all VM instances will be mirrored. They must live in the same region as this packetMirroring. You may specify a maximum of 5 subnetworks.", - "type": "array", - "items": { - "$ref": "PacketMirroringMirroredResourceInfoSubnetInfo" - } + "insert": { + "id": "compute.regionHealthCheckServices.insert", + "path": "projects/{project}/regions/{region}/healthCheckServices", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "HealthCheckService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a regional HealthCheckService resource in the specified project and region using the data included in the request." }, - "instances": { - "description": "A set of virtual machine instances that are being mirrored. They must live in zones contained in the same region as this packetMirroring. Note that this config will apply only to those network interfaces of the Instances that belong to the network specified in this packetMirroring. You may specify a maximum of 50 Instances.", - "type": "array", - "items": { - "$ref": "PacketMirroringMirroredResourceInfoInstanceInfo" - } + "delete": { + "id": "compute.regionHealthCheckServices.delete", + "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "httpMethod": "DELETE", + "parameters": { + "healthCheckService": { + "description": "Name of the HealthCheckService to delete. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "healthCheckService" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified regional HealthCheckService." }, - "tags": { - "description": "A set of mirrored tags. Traffic from/to all VM instances that have one or more of these tags will be mirrored.", - "type": "array", - "items": { - "type": "string" - } + "patch": { + "id": "compute.regionHealthCheckServices.patch", + "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", + "httpMethod": "PATCH", + "parameters": { + "healthCheckService": { + "description": "Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "healthCheckService" + ], + "request": { + "$ref": "HealthCheckService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified regional HealthCheckService resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." } } }, - "PacketMirroringMirroredResourceInfoSubnetInfo": { - "id": "PacketMirroringMirroredResourceInfoSubnetInfo", - "type": "object", - "properties": { - "url": { - "description": "Resource URL to the subnetwork for which traffic from/to all VM instances will be mirrored.", - "type": "string" + "healthChecks": { + "methods": { + "list": { + "id": "compute.healthChecks.list", + "path": "projects/{project}/global/healthChecks", + "flatPath": "projects/{project}/global/healthChecks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "HealthCheckList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of HealthCheck resources available to the specified project." }, - "canonicalUrl": { - "description": "[Output Only] Unique identifier for the subnetwork; defined by the server.", - "type": "string" - } - } - }, - "PacketMirroringMirroredResourceInfoInstanceInfo": { - "id": "PacketMirroringMirroredResourceInfoInstanceInfo", - "type": "object", - "properties": { - "url": { - "description": "Resource URL to the virtual machine instance which is being mirrored.", - "type": "string" + "aggregatedList": { + "id": "compute.healthChecks.aggregatedList", + "path": "projects/{project}/aggregated/healthChecks", + "flatPath": "projects/{project}/aggregated/healthChecks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "HealthChecksAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of all HealthCheck resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + }, + "get": { + "id": "compute.healthChecks.get", + "path": "projects/{project}/global/healthChecks/{healthCheck}", + "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", + "httpMethod": "GET", + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "healthCheck" + ], + "response": { + "$ref": "HealthCheck" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified HealthCheck resource." }, - "canonicalUrl": { - "description": "[Output Only] Unique identifier for the instance; defined by the server.", - "type": "string" - } - } - }, - "PacketMirroringFilter": { - "id": "PacketMirroringFilter", - "type": "object", - "properties": { - "cidrRanges": { - "description": "One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source (ingress) or destination (egress) IP in the IP header. If no ranges are specified, all IPv4 traffic that matches the specified IPProtocols is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use \"0.0.0.0/0,::/0\".", - "type": "array", - "items": { - "type": "string" - } + "insert": { + "id": "compute.healthChecks.insert", + "path": "projects/{project}/global/healthChecks", + "flatPath": "projects/{project}/global/healthChecks", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a HealthCheck resource in the specified project using the data included in the request." }, - "IPProtocols": { - "description": "Protocols that apply as filter on mirrored traffic. If no protocols are specified, all traffic that matches the specified CIDR ranges is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored.", - "type": "array", - "items": { - "type": "string" - } + "delete": { + "id": "compute.healthChecks.delete", + "path": "projects/{project}/global/healthChecks/{healthCheck}", + "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", + "httpMethod": "DELETE", + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "healthCheck" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified HealthCheck resource." }, - "direction": { - "description": "Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. The default is BOTH.", - "type": "string", - "enumDescriptions": [ - "Default, both directions are mirrored.", - "Only egress traffic is mirrored.", - "Only ingress traffic is mirrored." + "update": { + "id": "compute.healthChecks.update", + "path": "projects/{project}/global/healthChecks/{healthCheck}", + "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", + "httpMethod": "PUT", + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "healthCheck" ], - "enum": [ - "BOTH", - "EGRESS", - "INGRESS" - ] + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates a HealthCheck resource in the specified project using the data included in the request." + }, + "patch": { + "id": "compute.healthChecks.patch", + "path": "projects/{project}/global/healthChecks/{healthCheck}", + "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", + "httpMethod": "PATCH", + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "healthCheck" + ], + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." } } }, - "PacketMirroringList": { - "id": "PacketMirroringList", - "description": "Contains a list of PacketMirroring resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#packetMirroring for packetMirrorings.", - "default": "compute#packetMirroringList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "regionHealthChecks": { + "methods": { + "list": { + "id": "compute.regionHealthChecks.list", + "path": "projects/{project}/regions/{region}/healthChecks", + "flatPath": "projects/{project}/regions/{region}/healthChecks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "HealthCheckList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of HealthCheck resources available to the specified project." }, - "items": { - "description": "A list of PacketMirroring resources.", - "type": "array", - "items": { - "$ref": "PacketMirroring" - } + "get": { + "id": "compute.regionHealthChecks.get", + "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "httpMethod": "GET", + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "healthCheck" + ], + "response": { + "$ref": "HealthCheck" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified HealthCheck resource." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "insert": { + "id": "compute.regionHealthChecks.insert", + "path": "projects/{project}/regions/{region}/healthChecks", + "flatPath": "projects/{project}/regions/{region}/healthChecks", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a HealthCheck resource in the specified project using the data included in the request." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "delete": { + "id": "compute.regionHealthChecks.delete", + "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "httpMethod": "DELETE", + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "healthCheck" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified HealthCheck resource." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "update": { + "id": "compute.regionHealthChecks.update", + "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "httpMethod": "PUT", + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "PacketMirroringAggregatedList": { - "id": "PacketMirroringAggregatedList", - "description": "Contains a list of packetMirrorings.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#packetMirroringAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of PacketMirroring resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of packetMirrorings.", - "$ref": "PacketMirroringsScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + }, + "parameterOrder": [ + "project", + "region", + "healthCheck" + ], + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates a HealthCheck resource in the specified project using the data included in the request." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "id": "compute.regionHealthChecks.patch", + "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", + "httpMethod": "PATCH", + "parameters": { + "healthCheck": { + "description": "Name of the HealthCheck resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + }, + "parameterOrder": [ + "project", + "region", + "healthCheck" + ], + "request": { + "$ref": "HealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." } } }, - "PacketMirroringsScopedList": { - "id": "PacketMirroringsScopedList", - "type": "object", - "properties": { - "packetMirrorings": { - "description": "A list of packetMirrorings contained in this scope.", - "type": "array", - "items": { - "$ref": "PacketMirroring" - } + "httpHealthChecks": { + "methods": { + "list": { + "id": "compute.httpHealthChecks.list", + "path": "projects/{project}/global/httpHealthChecks", + "flatPath": "projects/{project}/global/httpHealthChecks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "HttpHealthCheckList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of HttpHealthCheck resources available to the specified project." }, - "warning": { - "description": "Informational warning which replaces the list of packetMirrorings when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "id": "compute.httpHealthChecks.get", + "path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "httpMethod": "GET", + "parameters": { + "httpHealthCheck": { + "description": "Name of the HttpHealthCheck resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "httpHealthCheck" + ], + "response": { + "$ref": "HttpHealthCheck" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified HttpHealthCheck resource." + }, + "insert": { + "id": "compute.httpHealthChecks.insert", + "path": "projects/{project}/global/httpHealthChecks", + "flatPath": "projects/{project}/global/httpHealthChecks", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "HttpHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a HttpHealthCheck resource in the specified project using the data included in the request." + }, + "delete": { + "id": "compute.httpHealthChecks.delete", + "path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "httpMethod": "DELETE", + "parameters": { + "httpHealthCheck": { + "description": "Name of the HttpHealthCheck resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "httpHealthCheck" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified HttpHealthCheck resource." + }, + "update": { + "id": "compute.httpHealthChecks.update", + "path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "httpMethod": "PUT", + "parameters": { + "httpHealthCheck": { + "description": "Name of the HttpHealthCheck resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "httpHealthCheck" + ], + "request": { + "$ref": "HttpHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates a HttpHealthCheck resource in the specified project using the data included in the request." + }, + "patch": { + "id": "compute.httpHealthChecks.patch", + "path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", + "httpMethod": "PATCH", + "parameters": { + "httpHealthCheck": { + "description": "Name of the HttpHealthCheck resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "httpHealthCheck" + ], + "request": { + "$ref": "HttpHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates a HttpHealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." } } }, - "Project": { - "id": "Project", - "description": "Represents a Project resource. A project is used to organize resources in a Google Cloud Platform environment. For more information, read about the Resource Hierarchy.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#project for projects.", - "default": "compute#project", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server. This is *not* the project ID, and is just a unique ID used by Compute Engine to identify resources.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "The project ID. For example: my-example-project. Use the project ID to make requests to Compute Engine.", - "type": "string" - }, - "description": { - "description": "An optional textual description of the resource.", - "type": "string" - }, - "commonInstanceMetadata": { - "description": "Metadata key/value pairs available to all instances contained in this project. See Custom metadata for more information.", - "$ref": "Metadata" - }, - "quotas": { - "description": "[Output Only] Quotas assigned to this project.", - "type": "array", - "items": { - "$ref": "Quota" - } - }, - "usageExportLocation": { - "description": "The naming prefix for daily usage reports and the Google Cloud Storage bucket where they are stored.", - "$ref": "UsageExportLocation" - }, - "enabledFeatures": { - "description": "Restricted features enabled for use on this project.", - "type": "array", - "items": { - "type": "string" - } - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "defaultServiceAccount": { - "description": "[Output Only] Default service account used by VMs running in this project.", - "type": "string" - }, - "xpnProjectStatus": { - "description": "[Output Only] The role this project has in a shared VPC configuration. Currently, only projects with the host role, which is specified by the value HOST, are differentiated.", - "type": "string", - "enumDescriptions": [ - "", - "" + "httpsHealthChecks": { + "methods": { + "list": { + "id": "compute.httpsHealthChecks.list", + "path": "projects/{project}/global/httpsHealthChecks", + "flatPath": "projects/{project}/global/httpsHealthChecks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" ], - "enum": [ - "HOST", - "UNSPECIFIED_XPN_PROJECT_STATUS" - ] - }, - "defaultNetworkTier": { - "description": "This signifies the default network tier used for configuring resources of the project and can only take the following values: PREMIUM, STANDARD. Initially the default network tier is PREMIUM.", - "type": "string", - "enumDescriptions": [ - "Public internet quality with fixed bandwidth.", - "High quality, Google-grade network tier, support for all networking products.", - "Public internet quality, only limited support for other networking products.", - "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." + "response": { + "$ref": "HttpsHealthCheckList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" - ] + "description": "Retrieves the list of HttpsHealthCheck resources available to the specified project." }, - "vmDnsSetting": { - "description": "[Output Only] Default internal DNS setting used by VMs running in this project.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "get": { + "id": "compute.httpsHealthChecks.get", + "path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "httpMethod": "GET", + "parameters": { + "httpsHealthCheck": { + "description": "Name of the HttpsHealthCheck resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "httpsHealthCheck" ], - "enum": [ - "GLOBAL_DEFAULT", - "UNSPECIFIED_VM_DNS_SETTING", - "ZONAL_DEFAULT", - "ZONAL_ONLY" - ] + "response": { + "$ref": "HttpsHealthCheck" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified HttpsHealthCheck resource." }, - "cloudArmorTier": { - "description": "[Output Only] The Cloud Armor tier for this project. It can be one of the following values: CA_STANDARD, CA_ENTERPRISE_PAYGO. If this field is not specified, it is assumed to be CA_STANDARD.", - "type": "string", - "enumDescriptions": [ - "Enterprise tier protection billed annually.", - "Enterprise tier protection billed monthly.", - "Standard protection." + "insert": { + "id": "compute.httpsHealthChecks.insert", + "path": "projects/{project}/global/httpsHealthChecks", + "flatPath": "projects/{project}/global/httpsHealthChecks", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" ], - "enum": [ - "CA_ENTERPRISE_ANNUAL", - "CA_ENTERPRISE_PAYGO", - "CA_STANDARD" - ] - } - } - }, - "Quota": { - "id": "Quota", - "description": "A quotas entry.", - "type": "object", - "properties": { - "metric": { - "description": "[Output Only] Name of the quota metric.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "Guest CPUs", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "The total number of snapshots allowed for a single project.", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "request": { + "$ref": "HttpsHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "A2_CPUS", - "AFFINITY_GROUPS", - "AUTOSCALERS", - "BACKEND_BUCKETS", - "BACKEND_SERVICES", - "C2D_CPUS", - "C2_CPUS", - "C3_CPUS", - "COMMITMENTS", - "COMMITTED_A2_CPUS", - "COMMITTED_C2D_CPUS", - "COMMITTED_C2_CPUS", - "COMMITTED_C3_CPUS", - "COMMITTED_CPUS", - "COMMITTED_E2_CPUS", - "COMMITTED_LICENSES", - "COMMITTED_LOCAL_SSD_TOTAL_GB", - "COMMITTED_M3_CPUS", - "COMMITTED_MEMORY_OPTIMIZED_CPUS", - "COMMITTED_N2A_CPUS", - "COMMITTED_N2D_CPUS", - "COMMITTED_N2_CPUS", - "COMMITTED_NVIDIA_A100_80GB_GPUS", - "COMMITTED_NVIDIA_A100_GPUS", - "COMMITTED_NVIDIA_H100_GPUS", - "COMMITTED_NVIDIA_K80_GPUS", - "COMMITTED_NVIDIA_L4_GPUS", - "COMMITTED_NVIDIA_P100_GPUS", - "COMMITTED_NVIDIA_P4_GPUS", - "COMMITTED_NVIDIA_T4_GPUS", - "COMMITTED_NVIDIA_V100_GPUS", - "COMMITTED_T2A_CPUS", - "COMMITTED_T2D_CPUS", - "COMMITTED_Z3_CPUS", - "CPUS", - "CPUS_ALL_REGIONS", - "DISKS_TOTAL_GB", - "E2_CPUS", - "EXTERNAL_MANAGED_FORWARDING_RULES", - "EXTERNAL_NETWORK_LB_FORWARDING_RULES", - "EXTERNAL_PROTOCOL_FORWARDING_RULES", - "EXTERNAL_VPN_GATEWAYS", - "FIREWALLS", - "FORWARDING_RULES", - "GLOBAL_EXTERNAL_MANAGED_BACKEND_SERVICES", - "GLOBAL_EXTERNAL_MANAGED_FORWARDING_RULES", - "GLOBAL_EXTERNAL_PROXY_LB_BACKEND_SERVICES", - "GLOBAL_INTERNAL_ADDRESSES", - "GLOBAL_INTERNAL_MANAGED_BACKEND_SERVICES", - "GLOBAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES", - "GPUS_ALL_REGIONS", - "HDB_TOTAL_GB", - "HDB_TOTAL_IOPS", - "HDB_TOTAL_THROUGHPUT", - "HEALTH_CHECKS", - "IMAGES", - "INSTANCES", - "INSTANCE_GROUPS", - "INSTANCE_GROUP_MANAGERS", - "INSTANCE_TEMPLATES", - "INTERCONNECTS", - "INTERCONNECT_ATTACHMENTS_PER_REGION", - "INTERCONNECT_ATTACHMENTS_TOTAL_MBPS", - "INTERCONNECT_TOTAL_GBPS", - "INTERNAL_ADDRESSES", - "INTERNAL_TRAFFIC_DIRECTOR_FORWARDING_RULES", - "IN_PLACE_SNAPSHOTS", - "IN_USE_ADDRESSES", - "IN_USE_BACKUP_SCHEDULES", - "IN_USE_SNAPSHOT_SCHEDULES", - "LOCAL_SSD_TOTAL_GB", - "M1_CPUS", - "M2_CPUS", - "M3_CPUS", - "MACHINE_IMAGES", - "N2A_CPUS", - "N2D_CPUS", - "N2_CPUS", - "NETWORKS", - "NETWORK_ATTACHMENTS", - "NETWORK_ENDPOINT_GROUPS", - "NETWORK_FIREWALL_POLICIES", - "NET_LB_SECURITY_POLICIES_PER_REGION", - "NET_LB_SECURITY_POLICY_RULES_PER_REGION", - "NET_LB_SECURITY_POLICY_RULE_ATTRIBUTES_PER_REGION", - "NODE_GROUPS", - "NODE_TEMPLATES", - "NVIDIA_A100_80GB_GPUS", - "NVIDIA_A100_GPUS", - "NVIDIA_K80_GPUS", - "NVIDIA_L4_GPUS", - "NVIDIA_P100_GPUS", - "NVIDIA_P100_VWS_GPUS", - "NVIDIA_P4_GPUS", - "NVIDIA_P4_VWS_GPUS", - "NVIDIA_T4_GPUS", - "NVIDIA_T4_VWS_GPUS", - "NVIDIA_V100_GPUS", - "PACKET_MIRRORINGS", - "PD_EXTREME_TOTAL_PROVISIONED_IOPS", - "PREEMPTIBLE_CPUS", - "PREEMPTIBLE_LOCAL_SSD_GB", - "PREEMPTIBLE_NVIDIA_A100_80GB_GPUS", - "PREEMPTIBLE_NVIDIA_A100_GPUS", - "PREEMPTIBLE_NVIDIA_H100_GPUS", - "PREEMPTIBLE_NVIDIA_K80_GPUS", - "PREEMPTIBLE_NVIDIA_L4_GPUS", - "PREEMPTIBLE_NVIDIA_P100_GPUS", - "PREEMPTIBLE_NVIDIA_P100_VWS_GPUS", - "PREEMPTIBLE_NVIDIA_P4_GPUS", - "PREEMPTIBLE_NVIDIA_P4_VWS_GPUS", - "PREEMPTIBLE_NVIDIA_T4_GPUS", - "PREEMPTIBLE_NVIDIA_T4_VWS_GPUS", - "PREEMPTIBLE_NVIDIA_V100_GPUS", - "PREEMPTIBLE_TPU_LITE_DEVICE_V5", - "PREEMPTIBLE_TPU_LITE_PODSLICE_V5", - "PREEMPTIBLE_TPU_PODSLICE_V4", - "PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK", - "PSC_INTERNAL_LB_FORWARDING_RULES", - "PUBLIC_ADVERTISED_PREFIXES", - "PUBLIC_DELEGATED_PREFIXES", - "REGIONAL_AUTOSCALERS", - "REGIONAL_EXTERNAL_MANAGED_BACKEND_SERVICES", - "REGIONAL_EXTERNAL_NETWORK_LB_BACKEND_SERVICES", - "REGIONAL_INSTANCE_GROUP_MANAGERS", - "REGIONAL_INTERNAL_LB_BACKEND_SERVICES", - "REGIONAL_INTERNAL_MANAGED_BACKEND_SERVICES", - "REGIONAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES", - "RESERVATIONS", - "RESOURCE_POLICIES", - "ROUTERS", - "ROUTES", - "SECURITY_POLICIES", - "SECURITY_POLICIES_PER_REGION", - "SECURITY_POLICY_ADVANCED_RULES_PER_REGION", - "SECURITY_POLICY_CEVAL_RULES", - "SECURITY_POLICY_RULES", - "SECURITY_POLICY_RULES_PER_REGION", - "SERVICE_ATTACHMENTS", - "SNAPSHOTS", - "SSD_TOTAL_GB", - "SSL_CERTIFICATES", - "SSL_POLICIES", - "STATIC_ADDRESSES", - "STATIC_BYOIP_ADDRESSES", - "STATIC_EXTERNAL_IPV6_ADDRESS_RANGES", - "SUBNETWORKS", - "T2A_CPUS", - "T2D_CPUS", - "TARGET_HTTPS_PROXIES", - "TARGET_HTTP_PROXIES", - "TARGET_INSTANCES", - "TARGET_POOLS", - "TARGET_SSL_PROXIES", - "TARGET_TCP_PROXIES", - "TARGET_VPN_GATEWAYS", - "TPU_LITE_DEVICE_V5", - "TPU_LITE_PODSLICE_V5", - "TPU_PODSLICE_V4", - "URL_MAPS", - "VARIABLE_IPV6_PUBLIC_DELEGATED_PREFIXES", - "VPN_GATEWAYS", - "VPN_TUNNELS", - "XPN_SERVICE_PROJECTS" - ] + "description": "Creates a HttpsHealthCheck resource in the specified project using the data included in the request." }, - "limit": { - "description": "[Output Only] Quota limit for this metric.", - "type": "number", - "format": "double" + "delete": { + "id": "compute.httpsHealthChecks.delete", + "path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "httpMethod": "DELETE", + "parameters": { + "httpsHealthCheck": { + "description": "Name of the HttpsHealthCheck resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "httpsHealthCheck" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified HttpsHealthCheck resource." }, - "usage": { - "description": "[Output Only] Current usage of this metric.", - "type": "number", - "format": "double" + "update": { + "id": "compute.httpsHealthChecks.update", + "path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "httpMethod": "PUT", + "parameters": { + "httpsHealthCheck": { + "description": "Name of the HttpsHealthCheck resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "httpsHealthCheck" + ], + "request": { + "$ref": "HttpsHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates a HttpsHealthCheck resource in the specified project using the data included in the request." }, - "owner": { - "description": "[Output Only] Owning resource. This is the resource on which this quota is applied.", - "type": "string" + "patch": { + "id": "compute.httpsHealthChecks.patch", + "path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", + "httpMethod": "PATCH", + "parameters": { + "httpsHealthCheck": { + "description": "Name of the HttpsHealthCheck resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "httpsHealthCheck" + ], + "request": { + "$ref": "HttpsHealthCheck" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates a HttpsHealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." } } }, - "UsageExportLocation": { - "id": "UsageExportLocation", - "description": "The location in Cloud Storage and naming method of the daily usage report. Contains bucket_name and report_name prefix.", - "type": "object", - "properties": { - "bucketName": { - "description": "The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket.", - "type": "string" + "instanceTemplates": { + "methods": { + "list": { + "id": "compute.instanceTemplates.list", + "path": "projects/{project}/global/instanceTemplates", + "flatPath": "projects/{project}/global/instanceTemplates", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "InstanceTemplateList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of instance templates that are contained within the specified project." + }, + "get": { + "id": "compute.instanceTemplates.get", + "path": "projects/{project}/global/instanceTemplates/{instanceTemplate}", + "flatPath": "projects/{project}/global/instanceTemplates/{instanceTemplate}", + "httpMethod": "GET", + "parameters": { + "instanceTemplate": { + "description": "The name of the instance template.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "instanceTemplate" + ], + "response": { + "$ref": "InstanceTemplate" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified instance template." + }, + "insert": { + "id": "compute.instanceTemplates.insert", + "path": "projects/{project}/global/instanceTemplates", + "flatPath": "projects/{project}/global/instanceTemplates", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "InstanceTemplate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates an instance template in the specified project using the data that is included in the request. If you are creating a new template to update an existing instance group, your new instance template must use the same network or, if applicable, the same subnetwork as the original template." + }, + "delete": { + "id": "compute.instanceTemplates.delete", + "path": "projects/{project}/global/instanceTemplates/{instanceTemplate}", + "flatPath": "projects/{project}/global/instanceTemplates/{instanceTemplate}", + "httpMethod": "DELETE", + "parameters": { + "instanceTemplate": { + "description": "The name of the instance template to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "instanceTemplate" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified instance template. Deleting an instance template is permanent and cannot be undone. It is not possible to delete templates that are already in use by a managed instance group." + }, + "aggregatedList": { + "id": "compute.instanceTemplates.aggregatedList", + "path": "projects/{project}/aggregated/instanceTemplates", + "flatPath": "projects/{project}/aggregated/instanceTemplates", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "InstanceTemplateAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of all InstanceTemplates resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "reportNamePrefix": { - "description": "An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage_gce. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions.", - "type": "string" - } - } - }, - "InstanceMoveRequest": { - "id": "InstanceMoveRequest", - "type": "object", - "properties": { - "targetInstance": { - "description": "The URL of the target instance to move. This can be a full or partial URL. For example, the following are all valid URLs to an instance: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance ", - "type": "string" + "getIamPolicy": { + "id": "compute.instanceTemplates.getIamPolicy", + "path": "projects/{project}/global/instanceTemplates/{resource}/getIamPolicy", + "flatPath": "projects/{project}/global/instanceTemplates/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "destinationZone": { - "description": "The URL of the destination zone to move the instance. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone ", - "type": "string" - } - } - }, - "DiskMoveRequest": { - "id": "DiskMoveRequest", - "type": "object", - "properties": { - "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: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk ", - "type": "string" + "setIamPolicy": { + "id": "compute.instanceTemplates.setIamPolicy", + "path": "projects/{project}/global/instanceTemplates/{resource}/setIamPolicy", + "flatPath": "projects/{project}/global/instanceTemplates/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "destinationZone": { - "description": "The URL of the destination zone to move the disk. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone ", - "type": "string" - } - } - }, - "ProjectsListXpnHostsRequest": { - "id": "ProjectsListXpnHostsRequest", - "type": "object", - "properties": { - "organization": { - "description": "Optional organization ID managed by Cloud Resource Manager, for which to list shared VPC host projects. If not specified, the organization will be inferred from the project.", - "type": "string" + "testIamPermissions": { + "id": "compute.instanceTemplates.testIamPermissions", + "path": "projects/{project}/global/instanceTemplates/{resource}/testIamPermissions", + "flatPath": "projects/{project}/global/instanceTemplates/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "XpnHostList": { - "id": "XpnHostList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#xpnHostList for lists of shared VPC hosts.", - "default": "compute#xpnHostList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "[Output Only] A list of shared VPC host project URLs.", - "type": "array", - "items": { - "$ref": "Project" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "regionInstanceTemplates": { + "methods": { + "list": { + "id": "compute.regionInstanceTemplates.list", + "path": "projects/{project}/regions/{region}/instanceTemplates", + "flatPath": "projects/{project}/regions/{region}/instanceTemplates", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the regions for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "InstanceTemplateList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of instance templates that are contained within the specified project and region." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "id": "compute.regionInstanceTemplates.get", + "path": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", + "flatPath": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", + "httpMethod": "GET", + "parameters": { + "instanceTemplate": { + "description": "The name of the instance template.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceTemplate" + ], + "response": { + "$ref": "InstanceTemplate" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified instance template." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.regionInstanceTemplates.insert", + "path": "projects/{project}/regions/{region}/instanceTemplates", + "flatPath": "projects/{project}/regions/{region}/instanceTemplates", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "ProjectsEnableXpnResourceRequest": { - "id": "ProjectsEnableXpnResourceRequest", - "type": "object", - "properties": { - "xpnResource": { - "description": "Service resource (a.k.a service project) ID.", - "$ref": "XpnResourceId" - } - } - }, - "XpnResourceId": { - "id": "XpnResourceId", - "description": "Service resource (a.k.a service project) ID.", - "type": "object", - "properties": { - "type": { - "description": "The type of the service resource.", - "type": "string", - "enumDescriptions": [ - "", - "" + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "InstanceTemplate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates an instance template in the specified project and region using the global instance template whose URL is included in the request." + }, + "delete": { + "id": "compute.regionInstanceTemplates.delete", + "path": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", + "flatPath": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", + "httpMethod": "DELETE", + "parameters": { + "instanceTemplate": { + "description": "The name of the instance template to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instanceTemplate" ], - "enum": [ - "PROJECT", - "XPN_RESOURCE_TYPE_UNSPECIFIED" - ] - }, - "id": { - "description": "The ID of the service resource. In the case of projects, this field supports project id (e.g., my-project-123) and project number (e.g. 12345678).", - "type": "string" - } - } - }, - "ProjectsDisableXpnResourceRequest": { - "id": "ProjectsDisableXpnResourceRequest", - "type": "object", - "properties": { - "xpnResource": { - "description": "Service resource (a.k.a service project) ID.", - "$ref": "XpnResourceId" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified instance template. Deleting an instance template is permanent and cannot be undone." } } }, - "ProjectsGetXpnResources": { - "id": "ProjectsGetXpnResources", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#projectsGetXpnResources for lists of service resources (a.k.a service projects)", - "default": "compute#projectsGetXpnResources", - "type": "string" - }, - "resources": { - "description": "Service resources (a.k.a service projects) attached to this project as their shared VPC host.", - "type": "array", - "items": { - "$ref": "XpnResourceId" - } + "instanceSettings": { + "methods": { + "get": { + "id": "compute.instanceSettings.get", + "path": "projects/{project}/zones/{zone}/instanceSettings", + "flatPath": "projects/{project}/zones/{zone}/instanceSettings", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "InstanceSettings" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Get Instance settings." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - } - } - }, - "ProjectsSetDefaultNetworkTierRequest": { - "id": "ProjectsSetDefaultNetworkTierRequest", - "type": "object", - "properties": { - "networkTier": { - "description": "Default network tier to be set.", - "type": "string", - "enumDescriptions": [ - "Public internet quality with fixed bandwidth.", - "High quality, Google-grade network tier, support for all networking products.", - "Public internet quality, only limited support for other networking products.", - "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." + "patch": { + "id": "compute.instanceSettings.patch", + "path": "projects/{project}/zones/{zone}/instanceSettings", + "flatPath": "projects/{project}/zones/{zone}/instanceSettings", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" + }, + "zone": { + "description": "The zone scoping this request. It should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" - ] - } - } - }, - "ProjectsSetCloudArmorTierRequest": { - "id": "ProjectsSetCloudArmorTierRequest", - "type": "object", - "properties": { - "cloudArmorTier": { - "description": "Managed protection tier to be set.", - "type": "string", - "enumDescriptions": [ - "Enterprise tier protection billed annually.", - "Enterprise tier protection billed monthly.", - "Standard protection." + "request": { + "$ref": "InstanceSettings" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "CA_ENTERPRISE_ANNUAL", - "CA_ENTERPRISE_PAYGO", - "CA_STANDARD" - ] + "description": "Patch Instance settings" } } }, - "PublicAdvertisedPrefixList": { - "id": "PublicAdvertisedPrefixList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes.", - "default": "compute#publicAdvertisedPrefixList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "instantSnapshots": { + "methods": { + "list": { + "id": "compute.instantSnapshots.list", + "path": "projects/{project}/zones/{zone}/instantSnapshots", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "InstantSnapshotList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of InstantSnapshot resources contained within the specified zone." }, - "items": { - "description": "A list of PublicAdvertisedPrefix resources.", - "type": "array", - "items": { - "$ref": "PublicAdvertisedPrefix" - } + "get": { + "id": "compute.instantSnapshots.get", + "path": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", + "httpMethod": "GET", + "parameters": { + "instantSnapshot": { + "description": "Name of the InstantSnapshot resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "instantSnapshot" + ], + "response": { + "$ref": "InstantSnapshot" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified InstantSnapshot resource in the specified zone." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "insert": { + "id": "compute.instantSnapshots.insert", + "path": "projects/{project}/zones/{zone}/instantSnapshots", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { + "$ref": "InstantSnapshot" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates an instant snapshot in the specified zone." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "setLabels": { + "id": "compute.instantSnapshots.setLabels", + "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setLabels", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "request": { + "$ref": "ZoneSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on a instantSnapshot in the given zone. To learn more about labels, read the Labeling Resources documentation." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "id": "compute.instantSnapshots.delete", + "path": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", + "httpMethod": "DELETE", + "parameters": { + "instantSnapshot": { + "description": "Name of the InstantSnapshot resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "PublicAdvertisedPrefix": { - "id": "PublicAdvertisedPrefix", - "description": "A public advertised prefix represents an aggregated IP prefix or netblock which customers bring to cloud. The IP prefix is a single unit of route advertisement and is announced globally to the internet.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes.", - "default": "compute#publicAdvertisedPrefix", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.publicAdvertisedPrefixes.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "ipCidrRange": { - "description": "The address range, in CIDR format, represented by this public advertised prefix.", - "type": "string" - }, - "dnsVerificationIp": { - "description": "The address to be used for reverse DNS verification.", - "type": "string" - }, - "sharedSecret": { - "description": "[Output Only] The shared secret to be used for reverse DNS verification.", - "type": "string" - }, - "status": { - "description": "The status of the public advertised prefix. Possible values include: - `INITIAL`: RPKI validation is complete. - `PTR_CONFIGURED`: User has configured the PTR. - `VALIDATED`: Reverse DNS lookup is successful. - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being configured. - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. ", - "type": "string", - "enumDescriptions": [ - "The prefix is announced to Internet.", - "RPKI validation is complete.", - "The prefix is fully configured.", - "The prefix is being configured.", - "The prefix is being removed.", - "User has configured the PTR.", - "The prefix is currently withdrawn but ready to be announced.", - "Reverse DNS lookup failed.", - "Reverse DNS lookup is successful." + "parameterOrder": [ + "project", + "zone", + "instantSnapshot" ], - "enum": [ - "ANNOUNCED_TO_INTERNET", - "INITIAL", - "PREFIX_CONFIGURATION_COMPLETE", - "PREFIX_CONFIGURATION_IN_PROGRESS", - "PREFIX_REMOVAL_IN_PROGRESS", - "PTR_CONFIGURED", - "READY_TO_ANNOUNCE", - "REVERSE_DNS_LOOKUP_FAILED", - "VALIDATED" - ] - }, - "pdpScope": { - "description": "Specifies how child public delegated prefix will be scoped. It could be one of following values: - `REGIONAL`: The public delegated prefix is regional only. The provisioning will take a few minutes. - `GLOBAL`: The public delegated prefix is global only. The provisioning will take ~4 weeks. - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is BYOIP V1 legacy prefix. This is output only value and no longer supported in BYOIP V2. ", - "type": "string", - "enumDescriptions": [ - "The public delegated prefix is global only. The provisioning will take ~4 weeks.", - "The public delegated prefixes is BYOIP V1 legacy prefix. This is output only value and no longer supported in BYOIP V2.", - "The public delegated prefix is regional only. The provisioning will take a few minutes." + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "GLOBAL", - "GLOBAL_AND_REGIONAL", - "REGIONAL" - ] - }, - "publicDelegatedPrefixs": { - "description": "[Output Only] The list of public delegated prefixes that exist for this public advertised prefix.", - "type": "array", - "items": { - "$ref": "PublicAdvertisedPrefixPublicDelegatedPrefix" - } - }, - "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 new PublicAdvertisedPrefix. An up-to-date fingerprint must be provided in order to update the PublicAdvertisedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicAdvertisedPrefix.", - "type": "string", - "format": "byte" + "description": "Deletes the specified InstantSnapshot resource. Keep in mind that deleting a single instantSnapshot might not necessarily delete all the data on that instantSnapshot. If any data on the instantSnapshot that is marked for deletion is needed for subsequent instantSnapshots, the data will be moved to the next corresponding instantSnapshot. For more information, see Deleting instantSnapshots." }, - "byoipApiVersion": { - "description": "[Output Only] The version of BYOIP API.", - "type": "string", - "enumDescriptions": [ - "This public advertised prefix can be used to create both regional and global public delegated prefixes. It usually takes 4 weeks to create or delete a public delegated prefix. The BGP status cannot be changed.", - "This public advertised prefix can only be used to create regional public delegated prefixes. Public delegated prefix creation and deletion takes minutes and the BGP status can be modified." + "getIamPolicy": { + "id": "compute.instantSnapshots.getIamPolicy", + "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/getIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "V1", - "V2" - ] - } - } - }, - "PublicAdvertisedPrefixPublicDelegatedPrefix": { - "id": "PublicAdvertisedPrefixPublicDelegatedPrefix", - "description": "Represents a CIDR range which can be used to assign addresses.", - "type": "object", - "properties": { - "name": { - "description": "The name of the public delegated prefix", - "type": "string" - }, - "region": { - "description": "The region of the public delegated prefix if it is regional. If absent, the prefix is global.", - "type": "string" + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "project": { - "description": "The project number of the public delegated prefix", - "type": "string" + "setIamPolicy": { + "id": "compute.instantSnapshots.setIamPolicy", + "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "status": { - "description": "The status of the public delegated prefix. Possible values are: INITIALIZING: The public delegated prefix is being initialized and addresses cannot be created yet. ANNOUNCED: The public delegated prefix is active.", - "type": "string" + "testIamPermissions": { + "id": "compute.instantSnapshots.testIamPermissions", + "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/testIamPermissions", + "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." }, - "ipRange": { - "description": "The IP address range of the public delegated prefix", - "type": "string" + "aggregatedList": { + "id": "compute.instantSnapshots.aggregatedList", + "path": "projects/{project}/aggregated/instantSnapshots", + "flatPath": "projects/{project}/aggregated/instantSnapshots", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "InstantSnapshotAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of instantSnapshots. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." } } }, - "PublicDelegatedPrefixList": { - "id": "PublicDelegatedPrefixList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#publicDelegatedPrefixList for public delegated prefixes.", - "default": "compute#publicDelegatedPrefixList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of PublicDelegatedPrefix resources.", - "type": "array", - "items": { - "$ref": "PublicDelegatedPrefix" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "regionInstantSnapshots": { + "methods": { + "list": { + "id": "compute.regionInstantSnapshots.list", + "path": "projects/{project}/regions/{region}/instantSnapshots", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "PublicDelegatedPrefix": { - "id": "PublicDelegatedPrefix", - "description": "A PublicDelegatedPrefix resource represents an IP block within a PublicAdvertisedPrefix that is configured within a single cloud scope (global or region). IPs in the block can be allocated to resources within that scope. Public delegated prefixes may be further broken up into smaller IP blocks in the same scope as the parent block.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#publicDelegatedPrefix for public delegated prefixes.", - "default": "compute#publicDelegatedPrefix", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.publicDelegatedPrefixes.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the public delegated prefix resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "ipCidrRange": { - "description": "The IP address range, in CIDR format, represented by this public delegated prefix.", - "type": "string" - }, - "status": { - "description": "[Output Only] The status of the public delegated prefix, which can be one of following values: - `INITIALIZING` The public delegated prefix is being initialized and addresses cannot be created yet. - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration prefix and is active. - `ANNOUNCED` The public delegated prefix is active. - `DELETING` The public delegated prefix is being deprovsioned. ", - "type": "string", - "enumDescriptions": [ - "The public delegated prefix is active.", - "The prefix is announced within Google network.", - "The prefix is announced to Internet and within Google.", - "The public delegated prefix is being deprovsioned.", - "The public delegated prefix is being initialized and addresses cannot be created yet.", - "The public delegated prefix is currently withdrawn but ready to be announced." + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ANNOUNCED", - "ANNOUNCED_TO_GOOGLE", - "ANNOUNCED_TO_INTERNET", - "DELETING", - "INITIALIZING", - "READY_TO_ANNOUNCE" - ] - }, - "parentPrefix": { - "description": "The URL of parent prefix. Either PublicAdvertisedPrefix or PublicDelegatedPrefix.", - "type": "string" - }, - "publicDelegatedSubPrefixs": { - "description": "The list of sub public delegated prefixes that exist for this public delegated prefix.", - "type": "array", - "items": { - "$ref": "PublicDelegatedPrefixPublicDelegatedSubPrefix" - } - }, - "isLiveMigration": { - "description": "If true, the prefix will be live migrated.", - "type": "boolean" - }, - "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 new PublicDelegatedPrefix. An up-to-date fingerprint must be provided in order to update the PublicDelegatedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicDelegatedPrefix.", - "type": "string", - "format": "byte" - }, - "mode": { - "description": "The public delegated prefix mode for IPv6 only.", - "type": "string", - "enumDescriptions": [ - "The public delegated prefix is used for further sub-delegation only. Such prefixes cannot set allocatablePrefixLength.", - "The public delegated prefix is used for creating forwarding rules only. Such prefixes cannot set publicDelegatedSubPrefixes." + "response": { + "$ref": "InstantSnapshotList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "DELEGATION", - "EXTERNAL_IPV6_FORWARDING_RULE_CREATION" - ] - }, - "allocatablePrefixLength": { - "description": "The allocatable prefix length supported by this public delegated prefix. This field is optional and cannot be set for prefixes in DELEGATION mode. It cannot be set for IPv4 prefixes either, and it always defaults to 32.", - "type": "integer", - "format": "int32" + "description": "Retrieves the list of InstantSnapshot resources contained within the specified region." }, - "byoipApiVersion": { - "description": "[Output Only] The version of BYOIP API.", - "type": "string", - "enumDescriptions": [ - "This public delegated prefix usually takes 4 weeks to delete, and the BGP status cannot be changed. Announce and Withdraw APIs can not be used on this prefix.", - "This public delegated prefix takes minutes to delete. Announce and Withdraw APIs can be used on this prefix to change the BGP status." + "get": { + "id": "compute.regionInstantSnapshots.get", + "path": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", + "httpMethod": "GET", + "parameters": { + "instantSnapshot": { + "description": "Name of the InstantSnapshot resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instantSnapshot" ], - "enum": [ - "V1", - "V2" - ] - } - } - }, - "PublicDelegatedPrefixPublicDelegatedSubPrefix": { - "id": "PublicDelegatedPrefixPublicDelegatedSubPrefix", - "description": "Represents a sub PublicDelegatedPrefix.", - "type": "object", - "properties": { - "name": { - "description": "The name of the sub public delegated prefix.", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] The region of the sub public delegated prefix if it is regional. If absent, the sub prefix is global.", - "type": "string" - }, - "status": { - "description": "[Output Only] The status of the sub public delegated prefix.", - "type": "string", - "enumDescriptions": [ - "", - "" + "response": { + "$ref": "InstantSnapshot" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ACTIVE", - "INACTIVE" - ] - }, - "ipCidrRange": { - "description": "The IP address range, in CIDR format, represented by this sub public delegated prefix.", - "type": "string" - }, - "delegateeProject": { - "description": "Name of the project scoping this PublicDelegatedSubPrefix.", - "type": "string" - }, - "isAddress": { - "description": "Whether the sub prefix is delegated to create Address resources in the delegatee project.", - "type": "boolean" + "description": "Returns the specified InstantSnapshot resource in the specified region." }, - "mode": { - "description": "The PublicDelegatedSubPrefix mode for IPv6 only.", - "type": "string", - "enumDescriptions": [ - "The public delegated prefix is used for further sub-delegation only. Such prefixes cannot set allocatablePrefixLength.", - "The public delegated prefix is used for creating forwarding rules only. Such prefixes cannot set publicDelegatedSubPrefixes." + "insert": { + "id": "compute.regionInstantSnapshots.insert", + "path": "projects/{project}/regions/{region}/instantSnapshots", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "DELEGATION", - "EXTERNAL_IPV6_FORWARDING_RULE_CREATION" - ] - }, - "allocatablePrefixLength": { - "description": "The allocatable prefix length supported by this PublicDelegatedSubPrefix.", - "type": "integer", - "format": "int32" - } - } - }, - "PublicDelegatedPrefixAggregatedList": { - "id": "PublicDelegatedPrefixAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#publicDelegatedPrefixAggregatedList for aggregated lists of public delegated prefixes.", - "default": "compute#publicDelegatedPrefixAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of PublicDelegatedPrefixesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of PublicDelegatedPrefixes.", - "$ref": "PublicDelegatedPrefixesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "request": { + "$ref": "InstantSnapshot" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates an instant snapshot in the specified region." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "setLabels": { + "id": "compute.regionInstantSnapshots.setLabels", + "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setLabels", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on a instantSnapshot in the given region. To learn more about labels, read the Labeling Resources documentation." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "id": "compute.regionInstantSnapshots.delete", + "path": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", + "httpMethod": "DELETE", + "parameters": { + "instantSnapshot": { + "description": "Name of the InstantSnapshot resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "instantSnapshot" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified InstantSnapshot resource. Keep in mind that deleting a single instantSnapshot might not necessarily delete all the data on that instantSnapshot. If any data on the instantSnapshot that is marked for deletion is needed for subsequent instantSnapshots, the data will be moved to the next corresponding instantSnapshot. For more information, see Deleting instantSnapshots." + }, + "getIamPolicy": { + "id": "compute.regionInstantSnapshots.getIamPolicy", + "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/getIamPolicy", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "PublicDelegatedPrefixesScopedList": { - "id": "PublicDelegatedPrefixesScopedList", - "type": "object", - "properties": { - "publicDelegatedPrefixes": { - "description": "[Output Only] A list of PublicDelegatedPrefixes contained in this scope.", - "type": "array", - "items": { - "$ref": "PublicDelegatedPrefix" - } + "setIamPolicy": { + "id": "compute.regionInstantSnapshots.setIamPolicy", + "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setIamPolicy", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of public delegated prefixes when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "id": "compute.regionInstantSnapshots.testIamPermissions", + "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "RegionList": { - "id": "RegionList", - "description": "Contains a list of region resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#regionList for lists of regions.", - "default": "compute#regionList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Region resources.", - "type": "array", - "items": { - "$ref": "Region" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "interconnectAttachments": { + "methods": { + "list": { + "id": "compute.interconnectAttachments.list", + "path": "projects/{project}/regions/{region}/interconnectAttachments", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "InterconnectAttachmentList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of interconnect attachments contained within the specified region." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "id": "compute.interconnectAttachments.aggregatedList", + "path": "projects/{project}/aggregated/interconnectAttachments", + "flatPath": "projects/{project}/aggregated/interconnectAttachments", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" } - } - } - } - }, - "Region": { - "id": "Region", - "description": "Represents a Region resource. A region is a geographical area where a resource is located. For more information, read Regions and Zones.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#region for regions.", - "default": "compute#region", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "[Output Only] Name of the resource.", - "type": "string" - }, - "description": { - "description": "[Output Only] Textual description of the resource.", - "type": "string" - }, - "status": { - "description": "[Output Only] Status of the region, either UP or DOWN.", - "type": "string", - "enumDescriptions": [ - "", - "" + }, + "parameterOrder": [ + "project" ], - "enum": [ - "DOWN", - "UP" - ] - }, - "zones": { - "description": "[Output Only] A list of zones available in this region, in the form of resource URLs.", - "type": "array", - "items": { - "type": "string" - } - }, - "quotas": { - "description": "[Output Only] Quotas assigned to this region.", - "type": "array", - "items": { - "$ref": "Quota" - } - }, - "deprecated": { - "description": "[Output Only] The deprecation status associated with this region.", - "$ref": "DeprecationStatus" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "supportsPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" + "response": { + "$ref": "InterconnectAttachmentAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of interconnect attachments. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "quotaStatusWarning": { - "description": "[Output Only] Warning of fetching the `quotas` field for this region. This field is populated only if fetching of the `quotas` field fails.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "id": "compute.interconnectAttachments.get", + "path": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", + "httpMethod": "GET", + "parameters": { + "interconnectAttachment": { + "description": "Name of the interconnect attachment to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "ResourcePolicyList": { - "id": "ResourcePolicyList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource.Always compute#resourcePoliciesList for listsof resourcePolicies", - "default": "compute#resourcePolicyList", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string" + }, + "parameterOrder": [ + "project", + "region", + "interconnectAttachment" + ], + "response": { + "$ref": "InterconnectAttachment" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified interconnect attachment." }, - "items": { - "description": "[Output Only] A list of ResourcePolicy resources.", - "type": "array", - "items": { - "$ref": "ResourcePolicy" - } + "insert": { + "id": "compute.interconnectAttachments.insert", + "path": "projects/{project}/regions/{region}/interconnectAttachments", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "InterconnectAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates an InterconnectAttachment in the specified project using the data included in the request." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "patch": { + "id": "compute.interconnectAttachments.patch", + "path": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", + "httpMethod": "PATCH", + "parameters": { + "interconnectAttachment": { + "description": "Name of the interconnect attachment to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "interconnectAttachment" + ], + "request": { + "$ref": "InterconnectAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified interconnect attachment with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "id": "compute.interconnectAttachments.delete", + "path": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", + "httpMethod": "DELETE", + "parameters": { + "interconnectAttachment": { + "description": "Name of the interconnect attachment to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "etag": { - "type": "string" - } - } - }, - "ResourcePolicy": { - "id": "ResourcePolicy", - "description": "Represents a Resource Policy resource. You can use resource policies to schedule actions for some Compute Engine resources. For example, you can use them to schedule persistent disk snapshots.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#resource_policies for resource policies.", - "default": "compute#resourcePolicy", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined fully-qualified URL for this resource.", - "type": "string" - }, - "region": { - "type": "string" - }, - "description": { - "type": "string" - }, - "name": { - "description": "The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "annotations": { - "required": [ - "compute.instances.insert" - ] }, - "type": "string" - }, - "snapshotSchedulePolicy": { - "description": "Resource policy for persistent disks for creating snapshots.", - "$ref": "ResourcePolicySnapshotSchedulePolicy" - }, - "groupPlacementPolicy": { - "description": "Resource policy for instances for placement configuration.", - "$ref": "ResourcePolicyGroupPlacementPolicy" - }, - "instanceSchedulePolicy": { - "description": "Resource policy for scheduling instance operations.", - "$ref": "ResourcePolicyInstanceSchedulePolicy" - }, - "diskConsistencyGroupPolicy": { - "description": "Resource policy for disk consistency groups.", - "$ref": "ResourcePolicyDiskConsistencyGroupPolicy" - }, - "status": { - "description": "[Output Only] The status of resource policy creation.", - "type": "string", - "enumDescriptions": [ - "Resource policy is being created.", - "Resource policy is being deleted.", - "Resource policy is expired and will not run again.", - "", - "Resource policy is ready to be used." + "parameterOrder": [ + "project", + "region", + "interconnectAttachment" ], - "enum": [ - "CREATING", - "DELETING", - "EXPIRED", - "INVALID", - "READY" - ] - }, - "resourceStatus": { - "description": "[Output Only] The system status of the resource policy.", - "$ref": "ResourcePolicyResourceStatus" - } - } - }, - "ResourcePolicySnapshotSchedulePolicy": { - "id": "ResourcePolicySnapshotSchedulePolicy", - "description": "A snapshot schedule policy specifies when and how frequently snapshots are to be created for the target disk. Also specifies how many and how long these scheduled snapshots should be retained.", - "type": "object", - "properties": { - "schedule": { - "description": "A Vm Maintenance Policy specifies what kind of infrastructure maintenance we are allowed to perform on this VM and when. Schedule that is applied to disks covered by this policy.", - "$ref": "ResourcePolicySnapshotSchedulePolicySchedule" - }, - "retentionPolicy": { - "description": "Retention policy applied to snapshots created by this resource policy.", - "$ref": "ResourcePolicySnapshotSchedulePolicyRetentionPolicy" - }, - "snapshotProperties": { - "description": "Properties with which snapshots are created such as labels, encryption keys.", - "$ref": "ResourcePolicySnapshotSchedulePolicySnapshotProperties" - } - } - }, - "ResourcePolicySnapshotSchedulePolicySchedule": { - "id": "ResourcePolicySnapshotSchedulePolicySchedule", - "description": "A schedule for disks where the schedueled operations are performed.", - "type": "object", - "properties": { - "hourlySchedule": { - "$ref": "ResourcePolicyHourlyCycle" - }, - "dailySchedule": { - "$ref": "ResourcePolicyDailyCycle" - }, - "weeklySchedule": { - "$ref": "ResourcePolicyWeeklyCycle" - } - } - }, - "ResourcePolicyHourlyCycle": { - "id": "ResourcePolicyHourlyCycle", - "description": "Time window specified for hourly operations.", - "type": "object", - "properties": { - "hoursInCycle": { - "description": "Defines a schedule with units measured in hours. The value determines how many hours pass between the start of each cycle.", - "type": "integer", - "format": "int32" - }, - "startTime": { - "description": "Time within the window to start the operations. It must be in format \"HH:MM\", where HH : [00-23] and MM : [00-00] GMT.", - "type": "string" - }, - "duration": { - "description": "[Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario.", - "type": "string" - } - } - }, - "ResourcePolicyDailyCycle": { - "id": "ResourcePolicyDailyCycle", - "description": "Time window specified for daily operations.", - "type": "object", - "properties": { - "daysInCycle": { - "description": "Defines a schedule with units measured in days. The value determines how many days pass between the start of each cycle.", - "type": "integer", - "format": "int32" - }, - "startTime": { - "description": "Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid.", - "type": "string" - }, - "duration": { - "description": "[Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario.", - "type": "string" - } - } - }, - "ResourcePolicyWeeklyCycle": { - "id": "ResourcePolicyWeeklyCycle", - "description": "Time window specified for weekly operations.", - "type": "object", - "properties": { - "dayOfWeeks": { - "description": "Up to 7 intervals/windows, one for each day of the week.", - "type": "array", - "items": { - "$ref": "ResourcePolicyWeeklyCycleDayOfWeek" - } - } - } - }, - "ResourcePolicyWeeklyCycleDayOfWeek": { - "id": "ResourcePolicyWeeklyCycleDayOfWeek", - "type": "object", - "properties": { - "day": { - "description": "Defines a schedule that runs on specific days of the week. Specify one or more days. The following options are available: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "FRIDAY", - "INVALID", - "MONDAY", - "SATURDAY", - "SUNDAY", - "THURSDAY", - "TUESDAY", - "WEDNESDAY" - ] - }, - "startTime": { - "description": "Time within the window to start the operations. It must be in format \"HH:MM\", where HH : [00-23] and MM : [00-00] GMT.", - "type": "string" - }, - "duration": { - "description": "[Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario.", - "type": "string" - } - } - }, - "ResourcePolicySnapshotSchedulePolicyRetentionPolicy": { - "id": "ResourcePolicySnapshotSchedulePolicyRetentionPolicy", - "description": "Policy for retention of scheduled snapshots.", - "type": "object", - "properties": { - "maxRetentionDays": { - "description": "Maximum age of the snapshot that is allowed to be kept.", - "type": "integer", - "format": "int32" + "description": "Deletes the specified interconnect attachment." }, - "onSourceDiskDelete": { - "description": "Specifies the behavior to apply to scheduled snapshots when the source disk is deleted.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "setLabels": { + "id": "compute.interconnectAttachments.setLabels", + "path": "projects/{project}/regions/{region}/interconnectAttachments/{resource}/setLabels", + "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "APPLY_RETENTION_POLICY", - "KEEP_AUTO_SNAPSHOTS", - "UNSPECIFIED_ON_SOURCE_DISK_DELETE" - ] + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on an InterconnectAttachment. To learn more about labels, read the Labeling Resources documentation." } } }, - "ResourcePolicySnapshotSchedulePolicySnapshotProperties": { - "id": "ResourcePolicySnapshotSchedulePolicySnapshotProperties", - "description": "Specified snapshot properties for scheduled snapshots created by this policy.", - "type": "object", - "properties": { - "labels": { - "description": "Labels to apply to scheduled snapshots. These can be later modified by the setLabels method. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "storageLocations": { - "description": "Cloud Storage bucket storage location of the auto snapshot (regional or multi-regional).", - "type": "array", - "items": { - "type": "string" - } - }, - "guestFlush": { - "description": "Indication to perform a 'guest aware' snapshot.", - "type": "boolean" + "interconnects": { + "methods": { + "insert": { + "id": "compute.interconnects.insert", + "path": "projects/{project}/global/interconnects", + "flatPath": "projects/{project}/global/interconnects", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "Interconnect" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates an Interconnect in the specified project using the data included in the request." }, - "chainName": { - "description": "Chain name that the snapshot is created in.", - "type": "string" - } - } - }, - "ResourcePolicyGroupPlacementPolicy": { - "id": "ResourcePolicyGroupPlacementPolicy", - "description": "A GroupPlacementPolicy specifies resource placement configuration. It specifies the failure bucket separation", - "type": "object", - "properties": { - "vmCount": { - "description": "Number of VMs in this placement group. Google does not recommend that you use this field unless you use a compact policy and you want your policy to work only if it contains this exact number of VMs.", - "type": "integer", - "format": "int32" + "list": { + "id": "compute.interconnects.list", + "path": "projects/{project}/global/interconnects", + "flatPath": "projects/{project}/global/interconnects", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "InterconnectList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of Interconnects available to the specified project." }, - "availabilityDomainCount": { - "description": "The number of availability domains to spread instances across. If two instances are in different availability domain, they are not in the same low latency network.", - "type": "integer", - "format": "int32" + "getDiagnostics": { + "id": "compute.interconnects.getDiagnostics", + "path": "projects/{project}/global/interconnects/{interconnect}/getDiagnostics", + "flatPath": "projects/{project}/global/interconnects/{interconnect}/getDiagnostics", + "httpMethod": "GET", + "parameters": { + "interconnect": { + "description": "Name of the interconnect resource to query.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "interconnect" + ], + "response": { + "$ref": "InterconnectsGetDiagnosticsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the interconnectDiagnostics for the specified Interconnect. In the event of a global outage, do not use this API to make decisions about where to redirect your network traffic. Unlike a VLAN attachment, which is regional, a Cloud Interconnect connection is a global resource. A global outage can prevent this API from functioning properly." }, - "collocation": { - "description": "Specifies network collocation", - "type": "string", - "enumDescriptions": [ - "", - "" + "getMacsecConfig": { + "id": "compute.interconnects.getMacsecConfig", + "path": "projects/{project}/global/interconnects/{interconnect}/getMacsecConfig", + "flatPath": "projects/{project}/global/interconnects/{interconnect}/getMacsecConfig", + "httpMethod": "GET", + "parameters": { + "interconnect": { + "description": "Name of the interconnect resource to query.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "interconnect" ], - "enum": [ - "COLLOCATED", - "UNSPECIFIED_COLLOCATION" - ] - } - } - }, - "ResourcePolicyInstanceSchedulePolicy": { - "id": "ResourcePolicyInstanceSchedulePolicy", - "description": "An InstanceSchedulePolicy specifies when and how frequent certain operations are performed on the instance.", - "type": "object", - "properties": { - "vmStartSchedule": { - "description": "Specifies the schedule for starting instances.", - "$ref": "ResourcePolicyInstanceSchedulePolicySchedule" + "response": { + "$ref": "InterconnectsGetMacsecConfigResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the interconnectMacsecConfig for the specified Interconnect." }, - "vmStopSchedule": { - "description": "Specifies the schedule for stopping instances.", - "$ref": "ResourcePolicyInstanceSchedulePolicySchedule" + "get": { + "id": "compute.interconnects.get", + "path": "projects/{project}/global/interconnects/{interconnect}", + "flatPath": "projects/{project}/global/interconnects/{interconnect}", + "httpMethod": "GET", + "parameters": { + "interconnect": { + "description": "Name of the interconnect to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "interconnect" + ], + "response": { + "$ref": "Interconnect" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified Interconnect. Get a list of available Interconnects by making a list() request." }, - "timeZone": { - "description": "Specifies the time zone to be used in interpreting Schedule.schedule. The value of this field must be a time zone name from the tz database: https://wikipedia.org/wiki/Tz_database.", - "type": "string" + "delete": { + "id": "compute.interconnects.delete", + "path": "projects/{project}/global/interconnects/{interconnect}", + "flatPath": "projects/{project}/global/interconnects/{interconnect}", + "httpMethod": "DELETE", + "parameters": { + "interconnect": { + "description": "Name of the interconnect to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "interconnect" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified Interconnect." }, - "startTime": { - "description": "The start time of the schedule. The timestamp is an RFC3339 string.", - "type": "string" + "patch": { + "id": "compute.interconnects.patch", + "path": "projects/{project}/global/interconnects/{interconnect}", + "flatPath": "projects/{project}/global/interconnects/{interconnect}", + "httpMethod": "PATCH", + "parameters": { + "interconnect": { + "description": "Name of the interconnect to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "interconnect" + ], + "request": { + "$ref": "Interconnect" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified Interconnect with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." }, - "expirationTime": { - "description": "The expiration time of the schedule. The timestamp is an RFC3339 string.", - "type": "string" - } - } - }, - "ResourcePolicyInstanceSchedulePolicySchedule": { - "id": "ResourcePolicyInstanceSchedulePolicySchedule", - "description": "Schedule for an instance operation.", - "type": "object", - "properties": { - "schedule": { - "description": "Specifies the frequency for the operation, using the unix-cron format.", - "type": "string" - } - } - }, - "ResourcePolicyDiskConsistencyGroupPolicy": { - "id": "ResourcePolicyDiskConsistencyGroupPolicy", - "description": "Resource policy for disk consistency groups.", - "type": "object", - "properties": {} - }, - "ResourcePolicyResourceStatus": { - "id": "ResourcePolicyResourceStatus", - "description": "Contains output only fields. Use this sub-message for all output fields set on ResourcePolicy. The internal structure of this \"status\" field should mimic the structure of ResourcePolicy proto specification.", - "type": "object", - "properties": { - "instanceSchedulePolicy": { - "description": "[Output Only] Specifies a set of output values reffering to the instance_schedule_policy system status. This field should have the same name as corresponding policy field.", - "$ref": "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus" + "setLabels": { + "id": "compute.interconnects.setLabels", + "path": "projects/{project}/global/interconnects/{resource}/setLabels", + "flatPath": "projects/{project}/global/interconnects/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on an Interconnect. To learn more about labels, read the Labeling Resources documentation." } } }, - "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus": { - "id": "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus", - "type": "object", - "properties": { - "nextRunStartTime": { - "description": "[Output Only] The next time the schedule is planned to run. The actual time might be slightly different. The timestamp is an RFC3339 string.", - "type": "string" + "interconnectLocations": { + "methods": { + "list": { + "id": "compute.interconnectLocations.list", + "path": "projects/{project}/global/interconnectLocations", + "flatPath": "projects/{project}/global/interconnectLocations", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "InterconnectLocationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of interconnect locations available to the specified project." }, - "lastRunStartTime": { - "description": "[Output Only] The last time the schedule successfully ran. The timestamp is an RFC3339 string.", - "type": "string" + "get": { + "id": "compute.interconnectLocations.get", + "path": "projects/{project}/global/interconnectLocations/{interconnectLocation}", + "flatPath": "projects/{project}/global/interconnectLocations/{interconnectLocation}", + "httpMethod": "GET", + "parameters": { + "interconnectLocation": { + "description": "Name of the interconnect location to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "interconnectLocation" + ], + "response": { + "$ref": "InterconnectLocation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the details for the specified interconnect location. Gets a list of available interconnect locations by making a list() request." } } }, - "ResourcePolicyAggregatedList": { - "id": "ResourcePolicyAggregatedList", - "description": "Contains a list of resourcePolicies.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#resourcePolicyAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of ResourcePolicy resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of resourcePolicies.", - "$ref": "ResourcePoliciesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "interconnectRemoteLocations": { + "methods": { + "list": { + "id": "compute.interconnectRemoteLocations.list", + "path": "projects/{project}/global/interconnectRemoteLocations", + "flatPath": "projects/{project}/global/interconnectRemoteLocations", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "InterconnectRemoteLocationList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of interconnect remote locations available to the specified project." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "id": "compute.interconnectRemoteLocations.get", + "path": "projects/{project}/global/interconnectRemoteLocations/{interconnectRemoteLocation}", + "flatPath": "projects/{project}/global/interconnectRemoteLocations/{interconnectRemoteLocation}", + "httpMethod": "GET", + "parameters": { + "interconnectRemoteLocation": { + "description": "Name of the interconnect remote location to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "interconnectRemoteLocation" + ], + "response": { + "$ref": "InterconnectRemoteLocation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the details for the specified interconnect remote location. Gets a list of available interconnect remote locations by making a list() request." + } + } + }, + "licenseCodes": { + "methods": { + "get": { + "id": "compute.licenseCodes.get", + "path": "projects/{project}/global/licenseCodes/{licenseCode}", + "flatPath": "projects/{project}/global/licenseCodes/{licenseCode}", + "httpMethod": "GET", + "parameters": { + "licenseCode": { + "description": "Number corresponding to the License code resource to return.", + "pattern": "[0-9]{0,61}?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" } - } - }, - "etag": { - "type": "string" + }, + "parameterOrder": [ + "project", + "licenseCode" + ], + "response": { + "$ref": "LicenseCode" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Return a specified license code. License codes are mirrored across all projects that have permissions to read the License Code. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } + "testIamPermissions": { + "id": "compute.licenseCodes.testIamPermissions", + "path": "projects/{project}/global/licenseCodes/{resource}/testIamPermissions", + "flatPath": "projects/{project}/global/licenseCodes/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " } } }, - "ResourcePoliciesScopedList": { - "id": "ResourcePoliciesScopedList", - "type": "object", - "properties": { - "resourcePolicies": { - "description": "A list of resourcePolicies contained in this scope.", - "type": "array", - "items": { - "$ref": "ResourcePolicy" - } + "licenses": { + "methods": { + "get": { + "id": "compute.licenses.get", + "path": "projects/{project}/global/licenses/{license}", + "flatPath": "projects/{project}/global/licenses/{license}", + "httpMethod": "GET", + "parameters": { + "license": { + "description": "Name of the License resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "license" + ], + "response": { + "$ref": "License" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified License resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " }, - "warning": { - "description": "Informational warning which replaces the list of resourcePolicies when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "list": { + "id": "compute.licenses.list", + "path": "projects/{project}/global/licenses", + "flatPath": "projects/{project}/global/licenses", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "LicensesListResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of licenses available in the specified project. This method does not get any licenses that belong to other projects, including licenses attached to publicly-available images, like Debian 9. If you want to get a list of publicly-available licenses, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + }, + "delete": { + "id": "compute.licenses.delete", + "path": "projects/{project}/global/licenses/{license}", + "flatPath": "projects/{project}/global/licenses/{license}", + "httpMethod": "DELETE", + "parameters": { + "license": { + "description": "Name of the license resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "license" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified license. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + }, + "insert": { + "id": "compute.licenses.insert", + "path": "projects/{project}/global/licenses", + "flatPath": "projects/{project}/global/licenses", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "License" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/devstorage.full_control", + "https://www.googleapis.com/auth/devstorage.read_only", + "https://www.googleapis.com/auth/devstorage.read_write" + ], + "description": "Create a License resource in the specified project. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + }, + "getIamPolicy": { + "id": "compute.licenses.getIamPolicy", + "path": "projects/{project}/global/licenses/{resource}/getIamPolicy", + "flatPath": "projects/{project}/global/licenses/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + }, + "setIamPolicy": { + "id": "compute.licenses.setIamPolicy", + "path": "projects/{project}/global/licenses/{resource}/setIamPolicy", + "flatPath": "projects/{project}/global/licenses/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + }, + "testIamPermissions": { + "id": "compute.licenses.testIamPermissions", + "path": "projects/{project}/global/licenses/{resource}/testIamPermissions", + "flatPath": "projects/{project}/global/licenses/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " } } }, - "RouteList": { - "id": "RouteList", - "description": "Contains a list of Route resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#routeList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Route resources.", - "type": "array", - "items": { - "$ref": "Route" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "machineImages": { + "methods": { + "list": { + "id": "compute.machineImages.list", + "path": "projects/{project}/global/machineImages", + "flatPath": "projects/{project}/global/machineImages", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "Route": { - "id": "Route", - "description": "Represents a Route resource. A route defines a path from VM instances in the VPC network to a specific destination. This destination can be inside or outside the VPC network. For more information, read the Routes overview.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of this resource. Always compute#routes for Route resources.", - "default": "compute#route", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "annotations": { - "required": [ - "compute.routes.insert" - ] - }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this field when you create the resource.", - "type": "string" - }, - "network": { - "description": "Fully-qualified URL of the network that this route applies to.", - "annotations": { - "required": [ - "compute.routes.insert" - ] }, - "type": "string" - }, - "tags": { - "description": "A list of instance tags to which this route applies.", - "annotations": { - "required": [ - "compute.routes.insert" - ] + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "MachineImageList" }, - "type": "array", - "items": { - "type": "string" - } + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of machine images that are contained within the specified project." }, - "destRange": { - "description": "The destination range of outgoing packets that this route applies to. Both IPv4 and IPv6 are supported. Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291 format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952 compressed format.", - "annotations": { - "required": [ - "compute.routes.insert" - ] + "get": { + "id": "compute.machineImages.get", + "path": "projects/{project}/global/machineImages/{machineImage}", + "flatPath": "projects/{project}/global/machineImages/{machineImage}", + "httpMethod": "GET", + "parameters": { + "machineImage": { + "description": "The name of the machine image.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } }, - "type": "string" - }, - "priority": { - "description": "The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In cases where multiple routes have equal prefix length, the one with the lowest-numbered priority value wins. The default value is `1000`. The priority value must be from `0` to `65535`, inclusive.", - "annotations": { - "required": [ - "compute.routes.insert" - ] + "parameterOrder": [ + "project", + "machineImage" + ], + "response": { + "$ref": "MachineImage" }, - "type": "integer", - "format": "uint32" - }, - "nextHopInstance": { - "description": "The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/", - "type": "string" - }, - "nextHopIp": { - "description": "The network IP address of an instance that should handle matching packets. Both IPv6 address and IPv4 addresses are supported. Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.", - "type": "string" - }, - "nextHopNetwork": { - "description": "The URL of the local network if it should handle matching packets.", - "type": "string" - }, - "nextHopGateway": { - "description": "The URL to a gateway that should handle matching packets. You can only specify the internet gateway using a full or partial valid URL: projects/ project/global/gateways/default-internet-gateway", - "type": "string" - }, - "nextHopPeering": { - "description": "[Output Only] The network peering name that should handle matching packets, which should conform to RFC1035.", - "type": "string" - }, - "nextHopIlb": { - "description": "The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.", - "type": "string" + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified machine image." }, - "warnings": { - "description": "[Output Only] If potential misconfigurations are detected for this route, this field will be populated with warning messages.", - "type": "array", - "items": { - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } + "insert": { + "id": "compute.machineImages.insert", + "path": "projects/{project}/global/machineImages", + "flatPath": "projects/{project}/global/machineImages", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sourceInstance": { + "description": "Required. Source instance that is used to create the machine image from.", + "location": "query", + "type": "string" } - } - }, - "nextHopVpnTunnel": { - "description": "The URL to a VpnTunnel that should handle matching packets.", - "type": "string" - }, - "nextHopHub": { - "description": "[Output Only] The full resource name of the Network Connectivity Center hub that will handle matching packets.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined fully-qualified URL for this resource.", - "type": "string" - }, - "routeType": { - "description": "[Output Only] The type of this route, which can be one of the following values: - 'TRANSIT' for a transit route that this router learned from another Cloud Router and will readvertise to one of its BGP peers - 'SUBNET' for a route from a subnet of the VPC - 'BGP' for a route learned from a BGP peer of this router - 'STATIC' for a static route", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "MachineImage" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "BGP", - "STATIC", - "SUBNET", - "TRANSIT" - ] - }, - "asPaths": { - "description": "[Output Only] AS path.", - "type": "array", - "items": { - "$ref": "RouteAsPath" - } + "description": "Creates a machine image in the specified project using the data that is included in the request. If you are creating a new machine image to update an existing instance, your new machine image should use the same network or, if applicable, the same subnetwork as the original instance." }, - "routeStatus": { - "description": "[Output only] The status of the route.", - "type": "string", - "enumDescriptions": [ - "This route is processed and active.", - "The route is dropped due to the VPC exceeding the dynamic route limit. For dynamic route limit, please refer to the Learned route example", - "This route is processed but inactive due to failure from the backend. The backend may have rejected the route", - "This route is being processed internally. The status will change once processed." + "delete": { + "id": "compute.machineImages.delete", + "path": "projects/{project}/global/machineImages/{machineImage}", + "flatPath": "projects/{project}/global/machineImages/{machineImage}", + "httpMethod": "DELETE", + "parameters": { + "machineImage": { + "description": "The name of the machine image to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "machineImage" ], - "enum": [ - "ACTIVE", - "DROPPED", - "INACTIVE", - "PENDING" - ] - } - } - }, - "RouteAsPath": { - "id": "RouteAsPath", - "type": "object", - "properties": { - "pathSegmentType": { - "description": "[Output Only] The type of the AS Path, which can be one of the following values: - 'AS_SET': unordered set of autonomous systems that the route in has traversed - 'AS_SEQUENCE': ordered set of autonomous systems that the route has traversed - 'AS_CONFED_SEQUENCE': ordered set of Member Autonomous Systems in the local confederation that the route has traversed - 'AS_CONFED_SET': unordered set of Member Autonomous Systems in the local confederation that the route has traversed ", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "AS_CONFED_SEQUENCE", - "AS_CONFED_SET", - "AS_SEQUENCE", - "AS_SET" - ] - }, - "asLists": { - "description": "[Output Only] The AS numbers of the AS Path.", - "type": "array", - "items": { - "type": "integer", - "format": "uint32" - } - } - } - }, - "Router": { - "id": "Router", - "description": "Represents a Cloud Router resource. For more information about Cloud Router, read the Cloud Router overview.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#router for routers.", - "default": "compute#router", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" + "description": "Deletes the specified machine image. Deleting a machine image is permanent and cannot be undone." }, - "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])?", - "annotations": { - "required": [ - "compute.routers.insert" - ] + "getIamPolicy": { + "id": "compute.machineImages.getIamPolicy", + "path": "projects/{project}/global/machineImages/{resource}/getIamPolicy", + "flatPath": "projects/{project}/global/machineImages/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "network": { - "description": "URI of the network to which this router belongs.", - "annotations": { - "required": [ - "compute.routers.insert", - "compute.routers.update" - ] + "parameterOrder": [ + "project", + "resource" + ], + "response": { + "$ref": "Policy" }, - "type": "string" - }, - "interfaces": { - "description": "Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface.", - "type": "array", - "items": { - "$ref": "RouterInterface" - } - }, - "bgpPeers": { - "description": "BGP information that must be configured into the routing stack to establish BGP peering. This information must specify the peer ASN and either the interface name, IP address, or peer IP address. Please refer to RFC4273.", - "type": "array", - "items": { - "$ref": "RouterBgpPeer" - } - }, - "bgp": { - "description": "BGP information specific to this router.", - "$ref": "RouterBgp" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "nats": { - "description": "A list of NAT services created in this router.", - "type": "array", - "items": { - "$ref": "RouterNat" - } + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "encryptedInterconnectRouter": { - "description": "Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments).", - "type": "boolean" + "setIamPolicy": { + "id": "compute.machineImages.setIamPolicy", + "path": "projects/{project}/global/machineImages/{resource}/setIamPolicy", + "flatPath": "projects/{project}/global/machineImages/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "GlobalSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "md5AuthenticationKeys": { - "description": "Keys used for MD5 authentication.", - "type": "array", - "items": { - "$ref": "RouterMd5AuthenticationKey" - } + "testIamPermissions": { + "id": "compute.machineImages.testIamPermissions", + "path": "projects/{project}/global/machineImages/{resource}/testIamPermissions", + "flatPath": "projects/{project}/global/machineImages/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "RouterInterface": { - "id": "RouterInterface", - "type": "object", - "properties": { - "name": { - "description": "Name of this interface entry. 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])?", - "annotations": { - "required": [ - "compute.routers.insert" - ] + "machineTypes": { + "methods": { + "list": { + "id": "compute.machineTypes.list", + "path": "projects/{project}/zones/{zone}/machineTypes", + "flatPath": "projects/{project}/zones/{zone}/machineTypes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } }, - "type": "string" - }, - "linkedVpnTunnel": { - "description": "URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.", - "type": "string" - }, - "linkedInterconnectAttachment": { - "description": "URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.", - "type": "string" - }, - "ipRange": { - "description": "IP address and range of the interface. - For Internet Protocol version 4 (IPv4), the IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example, 169.254.0.1/30. Note: Do not truncate the IP address, as it represents the IP address of the interface. - For Internet Protocol version 6 (IPv6), the value must be a unique local address (ULA) range from fdff:1::/64 with a mask length of 126 or less. This value should be a CIDR-formatted string, for example, fc00:0:1:1::1/112. Within the router's VPC, this IPv6 prefix will be reserved exclusively for this connection and cannot be used for any other purpose. ", - "type": "string" - }, - "managementType": { - "description": "[Output Only] The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted. ", - "type": "string", - "enumDescriptions": [ - "The interface is automatically created for PARTNER type InterconnectAttachment, Google will automatically create/update/delete this interface when the PARTNER InterconnectAttachment is created/provisioned/deleted. This type of interface cannot be manually managed by user.", - "Default value, the interface is manually created and managed by user." + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "MANAGED_BY_ATTACHMENT", - "MANAGED_BY_USER" - ] - }, - "privateIpAddress": { - "description": "The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM.", - "type": "string" - }, - "redundantInterface": { - "description": "Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface 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" + "response": { + "$ref": "MachineTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of machine types available to the specified project." }, - "subnetwork": { - "description": "The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here.", - "type": "string" + "aggregatedList": { + "id": "compute.machineTypes.aggregatedList", + "path": "projects/{project}/aggregated/machineTypes", + "flatPath": "projects/{project}/aggregated/machineTypes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "MachineTypeAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of machine types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "ipVersion": { - "description": "IP version of this interface.", - "type": "string", - "enumDescriptions": [ - "", - "" + "get": { + "id": "compute.machineTypes.get", + "path": "projects/{project}/zones/{zone}/machineTypes/{machineType}", + "flatPath": "projects/{project}/zones/{zone}/machineTypes/{machineType}", + "httpMethod": "GET", + "parameters": { + "machineType": { + "description": "Name of the machine type to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "machineType" + ], + "response": { + "$ref": "MachineType" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "IPV4", - "IPV6" - ] + "description": "Returns the specified machine type." } } }, - "RouterBgpPeer": { - "id": "RouterBgpPeer", - "type": "object", - "properties": { - "name": { - "description": "Name of this BGP peer. 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])?", - "annotations": { - "required": [ - "compute.routers.insert" - ] + "networkAttachments": { + "methods": { + "aggregatedList": { + "id": "compute.networkAttachments.aggregatedList", + "path": "projects/{project}/aggregated/networkAttachments", + "flatPath": "projects/{project}/aggregated/networkAttachments", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } }, - "type": "string" - }, - "interfaceName": { - "description": "Name of the interface the BGP peer is associated with.", - "type": "string" - }, - "ipAddress": { - "description": "IP address of the interface inside Google Cloud Platform.", - "type": "string" - }, - "peerIpAddress": { - "description": "IP address of the BGP interface outside Google Cloud Platform.", - "type": "string" - }, - "peerAsn": { - "description": "Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.", - "annotations": { - "required": [ - "compute.routers.insert" - ] + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "NetworkAttachmentAggregatedList" }, - "type": "integer", - "format": "uint32" - }, - "advertisedRoutePriority": { - "description": "The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.", - "type": "integer", - "format": "uint32" - }, - "advertiseMode": { - "description": "User-specified flag to indicate which mode to use for advertisement.", - "type": "string", - "enumDescriptions": [ - "", - "" + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "CUSTOM", - "DEFAULT" - ] - }, - "advertisedGroups": { - "description": "User-specified list of prefix groups to advertise in custom mode, which currently supports the following option: - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering. Note that this field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the \"bgp\" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "Advertise all available subnets (including peer VPC subnets)." - ], - "enum": [ - "ALL_SUBNETS" - ] - } - }, - "advertisedIpRanges": { - "description": "User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the \"bgp\" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges.", - "type": "array", - "items": { - "$ref": "RouterAdvertisedIpRange" - } + "description": "Retrieves the list of all NetworkAttachment resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "managementType": { - "description": "[Output Only] The resource that configures and manages this BGP peer. - MANAGED_BY_USER is the default value and can be managed by you or other users - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted. ", - "type": "string", - "enumDescriptions": [ - "The BGP peer is automatically created for PARTNER type InterconnectAttachment; Google will automatically create/delete this BGP peer when the PARTNER InterconnectAttachment is created/deleted, and Google will update the ipAddress and peerIpAddress when the PARTNER InterconnectAttachment is provisioned. This type of BGP peer cannot be created or deleted, but can be modified for all fields except for name, ipAddress and peerIpAddress.", - "Default value, the BGP peer is manually created and managed by user." + "list": { + "id": "compute.networkAttachments.list", + "path": "projects/{project}/regions/{region}/networkAttachments", + "flatPath": "projects/{project}/regions/{region}/networkAttachments", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "MANAGED_BY_ATTACHMENT", - "MANAGED_BY_USER" - ] - }, - "enable": { - "description": "The status of the BGP peer connection. If set to FALSE, any active session with the peer is terminated and all associated routing information is removed. If set to TRUE, the peer connection can be established with routing information. The default is TRUE.", - "type": "string", - "enumDescriptions": [ - "", - "" + "response": { + "$ref": "NetworkAttachmentList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "FALSE", - "TRUE" - ] - }, - "bfd": { - "description": "BFD configuration for the BGP peering.", - "$ref": "RouterBgpPeerBfd" - }, - "routerApplianceInstance": { - "description": "URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.", - "type": "string" - }, - "enableIpv6": { - "description": "Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6.", - "type": "boolean" - }, - "ipv6NexthopAddress": { - "description": "IPv6 address of the interface inside Google Cloud Platform.", - "type": "string" - }, - "peerIpv6NexthopAddress": { - "description": "IPv6 address of the BGP interface outside Google Cloud Platform.", - "type": "string" - }, - "md5AuthenticationKeyName": { - "description": "Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035.", - "type": "string" - }, - "customLearnedRoutePriority": { - "description": "The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from `0` to `65335`. If you don't provide a value, Google Cloud assigns a priority of `100` to the ranges.", - "type": "integer", - "format": "int32" - }, - "customLearnedIpRanges": { - "description": "A list of user-defined custom learned route IP address ranges for a BGP session.", - "type": "array", - "items": { - "$ref": "RouterBgpPeerCustomLearnedIpRange" - } - }, - "enableIpv4": { - "description": "Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.", - "type": "boolean" - }, - "ipv4NexthopAddress": { - "description": "IPv4 address of the interface inside Google Cloud Platform.", - "type": "string" - }, - "peerIpv4NexthopAddress": { - "description": "IPv4 address of the BGP interface outside Google Cloud Platform.", - "type": "string" - }, - "exportPolicies": { - "description": "List of export policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_EXPORT type. Note that Route Policies are currently available in preview. Please use Beta API to use Route Policies.", - "type": "array", - "items": { - "type": "string" - } - }, - "importPolicies": { - "description": "List of import policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_IMPORT type. Note that Route Policies are currently available in preview. Please use Beta API to use Route Policies.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "RouterAdvertisedIpRange": { - "id": "RouterAdvertisedIpRange", - "description": "Description-tagged IP ranges for the router to advertise.", - "type": "object", - "properties": { - "range": { - "description": "The IP range to advertise. The value must be a CIDR-formatted string.", - "type": "string" + "description": "Lists the NetworkAttachments for a project in the given scope." }, - "description": { - "description": "User-specified description for the IP range.", - "type": "string" - } - } - }, - "RouterBgpPeerBfd": { - "id": "RouterBgpPeerBfd", - "type": "object", - "properties": { - "sessionInitializationMode": { - "description": "The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "get": { + "id": "compute.networkAttachments.get", + "path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "httpMethod": "GET", + "parameters": { + "networkAttachment": { + "description": "Name of the NetworkAttachment resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "networkAttachment" ], - "enum": [ - "ACTIVE", - "DISABLED", - "PASSIVE" - ] - }, - "minTransmitInterval": { - "description": "The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000.", - "type": "integer", - "format": "uint32" - }, - "minReceiveInterval": { - "description": "The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000.", - "type": "integer", - "format": "uint32" - }, - "multiplier": { - "description": "The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16. The default is 5.", - "type": "integer", - "format": "uint32" - } - } - }, - "RouterBgpPeerCustomLearnedIpRange": { - "id": "RouterBgpPeerCustomLearnedIpRange", - "type": "object", - "properties": { - "range": { - "description": "The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a `/32` singular IP address range, and, for IPv6, `/128`.", - "type": "string" - } - } - }, - "RouterBgp": { - "id": "RouterBgp", - "type": "object", - "properties": { - "asn": { - "description": "Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN.", - "type": "integer", - "format": "uint32" - }, - "advertiseMode": { - "description": "User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM.", - "type": "string", - "enumDescriptions": [ - "", - "" + "response": { + "$ref": "NetworkAttachment" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "CUSTOM", - "DEFAULT" - ] - }, - "advertisedGroups": { - "description": "User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "Advertise all available subnets (including peer VPC subnets)." - ], - "enum": [ - "ALL_SUBNETS" - ] - } - }, - "advertisedIpRanges": { - "description": "User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges.", - "type": "array", - "items": { - "$ref": "RouterAdvertisedIpRange" - } - }, - "keepaliveInterval": { - "description": "The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20.", - "type": "integer", - "format": "uint32" + "description": "Returns the specified NetworkAttachment resource in the given scope." }, - "identifierRange": { - "description": "Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this \"router ID\".", - "type": "string" - } - } - }, - "RouterNat": { - "id": "RouterNat", - "description": "Represents a Nat resource. It enables the VMs within the specified subnetworks to access Internet without external IP addresses. It specifies a list of subnetworks (and the ranges within) that want to use NAT. Customers can also provide the external IPs that would be used for NAT. GCP would auto-allocate ephemeral IPs if no external IPs are provided.", - "type": "object", - "properties": { - "name": { - "description": "Unique name of this Nat service. 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" + "insert": { + "id": "compute.networkAttachments.insert", + "path": "projects/{project}/regions/{region}/networkAttachments", + "flatPath": "projects/{project}/regions/{region}/networkAttachments", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "NetworkAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a NetworkAttachment in the specified project in the given scope using the parameters that are included in the request." }, - "type": { - "description": "Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC.", - "type": "string", - "enumDescriptions": [ - "NAT used for private IP translation.", - "NAT used for public IP translation. This is the default." + "delete": { + "id": "compute.networkAttachments.delete", + "path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "httpMethod": "DELETE", + "parameters": { + "networkAttachment": { + "description": "Name of the NetworkAttachment resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "networkAttachment" ], - "enum": [ - "PRIVATE", - "PUBLIC" - ] - }, - "autoNetworkTier": { - "description": "The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used.", - "type": "string", - "enumDescriptions": [ - "Public internet quality with fixed bandwidth.", - "High quality, Google-grade network tier, support for all networking products.", - "Public internet quality, only limited support for other networking products.", - "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "FIXED_STANDARD", - "PREMIUM", - "STANDARD", - "STANDARD_OVERRIDES_FIXED_STANDARD" - ] - }, - "endpointTypes": { - "description": "List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "This is used for regional Application Load Balancers (internal and external) and regional proxy Network Load Balancers (internal and external) endpoints.", - "This is used for Secure Web Gateway endpoints.", - "This is the default." - ], - "enum": [ - "ENDPOINT_TYPE_MANAGED_PROXY_LB", - "ENDPOINT_TYPE_SWG", - "ENDPOINT_TYPE_VM" - ] - } + "description": "Deletes the specified NetworkAttachment in the given scope" }, - "sourceSubnetworkIpRangesToNat": { - "description": "Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region.", - "type": "string", - "enumDescriptions": [ - "All the IP ranges in every Subnetwork are allowed to Nat.", - "All the primary IP ranges in every Subnetwork are allowed to Nat.", - "A list of Subnetworks are allowed to Nat (specified in the field subnetwork below)" + "patch": { + "id": "compute.networkAttachments.patch", + "path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", + "httpMethod": "PATCH", + "parameters": { + "networkAttachment": { + "description": "Name of the NetworkAttachment resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "networkAttachment" ], - "enum": [ - "ALL_SUBNETWORKS_ALL_IP_RANGES", - "ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES", - "LIST_OF_SUBNETWORKS" - ] - }, - "subnetworks": { - "description": "A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above.", - "type": "array", - "items": { - "$ref": "RouterNatSubnetworkToNat" - } - }, - "natIps": { - "description": "A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project.", - "type": "array", - "items": { - "type": "string" - } - }, - "drainNatIps": { - "description": "A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only.", - "type": "array", - "items": { - "type": "string" - } - }, - "natIpAllocateOption": { - "description": "Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty. ", - "type": "string", - "enumDescriptions": [ - "Nat IPs are allocated by GCP; customers can not specify any Nat IPs.", - "Only use Nat IPs provided by customers. When specified Nat IPs are not enough then the Nat service fails for new VMs." + "request": { + "$ref": "NetworkAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "AUTO_ONLY", - "MANUAL_ONLY" - ] - }, - "minPortsPerVm": { - "description": "Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM.", - "type": "integer", - "format": "int32" - }, - "maxPortsPerVm": { - "description": "Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config.", - "type": "integer", - "format": "int32" - }, - "enableDynamicPortAllocation": { - "description": "Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config. ", - "type": "boolean" - }, - "udpIdleTimeoutSec": { - "description": "Timeout (in seconds) for UDP connections. Defaults to 30s if not set.", - "type": "integer", - "format": "int32" - }, - "icmpIdleTimeoutSec": { - "description": "Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.", - "type": "integer", - "format": "int32" - }, - "tcpEstablishedIdleTimeoutSec": { - "description": "Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set.", - "type": "integer", - "format": "int32" - }, - "tcpTransitoryIdleTimeoutSec": { - "description": "Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set.", - "type": "integer", - "format": "int32" - }, - "tcpTimeWaitTimeoutSec": { - "description": "Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set.", - "type": "integer", - "format": "int32" - }, - "logConfig": { - "description": "Configure logging on this NAT.", - "$ref": "RouterNatLogConfig" - }, - "rules": { - "description": "A list of rules associated with this NAT.", - "type": "array", - "items": { - "$ref": "RouterNatRule" - } - }, - "enableEndpointIndependentMapping": { - "type": "boolean" - } - } - }, - "RouterNatSubnetworkToNat": { - "id": "RouterNatSubnetworkToNat", - "description": "Defines the IP ranges that want to use NAT for a subnetwork.", - "type": "object", - "properties": { - "name": { - "description": "URL for the subnetwork resource that will use NAT.", - "type": "string" - }, - "sourceIpRangesToNat": { - "description": "Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: [\"PRIMARY_IP_RANGE\", \"LIST_OF_SECONDARY_IP_RANGES\"] Default: [ALL_IP_RANGES]", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "The primary and all the secondary ranges are allowed to Nat.", - "A list of secondary ranges are allowed to Nat.", - "The primary range is allowed to Nat." - ], - "enum": [ - "ALL_IP_RANGES", - "LIST_OF_SECONDARY_IP_RANGES", - "PRIMARY_IP_RANGE" - ] - } - }, - "secondaryIpRangeNames": { - "description": "A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if \"LIST_OF_SECONDARY_IP_RANGES\" is one of the values in source_ip_ranges_to_nat.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "RouterNatLogConfig": { - "id": "RouterNatLogConfig", - "description": "Configuration of logging on a NAT.", - "type": "object", - "properties": { - "enable": { - "description": "Indicates whether or not to export logs. This is false by default.", - "type": "boolean" + "description": "Patches the specified NetworkAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." }, - "filter": { - "description": "Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful. ", - "type": "string", - "enumDescriptions": [ - "Export logs for all (successful and unsuccessful) connections.", - "Export logs for connection failures only.", - "Export logs for successful connections only." + "getIamPolicy": { + "id": "compute.networkAttachments.getIamPolicy", + "path": "projects/{project}/regions/{region}/networkAttachments/{resource}/getIamPolicy", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "ALL", - "ERRORS_ONLY", - "TRANSLATIONS_ONLY" - ] - } - } - }, - "RouterNatRule": { - "id": "RouterNatRule", - "type": "object", - "properties": { - "ruleNumber": { - "description": "An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT.", - "type": "integer", - "format": "uint32" - }, - "description": { - "description": "An optional description of this rule.", - "type": "string" + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "match": { - "description": "CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'`", - "type": "string" + "setIamPolicy": { + "id": "compute.networkAttachments.setIamPolicy", + "path": "projects/{project}/regions/{region}/networkAttachments/{resource}/setIamPolicy", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "action": { - "description": "The action to be enforced for traffic that matches this rule.", - "$ref": "RouterNatRuleAction" + "testIamPermissions": { + "id": "compute.networkAttachments.testIamPermissions", + "path": "projects/{project}/regions/{region}/networkAttachments/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "RouterNatRuleAction": { - "id": "RouterNatRuleAction", - "type": "object", - "properties": { - "sourceNatActiveIps": { - "description": "A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT.", - "type": "array", - "items": { - "type": "string" - } + "networkEdgeSecurityServices": { + "methods": { + "get": { + "id": "compute.networkEdgeSecurityServices.get", + "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", + "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", + "httpMethod": "GET", + "parameters": { + "networkEdgeSecurityService": { + "description": "Name of the network edge security service to get.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "networkEdgeSecurityService" + ], + "response": { + "$ref": "NetworkEdgeSecurityService" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets a specified NetworkEdgeSecurityService." }, - "sourceNatDrainIps": { - "description": "A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT.", - "type": "array", - "items": { - "type": "string" - } + "insert": { + "id": "compute.networkEdgeSecurityServices.insert", + "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices", + "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "validateOnly": { + "description": "If true, the request will not be committed.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "NetworkEdgeSecurityService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a new service in the specified project using the data included in the request." }, - "sourceNatActiveRanges": { - "description": "A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT.", - "type": "array", - "items": { - "type": "string" - } + "delete": { + "id": "compute.networkEdgeSecurityServices.delete", + "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", + "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", + "httpMethod": "DELETE", + "parameters": { + "networkEdgeSecurityService": { + "description": "Name of the network edge security service to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "networkEdgeSecurityService" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified service." }, - "sourceNatDrainRanges": { - "description": "A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "RouterMd5AuthenticationKey": { - "id": "RouterMd5AuthenticationKey", - "type": "object", - "properties": { - "name": { - "description": "Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035.", - "annotations": { - "required": [ - "compute.routers.insert", - "compute.routers.update" - ] + "patch": { + "id": "compute.networkEdgeSecurityServices.patch", + "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", + "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", + "httpMethod": "PATCH", + "parameters": { + "networkEdgeSecurityService": { + "description": "Name of the network edge security service to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "paths": { + "location": "query", + "repeated": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "Indicates fields to be updated as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" + } }, - "type": "string" + "parameterOrder": [ + "project", + "region", + "networkEdgeSecurityService" + ], + "request": { + "$ref": "NetworkEdgeSecurityService" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified policy with the data included in the request." }, - "key": { - "description": "[Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters.", - "annotations": { - "required": [ - "compute.routers.insert" - ] + "aggregatedList": { + "id": "compute.networkEdgeSecurityServices.aggregatedList", + "path": "projects/{project}/aggregated/networkEdgeSecurityServices", + "flatPath": "projects/{project}/aggregated/networkEdgeSecurityServices", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } }, - "type": "string" + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "NetworkEdgeSecurityServiceAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of all NetworkEdgeSecurityService resources available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." } } }, - "RouterList": { - "id": "RouterList", - "description": "Contains a list of Router resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#router for routers.", - "default": "compute#routerList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Router resources.", - "type": "array", - "items": { - "$ref": "Router" - } + "networkEndpointGroups": { + "methods": { + "list": { + "id": "compute.networkEndpointGroups.list", + "path": "projects/{project}/zones/{zone}/networkEndpointGroups", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "NetworkEndpointGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of network endpoint groups that are located in the specified project and zone." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "aggregatedList": { + "id": "compute.networkEndpointGroups.aggregatedList", + "path": "projects/{project}/aggregated/networkEndpointGroups", + "flatPath": "projects/{project}/aggregated/networkEndpointGroups", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "NetworkEndpointGroupAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of network endpoint groups and sorts them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "id": "compute.networkEndpointGroups.get", + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "GET", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "networkEndpointGroup" + ], + "response": { + "$ref": "NetworkEndpointGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified network endpoint group." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.networkEndpointGroups.insert", + "path": "projects/{project}/zones/{zone}/networkEndpointGroups", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone where you want to create the network endpoint group. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "RouterAggregatedList": { - "id": "RouterAggregatedList", - "description": "Contains a list of routers.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#routerAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Router resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of routers.", - "$ref": "RoutersScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { + "$ref": "NetworkEndpointGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a network endpoint group in the specified project using the parameters that are included in the request." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "delete": { + "id": "compute.networkEndpointGroups.delete", + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "DELETE", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group to delete. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "networkEndpointGroup" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified network endpoint group. The network endpoints in the NEG and the VM instances they belong to are not terminated when the NEG is deleted. Note that the NEG cannot be deleted if there are backend services referencing it." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "attachNetworkEndpoints": { + "id": "compute.networkEndpointGroups.attachNetworkEndpoints", + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "httpMethod": "POST", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "zone", + "networkEndpointGroup" + ], + "request": { + "$ref": "NetworkEndpointGroupsAttachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Attach a list of network endpoints to the specified network endpoint group." }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "RoutersScopedList": { - "id": "RoutersScopedList", - "type": "object", - "properties": { - "routers": { - "description": "A list of routers contained in this scope.", - "type": "array", - "items": { - "$ref": "Router" - } + "detachNetworkEndpoints": { + "id": "compute.networkEndpointGroups.detachNetworkEndpoints", + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "httpMethod": "POST", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "networkEndpointGroup" + ], + "request": { + "$ref": "NetworkEndpointGroupsDetachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Detach a list of network endpoints from the specified network endpoint group." }, - "warning": { - "description": "Informational warning which replaces the list of routers when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listNetworkEndpoints": { + "id": "compute.networkEndpointGroups.listNetworkEndpoints", + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "httpMethod": "POST", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "networkEndpointGroup": { + "description": "The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "networkEndpointGroup" + ], + "request": { + "$ref": "NetworkEndpointGroupsListEndpointsRequest" + }, + "response": { + "$ref": "NetworkEndpointGroupsListNetworkEndpoints" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the network endpoints in the specified network endpoint group." + }, + "testIamPermissions": { + "id": "compute.networkEndpointGroups.testIamPermissions", + "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{resource}/testIamPermissions", + "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "RouterStatusResponse": { - "id": "RouterStatusResponse", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#routerStatusResponse", - "type": "string" - }, - "result": { - "$ref": "RouterStatus" - } - } - }, - "RouterStatus": { - "id": "RouterStatus", - "type": "object", - "properties": { - "network": { - "description": "URI of the network to which this router belongs.", - "type": "string" - }, - "bestRoutes": { - "description": "A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions.", - "type": "array", - "items": { - "$ref": "Route" - } - }, - "bestRoutesForRouter": { - "description": "A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router.", - "type": "array", - "items": { - "$ref": "Route" - } - }, - "bgpPeerStatus": { - "type": "array", - "items": { - "$ref": "RouterStatusBgpPeerStatus" - } - }, - "natStatus": { - "type": "array", - "items": { - "$ref": "RouterStatusNatStatus" - } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "RouterStatusBgpPeerStatus": { - "id": "RouterStatusBgpPeerStatus", - "type": "object", - "properties": { - "name": { - "description": "Name of this BGP peer. Unique within the Routers resource.", - "type": "string" - }, - "linkedVpnTunnel": { - "description": "URL of the VPN tunnel that this BGP peer controls.", - "type": "string" - }, - "routerApplianceInstance": { - "description": "[Output only] URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance is the peer side of the BGP session.", - "type": "string" - }, - "ipAddress": { - "description": "IP address of the local BGP interface.", - "type": "string" - }, - "peerIpAddress": { - "description": "IP address of the remote BGP interface.", - "type": "string" - }, - "ipv6NexthopAddress": { - "description": "IPv6 address of the local BGP interface.", - "type": "string" - }, - "peerIpv6NexthopAddress": { - "description": "IPv6 address of the remote BGP interface.", - "type": "string" - }, - "enableIpv6": { - "description": "Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6.", - "type": "boolean" - }, - "status": { - "description": "Status of the BGP peer: {UP, DOWN}", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "globalNetworkEndpointGroups": { + "methods": { + "list": { + "id": "compute.globalNetworkEndpointGroups.list", + "path": "projects/{project}/global/networkEndpointGroups", + "flatPath": "projects/{project}/global/networkEndpointGroups", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" ], - "enum": [ - "DOWN", - "UNKNOWN", - "UP" - ] - }, - "state": { - "description": "The state of the BGP session. For a list of possible values for this field, see BGP session states.", - "type": "string" - }, - "uptime": { - "description": "Time this session has been up. Format: 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds", - "type": "string" - }, - "uptimeSeconds": { - "description": "Time this session has been up, in seconds. Format: 145", - "type": "string" - }, - "numLearnedRoutes": { - "description": "Number of routes learned from the remote BGP Peer.", - "type": "integer", - "format": "uint32" - }, - "advertisedRoutes": { - "description": "Routes that were advertised to the remote BGP peer", - "type": "array", - "items": { - "$ref": "Route" - } + "response": { + "$ref": "NetworkEndpointGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of network endpoint groups that are located in the specified project." }, - "bfdStatus": { - "$ref": "BfdStatus" + "get": { + "id": "compute.globalNetworkEndpointGroups.get", + "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", + "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "GET", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "networkEndpointGroup" + ], + "response": { + "$ref": "NetworkEndpointGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified network endpoint group." }, - "md5AuthEnabled": { - "description": "Informs whether MD5 authentication is enabled on this BGP peer.", - "type": "boolean" + "insert": { + "id": "compute.globalNetworkEndpointGroups.insert", + "path": "projects/{project}/global/networkEndpointGroups", + "flatPath": "projects/{project}/global/networkEndpointGroups", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "NetworkEndpointGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a network endpoint group in the specified project using the parameters that are included in the request." }, - "statusReason": { - "description": "Indicates why particular status was returned.", - "type": "string", - "enumDescriptions": [ - "BGP peer disabled because it requires IPv4 but the underlying connection is IPv6-only.", - "BGP peer disabled because it requires IPv6 but the underlying connection is IPv4-only.", - "Indicates internal problems with configuration of MD5 authentication. This particular reason can only be returned when md5AuthEnabled is true and status is DOWN.", - "" + "delete": { + "id": "compute.globalNetworkEndpointGroups.delete", + "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", + "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "DELETE", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group to delete. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "networkEndpointGroup" ], - "enum": [ - "IPV4_PEER_ON_IPV6_ONLY_CONNECTION", - "IPV6_PEER_ON_IPV4_ONLY_CONNECTION", - "MD5_AUTH_INTERNAL_PROBLEM", - "STATUS_REASON_UNSPECIFIED" - ] + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified network endpoint group.Note that the NEG cannot be deleted if there are backend services referencing it." }, - "ipv4NexthopAddress": { - "description": "IPv4 address of the local BGP interface.", - "type": "string" + "attachNetworkEndpoints": { + "id": "compute.globalNetworkEndpointGroups.attachNetworkEndpoints", + "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "httpMethod": "POST", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "networkEndpointGroup" + ], + "request": { + "$ref": "GlobalNetworkEndpointGroupsAttachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Attach a network endpoint to the specified network endpoint group." }, - "peerIpv4NexthopAddress": { - "description": "IPv4 address of the remote BGP interface.", - "type": "string" + "detachNetworkEndpoints": { + "id": "compute.globalNetworkEndpointGroups.detachNetworkEndpoints", + "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "httpMethod": "POST", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "networkEndpointGroup" + ], + "request": { + "$ref": "GlobalNetworkEndpointGroupsDetachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Detach the network endpoint from the specified network endpoint group." }, - "enableIpv4": { - "description": "Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.", - "type": "boolean" + "listNetworkEndpoints": { + "id": "compute.globalNetworkEndpointGroups.listNetworkEndpoints", + "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "httpMethod": "POST", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "networkEndpointGroup": { + "description": "The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "networkEndpointGroup" + ], + "response": { + "$ref": "NetworkEndpointGroupsListNetworkEndpoints" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the network endpoints in the specified network endpoint group." } } }, - "BfdStatus": { - "id": "BfdStatus", - "description": "Next free: 15", - "type": "object", - "properties": { - "uptimeMs": { - "description": "Session uptime in milliseconds. Value will be 0 if session is not up.", - "type": "string", - "format": "int64" - }, - "localState": { - "description": "The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" + "regionNetworkEndpointGroups": { + "methods": { + "list": { + "id": "compute.regionNetworkEndpointGroups.list", + "path": "projects/{project}/regions/{region}/networkEndpointGroups", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ADMIN_DOWN", - "DOWN", - "INIT", - "STATE_UNSPECIFIED", - "UP" - ] - }, - "localDiagnostic": { - "description": "The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "response": { + "$ref": "NetworkEndpointGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ADMINISTRATIVELY_DOWN", - "CONCATENATED_PATH_DOWN", - "CONTROL_DETECTION_TIME_EXPIRED", - "DIAGNOSTIC_UNSPECIFIED", - "ECHO_FUNCTION_FAILED", - "FORWARDING_PLANE_RESET", - "NEIGHBOR_SIGNALED_SESSION_DOWN", - "NO_DIAGNOSTIC", - "PATH_DOWN", - "REVERSE_CONCATENATED_PATH_DOWN" - ] - }, - "controlPacketCounts": { - "description": "Control packet counts for the current BFD session.", - "$ref": "BfdStatusPacketCounts" - }, - "txPacket": { - "description": "The most recent Tx control packet for this BFD session.", - "$ref": "BfdPacket" - }, - "rxPacket": { - "description": "The most recent Rx control packet for this BFD session.", - "$ref": "BfdPacket" - }, - "controlPacketIntervals": { - "description": "Inter-packet time interval statistics for control packets.", - "type": "array", - "items": { - "$ref": "PacketIntervals" - } - }, - "negotiatedLocalControlTxIntervalMs": { - "description": "Negotiated transmit interval for control packets.", - "type": "integer", - "format": "uint32" + "description": "Retrieves the list of regional network endpoint groups available to the specified project in the given region." }, - "bfdSessionInitializationMode": { - "description": "The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "get": { + "id": "compute.regionNetworkEndpointGroups.get", + "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "GET", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "networkEndpointGroup" ], - "enum": [ - "ACTIVE", - "DISABLED", - "PASSIVE" - ] - }, - "configUpdateTimestampMicros": { - "description": "Unix timestamp of the most recent config update.", - "type": "string", - "format": "int64" - } - } - }, - "BfdStatusPacketCounts": { - "id": "BfdStatusPacketCounts", - "type": "object", - "properties": { - "numTx": { - "description": "Number of packets transmitted since the beginning of the current BFD session.", - "type": "integer", - "format": "uint32" - }, - "numRx": { - "description": "Number of packets received since the beginning of the current BFD session.", - "type": "integer", - "format": "uint32" - }, - "numRxSuccessful": { - "description": "Number of packets received that were successfully processed since the beginning of the current BFD session.", - "type": "integer", - "format": "uint32" - }, - "numRxRejected": { - "description": "Number of packets received that were rejected because of errors since the beginning of the current BFD session.", - "type": "integer", - "format": "uint32" - } - } - }, - "BfdPacket": { - "id": "BfdPacket", - "type": "object", - "properties": { - "version": { - "description": "The version number of the BFD protocol, as specified in section 4.1 of RFC5880.", - "type": "integer", - "format": "uint32" - }, - "diagnostic": { - "description": "The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "", - "", - "", - "", - "" + "response": { + "$ref": "NetworkEndpointGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ADMINISTRATIVELY_DOWN", - "CONCATENATED_PATH_DOWN", - "CONTROL_DETECTION_TIME_EXPIRED", - "DIAGNOSTIC_UNSPECIFIED", - "ECHO_FUNCTION_FAILED", - "FORWARDING_PLANE_RESET", - "NEIGHBOR_SIGNALED_SESSION_DOWN", - "NO_DIAGNOSTIC", - "PATH_DOWN", - "REVERSE_CONCATENATED_PATH_DOWN" - ] + "description": "Returns the specified network endpoint group." }, - "state": { - "description": "The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "" + "insert": { + "id": "compute.regionNetworkEndpointGroups.insert", + "path": "projects/{project}/regions/{region}/networkEndpointGroups", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where you want to create the network endpoint group. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ADMIN_DOWN", - "DOWN", - "INIT", - "STATE_UNSPECIFIED", - "UP" - ] - }, - "poll": { - "description": "The Poll bit of the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "boolean" - }, - "final": { - "description": "The Final bit of the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "boolean" - }, - "controlPlaneIndependent": { - "description": "The Control Plane Independent bit of the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "boolean" - }, - "authenticationPresent": { - "description": "The Authentication Present bit of the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "boolean" - }, - "demand": { - "description": "The demand bit of the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "boolean" - }, - "multipoint": { - "description": "The multipoint bit of the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "boolean" - }, - "multiplier": { - "description": "The detection time multiplier of the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "integer", - "format": "uint32" - }, - "length": { - "description": "The length of the BFD Control packet in bytes. This is specified in section 4.1 of RFC5880", - "type": "integer", - "format": "uint32" - }, - "myDiscriminator": { - "description": "The My Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "integer", - "format": "uint32" - }, - "yourDiscriminator": { - "description": "The Your Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "integer", - "format": "uint32" + "request": { + "$ref": "NetworkEndpointGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a network endpoint group in the specified project using the parameters that are included in the request." }, - "minTxIntervalMs": { - "description": "The Desired Min TX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "integer", - "format": "uint32" + "delete": { + "id": "compute.regionNetworkEndpointGroups.delete", + "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", + "httpMethod": "DELETE", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group to delete. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "networkEndpointGroup" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified network endpoint group. Note that the NEG cannot be deleted if it is configured as a backend of a backend service." }, - "minRxIntervalMs": { - "description": "The Required Min RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "integer", - "format": "uint32" + "attachNetworkEndpoints": { + "id": "compute.regionNetworkEndpointGroups.attachNetworkEndpoints", + "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", + "httpMethod": "POST", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where you want to create the network endpoint group. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "networkEndpointGroup" + ], + "request": { + "$ref": "RegionNetworkEndpointGroupsAttachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Attach a list of network endpoints to the specified network endpoint group." }, - "minEchoRxIntervalMs": { - "description": "The Required Min Echo RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880", - "type": "integer", - "format": "uint32" - } - } - }, - "PacketIntervals": { - "id": "PacketIntervals", - "description": "Next free: 7", - "type": "object", - "properties": { - "type": { - "description": "The type of packets for which inter-packet intervals were computed.", - "type": "string", - "enumDescriptions": [ - "Only applies to Echo packets. This shows the intervals between sending and receiving the same packet.", - "Intervals between received packets.", - "Intervals between transmitted packets.", - "" + "detachNetworkEndpoints": { + "id": "compute.regionNetworkEndpointGroups.detachNetworkEndpoints", + "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", + "httpMethod": "POST", + "parameters": { + "networkEndpointGroup": { + "description": "The name of the network endpoint group you are detaching network endpoints from. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "networkEndpointGroup" + ], + "request": { + "$ref": "RegionNetworkEndpointGroupsDetachEndpointsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "LOOPBACK", - "RECEIVE", - "TRANSMIT", - "TYPE_UNSPECIFIED" - ] + "description": "Detach the network endpoint from the specified network endpoint group." }, - "duration": { - "description": "From how long ago in the past these intervals were observed.", - "type": "string", - "enumDescriptions": [ - "", - "", - "From BfdSession object creation time.", - "" + "listNetworkEndpoints": { + "id": "compute.regionNetworkEndpointGroups.listNetworkEndpoints", + "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", + "httpMethod": "POST", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "networkEndpointGroup": { + "description": "The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where the network endpoint group is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region", + "networkEndpointGroup" ], - "enum": [ - "DURATION_UNSPECIFIED", - "HOUR", - "MAX", - "MINUTE" - ] - }, - "numIntervals": { - "description": "Number of inter-packet intervals from which these statistics were derived.", - "type": "string", - "format": "int64" - }, - "minMs": { - "description": "Minimum observed inter-packet interval in milliseconds.", - "type": "string", - "format": "int64" - }, - "maxMs": { - "description": "Maximum observed inter-packet interval in milliseconds.", - "type": "string", - "format": "int64" - }, - "avgMs": { - "description": "Average observed inter-packet interval in milliseconds.", - "type": "string", - "format": "int64" + "response": { + "$ref": "NetworkEndpointGroupsListNetworkEndpoints" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the network endpoints in the specified network endpoint group." } } }, - "RouterStatusNatStatus": { - "id": "RouterStatusNatStatus", - "description": "Status of a NAT contained in this router.", - "type": "object", - "properties": { - "name": { - "description": "Unique name of this NAT.", - "type": "string" - }, - "userAllocatedNatIpResources": { - "description": "A list of fully qualified URLs of reserved IP address resources.", - "type": "array", - "items": { - "type": "string" - } - }, - "drainUserAllocatedNatIps": { - "description": "A list of IPs user-allocated for NAT that are in drain mode. Example: [\"1.1.1.1\", \"179.12.26.133\"].", - "type": "array", - "items": { - "type": "string" - } + "networks": { + "methods": { + "list": { + "id": "compute.networks.list", + "path": "projects/{project}/global/networks", + "flatPath": "projects/{project}/global/networks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "NetworkList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of networks available to the specified project." }, - "userAllocatedNatIps": { - "description": "A list of IPs user-allocated for NAT. They will be raw IP strings like \"179.12.26.133\".", - "type": "array", - "items": { - "type": "string" - } + "get": { + "id": "compute.networks.get", + "path": "projects/{project}/global/networks/{network}", + "flatPath": "projects/{project}/global/networks/{network}", + "httpMethod": "GET", + "parameters": { + "network": { + "description": "Name of the network to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "network" + ], + "response": { + "$ref": "Network" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified network." }, - "autoAllocatedNatIps": { - "description": "A list of IPs auto-allocated for NAT. Example: [\"1.1.1.1\", \"129.2.16.89\"]", - "type": "array", - "items": { - "type": "string" - } + "insert": { + "id": "compute.networks.insert", + "path": "projects/{project}/global/networks", + "flatPath": "projects/{project}/global/networks", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "Network" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a network in the specified project using the data included in the request." }, - "drainAutoAllocatedNatIps": { - "description": "A list of IPs auto-allocated for NAT that are in drain mode. Example: [\"1.1.1.1\", \"179.12.26.133\"].", - "type": "array", - "items": { - "type": "string" - } + "delete": { + "id": "compute.networks.delete", + "path": "projects/{project}/global/networks/{network}", + "flatPath": "projects/{project}/global/networks/{network}", + "httpMethod": "DELETE", + "parameters": { + "network": { + "description": "Name of the network to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "network" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified network." }, - "minExtraNatIpsNeeded": { - "description": "The number of extra IPs to allocate. This will be greater than 0 only if user-specified IPs are NOT enough to allow all configured VMs to use NAT. This value is meaningful only when auto-allocation of NAT IPs is *not* used.", - "type": "integer", - "format": "int32" + "patch": { + "id": "compute.networks.patch", + "path": "projects/{project}/global/networks/{network}", + "flatPath": "projects/{project}/global/networks/{network}", + "httpMethod": "PATCH", + "parameters": { + "network": { + "description": "Name of the network to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "network" + ], + "request": { + "$ref": "Network" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified network with the data included in the request. Only routingConfig can be modified." }, - "numVmEndpointsWithNatMappings": { - "description": "Number of VM endpoints (i.e., Nics) that can use NAT.", - "type": "integer", - "format": "int32" + "updatePeering": { + "id": "compute.networks.updatePeering", + "path": "projects/{project}/global/networks/{network}/updatePeering", + "flatPath": "projects/{project}/global/networks/{network}/updatePeering", + "httpMethod": "PATCH", + "parameters": { + "network": { + "description": "Name of the network resource which the updated peering is belonging to.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "network" + ], + "request": { + "$ref": "NetworksUpdatePeeringRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified network peering with the data included in the request. You can only modify the NetworkPeering.export_custom_routes field and the NetworkPeering.import_custom_routes field." }, - "ruleStatus": { - "description": "Status of rules in this NAT.", - "type": "array", - "items": { - "$ref": "RouterStatusNatStatusNatRuleStatus" - } - } - } - }, - "RouterStatusNatStatusNatRuleStatus": { - "id": "RouterStatusNatStatusNatRuleStatus", - "description": "Status of a NAT Rule contained in this NAT.", - "type": "object", - "properties": { - "ruleNumber": { - "description": "Rule number of the rule.", - "type": "integer", - "format": "int32" + "addPeering": { + "id": "compute.networks.addPeering", + "path": "projects/{project}/global/networks/{network}/addPeering", + "flatPath": "projects/{project}/global/networks/{network}/addPeering", + "httpMethod": "POST", + "parameters": { + "network": { + "description": "Name of the network resource to add peering to.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "network" + ], + "request": { + "$ref": "NetworksAddPeeringRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Adds a peering to the specified network." }, - "activeNatIps": { - "description": "A list of active IPs for NAT. Example: [\"1.1.1.1\", \"179.12.26.133\"].", - "type": "array", - "items": { - "type": "string" - } + "removePeering": { + "id": "compute.networks.removePeering", + "path": "projects/{project}/global/networks/{network}/removePeering", + "flatPath": "projects/{project}/global/networks/{network}/removePeering", + "httpMethod": "POST", + "parameters": { + "network": { + "description": "Name of the network resource to remove peering from.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "network" + ], + "request": { + "$ref": "NetworksRemovePeeringRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Removes a peering from the specified network." }, - "drainNatIps": { - "description": "A list of IPs for NAT that are in drain mode. Example: [\"1.1.1.1\", \"179.12.26.133\"].", - "type": "array", - "items": { - "type": "string" - } + "switchToCustomMode": { + "id": "compute.networks.switchToCustomMode", + "path": "projects/{project}/global/networks/{network}/switchToCustomMode", + "flatPath": "projects/{project}/global/networks/{network}/switchToCustomMode", + "httpMethod": "POST", + "parameters": { + "network": { + "description": "Name of the network to be updated.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "network" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Switches the network mode from auto subnet mode to custom subnet mode." }, - "minExtraIpsNeeded": { - "description": "The number of extra IPs to allocate. This will be greater than 0 only if the existing IPs in this NAT Rule are NOT enough to allow all configured VMs to use NAT.", - "type": "integer", - "format": "int32" + "getEffectiveFirewalls": { + "id": "compute.networks.getEffectiveFirewalls", + "path": "projects/{project}/global/networks/{network}/getEffectiveFirewalls", + "flatPath": "projects/{project}/global/networks/{network}/getEffectiveFirewalls", + "httpMethod": "GET", + "parameters": { + "network": { + "description": "Name of the network for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "network" + ], + "response": { + "$ref": "NetworksGetEffectiveFirewallsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the effective firewalls on a given network." }, - "numVmEndpointsWithNatMappings": { - "description": "Number of VM endpoints (i.e., NICs) that have NAT Mappings from this NAT Rule.", - "type": "integer", - "format": "int32" + "listPeeringRoutes": { + "id": "compute.networks.listPeeringRoutes", + "path": "projects/{project}/global/networks/{network}/listPeeringRoutes", + "flatPath": "projects/{project}/global/networks/{network}/listPeeringRoutes", + "httpMethod": "GET", + "parameters": { + "direction": { + "description": "The direction of the exchanged routes.", + "location": "query", + "type": "string", + "enumDescriptions": [ + "For routes exported from peer network.", + "For routes exported from local network." + ], + "enum": [ + "INCOMING", + "OUTGOING" + ] + }, + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "network": { + "description": "Name of the network for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "peeringName": { + "description": "The response will show routes exchanged over the given peering connection.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The region of the request. The response will include all subnet routes, static routes and dynamic routes in the region.", + "location": "query", + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "network" + ], + "response": { + "$ref": "ExchangedPeeringRoutesList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the peering routes exchanged over peering connection." } } }, - "VmEndpointNatMappingsList": { - "id": "VmEndpointNatMappingsList", - "description": "Contains a list of VmEndpointNatMappings.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#vmEndpointNatMappingsList for lists of Nat mappings of VM endpoints.", - "default": "compute#vmEndpointNatMappingsList", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string" - }, - "result": { - "description": "[Output Only] A list of Nat mapping information of VM endpoints.", - "type": "array", - "items": { - "$ref": "VmEndpointNatMappings" - } + "nodeGroups": { + "methods": { + "list": { + "id": "compute.nodeGroups.list", + "path": "projects/{project}/zones/{zone}/nodeGroups", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "NodeGroupList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of node groups available to the specified project. Note: use nodeGroups.listNodes for more details about each group." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "aggregatedList": { + "id": "compute.nodeGroups.aggregatedList", + "path": "projects/{project}/aggregated/nodeGroups", + "flatPath": "projects/{project}/aggregated/nodeGroups", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "NodeGroupAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "id": "compute.nodeGroups.get", + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", + "httpMethod": "GET", + "parameters": { + "nodeGroup": { + "description": "Name of the node group to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "response": { + "$ref": "NodeGroup" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified NodeGroup. Get a list of available NodeGroups by making a list() request. Note: the \"nodes\" field should not be used. Use nodeGroups.listNodes instead." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.nodeGroups.insert", + "path": "projects/{project}/zones/{zone}/nodeGroups", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups", + "httpMethod": "POST", + "parameters": { + "initialNodeCount": { + "description": "Initial count of nodes in the node group.", + "location": "query", + "required": true, + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "initialNodeCount" + ], + "request": { + "$ref": "NodeGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a NodeGroup resource in the specified project using the data included in the request." + }, + "delete": { + "id": "compute.nodeGroups.delete", + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", + "httpMethod": "DELETE", + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "VmEndpointNatMappings": { - "id": "VmEndpointNatMappings", - "description": "Contain information of Nat mapping for a VM endpoint (i.e., NIC).", - "type": "object", - "properties": { - "instanceName": { - "description": "Name of the VM instance which the endpoint belongs to", - "type": "string" - }, - "interfaceNatMappings": { - "type": "array", - "items": { - "$ref": "VmEndpointNatMappingsInterfaceNatMappings" - } - } - } - }, - "VmEndpointNatMappingsInterfaceNatMappings": { - "id": "VmEndpointNatMappingsInterfaceNatMappings", - "description": "Contain information of Nat mapping for an interface of this endpoint.", - "type": "object", - "properties": { - "sourceVirtualIp": { - "description": "Primary IP of the VM for this NIC.", - "type": "string" - }, - "sourceAliasIpRange": { - "description": "Alias IP range for this interface endpoint. It will be a private (RFC 1918) IP range. Examples: \"10.33.4.55/32\", or \"192.168.5.0/24\".", - "type": "string" - }, - "numTotalNatPorts": { - "description": "Total number of ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field nat_ip_port_ranges.", - "type": "integer", - "format": "int32" - }, - "natIpPortRanges": { - "description": "A list of all IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: [\"2.2.2.2:12345-12355\", \"1.1.1.1:2234-2234\"].", - "type": "array", - "items": { - "type": "string" - } + }, + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified NodeGroup resource." }, - "drainNatIpPortRanges": { - "description": "List of all drain IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: [\"2.2.2.2:12345-12355\", \"1.1.1.1:2234-2234\"].", - "type": "array", - "items": { - "type": "string" - } + "addNodes": { + "id": "compute.nodeGroups.addNodes", + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/addNodes", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/addNodes", + "httpMethod": "POST", + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "request": { + "$ref": "NodeGroupsAddNodesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Adds specified number of nodes to the node group." }, - "numTotalDrainNatPorts": { - "description": "Total number of drain ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field drain_nat_ip_port_ranges.", - "type": "integer", - "format": "int32" + "deleteNodes": { + "id": "compute.nodeGroups.deleteNodes", + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/deleteNodes", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/deleteNodes", + "httpMethod": "POST", + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource whose nodes will be deleted.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "request": { + "$ref": "NodeGroupsDeleteNodesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes specified nodes from the node group." }, - "ruleMappings": { - "description": "Information about mappings provided by rules in this NAT.", - "type": "array", - "items": { - "$ref": "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings" - } - } - } - }, - "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings": { - "id": "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings", - "description": "Contains information of NAT Mappings provided by a NAT Rule.", - "type": "object", - "properties": { - "ruleNumber": { - "description": "Rule number of the NAT Rule.", - "type": "integer", - "format": "int32" + "listNodes": { + "id": "compute.nodeGroups.listNodes", + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/listNodes", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/listNodes", + "httpMethod": "POST", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "nodeGroup": { + "description": "Name of the NodeGroup resource whose nodes you want to list.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "response": { + "$ref": "NodeGroupsListNodes" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists nodes in the node group." }, - "numTotalNatPorts": { - "description": "Total number of ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field nat_ip_port_ranges.", - "type": "integer", - "format": "int32" + "setNodeTemplate": { + "id": "compute.nodeGroups.setNodeTemplate", + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/setNodeTemplate", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/setNodeTemplate", + "httpMethod": "POST", + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "request": { + "$ref": "NodeGroupsSetNodeTemplateRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the node template of the node group." }, - "natIpPortRanges": { - "description": "A list of all IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: [\"2.2.2.2:12345-12355\", \"1.1.1.1:2234-2234\"].", - "type": "array", - "items": { - "type": "string" - } + "patch": { + "id": "compute.nodeGroups.patch", + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", + "httpMethod": "PATCH", + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "request": { + "$ref": "NodeGroup" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified node group." }, - "drainNatIpPortRanges": { - "description": "List of all drain IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: [\"2.2.2.2:12345-12355\", \"1.1.1.1:2234-2234\"].", - "type": "array", - "items": { - "type": "string" - } + "simulateMaintenanceEvent": { + "id": "compute.nodeGroups.simulateMaintenanceEvent", + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/simulateMaintenanceEvent", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/simulateMaintenanceEvent", + "httpMethod": "POST", + "parameters": { + "nodeGroup": { + "description": "Name of the NodeGroup resource whose nodes will go under maintenance simulation.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "request": { + "$ref": "NodeGroupsSimulateMaintenanceEventRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Simulates maintenance event on specified nodes from the node group." }, - "numTotalDrainNatPorts": { - "description": "Total number of drain ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field drain_nat_ip_port_ranges.", - "type": "integer", - "format": "int32" - } - } - }, - "NatIpInfoResponse": { - "id": "NatIpInfoResponse", - "type": "object", - "properties": { - "result": { - "description": "[Output Only] A list of NAT IP information.", - "type": "array", - "items": { - "$ref": "NatIpInfo" - } - } - } - }, - "NatIpInfo": { - "id": "NatIpInfo", - "description": "Contains NAT IP information of a NAT config (i.e. usage status, mode).", - "type": "object", - "properties": { - "natName": { - "description": "Name of the NAT config which the NAT IP belongs to.", - "type": "string" + "performMaintenance": { + "id": "compute.nodeGroups.performMaintenance", + "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/performMaintenance", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/performMaintenance", + "httpMethod": "POST", + "parameters": { + "nodeGroup": { + "description": "Name of the node group scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "nodeGroup" + ], + "request": { + "$ref": "NodeGroupsPerformMaintenanceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Perform maintenance on a subset of nodes in the node group." }, - "natIpInfoMappings": { - "description": "A list of all NAT IPs assigned to this NAT config.", - "type": "array", - "items": { - "$ref": "NatIpInfoNatIpInfoMapping" - } - } - } - }, - "NatIpInfoNatIpInfoMapping": { - "id": "NatIpInfoNatIpInfoMapping", - "description": "Contains information of a NAT IP.", - "type": "object", - "properties": { - "natIp": { - "description": "NAT IP address. For example: 203.0.113.11.", - "type": "string" + "getIamPolicy": { + "id": "compute.nodeGroups.getIamPolicy", + "path": "projects/{project}/zones/{zone}/nodeGroups/{resource}/getIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "usage": { - "description": "Specifies whether NAT IP is currently serving at least one endpoint or not.", - "type": "string", - "enumDescriptions": [ - "", - "" + "setIamPolicy": { + "id": "compute.nodeGroups.setIamPolicy", + "path": "projects/{project}/zones/{zone}/nodeGroups/{resource}/setIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "IN_USE", - "UNUSED" - ] + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "mode": { - "description": "Specifies whether NAT IP is auto or manual.", - "type": "string", - "enumDescriptions": [ - "", - "" + "testIamPermissions": { + "id": "compute.nodeGroups.testIamPermissions", + "path": "projects/{project}/zones/{zone}/nodeGroups/{resource}/testIamPermissions", + "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" ], - "enum": [ - "AUTO", - "MANUAL" - ] - } - } - }, - "RoutersPreviewResponse": { - "id": "RoutersPreviewResponse", - "type": "object", - "properties": { - "resource": { - "description": "Preview of given router.", - "$ref": "Router" + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "ServiceAttachmentAggregatedList": { - "id": "ServiceAttachmentAggregatedList", - "description": "Contains a list of ServiceAttachmentsScopedList.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#serviceAttachmentAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of ServiceAttachmentsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of ServiceAttachments.", - "$ref": "ServiceAttachmentsScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "nodeTemplates": { + "methods": { + "list": { + "id": "compute.nodeTemplates.list", + "path": "projects/{project}/regions/{region}/nodeTemplates", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "NodeTemplateList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of node templates available to the specified project." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "aggregatedList": { + "id": "compute.nodeTemplates.aggregatedList", + "path": "projects/{project}/aggregated/nodeTemplates", + "flatPath": "projects/{project}/aggregated/nodeTemplates", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "NodeTemplateAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of node templates. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + }, + "get": { + "id": "compute.nodeTemplates.get", + "path": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", + "httpMethod": "GET", + "parameters": { + "nodeTemplate": { + "description": "Name of the node template to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "nodeTemplate" + ], + "response": { + "$ref": "NodeTemplate" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified node template." + }, + "insert": { + "id": "compute.nodeTemplates.insert", + "path": "projects/{project}/regions/{region}/nodeTemplates", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ServiceAttachmentsScopedList": { - "id": "ServiceAttachmentsScopedList", - "type": "object", - "properties": { - "serviceAttachments": { - "description": "A list of ServiceAttachments contained in this scope.", - "type": "array", - "items": { - "$ref": "ServiceAttachment" - } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "NodeTemplate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a NodeTemplate resource in the specified project using the data included in the request." }, - "warning": { - "description": "Informational warning which replaces the list of service attachments when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "id": "compute.nodeTemplates.delete", + "path": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", + "httpMethod": "DELETE", + "parameters": { + "nodeTemplate": { + "description": "Name of the NodeTemplate resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "ServiceAttachment": { - "id": "ServiceAttachment", - "description": "Represents a ServiceAttachment resource. A service attachment represents a service that a producer has exposed. It encapsulates the load balancer which fronts the service runs and a list of NAT IP ranges that the producers uses to represent the consumers connecting to the service.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#serviceAttachment for service attachments.", - "default": "compute#serviceAttachment", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.serviceAttachments.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the service attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "producerForwardingRule": { - "description": "The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment.", - "deprecated": true, - "type": "string" - }, - "targetService": { - "description": "The URL of a service serving the endpoint identified by this service attachment.", - "type": "string" - }, - "connectionPreference": { - "description": "The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "parameterOrder": [ + "project", + "region", + "nodeTemplate" ], - "enum": [ - "ACCEPT_AUTOMATIC", - "ACCEPT_MANUAL", - "CONNECTION_PREFERENCE_UNSPECIFIED" - ] - }, - "connectedEndpoints": { - "description": "[Output Only] An array of connections for all the consumers connected to this service attachment.", - "type": "array", - "items": { - "$ref": "ServiceAttachmentConnectedEndpoint" - } - }, - "natSubnets": { - "description": "An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment.", - "type": "array", - "items": { - "type": "string" - } - }, - "enableProxyProtocol": { - "description": "If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers.", - "type": "boolean" - }, - "consumerRejectLists": { - "description": "Specifies a list of projects or networks that are not allowed to connect to this service attachment. The project can be specified using its project ID or project number and the network can be specified using its URL. A given service attachment can manage connections at either the project or network level. Therefore, both the reject and accept lists for a given service attachment must contain either only projects or only networks.", - "type": "array", - "items": { - "type": "string" - } - }, - "consumerAcceptLists": { - "description": "Specifies which consumer projects or networks are allowed to connect to the service attachment. Each project or network has a connection limit. A given service attachment can manage connections at either the project or network level. Therefore, both the accept and reject lists for a given service attachment must contain either only projects or only networks.", - "type": "array", - "items": { - "$ref": "ServiceAttachmentConsumerProjectLimit" - } - }, - "pscServiceAttachmentId": { - "description": "[Output Only] An 128-bit global unique ID of the PSC service attachment.", - "$ref": "Uint128" - }, - "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 ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment.", - "type": "string", - "format": "byte" - }, - "domainNames": { - "description": "If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: \"p.mycompany.com.\". Current max number of domain names supported is 1.", - "type": "array", - "items": { - "type": "string" - } - }, - "reconcileConnections": { - "description": "This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. - If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . - If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list. For newly created service attachment, this boolean defaults to false.", - "type": "boolean" - } - } - }, - "ServiceAttachmentConnectedEndpoint": { - "id": "ServiceAttachmentConnectedEndpoint", - "description": "[Output Only] A connection connected to this service attachment.", - "type": "object", - "properties": { - "status": { - "description": "The status of a connected endpoint to this service attachment.", - "type": "string", - "enumDescriptions": [ - "The connection has been accepted by the producer.", - "The connection has been closed by the producer.", - "The connection has been accepted by the producer, but the producer needs to take further action before the forwarding rule can serve traffic.", - "The connection is pending acceptance by the producer.", - "The consumer is still connected but not using the connection.", - "" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "ACCEPTED", - "CLOSED", - "NEEDS_ATTENTION", - "PENDING", - "REJECTED", - "STATUS_UNSPECIFIED" - ] + "description": "Deletes the specified NodeTemplate resource." }, - "pscConnectionId": { - "description": "The PSC connection id of the connected endpoint.", - "type": "string", - "format": "uint64" + "getIamPolicy": { + "id": "compute.nodeTemplates.getIamPolicy", + "path": "projects/{project}/regions/{region}/nodeTemplates/{resource}/getIamPolicy", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "endpoint": { - "description": "The url of a connected endpoint.", - "type": "string" + "setIamPolicy": { + "id": "compute.nodeTemplates.setIamPolicy", + "path": "projects/{project}/regions/{region}/nodeTemplates/{resource}/setIamPolicy", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "consumerNetwork": { - "description": "The url of the consumer network.", - "type": "string" + "testIamPermissions": { + "id": "compute.nodeTemplates.testIamPermissions", + "path": "projects/{project}/regions/{region}/nodeTemplates/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "ServiceAttachmentConsumerProjectLimit": { - "id": "ServiceAttachmentConsumerProjectLimit", - "type": "object", - "properties": { - "projectIdOrNum": { - "description": "The project id or number for the project to set the limit for.", - "type": "string" - }, - "networkUrl": { - "description": "The network URL for the network to set the limit for.", - "type": "string" + "nodeTypes": { + "methods": { + "list": { + "id": "compute.nodeTypes.list", + "path": "projects/{project}/zones/{zone}/nodeTypes", + "flatPath": "projects/{project}/zones/{zone}/nodeTypes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "NodeTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of node types available to the specified project." }, - "connectionLimit": { - "description": "The value of the limit to set.", - "type": "integer", - "format": "uint32" - } - } - }, - "Uint128": { - "id": "Uint128", - "type": "object", - "properties": { - "high": { - "type": "string", - "format": "uint64" + "aggregatedList": { + "id": "compute.nodeTypes.aggregatedList", + "path": "projects/{project}/aggregated/nodeTypes", + "flatPath": "projects/{project}/aggregated/nodeTypes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "NodeTypeAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of node types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "low": { - "type": "string", - "format": "uint64" + "get": { + "id": "compute.nodeTypes.get", + "path": "projects/{project}/zones/{zone}/nodeTypes/{nodeType}", + "flatPath": "projects/{project}/zones/{zone}/nodeTypes/{nodeType}", + "httpMethod": "GET", + "parameters": { + "nodeType": { + "description": "Name of the node type to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "nodeType" + ], + "response": { + "$ref": "NodeType" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified node type." } } }, - "ServiceAttachmentList": { - "id": "ServiceAttachmentList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#serviceAttachment for service attachments.", - "default": "compute#serviceAttachmentList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of ServiceAttachment resources.", - "type": "array", - "items": { - "$ref": "ServiceAttachment" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "regionNotificationEndpoints": { + "methods": { + "list": { + "id": "compute.regionNotificationEndpoints.list", + "path": "projects/{project}/regions/{region}/notificationEndpoints", + "flatPath": "projects/{project}/regions/{region}/notificationEndpoints", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "NotificationEndpointList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the NotificationEndpoints for a project in the given region." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "id": "compute.regionNotificationEndpoints.get", + "path": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", + "flatPath": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", + "httpMethod": "GET", + "parameters": { + "notificationEndpoint": { + "description": "Name of the NotificationEndpoint resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "notificationEndpoint" + ], + "response": { + "$ref": "NotificationEndpoint" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified NotificationEndpoint resource in the given region." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.regionNotificationEndpoints.insert", + "path": "projects/{project}/regions/{region}/notificationEndpoints", + "flatPath": "projects/{project}/regions/{region}/notificationEndpoints", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "SnapshotSettings": { - "id": "SnapshotSettings", - "type": "object", - "properties": { - "storageLocation": { - "description": "Policy of which storage location is going to be resolved, and additional data that particularizes how the policy is going to be carried out.", - "$ref": "SnapshotSettingsStorageLocationSettings" - } - } - }, - "SnapshotSettingsStorageLocationSettings": { - "id": "SnapshotSettingsStorageLocationSettings", - "type": "object", - "properties": { - "policy": { - "description": "The chosen location policy.", - "type": "string", - "enumDescriptions": [ - "Store snapshot in the same region as with the originating disk. No additional parameters are needed.", - "Store snapshot in the nearest multi region Cloud Storage bucket, relative to the originating disk. No additional parameters are needed.", - "Store snapshot in the specific locations, as specified by the user. The list of regions to store must be defined under the `locations` field.", - "" + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "NotificationEndpoint" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "LOCAL_REGION", - "NEAREST_MULTI_REGION", - "SPECIFIC_LOCATIONS", - "STORAGE_LOCATION_POLICY_UNSPECIFIED" - ] + "description": "Create a NotificationEndpoint in the specified project in the given region using the parameters that are included in the request." }, - "locations": { - "description": "When the policy is SPECIFIC_LOCATIONS, snapshots will be stored in the locations listed in this field. Keys are Cloud Storage bucket locations. Only one location can be specified.", - "type": "object", - "additionalProperties": { - "$ref": "SnapshotSettingsStorageLocationSettingsStorageLocationPreference" - } - } - } - }, - "SnapshotSettingsStorageLocationSettingsStorageLocationPreference": { - "id": "SnapshotSettingsStorageLocationSettingsStorageLocationPreference", - "description": "A structure for specifying storage locations.", - "type": "object", - "properties": { - "name": { - "description": "Name of the location. It should be one of the Cloud Storage buckets. Only one location can be specified.", - "type": "string" + "delete": { + "id": "compute.regionNotificationEndpoints.delete", + "path": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", + "flatPath": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", + "httpMethod": "DELETE", + "parameters": { + "notificationEndpoint": { + "description": "Name of the NotificationEndpoint resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "notificationEndpoint" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified NotificationEndpoint in the given region" } } }, - "SslCertificateList": { - "id": "SslCertificateList", - "description": "Contains a list of SslCertificate resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#sslCertificateList", - "type": "string" + "packetMirrorings": { + "methods": { + "get": { + "id": "compute.packetMirrorings.get", + "path": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", + "httpMethod": "GET", + "parameters": { + "packetMirroring": { + "description": "Name of the PacketMirroring resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "packetMirroring" + ], + "response": { + "$ref": "PacketMirroring" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified PacketMirroring resource." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "insert": { + "id": "compute.packetMirrorings.insert", + "path": "projects/{project}/regions/{region}/packetMirrorings", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "PacketMirroring" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a PacketMirroring resource in the specified project and region using the data included in the request." }, - "items": { - "description": "A list of SslCertificate resources.", - "type": "array", - "items": { - "$ref": "SslCertificate" - } + "patch": { + "id": "compute.packetMirrorings.patch", + "path": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", + "httpMethod": "PATCH", + "parameters": { + "packetMirroring": { + "description": "Name of the PacketMirroring resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "packetMirroring" + ], + "request": { + "$ref": "PacketMirroring" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified PacketMirroring resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "delete": { + "id": "compute.packetMirrorings.delete", + "path": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", + "httpMethod": "DELETE", + "parameters": { + "packetMirroring": { + "description": "Name of the PacketMirroring resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "packetMirroring" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified PacketMirroring resource." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "list": { + "id": "compute.packetMirrorings.list", + "path": "projects/{project}/regions/{region}/packetMirrorings", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "PacketMirroringList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of PacketMirroring resources available to the specified project and region." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "aggregatedList": { + "id": "compute.packetMirrorings.aggregatedList", + "path": "projects/{project}/aggregated/packetMirrorings", + "flatPath": "projects/{project}/aggregated/packetMirrorings", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "PacketMirroringAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of packetMirrorings. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + }, + "testIamPermissions": { + "id": "compute.packetMirrorings.testIamPermissions", + "path": "projects/{project}/regions/{region}/packetMirrorings/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "SslCertificate": { - "id": "SslCertificate", - "description": "Represents an SSL certificate resource. Google Compute Engine has two SSL certificate resources: * [Global](/compute/docs/reference/rest/v1/sslCertificates) * [Regional](/compute/docs/reference/rest/v1/regionSslCertificates) The global SSL certificates (sslCertificates) are used by: - Global external Application Load Balancers - Classic Application Load Balancers - Proxy Network Load Balancers (with target SSL proxies) The regional SSL certificates (regionSslCertificates) are used by: - Regional external Application Load Balancers - Regional internal Application Load Balancers Optionally, certificate file contents that you upload can contain a set of up to five PEM-encoded certificates. The API call creates an object (sslCertificate) that holds this data. You can use SSL keys and certificates to secure connections to a load balancer. For more information, read Creating and using SSL certificates, SSL certificates quotas and limits, and Troubleshooting SSL certificates.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates.", - "default": "compute#sslCertificate", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output only] Server-defined URL for the resource.", - "type": "string" - }, - "certificate": { - "description": "A value read into memory from a certificate file. The certificate file must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.", - "type": "string" - }, - "privateKey": { - "description": "A value read into memory from a write-only private key file. The private key file must be in PEM format. For security, only insert requests include this field.", - "type": "string" - }, - "managed": { - "description": "Configuration and status of a managed SSL certificate.", - "$ref": "SslCertificateManagedSslCertificate" - }, - "selfManaged": { - "description": "Configuration and status of a self-managed SSL certificate.", - "$ref": "SslCertificateSelfManagedSslCertificate" - }, - "type": { - "description": "(Optional) Specifies the type of SSL certificate, either \"SELF_MANAGED\" or \"MANAGED\". If not specified, the certificate is self-managed and the fields certificate and private_key are used.", - "type": "string", - "enumDescriptions": [ - "Google-managed SSLCertificate.", - "Certificate uploaded by user.", - "" + }, + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "MANAGED", - "SELF_MANAGED", - "TYPE_UNSPECIFIED" - ] - }, - "subjectAlternativeNames": { - "description": "[Output Only] Domains associated with the certificate via Subject Alternative Name.", - "type": "array", - "items": { - "type": "string" - } - }, - "expireTime": { - "description": "[Output Only] Expire time of the certificate. RFC3339", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the regional SSL Certificate resides. This field is not applicable to global SSL Certificate.", - "type": "string" - } - } - }, - "SslCertificateManagedSslCertificate": { - "id": "SslCertificateManagedSslCertificate", - "description": "Configuration and status of a managed SSL certificate.", - "type": "object", - "properties": { - "domains": { - "description": "The domains for which a managed SSL certificate will be generated. Each Google-managed SSL certificate supports up to the [maximum number of domains per Google-managed SSL certificate](/load-balancing/docs/quotas#ssl_certificates).", - "type": "array", - "items": { - "type": "string" - } - }, - "status": { - "description": "[Output only] Status of the managed certificate resource.", - "type": "string", - "enumDescriptions": [ - "The certificate management is working, and a certificate has been provisioned.", - "", - "The certificate management is working. GCP will attempt to provision the first certificate.", - "Certificate provisioning failed due to an issue with the DNS or load balancing configuration. For details of which domain failed, consult domain_status field.", - "Certificate provisioning failed due to an issue with the DNS or load balancing configuration. It won't be retried. To try again delete and create a new managed SslCertificate resource. For details of which domain failed, consult domain_status field.", - "Renewal of the certificate has failed due to an issue with the DNS or load balancing configuration. The existing cert is still serving; however, it will expire shortly. To provision a renewed certificate, delete and create a new managed SslCertificate resource. For details on which domain failed, consult domain_status field." + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ACTIVE", - "MANAGED_CERTIFICATE_STATUS_UNSPECIFIED", - "PROVISIONING", - "PROVISIONING_FAILED", - "PROVISIONING_FAILED_PERMANENTLY", - "RENEWAL_FAILED" - ] - }, - "domainStatus": { - "description": "[Output only] Detailed statuses of the domains specified for managed certificate resource.", - "type": "object", - "additionalProperties": { - "type": "string", - "enumDescriptions": [ - "A managed certificate can be provisioned, no issues for this domain.", - "", - "Failed to check CAA records for the domain.", - "Certificate issuance forbidden by an explicit CAA record for the domain.", - "There seems to be problem with the user's DNS or load balancer configuration for this domain.", - "Reached rate-limit for certificates per top-level private domain.", - "Certificate provisioning for this domain is under way. GCP will attempt to provision the first certificate." - ], - "enum": [ - "ACTIVE", - "DOMAIN_STATUS_UNSPECIFIED", - "FAILED_CAA_CHECKING", - "FAILED_CAA_FORBIDDEN", - "FAILED_NOT_VISIBLE", - "FAILED_RATE_LIMITED", - "PROVISIONING" - ] - } - } - } - }, - "SslCertificateSelfManagedSslCertificate": { - "id": "SslCertificateSelfManagedSslCertificate", - "description": "Configuration and status of a self-managed SSL certificate.", - "type": "object", - "properties": { - "certificate": { - "description": "A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.", - "type": "string" - }, - "privateKey": { - "description": "A write-only private key in PEM format. Only insert requests will include this field.", - "type": "string" + "description": "Returns permissions that a caller has on the specified resource." } } }, - "SslCertificateAggregatedList": { - "id": "SslCertificateAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#sslCertificateAggregatedList for lists of SSL Certificates.", - "default": "compute#sslCertificateAggregatedList", - "type": "string" + "projects": { + "methods": { + "get": { + "id": "compute.projects.get", + "path": "projects/{project}", + "flatPath": "projects/{project}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "Project" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified Project resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "setCommonInstanceMetadata": { + "id": "compute.projects.setCommonInstanceMetadata", + "path": "projects/{project}/setCommonInstanceMetadata", + "flatPath": "projects/{project}/setCommonInstanceMetadata", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "Metadata" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets metadata common to all instances within the specified project using the data included in the request." }, - "items": { - "description": "A list of SslCertificatesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of SslCertificates.", - "$ref": "SslCertificatesScopedList" - } + "setUsageExportBucket": { + "id": "compute.projects.setUsageExportBucket", + "path": "projects/{project}/setUsageExportBucket", + "flatPath": "projects/{project}/setUsageExportBucket", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "UsageExportLocation" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/devstorage.full_control", + "https://www.googleapis.com/auth/devstorage.read_only", + "https://www.googleapis.com/auth/devstorage.read_write" + ], + "description": "Enables the usage export feature and sets the usage export bucket where reports are stored. If you provide an empty request body using this method, the usage export feature will be disabled." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "moveInstance": { + "id": "compute.projects.moveInstance", + "path": "projects/{project}/moveInstance", + "flatPath": "projects/{project}/moveInstance", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "InstanceMoveRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "deprecated": true, + "description": "Moves an instance and its attached persistent disks from one zone to another. *Note*: Moving VMs or disks by using this method might cause unexpected behavior. For more information, see the [known issue](/compute/docs/troubleshooting/known-issues#moving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior). [Deprecated] This method is deprecated. See [moving instance across zones](/compute/docs/instances/moving-instance-across-zones) instead." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "moveDisk": { + "id": "compute.projects.moveDisk", + "path": "projects/{project}/moveDisk", + "flatPath": "projects/{project}/moveDisk", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "DiskMoveRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Moves a persistent disk from one zone to another." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listXpnHosts": { + "id": "compute.projects.listXpnHosts", + "path": "projects/{project}/listXpnHosts", + "flatPath": "projects/{project}/listXpnHosts", + "httpMethod": "POST", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "SslCertificatesScopedList": { - "id": "SslCertificatesScopedList", - "type": "object", - "properties": { - "sslCertificates": { - "description": "List of SslCertificates contained in this scope.", - "type": "array", - "items": { - "$ref": "SslCertificate" - } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "ProjectsListXpnHostsRequest" + }, + "response": { + "$ref": "XpnHostList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Lists all shared VPC host projects visible to the user in an organization." }, - "warning": { - "description": "Informational warning which replaces the list of backend services when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "enableXpnHost": { + "id": "compute.projects.enableXpnHost", + "path": "projects/{project}/enableXpnHost", + "flatPath": "projects/{project}/enableXpnHost", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "SslPoliciesList": { - "id": "SslPoliciesList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#sslPoliciesList for lists of sslPolicies.", - "default": "compute#sslPoliciesList", - "type": "string" + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Enable this project as a shared VPC host project." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "disableXpnHost": { + "id": "compute.projects.disableXpnHost", + "path": "projects/{project}/disableXpnHost", + "flatPath": "projects/{project}/disableXpnHost", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Disable this project as a shared VPC host project." }, - "items": { - "description": "A list of SslPolicy resources.", - "type": "array", - "items": { - "$ref": "SslPolicy" - } + "enableXpnResource": { + "id": "compute.projects.enableXpnResource", + "path": "projects/{project}/enableXpnResource", + "flatPath": "projects/{project}/enableXpnResource", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "ProjectsEnableXpnResourceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Enable service resource (a.k.a service project) for a host project, so that subnets in the host project can be used by instances in the service project." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "disableXpnResource": { + "id": "compute.projects.disableXpnResource", + "path": "projects/{project}/disableXpnResource", + "flatPath": "projects/{project}/disableXpnResource", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "ProjectsDisableXpnResourceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Disable a service resource (also known as service project) associated with this host project." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "getXpnHost": { + "id": "compute.projects.getXpnHost", + "path": "projects/{project}/getXpnHost", + "flatPath": "projects/{project}/getXpnHost", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "Project" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Gets the shared VPC host project that this project links to. May be empty if no link exists." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getXpnResources": { + "id": "compute.projects.getXpnResources", + "path": "projects/{project}/getXpnResources", + "flatPath": "projects/{project}/getXpnResources", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "ProjectsGetXpnResources" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Gets service resources (a.k.a service project) associated with this host project." + }, + "setDefaultNetworkTier": { + "id": "compute.projects.setDefaultNetworkTier", + "path": "projects/{project}/setDefaultNetworkTier", + "flatPath": "projects/{project}/setDefaultNetworkTier", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "SslPolicy": { - "id": "SslPolicy", - "description": "Represents an SSL Policy resource. Use SSL policies to control SSL features, such as versions and cipher suites, that are offered by Application Load Balancers and proxy Network Load Balancers. For more information, read SSL policies overview.", - "type": "object", - "properties": { - "kind": { - "description": "[Output only] Type of the resource. Always compute#sslPolicyfor SSL policies.", - "default": "compute#sslPolicy", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "name": { - "description": "Name of the resource. 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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "profile": { - "description": "Profile specifies the set of SSL features that can be used by the load balancer when negotiating SSL with clients. This can be one of COMPATIBLE, MODERN, RESTRICTED, or CUSTOM. If using CUSTOM, the set of SSL features to enable must be specified in the customFeatures field.", - "type": "string", - "enumDescriptions": [ - "Compatible profile. Allows the broadset set of clients, even those which support only out-of-date SSL features to negotiate with the load balancer.", - "Custom profile. Allow only the set of allowed SSL features specified in the customFeatures field.", - "Modern profile. Supports a wide set of SSL features, allowing modern clients to negotiate SSL with the load balancer.", - "Restricted profile. Supports a reduced set of SSL features, intended to meet stricter compliance requirements." + }, + "parameterOrder": [ + "project" ], - "enum": [ - "COMPATIBLE", - "CUSTOM", - "MODERN", - "RESTRICTED" - ] - }, - "minTlsVersion": { - "description": "The minimum version of SSL protocol that can be used by the clients to establish a connection with the load balancer. This can be one of TLS_1_0, TLS_1_1, TLS_1_2.", - "type": "string", - "enumDescriptions": [ - "TLS 1.0", - "TLS 1.1", - "TLS 1.2" + "request": { + "$ref": "ProjectsSetDefaultNetworkTierRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "TLS_1_0", - "TLS_1_1", - "TLS_1_2" - ] - }, - "enabledFeatures": { - "description": "[Output Only] The list of features enabled in the SSL policy.", - "type": "array", - "items": { - "type": "string" - } - }, - "customFeatures": { - "description": "A list of features enabled when the selected profile is CUSTOM. The method returns the set of features that can be specified in this list. This field must be empty if the profile is not CUSTOM.", - "type": "array", - "items": { - "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 SslPolicy. An up-to-date fingerprint must be provided in order to update the SslPolicy, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an SslPolicy.", - "type": "string", - "format": "byte" + "description": "Sets the default network tier of the project. The default network tier is used when an address/forwardingRule/instance is created without specifying the network tier field." }, - "warnings": { - "description": "[Output Only] If potential misconfigurations are detected for this SSL policy, this field will be populated with warning messages.", - "type": "array", - "items": { - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] - }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", - "type": "string" - }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } - } + "setCloudArmorTier": { + "id": "compute.projects.setCloudArmorTier", + "path": "projects/{project}/setCloudArmorTier", + "flatPath": "projects/{project}/setCloudArmorTier", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - }, - "region": { - "description": "[Output Only] URL of the region where the regional SSL policy resides. This field is not applicable to global SSL policies.", - "type": "string" - } - } - }, - "SslPoliciesListAvailableFeaturesResponse": { - "id": "SslPoliciesListAvailableFeaturesResponse", - "type": "object", - "properties": { - "features": { - "type": "array", - "items": { - "type": "string" - } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "ProjectsSetCloudArmorTierRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the billing account of the project must be subscribed to Cloud Armor Enterprise. See Subscribing to Cloud Armor Enterprise for more information." } } }, - "SslPoliciesAggregatedList": { - "id": "SslPoliciesAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#sslPolicyAggregatedList for lists of SSL Policies.", - "default": "compute#sslPoliciesAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of SslPoliciesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of SSL policies.", - "$ref": "SslPoliciesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "publicAdvertisedPrefixes": { + "methods": { + "list": { + "id": "compute.publicAdvertisedPrefixes.list", + "path": "projects/{project}/global/publicAdvertisedPrefixes", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "PublicAdvertisedPrefixList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the PublicAdvertisedPrefixes for a project." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "id": "compute.publicAdvertisedPrefixes.get", + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "publicAdvertisedPrefix": { + "description": "Name of the PublicAdvertisedPrefix resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "response": { + "$ref": "PublicAdvertisedPrefix" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified PublicAdvertisedPrefix resource." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.publicAdvertisedPrefixes.insert", + "path": "projects/{project}/global/publicAdvertisedPrefixes", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "PublicAdvertisedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a PublicAdvertisedPrefix in the specified project using the parameters that are included in the request." + }, + "delete": { + "id": "compute.publicAdvertisedPrefixes.delete", + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "publicAdvertisedPrefix": { + "description": "Name of the PublicAdvertisedPrefix resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified PublicAdvertisedPrefix" }, - "etag": { - "type": "string" + "patch": { + "id": "compute.publicAdvertisedPrefixes.patch", + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "publicAdvertisedPrefix": { + "description": "Name of the PublicAdvertisedPrefix resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "request": { + "$ref": "PublicAdvertisedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified Router resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "SslPoliciesScopedList": { - "id": "SslPoliciesScopedList", - "type": "object", - "properties": { - "sslPolicies": { - "description": "A list of SslPolicies contained in this scope.", - "type": "array", - "items": { - "$ref": "SslPolicy" - } + "announce": { + "id": "compute.publicAdvertisedPrefixes.announce", + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/announce", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/announce", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "publicAdvertisedPrefix": { + "description": "The name of the public advertised prefix. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Announces the specified PublicAdvertisedPrefix" }, - "warning": { - "description": "Informational warning which replaces the list of SSL policies when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "withdraw": { + "id": "compute.publicAdvertisedPrefixes.withdraw", + "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/withdraw", + "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/withdraw", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "publicAdvertisedPrefix": { + "description": "The name of the public advertised prefix. It should comply with RFC1035.", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "publicAdvertisedPrefix" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Withdraws the specified PublicAdvertisedPrefix" } } }, - "StoragePoolTypeList": { - "id": "StoragePoolTypeList", - "description": "Contains a list of storage pool types.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#storagePoolTypeList for storage pool types.", - "default": "compute#storagePoolTypeList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of StoragePoolType resources.", - "type": "array", - "items": { - "$ref": "StoragePoolType" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "globalPublicDelegatedPrefixes": { + "methods": { + "list": { + "id": "compute.globalPublicDelegatedPrefixes.list", + "path": "projects/{project}/global/publicDelegatedPrefixes", + "flatPath": "projects/{project}/global/publicDelegatedPrefixes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "PublicDelegatedPrefixList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the global PublicDelegatedPrefixes for a project." + }, + "get": { + "id": "compute.globalPublicDelegatedPrefixes.get", + "path": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "publicDelegatedPrefix": { + "description": "Name of the PublicDelegatedPrefix resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "StoragePoolType": { - "id": "StoragePoolType", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#storagePoolType for storage pool types.", - "default": "compute#storagePoolType", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "[Output Only] Name of the resource.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "type": "string" - }, - "description": { - "description": "[Output Only] An optional description of this resource.", - "type": "string" - }, - "deprecated": { - "description": "[Output Only] The deprecation status associated with this storage pool type.", - "$ref": "DeprecationStatus" - }, - "zone": { - "description": "[Output Only] URL of the zone where the storage pool type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource with the resource id.", - "type": "string" - }, - "minSizeGb": { - "description": "[Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb instead.", - "type": "string", - "format": "int64" - }, - "minPoolProvisionedCapacityGb": { - "description": "[Output Only] Minimum storage pool size in GB.", - "type": "string", - "format": "int64" - }, - "maxPoolProvisionedCapacityGb": { - "description": "[Output Only] Maximum storage pool size in GB.", - "type": "string", - "format": "int64" - }, - "minPoolProvisionedIops": { - "description": "[Output Only] Minimum provisioned IOPS.", - "type": "string", - "format": "int64" - }, - "maxPoolProvisionedIops": { - "description": "[Output Only] Maximum provisioned IOPS.", - "type": "string", - "format": "int64" + }, + "parameterOrder": [ + "project", + "publicDelegatedPrefix" + ], + "response": { + "$ref": "PublicDelegatedPrefix" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified global PublicDelegatedPrefix resource." }, - "minPoolProvisionedThroughput": { - "description": "[Output Only] Minimum provisioned throughput.", - "type": "string", - "format": "int64" + "insert": { + "id": "compute.globalPublicDelegatedPrefixes.insert", + "path": "projects/{project}/global/publicDelegatedPrefixes", + "flatPath": "projects/{project}/global/publicDelegatedPrefixes", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "PublicDelegatedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a global PublicDelegatedPrefix in the specified project using the parameters that are included in the request." }, - "maxPoolProvisionedThroughput": { - "description": "[Output Only] Maximum provisioned throughput.", - "type": "string", - "format": "int64" + "delete": { + "id": "compute.globalPublicDelegatedPrefixes.delete", + "path": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "publicDelegatedPrefix": { + "description": "Name of the PublicDelegatedPrefix resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "publicDelegatedPrefix" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified global PublicDelegatedPrefix." }, - "supportedDiskTypes": { - "description": "[Output Only] The list of disk types supported in this storage pool type.", - "type": "array", - "items": { - "type": "string" - } + "patch": { + "id": "compute.globalPublicDelegatedPrefixes.patch", + "path": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "publicDelegatedPrefix": { + "description": "Name of the PublicDelegatedPrefix resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "publicDelegatedPrefix" + ], + "request": { + "$ref": "PublicDelegatedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified global PublicDelegatedPrefix resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." } } }, - "StoragePoolTypeAggregatedList": { - "id": "StoragePoolTypeAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#storagePoolTypeAggregatedList .", - "default": "compute#storagePoolTypeAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of StoragePoolTypesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of storage pool types.", - "$ref": "StoragePoolTypesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "publicDelegatedPrefixes": { + "methods": { + "list": { + "id": "compute.publicDelegatedPrefixes.list", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "PublicDelegatedPrefixList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the PublicDelegatedPrefixes for a project in the given region." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "id": "compute.publicDelegatedPrefixes.get", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "publicDelegatedPrefix": { + "description": "Name of the PublicDelegatedPrefix resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "publicDelegatedPrefix" + ], + "response": { + "$ref": "PublicDelegatedPrefix" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified PublicDelegatedPrefix resource in the given region." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.publicDelegatedPrefixes.insert", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "PublicDelegatedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a PublicDelegatedPrefix in the specified project in the given region using the parameters that are included in the request." + }, + "delete": { + "id": "compute.publicDelegatedPrefixes.delete", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "publicDelegatedPrefix": { + "description": "Name of the PublicDelegatedPrefix resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "StoragePoolTypesScopedList": { - "id": "StoragePoolTypesScopedList", - "type": "object", - "properties": { - "storagePoolTypes": { - "description": "[Output Only] A list of storage pool types contained in this scope.", - "type": "array", - "items": { - "$ref": "StoragePoolType" - } + }, + "parameterOrder": [ + "project", + "region", + "publicDelegatedPrefix" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified PublicDelegatedPrefix in the given region." }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of storage pool types when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "id": "compute.publicDelegatedPrefixes.patch", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "publicDelegatedPrefix": { + "description": "Name of the PublicDelegatedPrefix resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "StoragePoolList": { - "id": "StoragePoolList", - "description": "A list of StoragePool resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#storagePoolList for lists of storagePools.", - "default": "compute#storagePoolList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of StoragePool resources.", - "type": "array", - "items": { - "$ref": "StoragePool" - } + }, + "parameterOrder": [ + "project", + "region", + "publicDelegatedPrefix" + ], + "request": { + "$ref": "PublicDelegatedPrefix" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified PublicDelegatedPrefix resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "announce": { + "id": "compute.publicDelegatedPrefixes.announce", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/announce", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/announce", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "publicDelegatedPrefix": { + "description": "The name of the public delegated prefix. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where the public delegated prefix is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "publicDelegatedPrefix" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Announces the specified PublicDelegatedPrefix in the given region." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "withdraw": { + "id": "compute.publicDelegatedPrefixes.withdraw", + "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/withdraw", + "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/withdraw", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "publicDelegatedPrefix": { + "description": "The name of the public delegated prefix. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region where the public delegated prefix is located. It should comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "publicDelegatedPrefix" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Withdraws the specified PublicDelegatedPrefix in the given region." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "id": "compute.publicDelegatedPrefixes.aggregatedList", + "path": "projects/{project}/aggregated/publicDelegatedPrefixes", + "flatPath": "projects/{project}/aggregated/publicDelegatedPrefixes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" } - } - }, - "etag": { - "type": "string" - }, - "unreachables": { - "description": "[Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder", - "type": "array", - "items": { - "type": "string" - } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "PublicDelegatedPrefixAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all PublicDelegatedPrefix resources owned by the specific project across all scopes. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." } } }, - "StoragePool": { - "id": "StoragePool", - "description": "Represents a zonal storage pool resource.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#storagePool for storage pools.", - "default": "compute#storagePool", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.storagePools.insert" - ] + "regions": { + "methods": { + "list": { + "id": "compute.regions.list", + "path": "projects/{project}/regions", + "flatPath": "projects/{project}/regions", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "poolProvisionedCapacityGb": { - "description": "Size, in GiB, of the storage pool. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools.", - "annotations": { - "required": [ - "compute.storagePools.insert" - ] + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "RegionList" }, - "type": "string", - "format": "int64" - }, - "poolProvisionedIops": { - "description": "Provisioned IOPS of the storage pool. Only relevant if the storage pool type is hyperdisk-balanced.", - "type": "string", - "format": "int64" - }, - "poolProvisionedThroughput": { - "description": "Provisioned throughput of the storage pool. Only relevant if the storage pool type is hyperdisk-balanced or hyperdisk-throughput.", - "type": "string", - "format": "int64" - }, - "zone": { - "description": "[Output Only] URL of the zone where the storage pool resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "state": { - "description": "[Output Only] The status of storage pool creation. - CREATING: Storage pool is provisioning. storagePool. - FAILED: Storage pool creation failed. - READY: Storage pool is ready for use. - DELETING: Storage pool is deleting. ", - "type": "string", - "enumDescriptions": [ - "StoragePool is provisioning", - "StoragePool is deleting.", - "StoragePool creation failed.", - "StoragePool is ready for use." + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY" - ] - }, - "selfLink": { - "description": "[Output Only] Server-defined fully-qualified URL for this resource.", - "type": "string" - }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL for this resource's resource id.", - "type": "string" - }, - "labels": { - "description": "Labels to apply to this storage pool. These can be later modified by the setLabels method.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this storage pool, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a storage pool.", - "type": "string", - "format": "byte" - }, - "resourceStatus": { - "description": "[Output Only] Status information for the storage pool resource.", - "$ref": "StoragePoolResourceStatus" - }, - "storagePoolType": { - "description": "Type of the storage pool.", - "type": "string" - }, - "status": { - "description": "[Output Only] Status information for the storage pool resource.", - "$ref": "StoragePoolResourceStatus" + "description": "Retrieves the list of region resources available to the specified project. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `items.quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method." }, - "capacityProvisioningType": { - "description": "Provisioning type of the byte capacity of the pool.", - "type": "string", - "enumDescriptions": [ - "Advanced provisioning \"thinly\" allocates the related resource.", - "Standard provisioning allocates the related resource for the pool disks' exclusive use.", - "" + "get": { + "id": "compute.regions.get", + "path": "projects/{project}/regions/{region}", + "flatPath": "projects/{project}/regions/{region}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "ADVANCED", - "STANDARD", - "UNSPECIFIED" - ] - }, - "performanceProvisioningType": { - "description": "Provisioning type of the performance-related parameters of the pool, such as throughput and IOPS.", - "type": "string", - "enumDescriptions": [ - "Advanced provisioning \"thinly\" allocates the related resource.", - "Standard provisioning allocates the related resource for the pool disks' exclusive use.", - "" + "response": { + "$ref": "Region" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ADVANCED", - "STANDARD", - "UNSPECIFIED" - ] - } - } - }, - "StoragePoolResourceStatus": { - "id": "StoragePoolResourceStatus", - "description": "[Output Only] Contains output only fields.", - "type": "object", - "properties": { - "lastResizeTimestamp": { - "description": "[Output Only] Timestamp of the last successful resize in RFC3339 text format.", - "type": "string" - }, - "diskCount": { - "description": "[Output Only] Number of disks used.", - "type": "string", - "format": "int64" - }, - "poolUsedCapacityBytes": { - "description": "[Output Only] Space used by data stored in disks within the storage pool (in bytes). This will reflect the total number of bytes written to the disks in the pool, in contrast to the capacity of those disks.", - "type": "string", - "format": "int64" - }, - "poolUserWrittenBytes": { - "description": "[Output Only] Amount of data written into the pool, before it is compacted.", - "type": "string", - "format": "int64" - }, - "totalProvisionedDiskCapacityGb": { - "description": "[Output Only] Sum of all the capacity provisioned in disks in this storage pool. A disk's provisioned capacity is the same as its total capacity.", - "type": "string", - "format": "int64" - }, - "maxTotalProvisionedDiskCapacityGb": { - "description": "[Output Only] Maximum allowed aggregate disk size in gigabytes.", - "type": "string", - "format": "int64" - }, - "poolUsedIops": { - "description": "[Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools.", - "type": "string", - "format": "int64" - }, - "totalProvisionedDiskIops": { - "description": "[Output Only] Sum of all the disks' provisioned IOPS.", - "type": "string", - "format": "int64" - }, - "poolUsedThroughput": { - "description": "[Output Only] Sum of all the disks' provisioned throughput in MB/s.", - "type": "string", - "format": "int64" - }, - "totalProvisionedDiskThroughput": { - "description": "[Output Only] Sum of all the disks' provisioned throughput in MB/s, minus some amount that is allowed per disk that is not counted towards pool's throughput capacity.", - "type": "string", - "format": "int64" + "description": "Returns the specified Region resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method." } } }, - "StoragePoolAggregatedList": { - "id": "StoragePoolAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#storagePoolAggregatedList for aggregated lists of storage pools.", - "default": "compute#storagePoolAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of StoragePoolsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of storage pool.", - "$ref": "StoragePoolsScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "resourcePolicies": { + "methods": { + "list": { + "id": "compute.resourcePolicies.list", + "path": "projects/{project}/regions/{region}/resourcePolicies", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "ResourcePolicyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "A list all the resource policies that have been configured for the specified project in specified region." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "id": "compute.resourcePolicies.aggregatedList", + "path": "projects/{project}/aggregated/resourcePolicies", + "flatPath": "projects/{project}/aggregated/resourcePolicies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" } - } - }, - "etag": { - "type": "string" - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "StoragePoolsScopedList": { - "id": "StoragePoolsScopedList", - "type": "object", - "properties": { - "storagePools": { - "description": "[Output Only] A list of storage pool contained in this scope.", - "type": "array", - "items": { - "$ref": "StoragePool" - } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "ResourcePolicyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of resource policies. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of storage pool when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "get": { + "id": "compute.resourcePolicies.get", + "path": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "resourcePolicy": { + "description": "Name of the resource policy to retrieve.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "StoragePoolListDisks": { - "id": "StoragePoolListDisks", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#storagePoolListDisks for lists of disks in a storagePool.", - "default": "compute#storagePoolListDisks", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of StoragePoolDisk resources.", - "type": "array", - "items": { - "$ref": "StoragePoolDisk" - } + }, + "parameterOrder": [ + "project", + "region", + "resourcePolicy" + ], + "response": { + "$ref": "ResourcePolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves all information of the specified resource policy." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "insert": { + "id": "compute.resourcePolicies.insert", + "path": "projects/{project}/regions/{region}/resourcePolicies", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "ResourcePolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a new resource policy." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "delete": { + "id": "compute.resourcePolicies.delete", + "path": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resourcePolicy": { + "description": "Name of the resource policy to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resourcePolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified resource policy." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "patch": { + "id": "compute.resourcePolicies.patch", + "path": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resourcePolicy": { + "description": "Id of the resource policy to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "location": "query", "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "format": "google-fieldmask" + } + }, + "parameterOrder": [ + "project", + "region", + "resourcePolicy" + ], + "request": { + "$ref": "ResourcePolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Modify the specified resource policy." + }, + "getIamPolicy": { + "id": "compute.resourcePolicies.getIamPolicy", + "path": "projects/{project}/regions/{region}/resourcePolicies/{resource}/getIamPolicy", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - }, - "etag": { - "type": "string" - }, - "unreachables": { - "description": "[Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "StoragePoolDisk": { - "id": "StoragePoolDisk", - "type": "object", - "properties": { - "disk": { - "description": "[Output Only] The URL of the disk.", - "type": "string" - }, - "name": { - "description": "[Output Only] The name of the disk.", - "type": "string" - }, - "status": { - "description": "[Output Only] The disk status.", - "type": "string", - "enumDescriptions": [ - "Disk is provisioning", - "Disk is deleting.", - "Disk creation failed.", - "Disk is ready for use.", - "Source data is being copied into the disk.", - "Disk is currently unavailable and cannot be accessed, attached or detached." + }, + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY", - "RESTORING", - "UNAVAILABLE" - ] - }, - "type": { - "description": "[Output Only] The disk type.", - "type": "string" - }, - "sizeGb": { - "description": "[Output Only] The disk size, in GB.", - "type": "string", - "format": "int64" - }, - "provisionedIops": { - "description": "[Output Only] The number of IOPS provisioned for the disk.", - "type": "string", - "format": "int64" - }, - "provisionedThroughput": { - "description": "[Output Only] The throughput provisioned for the disk.", - "type": "string", - "format": "int64" - }, - "usedBytes": { - "description": "[Output Only] Amount of disk space used.", - "type": "string", - "format": "int64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "attachedInstances": { - "description": "[Output Only] Instances this disk is attached to.", - "type": "array", - "items": { - "type": "string" - } - }, - "resourcePolicies": { - "description": "[Output Only] Resource policies applied to disk for automatic snapshot creations.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "SubnetworkList": { - "id": "SubnetworkList", - "description": "Contains a list of Subnetwork resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#subnetworkList for lists of subnetworks.", - "default": "compute#subnetworkList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of Subnetwork resources.", - "type": "array", - "items": { - "$ref": "Subnetwork" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "setIamPolicy": { + "id": "compute.resourcePolicies.setIamPolicy", + "path": "projects/{project}/regions/{region}/resourcePolicies/{resource}/setIamPolicy", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "id": "compute.resourcePolicies.testIamPermissions", + "path": "projects/{project}/regions/{region}/resourcePolicies/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "Subnetwork": { - "id": "Subnetwork", - "description": "Represents a Subnetwork resource. A subnetwork (also known as a subnet) is a logical partition of a Virtual Private Cloud network with one primary IP range and zero or more secondary IP ranges. For more information, read Virtual Private Cloud (VPC) Network.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#subnetwork for Subnetwork resources.", - "default": "compute#subnetwork", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "type": "string" - }, - "name": { - "description": "The name of the resource, provided by the client when initially creating the resource. 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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource. This field can be set only at resource creation time.", - "type": "string" - }, - "network": { - "description": "The URL of the network to which this subnetwork belongs, provided by the client when initially creating the subnetwork. This field can be set only at resource creation time.", - "type": "string" - }, - "ipCidrRange": { - "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. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.", - "type": "string" - }, - "reservedInternalRange": { - "description": "The URL of the reserved internal range.", - "type": "string" - }, - "gatewayAddress": { - "description": "[Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.", - "type": "string" - }, - "region": { - "description": "URL of the region where the Subnetwork resides. This field can be set only at resource creation time.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "privateIpGoogleAccess": { - "description": "Whether the VMs in this subnet can access Google services without assigned external IP addresses. This field can be both set at resource creation time and updated using setPrivateIpGoogleAccess.", - "type": "boolean" - }, - "secondaryIpRanges": { - "description": "An array of configurations for secondary IP ranges for VM instances contained in this subnetwork. The primary IP of such VM must belong to the primary ipCidrRange of the subnetwork. The alias IPs may belong to either primary or secondary ranges. This field can be updated with a patch request.", - "type": "array", - "items": { - "$ref": "SubnetworkSecondaryRange" - } - }, - "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. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.", - "type": "string", - "format": "byte" - }, - "enableFlowLogs": { - "description": "Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. This field isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY.", - "type": "boolean" - }, - "privateIpv6GoogleAccess": { - "description": "This field is for internal use. This field can be both set at resource creation time and updated using patch.", - "type": "string", - "enumDescriptions": [ - "Disable private IPv6 access to/from Google services.", - "Bidirectional private IPv6 access to/from Google services.", - "Outbound private IPv6 access from VMs in this subnet to Google services." - ], - "enum": [ - "DISABLE_GOOGLE_ACCESS", - "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", - "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE" - ] - }, - "ipv6CidrRange": { - "description": "[Output Only] This field is for internal use.", - "type": "string" - }, - "externalIpv6Prefix": { - "description": "The external IPv6 address range that is owned by this subnetwork.", - "type": "string" - }, - "internalIpv6Prefix": { - "description": "The internal IPv6 address range that is owned by this subnetwork.", - "type": "string" - }, - "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", - "type": "string", - "enumDescriptions": [ - "Subnet reserved for Global Envoy-based Load Balancing.", - "Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy purpose, please use REGIONAL_MANAGED_PROXY instead.", - "Regular user created or automatically created subnet.", - "Subnetwork used as source range for Private NAT Gateways.", - "Regular user created or automatically created subnet.", - "Subnetworks created for Private Service Connect in the producer network.", - "Subnetwork used for Regional Envoy-based Load Balancing." + "routes": { + "methods": { + "list": { + "id": "compute.routes.list", + "path": "projects/{project}/global/routes", + "flatPath": "projects/{project}/global/routes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" ], - "enum": [ - "GLOBAL_MANAGED_PROXY", - "INTERNAL_HTTPS_LOAD_BALANCER", - "PRIVATE", - "PRIVATE_NAT", - "PRIVATE_RFC_1918", - "PRIVATE_SERVICE_CONNECT", - "REGIONAL_MANAGED_PROXY" - ] - }, - "role": { - "description": "The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request.", - "type": "string", - "enumDescriptions": [ - "The ACTIVE subnet that is currently used.", - "The BACKUP subnet that could be promoted to ACTIVE." + "response": { + "$ref": "RouteList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ACTIVE", - "BACKUP" - ] + "description": "Retrieves the list of Route resources available to the specified project." }, - "state": { - "description": "[Output Only] The state of the subnetwork, which can be one of the following values: READY: Subnetwork is created and ready to use DRAINING: 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", - "type": "string", - "enumDescriptions": [ - "Subnetwork is being drained.", - "Subnetwork is ready for use." + "get": { + "id": "compute.routes.get", + "path": "projects/{project}/global/routes/{route}", + "flatPath": "projects/{project}/global/routes/{route}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "route": { + "description": "Name of the Route resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "route" ], - "enum": [ - "DRAINING", - "READY" - ] - }, - "logConfig": { - "description": "This field denotes the VPC flow logging options for this subnetwork. If logging is enabled, logs are exported to Cloud Logging.", - "$ref": "SubnetworkLogConfig" - }, - "stackType": { - "description": "The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch.", - "type": "string", - "enumDescriptions": [ - "New VMs in this subnet can have both IPv4 and IPv6 addresses.", - "New VMs in this subnet will only be assigned IPv4 addresses." + "response": { + "$ref": "Route" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY" - ] + "description": "Returns the specified Route resource." }, - "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.", - "type": "string", - "enumDescriptions": [ - "VMs on this subnet will be assigned IPv6 addresses that are accessible via the Internet, as well as the VPC network.", - "VMs on this subnet will be assigned IPv6 addresses that are only accessible over the VPC network." + "insert": { + "id": "compute.routes.insert", + "path": "projects/{project}/global/routes", + "flatPath": "projects/{project}/global/routes", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" ], - "enum": [ - "EXTERNAL", - "INTERNAL" - ] - } - } - }, - "SubnetworkSecondaryRange": { - "id": "SubnetworkSecondaryRange", - "description": "Represents a secondary IP range of a subnetwork.", - "type": "object", - "properties": { - "rangeName": { - "description": "The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork.", - "type": "string" - }, - "ipCidrRange": { - "description": "The range of IP addresses belonging to this subnetwork secondary range. Provide this property when you create the subnetwork. Ranges must be unique and non-overlapping with all primary and secondary IP ranges within a network. Only IPv4 is supported. The range can be any range listed in the Valid ranges list.", - "type": "string" - }, - "reservedInternalRange": { - "description": "The URL of the reserved internal range.", - "type": "string" - } - } - }, - "SubnetworkLogConfig": { - "id": "SubnetworkLogConfig", - "description": "The available logging options for this subnetwork.", - "type": "object", - "properties": { - "enable": { - "description": "Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. Flow logging isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY.", - "type": "boolean" - }, - "aggregationInterval": { - "description": "Can only be specified if VPC flow logging for this subnetwork is enabled. Toggles the aggregation interval for collecting flow logs. Increasing the interval time will reduce the amount of generated flow logs for long lasting connections. Default is an interval of 5 seconds per connection.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "", - "", - "" + "request": { + "$ref": "Route" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "INTERVAL_10_MIN", - "INTERVAL_15_MIN", - "INTERVAL_1_MIN", - "INTERVAL_30_SEC", - "INTERVAL_5_MIN", - "INTERVAL_5_SEC" - ] - }, - "flowSampling": { - "description": "Can only be specified if VPC flow logging for this subnetwork is enabled. The value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs within the subnetwork where 1.0 means all collected logs are reported and 0.0 means no logs are reported. Default is 0.5 unless otherwise specified by the org policy, which means half of all collected logs are reported.", - "type": "number", - "format": "float" + "description": "Creates a Route resource in the specified project using the data included in the request." }, - "metadata": { - "description": "Can only be specified if VPC flow logs for this subnetwork is enabled. Configures whether all, none or a subset of metadata fields should be added to the reported VPC flow logs. Default is EXCLUDE_ALL_METADATA.", - "type": "string", - "enumDescriptions": [ - "", - "", - "" + "delete": { + "id": "compute.routes.delete", + "path": "projects/{project}/global/routes/{route}", + "flatPath": "projects/{project}/global/routes/{route}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "route": { + "description": "Name of the Route resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "route" ], - "enum": [ - "CUSTOM_METADATA", - "EXCLUDE_ALL_METADATA", - "INCLUDE_ALL_METADATA" - ] - }, - "metadataFields": { - "description": "Can only be specified if VPC flow logs for this subnetwork is enabled and \"metadata\" was set to CUSTOM_METADATA.", - "type": "array", - "items": { - "type": "string" - } - }, - "filterExpr": { - "description": "Can only be specified if VPC flow logs for this subnetwork is enabled. The filter expression is used to define which VPC flow logs should be exported to Cloud Logging.", - "type": "string" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified Route resource." } } }, - "SubnetworkAggregatedList": { - "id": "SubnetworkAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#subnetworkAggregatedList for aggregated lists of subnetworks.", - "default": "compute#subnetworkAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of SubnetworksScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of Subnetworks.", - "$ref": "SubnetworksScopedList" - } + "routers": { + "methods": { + "get": { + "id": "compute.routers.get", + "path": "projects/{project}/regions/{region}/routers/{router}", + "flatPath": "projects/{project}/regions/{region}/routers/{router}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "router" + ], + "response": { + "$ref": "Router" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified Router resource." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "insert": { + "id": "compute.routers.insert", + "path": "projects/{project}/regions/{region}/routers", + "flatPath": "projects/{project}/regions/{region}/routers", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "Router" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a Router resource in the specified project and region using the data included in the request." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "update": { + "id": "compute.routers.update", + "path": "projects/{project}/regions/{region}/routers/{router}", + "flatPath": "projects/{project}/regions/{region}/routers/{router}", + "httpMethod": "PUT", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "router" + ], + "request": { + "$ref": "Router" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified Router resource with the data included in the request. This method conforms to PUT semantics, which requests that the state of the target resource be created or replaced with the state defined by the representation enclosed in the request message payload." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "id": "compute.routers.patch", + "path": "projects/{project}/regions/{region}/routers/{router}", + "flatPath": "projects/{project}/regions/{region}/routers/{router}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "SubnetworksScopedList": { - "id": "SubnetworksScopedList", - "type": "object", - "properties": { - "subnetworks": { - "description": "A list of subnetworks contained in this scope.", - "type": "array", - "items": { - "$ref": "Subnetwork" - } + }, + "parameterOrder": [ + "project", + "region", + "router" + ], + "request": { + "$ref": "Router" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified Router resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." }, - "warning": { - "description": "An informational warning that appears when the list of addresses is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "id": "compute.routers.delete", + "path": "projects/{project}/regions/{region}/routers/{router}", + "flatPath": "projects/{project}/regions/{region}/routers/{router}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "router": { + "description": "Name of the Router resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "UsableSubnetworksAggregatedList": { - "id": "UsableSubnetworksAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#usableSubnetworksAggregatedList for aggregated lists of usable subnetworks.", - "default": "compute#usableSubnetworksAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string" - }, - "items": { - "description": "[Output] A list of usable subnetwork URLs.", - "type": "array", - "items": { - "$ref": "UsableSubnetwork" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. In special cases listUsable may return 0 subnetworks and nextPageToken which still should be used to get the next page of results.", - "type": "string" + }, + "parameterOrder": [ + "project", + "region", + "router" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified Router resource." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "list": { + "id": "compute.routers.list", + "path": "projects/{project}/regions/{region}/routers", + "flatPath": "projects/{project}/regions/{region}/routers", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "RouterList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of Router resources available to the specified project." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "aggregatedList": { + "id": "compute.routers.aggregatedList", + "path": "projects/{project}/aggregated/routers", + "flatPath": "projects/{project}/aggregated/routers", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "RouterAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of routers. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + }, + "getRouterStatus": { + "id": "compute.routers.getRouterStatus", + "path": "projects/{project}/regions/{region}/routers/{router}/getRouterStatus", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/getRouterStatus", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to query.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "router" + ], + "response": { + "$ref": "RouterStatusResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves runtime information of the specified router." + }, + "getNatMappingInfo": { + "id": "compute.routers.getNatMappingInfo", + "path": "projects/{project}/regions/{region}/routers/{router}/getNatMappingInfo", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/getNatMappingInfo", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "natName": { + "description": "Name of the nat service to filter the Nat Mapping information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "router": { + "description": "Name of the Router resource to query for Nat Mapping information of VM endpoints.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "UsableSubnetwork": { - "id": "UsableSubnetwork", - "description": "Subnetwork which the current user has compute.subnetworks.use permission on.", - "type": "object", - "properties": { - "subnetwork": { - "description": "Subnetwork URL.", - "type": "string" - }, - "network": { - "description": "Network URL.", - "type": "string" - }, - "ipCidrRange": { - "description": "The range of internal addresses that are owned by this subnetwork.", - "type": "string" - }, - "secondaryIpRanges": { - "description": "Secondary IP ranges.", - "type": "array", - "items": { - "$ref": "UsableSubnetworkSecondaryRange" - } - }, - "stackType": { - "description": "The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch.", - "type": "string", - "enumDescriptions": [ - "New VMs in this subnet can have both IPv4 and IPv6 addresses.", - "New VMs in this subnet will only be assigned IPv4 addresses." + }, + "parameterOrder": [ + "project", + "region", + "router" ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY" - ] - }, - "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.", - "type": "string", - "enumDescriptions": [ - "VMs on this subnet will be assigned IPv6 addresses that are accessible via the Internet, as well as the VPC network.", - "VMs on this subnet will be assigned IPv6 addresses that are only accessible over the VPC network." + "response": { + "$ref": "VmEndpointNatMappingsList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "EXTERNAL", - "INTERNAL" - ] + "description": "Retrieves runtime Nat mapping information of VM endpoints." }, - "purpose": { - "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", - "type": "string", - "enumDescriptions": [ - "Subnet reserved for Global Envoy-based Load Balancing.", - "Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy purpose, please use REGIONAL_MANAGED_PROXY instead.", - "Regular user created or automatically created subnet.", - "Subnetwork used as source range for Private NAT Gateways.", - "Regular user created or automatically created subnet.", - "Subnetworks created for Private Service Connect in the producer network.", - "Subnetwork used for Regional Envoy-based Load Balancing." + "getNatIpInfo": { + "id": "compute.routers.getNatIpInfo", + "path": "projects/{project}/regions/{region}/routers/{router}/getNatIpInfo", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/getNatIpInfo", + "httpMethod": "GET", + "parameters": { + "natName": { + "description": "Name of the nat service to filter the NAT IP information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to query for Nat IP information. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "router" ], - "enum": [ - "GLOBAL_MANAGED_PROXY", - "INTERNAL_HTTPS_LOAD_BALANCER", - "PRIVATE", - "PRIVATE_NAT", - "PRIVATE_RFC_1918", - "PRIVATE_SERVICE_CONNECT", - "REGIONAL_MANAGED_PROXY" - ] - }, - "role": { - "description": "The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request.", - "type": "string", - "enumDescriptions": [ - "The ACTIVE subnet that is currently used.", - "The BACKUP subnet that could be promoted to ACTIVE." + "response": { + "$ref": "NatIpInfoResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "ACTIVE", - "BACKUP" - ] - }, - "externalIpv6Prefix": { - "description": "[Output Only] The external IPv6 address range that is assigned to this subnetwork.", - "type": "string" - }, - "internalIpv6Prefix": { - "description": "[Output Only] The internal IPv6 address range that is assigned to this subnetwork.", - "type": "string" - } - } - }, - "UsableSubnetworkSecondaryRange": { - "id": "UsableSubnetworkSecondaryRange", - "description": "Secondary IP range of a usable subnetwork.", - "type": "object", - "properties": { - "rangeName": { - "description": "The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork.", - "type": "string" + "description": "Retrieves runtime NAT IP information." }, - "ipCidrRange": { - "description": "The range of IP addresses belonging to this subnetwork secondary range.", - "type": "string" - } - } - }, - "SubnetworksExpandIpCidrRangeRequest": { - "id": "SubnetworksExpandIpCidrRangeRequest", - "type": "object", - "properties": { - "ipCidrRange": { - "description": "The IP (in CIDR format or netmask) of internal addresses that are legal on this Subnetwork. This range should be disjoint from other subnetworks within this network. This range can only be larger than (i.e. a superset of) the range previously defined before the update.", - "type": "string" - } - } - }, - "SubnetworksSetPrivateIpGoogleAccessRequest": { - "id": "SubnetworksSetPrivateIpGoogleAccessRequest", - "type": "object", - "properties": { - "privateIpGoogleAccess": { - "type": "boolean" + "preview": { + "id": "compute.routers.preview", + "path": "projects/{project}/regions/{region}/routers/{router}/preview", + "flatPath": "projects/{project}/regions/{region}/routers/{router}/preview", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "router": { + "description": "Name of the Router resource to query.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "router" + ], + "request": { + "$ref": "Router" + }, + "response": { + "$ref": "RoutersPreviewResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Preview fields auto-generated during router create and update operations. Calling this method does NOT create or update the router." } } }, - "TargetGrpcProxyList": { - "id": "TargetGrpcProxyList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies.", - "default": "compute#targetGrpcProxyList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of TargetGrpcProxy resources.", - "type": "array", - "items": { - "$ref": "TargetGrpcProxy" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "serviceAttachments": { + "methods": { + "aggregatedList": { + "id": "compute.serviceAttachments.aggregatedList", + "path": "projects/{project}/aggregated/serviceAttachments", + "flatPath": "projects/{project}/aggregated/serviceAttachments", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "ServiceAttachmentAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of all ServiceAttachment resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + }, + "list": { + "id": "compute.serviceAttachments.list", + "path": "projects/{project}/regions/{region}/serviceAttachments", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "TargetGrpcProxy": { - "id": "TargetGrpcProxy", - "description": "Represents a Target gRPC Proxy resource. A target gRPC proxy is a component of load balancers intended for load balancing gRPC traffic. Only global forwarding rules with load balancing scheme INTERNAL_SELF_MANAGED can reference a target gRPC proxy. The target gRPC Proxy references a URL map that specifies how traffic is routed to gRPC backend services.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies.", - "default": "compute#targetGrpcProxy", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.targetGrpcProxies.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "selfLinkWithId": { - "description": "[Output Only] Server-defined URL with id for the resource.", - "type": "string" - }, - "urlMap": { - "description": "URL to the UrlMap resource that defines the mapping from URL to the BackendService. The protocol field in the BackendService must be set to GRPC.", - "type": "string" + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "ServiceAttachmentList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the ServiceAttachments for a project in the given scope." }, - "validateForProxyless": { - "description": "If true, indicates that the BackendServices referenced by the urlMap may be accessed by gRPC applications without using a sidecar proxy. This will enable configuration checks on urlMap and its referenced BackendServices to not allow unsupported features. A gRPC application must use \"xds:///\" scheme in the target URI of the service it is connecting to. If false, indicates that the BackendServices referenced by the urlMap will be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC application must not use \"xds:///\" scheme in the target URI of the service it is connecting to", - "type": "boolean" + "get": { + "id": "compute.serviceAttachments.get", + "path": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "serviceAttachment": { + "description": "Name of the ServiceAttachment resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "serviceAttachment" + ], + "response": { + "$ref": "ServiceAttachment" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified ServiceAttachment resource in the given scope." }, - "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 TargetGrpcProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetGrpcProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetGrpcProxy.", - "type": "string", - "format": "byte" - } - } - }, - "TargetHttpProxyList": { - "id": "TargetHttpProxyList", - "description": "A list of TargetHttpProxy resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource. Always compute#targetHttpProxyList for lists of target HTTP proxies.", - "default": "compute#targetHttpProxyList", - "type": "string" + "insert": { + "id": "compute.serviceAttachments.insert", + "path": "projects/{project}/regions/{region}/serviceAttachments", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "ServiceAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a ServiceAttachment in the specified project in the given scope using the parameters that are included in the request." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "delete": { + "id": "compute.serviceAttachments.delete", + "path": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region of this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "serviceAttachment": { + "description": "Name of the ServiceAttachment resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "serviceAttachment" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified ServiceAttachment in the given scope" }, - "items": { - "description": "A list of TargetHttpProxy resources.", - "type": "array", - "items": { - "$ref": "TargetHttpProxy" - } + "patch": { + "id": "compute.serviceAttachments.patch", + "path": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The region scoping this request and should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "serviceAttachment": { + "description": "The resource id of the ServiceAttachment to patch. It should conform to RFC1035 resource name or be a string form on an unsigned long number.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "serviceAttachment" + ], + "request": { + "$ref": "ServiceAttachment" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified ServiceAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "getIamPolicy": { + "id": "compute.serviceAttachments.getIamPolicy", + "path": "projects/{project}/regions/{region}/serviceAttachments/{resource}/getIamPolicy", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "setIamPolicy": { + "id": "compute.serviceAttachments.setIamPolicy", + "path": "projects/{project}/regions/{region}/serviceAttachments/{resource}/setIamPolicy", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "testIamPermissions": { + "id": "compute.serviceAttachments.testIamPermissions", + "path": "projects/{project}/regions/{region}/serviceAttachments/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." } } }, - "TargetHttpProxy": { - "id": "TargetHttpProxy", - "description": "Represents a Target HTTP Proxy resource. Google Compute Engine has two Target HTTP Proxy resources: * [Global](/compute/docs/reference/rest/v1/targetHttpProxies) * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies) A target HTTP proxy is a component of Google Cloud HTTP load balancers. * targetHttpProxies are used by global external Application Load Balancers, classic Application Load Balancers, cross-region internal Application Load Balancers, and Traffic Director. * regionTargetHttpProxies are used by regional internal Application Load Balancers and regional external Application Load Balancers. Forwarding rules reference a target HTTP proxy, and the target proxy then references a URL map. For more information, read Using Target Proxies and Forwarding rule concepts.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#targetHttpProxy for target HTTP proxies.", - "default": "compute#targetHttpProxy", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "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" - }, - "region": { - "description": "[Output Only] URL of the region where the regional Target HTTP Proxy resides. This field is not applicable to global Target HTTP Proxies.", - "type": "string" - }, - "proxyBind": { - "description": "This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false.", - "type": "boolean" - }, - "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 TargetHttpProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetHttpProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpProxy.", - "type": "string", - "format": "byte" + "snapshotSettings": { + "methods": { + "get": { + "id": "compute.snapshotSettings.get", + "path": "projects/{project}/global/snapshotSettings", + "flatPath": "projects/{project}/global/snapshotSettings", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "SnapshotSettings" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Get snapshot settings." }, - "httpKeepAliveTimeoutSec": { - "description": "Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported.", - "type": "integer", - "format": "int32" - } - } - }, - "UrlMapReference": { - "id": "UrlMapReference", - "type": "object", - "properties": { - "urlMap": { - "type": "string" + "patch": { + "id": "compute.snapshotSettings.patch", + "path": "projects/{project}/global/snapshotSettings", + "flatPath": "projects/{project}/global/snapshotSettings", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "SnapshotSettings" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patch snapshot settings." } } }, - "TargetHttpProxyAggregatedList": { - "id": "TargetHttpProxyAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#targetHttpProxyAggregatedList for lists of Target HTTP Proxies.", - "default": "compute#targetHttpProxyAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of TargetHttpProxiesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of TargetHttpProxies.", - "$ref": "TargetHttpProxiesScopedList" - } + "sslCertificates": { + "methods": { + "list": { + "id": "compute.sslCertificates.list", + "path": "projects/{project}/global/sslCertificates", + "flatPath": "projects/{project}/global/sslCertificates", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "SslCertificateList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of SslCertificate resources available to the specified project." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "get": { + "id": "compute.sslCertificates.get", + "path": "projects/{project}/global/sslCertificates/{sslCertificate}", + "flatPath": "projects/{project}/global/sslCertificates/{sslCertificate}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "sslCertificate": { + "description": "Name of the SslCertificate resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "sslCertificate" + ], + "response": { + "$ref": "SslCertificate" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified SslCertificate resource." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "insert": { + "id": "compute.sslCertificates.insert", + "path": "projects/{project}/global/sslCertificates", + "flatPath": "projects/{project}/global/sslCertificates", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "SslCertificate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a SslCertificate resource in the specified project using the data included in the request." }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "TargetHttpProxiesScopedList": { - "id": "TargetHttpProxiesScopedList", - "type": "object", - "properties": { - "targetHttpProxies": { - "description": "A list of TargetHttpProxies contained in this scope.", - "type": "array", - "items": { - "$ref": "TargetHttpProxy" - } + "delete": { + "id": "compute.sslCertificates.delete", + "path": "projects/{project}/global/sslCertificates/{sslCertificate}", + "flatPath": "projects/{project}/global/sslCertificates/{sslCertificate}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sslCertificate": { + "description": "Name of the SslCertificate resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "sslCertificate" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified SslCertificate resource." }, - "warning": { - "description": "Informational warning which replaces the list of backend services when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "id": "compute.sslCertificates.aggregatedList", + "path": "projects/{project}/aggregated/sslCertificates", + "flatPath": "projects/{project}/aggregated/sslCertificates", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" } - } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "SslCertificateAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of all SslCertificate resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." } } }, - "TargetHttpsProxyList": { - "id": "TargetHttpsProxyList", - "description": "Contains a list of TargetHttpsProxy resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource. Always compute#targetHttpsProxyList for lists of target HTTPS proxies.", - "default": "compute#targetHttpsProxyList", - "type": "string" + "regionSslCertificates": { + "methods": { + "list": { + "id": "compute.regionSslCertificates.list", + "path": "projects/{project}/regions/{region}/sslCertificates", + "flatPath": "projects/{project}/regions/{region}/sslCertificates", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "SslCertificateList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of SslCertificate resources available to the specified project in the specified region." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "get": { + "id": "compute.regionSslCertificates.get", + "path": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", + "flatPath": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "sslCertificate": { + "description": "Name of the SslCertificate resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "sslCertificate" + ], + "response": { + "$ref": "SslCertificate" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified SslCertificate resource in the specified region. Get a list of available SSL certificates by making a list() request." }, - "items": { - "description": "A list of TargetHttpsProxy resources.", - "type": "array", - "items": { - "$ref": "TargetHttpsProxy" - } + "insert": { + "id": "compute.regionSslCertificates.insert", + "path": "projects/{project}/regions/{region}/sslCertificates", + "flatPath": "projects/{project}/regions/{region}/sslCertificates", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "SslCertificate" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a SslCertificate resource in the specified project and region using the data included in the request" }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "delete": { + "id": "compute.regionSslCertificates.delete", + "path": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", + "flatPath": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sslCertificate": { + "description": "Name of the SslCertificate resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "sslCertificate" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified SslCertificate resource in the region." + } + } + }, + "sslPolicies": { + "methods": { + "list": { + "id": "compute.sslPolicies.list", + "path": "projects/{project}/global/sslPolicies", + "flatPath": "projects/{project}/global/sslPolicies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "SslPoliciesList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all the SSL policies that have been configured for the specified project." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "get": { + "id": "compute.sslPolicies.get", + "path": "projects/{project}/global/sslPolicies/{sslPolicy}", + "flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "sslPolicy": { + "description": "Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "sslPolicy" + ], + "response": { + "$ref": "SslPolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all of the ordered rules present in a single specified policy." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.sslPolicies.insert", + "path": "projects/{project}/global/sslPolicies", + "flatPath": "projects/{project}/global/sslPolicies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "SslPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Returns the specified SSL policy resource." + }, + "delete": { + "id": "compute.sslPolicies.delete", + "path": "projects/{project}/global/sslPolicies/{sslPolicy}", + "flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "sslPolicy": { + "description": "Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "TargetHttpsProxy": { - "id": "TargetHttpsProxy", - "description": "Represents a Target HTTPS Proxy resource. Google Compute Engine has two Target HTTPS Proxy resources: * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies) * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies) A target HTTPS proxy is a component of GCP HTTPS load balancers. * targetHttpProxies are used by global external Application Load Balancers, classic Application Load Balancers, cross-region internal Application Load Balancers, and Traffic Director. * regionTargetHttpProxies are used by regional internal Application Load Balancers and regional external Application Load Balancers. Forwarding rules reference a target HTTPS proxy, and the target proxy then references a URL map. For more information, read Using Target Proxies and Forwarding rule concepts.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#targetHttpsProxy for target HTTPS proxies.", - "default": "compute#targetHttpsProxy", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "urlMap": { - "description": "A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService. For example, the following are all valid URLs for specifying a URL map: - https://www.googleapis.compute/v1/projects/project/global/urlMaps/ url-map - projects/project/global/urlMaps/url-map - global/urlMaps/url-map ", - "type": "string" - }, - "sslCertificates": { - "description": "URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API. Certificate Manager Certificates are not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. ", - "type": "array", - "items": { - "type": "string" - } - }, - "certificateMap": { - "description": "URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for Global external Application Load Balancer or Classic Application Load Balancer. For other products use Certificate Manager Certificates instead. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", - "type": "string" - }, - "quicOverride": { - "description": "Specifies the QUIC override policy for this TargetHttpsProxy resource. This setting determines whether the load balancer attempts to negotiate QUIC with clients. You can specify NONE, ENABLE, or DISABLE. - When quic-override is set to NONE, Google manages whether QUIC is used. - When quic-override is set to ENABLE, the load balancer uses QUIC when possible. - When quic-override is set to DISABLE, the load balancer doesn't use QUIC. - If the quic-override flag is not specified, NONE is implied. ", - "type": "string", - "enumDescriptions": [ - "The load balancer will not attempt to negotiate QUIC with clients.", - "The load balancer will attempt to negotiate QUIC with clients.", - "No overrides to the default QUIC policy. This option is implicit if no QUIC override has been specified in the request." + }, + "parameterOrder": [ + "project", + "sslPolicy" ], - "enum": [ - "DISABLE", - "ENABLE", - "NONE" - ] - }, - "sslPolicy": { - "description": "URL of SslPolicy resource that will be associated with the TargetHttpsProxy resource. If not set, the TargetHttpsProxy resource has no SSL policy configured.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the regional TargetHttpsProxy resides. This field is not applicable to global TargetHttpsProxies.", - "type": "string" - }, - "proxyBind": { - "description": "This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false.", - "type": "boolean" - }, - "serverTlsPolicy": { - "description": "Optional. A URL referring to a networksecurity.ServerTlsPolicy resource that describes how the proxy should authenticate inbound traffic. serverTlsPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL or EXTERNAL_MANAGED. For details which ServerTlsPolicy resources are accepted with INTERNAL_SELF_MANAGED and which with EXTERNAL, EXTERNAL_MANAGED loadBalancingScheme consult ServerTlsPolicy documentation. If left blank, communications are not encrypted.", - "type": "string" - }, - "authorizationPolicy": { - "description": "Optional. A URL referring to a networksecurity.AuthorizationPolicy resource that describes how the proxy should authorize inbound traffic. If left blank, access will not be restricted by an authorization policy. Refer to the AuthorizationPolicy resource for additional details. authorizationPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. Note: This field currently has no impact.", - "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 TargetHttpsProxy. An up-to-date fingerprint must be provided in order to patch the TargetHttpsProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpsProxy.", - "type": "string", - "format": "byte" - }, - "httpKeepAliveTimeoutSec": { - "description": "Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported.", - "type": "integer", - "format": "int32" - }, - "tlsEarlyData": { - "description": " Specifies whether TLS 1.3 0-RTT Data (\"Early Data\") should be accepted for this service. Early Data allows a TLS resumption handshake to include the initial application payload (a HTTP request) alongside the handshake, reducing the effective round trips to \"zero\". This applies to TLS 1.3 connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). This can improve application performance, especially on networks where interruptions may be common, such as on mobile. Requests with Early Data will have the \"Early-Data\" HTTP header set on the request, with a value of \"1\", to allow the backend to determine whether Early Data was included. Note: TLS Early Data may allow requests to be replayed, as the data is sent to the backend before the handshake has fully completed. Applications that allow idempotent HTTP methods to make non-idempotent changes, such as a GET request updating a database, should not accept Early Data on those requests, and reject requests with the \"Early-Data: 1\" HTTP header by returning a HTTP 425 (Too Early) status code, in order to remain RFC compliant. The default value is DISABLED.", - "type": "string", - "enumDescriptions": [ - "TLS 1.3 Early Data is not advertised, and any (invalid) attempts to send Early Data will be rejected by closing the connection.", - "This enables TLS 1.3 0-RTT, and only allows Early Data to be included on requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE). This mode does not enforce any other limitations for requests with Early Data. The application owner should validate that Early Data is acceptable for a given request path.", - "This enables TLS 1.3 0-RTT, and only allows Early Data to be included on requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE) without query parameters. Requests that send Early Data with non-idempotent HTTP methods or with query parameters will be rejected with a HTTP 425." + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "DISABLED", - "PERMISSIVE", - "STRICT" - ] - } - } - }, - "TargetHttpsProxyAggregatedList": { - "id": "TargetHttpsProxyAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#targetHttpsProxyAggregatedList for lists of Target HTTP Proxies.", - "default": "compute#targetHttpsProxyAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of TargetHttpsProxiesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of TargetHttpsProxies.", - "$ref": "TargetHttpsProxiesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "description": "Deletes the specified SSL policy. The SSL policy resource can be deleted only if it is not in use by any TargetHttpsProxy or TargetSslProxy resources." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "id": "compute.sslPolicies.patch", + "path": "projects/{project}/global/sslPolicies/{sslPolicy}", + "flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "sslPolicy": { + "description": "Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "sslPolicy" + ], + "request": { + "$ref": "SslPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified SSL policy with the data included in the request." }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "TargetHttpsProxiesScopedList": { - "id": "TargetHttpsProxiesScopedList", - "type": "object", - "properties": { - "targetHttpsProxies": { - "description": "A list of TargetHttpsProxies contained in this scope.", - "type": "array", - "items": { - "$ref": "TargetHttpsProxy" - } + "listAvailableFeatures": { + "id": "compute.sslPolicies.listAvailableFeatures", + "path": "projects/{project}/global/sslPolicies/listAvailableFeatures", + "flatPath": "projects/{project}/global/sslPolicies/listAvailableFeatures", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "SslPoliciesListAvailableFeaturesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all features that can be specified in the SSL policy when using custom profile." }, - "warning": { - "description": "Informational warning which replaces the list of backend services when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "aggregatedList": { + "id": "compute.sslPolicies.aggregatedList", + "path": "projects/{project}/aggregated/sslPolicies", + "flatPath": "projects/{project}/aggregated/sslPolicies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" } - } - } - } - }, - "TargetHttpsProxiesSetSslCertificatesRequest": { - "id": "TargetHttpsProxiesSetSslCertificatesRequest", - "type": "object", - "properties": { - "sslCertificates": { - "description": "New set of SslCertificate resources to associate with this TargetHttpsProxy resource. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "TargetHttpsProxiesSetCertificateMapRequest": { - "id": "TargetHttpsProxiesSetCertificateMapRequest", - "type": "object", - "properties": { - "certificateMap": { - "description": "URL of the Certificate Map to associate with this TargetHttpsProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", - "type": "string" - } - } - }, - "SslPolicyReference": { - "id": "SslPolicyReference", - "type": "object", - "properties": { - "sslPolicy": { - "description": "URL of the SSL policy resource. Set this to empty string to clear any existing SSL policy associated with the target proxy resource.", - "type": "string" - } - } - }, - "TargetHttpsProxiesSetQuicOverrideRequest": { - "id": "TargetHttpsProxiesSetQuicOverrideRequest", - "type": "object", - "properties": { - "quicOverride": { - "description": "QUIC policy for the TargetHttpsProxy resource.", - "type": "string", - "enumDescriptions": [ - "The load balancer will not attempt to negotiate QUIC with clients.", - "The load balancer will attempt to negotiate QUIC with clients.", - "No overrides to the default QUIC policy. This option is implicit if no QUIC override has been specified in the request." + }, + "parameterOrder": [ + "project" ], - "enum": [ - "DISABLE", - "ENABLE", - "NONE" - ] - } - } - }, - "RegionTargetHttpsProxiesSetSslCertificatesRequest": { - "id": "RegionTargetHttpsProxiesSetSslCertificatesRequest", - "type": "object", - "properties": { - "sslCertificates": { - "description": "New set of SslCertificate resources to associate with this TargetHttpsProxy resource.", - "type": "array", - "items": { - "type": "string" - } + "response": { + "$ref": "SslPoliciesAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of all SslPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." } } }, - "TargetInstanceList": { - "id": "TargetInstanceList", - "description": "Contains a list of TargetInstance resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#targetInstanceList", - "type": "string" + "regionSslPolicies": { + "methods": { + "list": { + "id": "compute.regionSslPolicies.list", + "path": "projects/{project}/regions/{region}/sslPolicies", + "flatPath": "projects/{project}/regions/{region}/sslPolicies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "SslPoliciesList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all the SSL policies that have been configured for the specified project and region." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "get": { + "id": "compute.regionSslPolicies.get", + "path": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", + "flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "sslPolicy": { + "description": "Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "sslPolicy" + ], + "response": { + "$ref": "SslPolicy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all of the ordered rules present in a single specified policy." }, - "items": { - "description": "A list of TargetInstance resources.", - "type": "array", - "items": { - "$ref": "TargetInstance" - } + "insert": { + "id": "compute.regionSslPolicies.insert", + "path": "projects/{project}/regions/{region}/sslPolicies", + "flatPath": "projects/{project}/regions/{region}/sslPolicies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "SslPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a new policy in the specified project and region using the data included in the request." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "delete": { + "id": "compute.regionSslPolicies.delete", + "path": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", + "flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sslPolicy": { + "description": "Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "sslPolicy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified SSL policy. The SSL policy resource can be deleted only if it is not in use by any TargetHttpsProxy or TargetSslProxy resources." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "patch": { + "id": "compute.regionSslPolicies.patch", + "path": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", + "flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "sslPolicy": { + "description": "Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "sslPolicy" + ], + "request": { + "$ref": "SslPolicy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified SSL policy with the data included in the request." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "listAvailableFeatures": { + "id": "compute.regionSslPolicies.listAvailableFeatures", + "path": "projects/{project}/regions/{region}/sslPolicies/listAvailableFeatures", + "flatPath": "projects/{project}/regions/{region}/sslPolicies/listAvailableFeatures", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "TargetInstance": { - "id": "TargetInstance", - "description": "Represents a Target Instance resource. You can use a target instance to handle traffic for one or more forwarding rules, which is ideal for forwarding protocol traffic that is managed by a single source. For example, ESP, AH, TCP, or UDP. For more information, read Target instances.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] The type of the resource. Always compute#targetInstance for target instances.", - "default": "compute#targetInstance", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "zone": { - "description": "[Output Only] URL of the zone where the target instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "natPolicy": { - "description": "Must have a value of NO_NAT. Protocol forwarding delivers packets while preserving the destination IP address of the forwarding rule referencing the target instance.", - "type": "string", - "enumDescriptions": [ - "No NAT performed." + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "NO_NAT" - ] - }, - "instance": { - "description": "A URL to the virtual machine instance that handles traffic for this target instance. When creating a target instance, you can provide the fully-qualified URL or a valid partial URL to the desired virtual machine. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance ", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "network": { - "description": "The URL of the network this target instance uses to forward traffic. If not specified, the traffic will be forwarded to the network that the default network interface belongs to.", - "type": "string" - }, - "securityPolicy": { - "description": "[Output Only] The resource URL for the security policy associated with this target instance.", - "type": "string" + "response": { + "$ref": "SslPoliciesListAvailableFeaturesResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists all features that can be specified in the SSL policy when using custom profile." } } }, - "TargetInstanceAggregatedList": { - "id": "TargetInstanceAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#targetInstanceAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of TargetInstance resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of target instances.", - "$ref": "TargetInstancesScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "storagePoolTypes": { + "methods": { + "list": { + "id": "compute.storagePoolTypes.list", + "path": "projects/{project}/zones/{zone}/storagePoolTypes", + "flatPath": "projects/{project}/zones/{zone}/storagePoolTypes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "TargetInstancesScopedList": { - "id": "TargetInstancesScopedList", - "type": "object", - "properties": { - "targetInstances": { - "description": "A list of target instances contained in this scope.", - "type": "array", - "items": { - "$ref": "TargetInstance" - } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "StoragePoolTypeList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of storage pool types available to the specified project." }, - "warning": { - "description": "Informational warning which replaces the list of addresses when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "aggregatedList": { + "id": "compute.storagePoolTypes.aggregatedList", + "path": "projects/{project}/aggregated/storagePoolTypes", + "flatPath": "projects/{project}/aggregated/storagePoolTypes", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "StoragePoolTypeAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of storage pool types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + }, + "get": { + "id": "compute.storagePoolTypes.get", + "path": "projects/{project}/zones/{zone}/storagePoolTypes/{storagePoolType}", + "flatPath": "projects/{project}/zones/{zone}/storagePoolTypes/{storagePoolType}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "storagePoolType": { + "description": "Name of the storage pool type to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "zone", + "storagePoolType" + ], + "response": { + "$ref": "StoragePoolType" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified storage pool type." } } }, - "TargetPoolList": { - "id": "TargetPoolList", - "description": "Contains a list of TargetPool resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#targetPoolList for lists of target pools.", - "default": "compute#targetPoolList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of TargetPool resources.", - "type": "array", - "items": { - "$ref": "TargetPool" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "storagePools": { + "methods": { + "list": { + "id": "compute.storagePools.list", + "path": "projects/{project}/zones/{zone}/storagePools", + "flatPath": "projects/{project}/zones/{zone}/storagePools", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "TargetPool": { - "id": "TargetPool", - "description": "Represents a Target Pool resource. Target pools are used with external passthrough Network Load Balancers. A target pool references member instances, an associated legacy HttpHealthCheck resource, and, optionally, a backup target pool. For more information, read Using target pools.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#targetPool for target pools.", - "default": "compute#targetPool", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the target pool resides.", - "type": "string" - }, - "healthChecks": { - "description": "The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. Only legacy HttpHealthChecks are supported. Only one health check may be specified.", - "type": "array", - "items": { - "type": "string" - } - }, - "instances": { - "description": "A list of resource URLs to the virtual machine instances serving this pool. They must live in zones contained in the same region as this pool.", - "type": "array", - "items": { - "type": "string" - } - }, - "sessionAffinity": { - "description": "Session 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.", - "type": "string", - "enumDescriptions": [ - "2-tuple hash on packet's source and destination IP addresses. Connections from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy.", - "1-tuple hash only on packet's source IP address. Connections from the same source IP address will be served by the same backend VM while that VM remains healthy. This option can only be used for Internal TCP/UDP Load Balancing.", - "5-tuple hash on packet's source and destination IP addresses, IP protocol, and source and destination ports. Connections for the same IP protocol from the same source IP address and port to the same destination IP address and port will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing.", - "3-tuple hash on packet's source and destination IP addresses, and IP protocol. Connections for the same IP protocol from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing.", - "Hash based on a cookie generated by the L7 loadbalancer. Only valid for HTTP(S) load balancing.", - "The hash is based on a user specified header field.", - "The hash is based on a user provided cookie.", - "No session affinity. Connections from the same client IP may go to any instance in the pool." + }, + "parameterOrder": [ + "project", + "zone" ], - "enum": [ - "CLIENT_IP", - "CLIENT_IP_NO_DESTINATION", - "CLIENT_IP_PORT_PROTO", - "CLIENT_IP_PROTO", - "GENERATED_COOKIE", - "HEADER_FIELD", - "HTTP_COOKIE", - "NONE" - ] - }, - "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]. If 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. In 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.", - "type": "number", - "format": "float" - }, - "backupPool": { - "description": "The server-defined URL for the resource. 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]. backupPool 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. In 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" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "securityPolicy": { - "description": "[Output Only] The resource URL for the security policy associated with this target pool.", - "type": "string" - } - } - }, - "TargetPoolAggregatedList": { - "id": "TargetPoolAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#targetPoolAggregatedList for aggregated lists of target pools.", - "default": "compute#targetPoolAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of TargetPool resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of target pools.", - "$ref": "TargetPoolsScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "response": { + "$ref": "StoragePoolList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of storage pools contained within the specified zone." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "aggregatedList": { + "id": "compute.storagePools.aggregatedList", + "path": "projects/{project}/aggregated/storagePools", + "flatPath": "projects/{project}/aggregated/storagePools", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "StoragePoolAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of storage pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + }, + "get": { + "id": "compute.storagePools.get", + "path": "projects/{project}/zones/{zone}/storagePools/{storagePool}", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "storagePool": { + "description": "Name of the storage pool to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "TargetPoolsScopedList": { - "id": "TargetPoolsScopedList", - "type": "object", - "properties": { - "targetPools": { - "description": "A list of target pools contained in this scope.", - "type": "array", - "items": { - "$ref": "TargetPool" - } + }, + "parameterOrder": [ + "project", + "zone", + "storagePool" + ], + "response": { + "$ref": "StoragePool" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns a specified storage pool. Gets a list of available storage pools by making a list() request." }, - "warning": { - "description": "Informational warning which replaces the list of addresses when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.storagePools.insert", + "path": "projects/{project}/zones/{zone}/storagePools", + "flatPath": "projects/{project}/zones/{zone}/storagePools", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "TargetPoolInstanceHealth": { - "id": "TargetPoolInstanceHealth", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#targetPoolInstanceHealth when checking the health of an instance.", - "default": "compute#targetPoolInstanceHealth", - "type": "string" - }, - "healthStatus": { - "type": "array", - "items": { - "$ref": "HealthStatus" - } - } - } - }, - "TargetPoolsAddHealthCheckRequest": { - "id": "TargetPoolsAddHealthCheckRequest", - "type": "object", - "properties": { - "healthChecks": { - "description": "The HttpHealthCheck to add to the target pool.", - "type": "array", - "items": { - "$ref": "HealthCheckReference" - } - } - } - }, - "TargetPoolsRemoveHealthCheckRequest": { - "id": "TargetPoolsRemoveHealthCheckRequest", - "type": "object", - "properties": { - "healthChecks": { - "description": "Health check URL to be removed. This can be a full or valid partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project /global/httpHealthChecks/health-check - projects/project/global/httpHealthChecks/health-check - global/httpHealthChecks/health-check ", - "type": "array", - "items": { - "$ref": "HealthCheckReference" - } - } - } - }, - "TargetPoolsAddInstanceRequest": { - "id": "TargetPoolsAddInstanceRequest", - "type": "object", - "properties": { - "instances": { - "description": "A full or partial URL to an instance to add to this target pool. This can be a full or partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone /instances/instance-name - projects/project-id/zones/zone/instances/instance-name - zones/zone/instances/instance-name ", - "type": "array", - "items": { - "$ref": "InstanceReference" - } - } - } - }, - "TargetPoolsRemoveInstanceRequest": { - "id": "TargetPoolsRemoveInstanceRequest", - "type": "object", - "properties": { - "instances": { - "description": "URLs of the instances to be removed from target pool.", - "type": "array", - "items": { - "$ref": "InstanceReference" - } - } - } - }, - "TargetSslProxyList": { - "id": "TargetSslProxyList", - "description": "Contains a list of TargetSslProxy resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#targetSslProxyList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of TargetSslProxy resources.", - "type": "array", - "items": { - "$ref": "TargetSslProxy" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { + "$ref": "StoragePool" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a storage pool in the specified project using the data in the request." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "delete": { + "id": "compute.storagePools.delete", + "path": "projects/{project}/zones/{zone}/storagePools/{storagePool}", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "storagePool": { + "description": "Name of the storage pool to delete.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "storagePool" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified storage pool. Deleting a storagePool removes its data permanently and is irreversible. However, deleting a storagePool does not delete any snapshots previously made from the storagePool. You must separately delete snapshots." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getIamPolicy": { + "id": "compute.storagePools.getIamPolicy", + "path": "projects/{project}/zones/{zone}/storagePools/{resource}/getIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + }, + "setIamPolicy": { + "id": "compute.storagePools.setIamPolicy", + "path": "projects/{project}/zones/{zone}/storagePools/{resource}/setIamPolicy", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "TargetSslProxy": { - "id": "TargetSslProxy", - "description": "Represents a Target SSL Proxy resource. A target SSL proxy is a component of a Proxy Network Load Balancer. The forwarding rule references the target SSL proxy, and the target proxy then references a backend service. For more information, read Proxy Network Load Balancer overview.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#targetSslProxy for target SSL proxies.", - "default": "compute#targetSslProxy", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "service": { - "description": "URL to the BackendService resource.", - "type": "string" - }, - "sslCertificates": { - "description": "URLs to SslCertificate resources that are used to authenticate connections to Backends. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. sslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED.", - "type": "array", - "items": { - "type": "string" - } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "request": { + "$ref": "ZoneSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "certificateMap": { - "description": "URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", - "type": "string" + "testIamPermissions": { + "id": "compute.storagePools.testIamPermissions", + "path": "projects/{project}/zones/{zone}/storagePools/{resource}/testIamPermissions", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." }, - "proxyHeader": { - "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", - "type": "string", - "enumDescriptions": [ - "", - "" + "update": { + "id": "compute.storagePools.update", + "path": "projects/{project}/zones/{zone}/storagePools/{storagePool}", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "storagePool": { + "description": "The storagePool name for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "update_mask indicates fields to be updated as part of this request.", + "location": "query", + "type": "string", + "format": "google-fieldmask" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "storagePool" ], - "enum": [ - "NONE", - "PROXY_V1" - ] + "request": { + "$ref": "StoragePool" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput." }, - "sslPolicy": { - "description": "URL of SslPolicy resource that will be associated with the TargetSslProxy resource. If not set, the TargetSslProxy resource will not have any SSL policy configured.", - "type": "string" - } - } - }, - "TargetSslProxiesSetBackendServiceRequest": { - "id": "TargetSslProxiesSetBackendServiceRequest", - "type": "object", - "properties": { - "service": { - "description": "The URL of the new BackendService resource for the targetSslProxy.", - "type": "string" - } - } - }, - "TargetSslProxiesSetSslCertificatesRequest": { - "id": "TargetSslProxiesSetSslCertificatesRequest", - "type": "object", - "properties": { - "sslCertificates": { - "description": "New set of URLs to SslCertificate resources to associate with this TargetSslProxy. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "TargetSslProxiesSetCertificateMapRequest": { - "id": "TargetSslProxiesSetCertificateMapRequest", - "type": "object", - "properties": { - "certificateMap": { - "description": "URL of the Certificate Map to associate with this TargetSslProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", - "type": "string" - } - } - }, - "TargetSslProxiesSetProxyHeaderRequest": { - "id": "TargetSslProxiesSetProxyHeaderRequest", - "type": "object", - "properties": { - "proxyHeader": { - "description": "The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + "listDisks": { + "id": "compute.storagePools.listDisks", + "path": "projects/{project}/zones/{zone}/storagePools/{storagePool}/listDisks", + "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}/listDisks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "storagePool": { + "description": "Name of the storage pool to list disks of.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "The name of the zone for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "storagePool" ], - "enum": [ - "NONE", - "PROXY_V1" - ] + "response": { + "$ref": "StoragePoolListDisks" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the disks in a specified storage pool." } } }, - "TargetTcpProxyList": { - "id": "TargetTcpProxyList", - "description": "Contains a list of TargetTcpProxy resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#targetTcpProxyList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of TargetTcpProxy resources.", - "type": "array", - "items": { - "$ref": "TargetTcpProxy" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "subnetworks": { + "methods": { + "list": { + "id": "compute.subnetworks.list", + "path": "projects/{project}/regions/{region}/subnetworks", + "flatPath": "projects/{project}/regions/{region}/subnetworks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } - } - } - }, - "TargetTcpProxy": { - "id": "TargetTcpProxy", - "description": "Represents a Target TCP Proxy resource. A target TCP proxy is a component of a Proxy Network Load Balancer. The forwarding rule references the target TCP proxy, and the target proxy then references a backend service. For more information, read Proxy Network Load Balancer overview.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#targetTcpProxy for target TCP proxies.", - "default": "compute#targetTcpProxy", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "service": { - "description": "URL to the BackendService resource.", - "type": "string" - }, - "proxyHeader": { - "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", - "type": "string", - "enumDescriptions": [ - "", - "" + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "NONE", - "PROXY_V1" - ] - }, - "proxyBind": { - "description": "This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false.", - "type": "boolean" + "response": { + "$ref": "SubnetworkList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of subnetworks available to the specified project." }, - "region": { - "description": "[Output Only] URL of the region where the regional TCP proxy resides. This field is not applicable to global TCP proxy.", - "type": "string" - } - } - }, - "TargetTcpProxyAggregatedList": { - "id": "TargetTcpProxyAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#targetTcpProxyAggregatedList for lists of Target TCP Proxies.", - "default": "compute#targetTcpProxyAggregatedList", - "type": "string" + "aggregatedList": { + "id": "compute.subnetworks.aggregatedList", + "path": "projects/{project}/aggregated/subnetworks", + "flatPath": "projects/{project}/aggregated/subnetworks", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "SubnetworkAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of subnetworks. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "listUsable": { + "id": "compute.subnetworks.listUsable", + "path": "projects/{project}/aggregated/subnetworks/listUsable", + "flatPath": "projects/{project}/aggregated/subnetworks/listUsable", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "UsableSubnetworksAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of all usable subnetworks in the project." }, - "items": { - "description": "A list of TargetTcpProxiesScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of TargetTcpProxies.", - "$ref": "TargetTcpProxiesScopedList" - } + "get": { + "id": "compute.subnetworks.get", + "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "subnetwork": { + "description": "Name of the Subnetwork resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "subnetwork" + ], + "response": { + "$ref": "Subnetwork" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified subnetwork." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "insert": { + "id": "compute.subnetworks.insert", + "path": "projects/{project}/regions/{region}/subnetworks", + "flatPath": "projects/{project}/regions/{region}/subnetworks", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "Subnetwork" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a subnetwork in the specified project using the data included in the request." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "delete": { + "id": "compute.subnetworks.delete", + "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "subnetwork": { + "description": "Name of the Subnetwork resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "subnetwork" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified subnetwork." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "expandIpCidrRange": { + "id": "compute.subnetworks.expandIpCidrRange", + "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/expandIpCidrRange", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/expandIpCidrRange", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "subnetwork": { + "description": "Name of the Subnetwork resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "subnetwork" + ], + "request": { + "$ref": "SubnetworksExpandIpCidrRangeRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Expands the IP CIDR range of the subnetwork to a specified value." + }, + "patch": { + "id": "compute.subnetworks.patch", + "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", + "httpMethod": "PATCH", + "parameters": { + "drainTimeoutSeconds": { + "description": "The drain timeout specifies the upper bound in seconds on the amount of time allowed to drain connections from the current ACTIVE subnetwork to the current BACKUP subnetwork. The drain timeout is only applicable when the following conditions are true: - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER - the subnetwork being patched has role = BACKUP - the patch request is setting the role to ACTIVE. Note that after this patch operation the roles of the ACTIVE and BACKUP subnetworks will be swapped.", + "location": "query", + "type": "integer", + "format": "int32" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "subnetwork": { + "description": "Name of the Subnetwork resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "TargetTcpProxiesScopedList": { - "id": "TargetTcpProxiesScopedList", - "type": "object", - "properties": { - "targetTcpProxies": { - "description": "A list of TargetTcpProxies contained in this scope.", - "type": "array", - "items": { - "$ref": "TargetTcpProxy" - } + }, + "parameterOrder": [ + "project", + "region", + "subnetwork" + ], + "request": { + "$ref": "Subnetwork" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified subnetwork with the data included in the request. Only certain fields can be updated with a patch request as indicated in the field descriptions. You must specify the current fingerprint of the subnetwork resource being patched." }, - "warning": { - "description": "Informational warning which replaces the list of backend services when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "getIamPolicy": { + "id": "compute.subnetworks.getIamPolicy", + "path": "projects/{project}/regions/{region}/subnetworks/{resource}/getIamPolicy", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/getIamPolicy", + "httpMethod": "GET", + "parameters": { + "optionsRequestedPolicyVersion": { + "description": "Requested IAM Policy version.", + "location": "query", + "type": "integer", + "format": "int32" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "TargetTcpProxiesSetBackendServiceRequest": { - "id": "TargetTcpProxiesSetBackendServiceRequest", - "type": "object", - "properties": { - "service": { - "description": "The URL of the new BackendService resource for the targetTcpProxy.", - "type": "string" - } - } - }, - "TargetTcpProxiesSetProxyHeaderRequest": { - "id": "TargetTcpProxiesSetProxyHeaderRequest", - "type": "object", - "properties": { - "proxyHeader": { - "description": "The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed.", - "type": "string", - "enumDescriptions": [ - "", - "" + }, + "parameterOrder": [ + "project", + "region", + "resource" ], - "enum": [ - "NONE", - "PROXY_V1" - ] - } - } - }, - "TargetVpnGatewayList": { - "id": "TargetVpnGatewayList", - "description": "Contains a list of TargetVpnGateway resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways.", - "default": "compute#targetVpnGatewayList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of TargetVpnGateway resources.", - "type": "array", - "items": { - "$ref": "TargetVpnGateway" - } + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "setIamPolicy": { + "id": "compute.subnetworks.setIamPolicy", + "path": "projects/{project}/regions/{region}/subnetworks/{resource}/setIamPolicy", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/setIamPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetPolicyRequest" + }, + "response": { + "$ref": "Policy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "testIamPermissions": { + "id": "compute.subnetworks.testIamPermissions", + "path": "projects/{project}/regions/{region}/subnetworks/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setPrivateIpGoogleAccess": { + "id": "compute.subnetworks.setPrivateIpGoogleAccess", + "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/setPrivateIpGoogleAccess", + "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/setPrivateIpGoogleAccess", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "subnetwork": { + "description": "Name of the Subnetwork resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "TargetVpnGateway": { - "id": "TargetVpnGateway", - "description": "Represents a Target VPN Gateway resource. The target VPN gateway resource represents a Classic Cloud VPN gateway. For more information, read the the Cloud VPN Overview.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways.", - "default": "compute#targetVpnGateway", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.targetVpnGateways.insert" - ] }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the target VPN gateway resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - }, - "network": { - "description": "URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created.", - "annotations": { - "required": [ - "compute.targetVpnGateways.insert" - ] + "parameterOrder": [ + "project", + "region", + "subnetwork" + ], + "request": { + "$ref": "SubnetworksSetPrivateIpGoogleAccessRequest" }, - "type": "string" - }, - "tunnels": { - "description": "[Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are created using the compute.vpntunnels.insert method and associated with a VPN gateway.", - "type": "array", - "items": { - "type": "string" - } - }, - "status": { - "description": "[Output Only] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING.", - "type": "string", - "enumDescriptions": [ - "", - "", - "", - "" + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "CREATING", - "DELETING", - "FAILED", - "READY" - ] - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "forwardingRules": { - "description": "[Output Only] A list of URLs to the ForwardingRule resources. ForwardingRules are created using compute.forwardingRules.insert and associated with a VPN gateway.", - "type": "array", - "items": { - "type": "string" - } - }, - "labels": { - "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this TargetVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a TargetVpnGateway.", - "type": "string", - "format": "byte" + "description": "Set whether VMs in this subnet can access Google services without assigning external IP addresses through Private Google Access." } } }, - "TargetVpnGatewayAggregatedList": { - "id": "TargetVpnGatewayAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways.", - "default": "compute#targetVpnGatewayAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of TargetVpnGateway resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of target VPN gateways.", - "$ref": "TargetVpnGatewaysScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" - }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "targetGrpcProxies": { + "methods": { + "list": { + "id": "compute.targetGrpcProxies.list", + "path": "projects/{project}/global/targetGrpcProxies", + "flatPath": "projects/{project}/global/targetGrpcProxies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" } - } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "TargetGrpcProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Lists the TargetGrpcProxies for a project in the given scope." }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "TargetVpnGatewaysScopedList": { - "id": "TargetVpnGatewaysScopedList", - "type": "object", - "properties": { - "targetVpnGateways": { - "description": "[Output Only] A list of target VPN gateways contained in this scope.", - "type": "array", - "items": { - "$ref": "TargetVpnGateway" - } + "get": { + "id": "compute.targetGrpcProxies.get", + "path": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", + "flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "targetGrpcProxy": { + "description": "Name of the TargetGrpcProxy resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetGrpcProxy" + ], + "response": { + "$ref": "TargetGrpcProxy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified TargetGrpcProxy resource in the given scope." }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of addresses when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "insert": { + "id": "compute.targetGrpcProxies.insert", + "path": "projects/{project}/global/targetGrpcProxies", + "flatPath": "projects/{project}/global/targetGrpcProxies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "TargetGrpcProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a TargetGrpcProxy in the specified project in the given scope using the parameters that are included in the request." + }, + "delete": { + "id": "compute.targetGrpcProxies.delete", + "path": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", + "flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "targetGrpcProxy": { + "description": "Name of the TargetGrpcProxy resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } + }, + "parameterOrder": [ + "project", + "targetGrpcProxy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified TargetGrpcProxy in the given scope" + }, + "patch": { + "id": "compute.targetGrpcProxies.patch", + "path": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", + "flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetGrpcProxy": { + "description": "Name of the TargetGrpcProxy resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetGrpcProxy" + ], + "request": { + "$ref": "TargetGrpcProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified TargetGrpcProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." } } }, - "UrlMapList": { - "id": "UrlMapList", - "description": "Contains a list of UrlMap resources.", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#urlMapList", - "type": "string" + "targetHttpProxies": { + "methods": { + "list": { + "id": "compute.targetHttpProxies.list", + "path": "projects/{project}/global/targetHttpProxies", + "flatPath": "projects/{project}/global/targetHttpProxies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "TargetHttpProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of TargetHttpProxy resources available to the specified project." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "get": { + "id": "compute.targetHttpProxies.get", + "path": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", + "flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpProxy" + ], + "response": { + "$ref": "TargetHttpProxy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified TargetHttpProxy resource." }, - "items": { - "description": "A list of UrlMap resources.", - "type": "array", - "items": { - "$ref": "UrlMap" - } + "insert": { + "id": "compute.targetHttpProxies.insert", + "path": "projects/{project}/global/targetHttpProxies", + "flatPath": "projects/{project}/global/targetHttpProxies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "TargetHttpProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a TargetHttpProxy resource in the specified project using the data included in the request." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "delete": { + "id": "compute.targetHttpProxies.delete", + "path": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", + "flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpProxy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified TargetHttpProxy resource." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "patch": { + "id": "compute.targetHttpProxies.patch", + "path": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", + "flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpProxy" + ], + "request": { + "$ref": "TargetHttpProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified TargetHttpProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setUrlMap": { + "id": "compute.targetHttpProxies.setUrlMap", + "path": "projects/{project}/targetHttpProxies/{targetHttpProxy}/setUrlMap", + "flatPath": "projects/{project}/targetHttpProxies/{targetHttpProxy}/setUrlMap", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy to set a URL map for.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpProxy" + ], + "request": { + "$ref": "UrlMapReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the URL map for TargetHttpProxy." + }, + "aggregatedList": { + "id": "compute.targetHttpProxies.aggregatedList", + "path": "projects/{project}/aggregated/targetHttpProxies", + "flatPath": "projects/{project}/aggregated/targetHttpProxies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" } - } - } - } - }, - "UrlMap": { - "id": "UrlMap", - "description": "Represents a URL Map resource. Compute Engine has two URL Map resources: * [Global](/compute/docs/reference/rest/v1/urlMaps) * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps) A URL map resource is a component of certain types of cloud load balancers and Traffic Director: * urlMaps are used by global external Application Load Balancers, classic Application Load Balancers, and cross-region internal Application Load Balancers. * regionUrlMaps are used by internal Application Load Balancers, regional external Application Load Balancers and regional internal Application Load Balancers. For a list of supported URL map features by the load balancer type, see the Load balancing features: Routing and traffic management table. For a list of supported URL map features for Traffic Director, see the Traffic Director features: Routing and traffic management table. This resource defines mappings from hostnames and URL paths to either a backend service or a backend bucket. To use the global urlMaps resource, the backend service must have a loadBalancingScheme of either EXTERNAL or INTERNAL_SELF_MANAGED. To use the regionUrlMaps resource, the backend service must have a loadBalancingScheme of INTERNAL_MANAGED. For more information, read URL Map Concepts.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of the resource. Always compute#urlMaps for url maps.", - "default": "compute#urlMap", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "hostRules": { - "description": "The list of host rules to use against the URL.", - "type": "array", - "items": { - "$ref": "HostRule" - } - }, - "pathMatchers": { - "description": "The list of named PathMatchers to use against the URL.", - "type": "array", - "items": { - "$ref": "PathMatcher" - } - }, - "tests": { - "description": "The list of expected URL mapping tests. Request to update the UrlMap succeeds only if all test cases pass. You can specify a maximum of 100 tests per UrlMap. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", - "type": "array", - "items": { - "$ref": "UrlMapTest" - } - }, - "defaultService": { - "description": "The full or partial URL of the defaultService resource to which traffic is directed if none of the hostRules match. If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. However, if defaultService is specified, defaultRouteAction cannot contain any defaultRouteAction.weightedBackendServices. Conversely, if defaultRouteAction specifies any defaultRouteAction.weightedBackendServices, defaultService must not be specified. If defaultService is specified, then set either defaultUrlRedirect , or defaultRouteAction.weightedBackendService Don't set both. defaultService has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", - "type": "string" - }, - "defaultRouteAction": { - "description": "defaultRouteAction takes effect when none of the hostRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If defaultRouteAction specifies any weightedBackendServices, defaultService must not be set. Conversely if defaultService is set, defaultRouteAction cannot contain any weightedBackendServices. Only one of defaultRouteAction or defaultUrlRedirect must be set. URL maps for classic Application Load Balancers only support the urlRewrite action within defaultRouteAction. defaultRouteAction has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", - "$ref": "HttpRouteAction" - }, - "defaultUrlRedirect": { - "description": "When none of the specified hostRules match, the request is redirected to a URL specified by defaultUrlRedirect. If defaultUrlRedirect is specified, defaultService or defaultRouteAction must not be set. Not supported when the URL map is bound to a target gRPC proxy.", - "$ref": "HttpRedirectAction" - }, - "headerAction": { - "description": "Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction specified here take effect after headerAction specified under pathMatcher. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", - "$ref": "HttpHeaderAction" - }, - "defaultCustomErrorResponsePolicy": { - "description": "defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the load balancer level and applies only when no policy has been defined for the error code at lower levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a UrlMap with the following configuration: - defaultCustomErrorResponsePolicy containing policies for responding to 5xx and 4xx errors - A PathMatcher configured for *.example.com has defaultCustomErrorResponsePolicy for 4xx. If a request for http://www.example.com/ encounters a 404, the policy in pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the request for http://www.example.com/ encounters a 502, the policy in UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request that does not match any host in *.example.com such as http://www.myotherexample.com/, encounters a 404, UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers.", - "$ref": "CustomErrorResponsePolicy" - }, - "fingerprint": { - "description": "Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field is ignored when inserting a UrlMap. An up-to-date fingerprint must be provided in order to update the UrlMap, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a UrlMap.", - "type": "string", - "format": "byte" - }, - "region": { - "description": "[Output Only] URL of the region where the regional URL map resides. This field is not applicable to global URL maps. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", - "type": "string" - } - } - }, - "HostRule": { - "id": "HostRule", - "description": "UrlMaps A host-matching rule for a URL. If matched, will use the named PathMatcher to select the BackendService.", - "type": "object", - "properties": { - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "hosts": { - "description": "The list of host patterns to match. They must be valid hostnames with optional port numbers in the format host:port. * matches any string of ([a-z0-9-.]*). In that case, * must be the first character, and if followed by anything, the immediate following character must be either - or .. * based matching is not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", - "type": "array", - "items": { - "type": "string" - } - }, - "pathMatcher": { - "description": "The name of the PathMatcher to use to match the path portion of the URL if the hostRule matches the URL's host portion.", - "type": "string" + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "TargetHttpProxyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of all TargetHttpProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." } } }, - "PathMatcher": { - "id": "PathMatcher", - "description": "A matcher for the path portion of the URL. The BackendService from the longest-matched rule will serve the URL. If no rule was matched, the default service is used.", - "type": "object", - "properties": { - "name": { - "description": "The name to which this PathMatcher is referred by the HostRule.", - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "defaultService": { - "description": "The full or partial URL to the BackendService resource. This URL is used if none of the pathRules or routeRules defined by this PathMatcher are matched. For example, the following are all valid URLs to a BackendService resource: - https://www.googleapis.com/compute/v1/projects/project /global/backendServices/backendService - compute/v1/projects/project/global/backendServices/backendService - global/backendServices/backendService If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. However, if defaultService is specified, defaultRouteAction cannot contain any weightedBackendServices. Conversely, if defaultRouteAction specifies any weightedBackendServices, defaultService must not be specified. If defaultService is specified, then set either defaultUrlRedirect or defaultRouteAction.weightedBackendService. Don't set both. Authorization requires one or more of the following Google IAM permissions on the specified resource default_service: - compute.backendBuckets.use - compute.backendServices.use ", - "type": "string" - }, - "defaultRouteAction": { - "description": "defaultRouteAction takes effect when none of the pathRules or routeRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If defaultRouteAction specifies any weightedBackendServices, defaultService must not be set. Conversely if defaultService is set, defaultRouteAction cannot contain any weightedBackendServices. If defaultRouteAction is specified, don't set defaultUrlRedirect. If defaultRouteAction.weightedBackendServices is specified, don't set defaultService. URL maps for classic Application Load Balancers only support the urlRewrite action within a path matcher's defaultRouteAction.", - "$ref": "HttpRouteAction" - }, - "defaultUrlRedirect": { - "description": "When none of the specified pathRules or routeRules match, the request is redirected to a URL specified by defaultUrlRedirect. If defaultUrlRedirect is specified, then set either defaultService or defaultRouteAction. Don't set both. Not supported when the URL map is bound to a target gRPC proxy.", - "$ref": "HttpRedirectAction" + "regionTargetHttpProxies": { + "methods": { + "list": { + "id": "compute.regionTargetHttpProxies.list", + "path": "projects/{project}/regions/{region}/targetHttpProxies", + "flatPath": "projects/{project}/regions/{region}/targetHttpProxies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "TargetHttpProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of TargetHttpProxy resources available to the specified project in the specified region." }, - "pathRules": { - "description": "The list of path rules. Use this list instead of routeRules when routing based on simple path matching is all that's required. The order by which path rules are specified does not matter. Matches are always done on the longest-path-first basis. For example: a pathRule with a path /a/b/c/* will match before /a/b/* irrespective of the order in which those paths appear in this list. Within a given pathMatcher, only one of pathRules or routeRules must be set.", - "type": "array", - "items": { - "$ref": "PathRule" - } + "get": { + "id": "compute.regionTargetHttpProxies.get", + "path": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", + "flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetHttpProxy" + ], + "response": { + "$ref": "TargetHttpProxy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified TargetHttpProxy resource in the specified region." }, - "routeRules": { - "description": "The list of HTTP route rules. Use this list instead of pathRules when advanced route matching and routing actions are desired. routeRules are evaluated in order of priority, from the lowest to highest number. Within a given pathMatcher, you can set only one of pathRules or routeRules.", - "type": "array", - "items": { - "$ref": "HttpRouteRule" - } + "insert": { + "id": "compute.regionTargetHttpProxies.insert", + "path": "projects/{project}/regions/{region}/targetHttpProxies", + "flatPath": "projects/{project}/regions/{region}/targetHttpProxies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "TargetHttpProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a TargetHttpProxy resource in the specified project and region using the data included in the request." }, - "headerAction": { - "description": "Specifies changes to request and response headers that need to take effect for the selected backend service. HeaderAction specified here are applied after the matching HttpRouteRule HeaderAction and before the HeaderAction in the UrlMap HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", - "$ref": "HttpHeaderAction" + "delete": { + "id": "compute.regionTargetHttpProxies.delete", + "path": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", + "flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetHttpProxy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified TargetHttpProxy resource." }, - "defaultCustomErrorResponsePolicy": { - "description": "defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the PathMatcher level and applies only when no policy has been defined for the error code at lower levels like RouteRule and PathRule within this PathMatcher. If an error code does not have a policy defined in defaultCustomErrorResponsePolicy, then a policy defined for the error code in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy is configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with pathMatcher.defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers.", - "$ref": "CustomErrorResponsePolicy" + "setUrlMap": { + "id": "compute.regionTargetHttpProxies.setUrlMap", + "path": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}/setUrlMap", + "flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}/setUrlMap", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpProxy": { + "description": "Name of the TargetHttpProxy to set a URL map for.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetHttpProxy" + ], + "request": { + "$ref": "UrlMapReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the URL map for TargetHttpProxy." } } }, - "HttpRouteAction": { - "id": "HttpRouteAction", - "type": "object", - "properties": { - "weightedBackendServices": { - "description": "A list of weighted backend services to send traffic to when a route match occurs. The weights determine the fraction of traffic that flows to their corresponding backend service. If all traffic needs to go to a single backend service, there must be one weightedBackendService with weight set to a non-zero number. After a backend service is identified and before forwarding the request to the backend service, advanced routing actions such as URL rewrites and header transformations are applied depending on additional settings specified in this HttpRouteAction.", - "type": "array", - "items": { - "$ref": "WeightedBackendService" - } - }, - "urlRewrite": { - "description": "The spec to modify the URL of the request, before forwarding the request to the matched service. urlRewrite is the only action supported in UrlMaps for classic Application Load Balancers. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", - "$ref": "UrlRewrite" - }, - "timeout": { - "description": "Specifies the timeout for the selected route. Timeout is computed from the time the request has been fully processed (known as *end-of-stream*) up until the response has been processed. Timeout includes all retries. If not specified, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", - "$ref": "Duration" + "targetHttpsProxies": { + "methods": { + "list": { + "id": "compute.targetHttpsProxies.list", + "path": "projects/{project}/global/targetHttpsProxies", + "flatPath": "projects/{project}/global/targetHttpsProxies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "TargetHttpsProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of TargetHttpsProxy resources available to the specified project." }, - "retryPolicy": { - "description": "Specifies the retry policy associated with this route.", - "$ref": "HttpRetryPolicy" + "aggregatedList": { + "id": "compute.targetHttpsProxies.aggregatedList", + "path": "projects/{project}/aggregated/targetHttpsProxies", + "flatPath": "projects/{project}/aggregated/targetHttpsProxies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "TargetHttpsProxyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of all TargetHttpsProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "requestMirrorPolicy": { - "description": "Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer does not wait for responses from the shadow service. Before sending traffic to the shadow service, the host / authority header is suffixed with -shadow. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", - "$ref": "RequestMirrorPolicy" + "get": { + "id": "compute.targetHttpsProxies.get", + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "response": { + "$ref": "TargetHttpsProxy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified TargetHttpsProxy resource." }, - "corsPolicy": { - "description": "The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard. Not supported when the URL map is bound to a target gRPC proxy.", - "$ref": "CorsPolicy" + "insert": { + "id": "compute.targetHttpsProxies.insert", + "path": "projects/{project}/global/targetHttpsProxies", + "flatPath": "projects/{project}/global/targetHttpsProxies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "TargetHttpsProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a TargetHttpsProxy resource in the specified project using the data included in the request." }, - "faultInjectionPolicy": { - "description": "The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by a load balancer on a percentage of requests before sending those requests to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests. timeout and retry_policy is ignored by clients that are configured with a fault_injection_policy if: 1. The traffic is generated by fault injection AND 2. The fault injection is not a delay fault injection. Fault injection is not supported with the classic Application Load Balancer . To see which load balancers support fault injection, see Load balancing: Routing and traffic management features.", - "$ref": "HttpFaultInjection" + "patch": { + "id": "compute.targetHttpsProxies.patch", + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "request": { + "$ref": "TargetHttpsProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified TargetHttpsProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." }, - "maxStreamDuration": { - "description": "Specifies the maximum duration (timeout) for streams on the selected route. Unlike the timeout field where the timeout duration starts from the time the request has been fully processed (known as *end-of-stream*), the duration in this field is computed from the beginning of the stream until the response has been processed, including all retries. A stream that does not complete in this duration is closed. If not specified, this field uses the maximum maxStreamDuration value among all backend services associated with the route. This field is only allowed if the Url map is used with backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED.", - "$ref": "Duration" - } - } - }, - "WeightedBackendService": { - "id": "WeightedBackendService", - "description": "In contrast to a single BackendService in HttpRouteAction to which all matching traffic is directed to, WeightedBackendService allows traffic to be split across multiple backend services. The volume of traffic for each backend service is proportional to the weight specified in each WeightedBackendService", - "type": "object", - "properties": { - "backendService": { - "description": "The full or partial URL to the default BackendService resource. Before forwarding the request to backendService, the load balancer applies any relevant headerActions specified as part of this backendServiceWeight.", - "type": "string" + "delete": { + "id": "compute.targetHttpsProxies.delete", + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified TargetHttpsProxy resource." }, - "weight": { - "description": "Specifies the fraction of traffic sent to a backend service, computed as weight / (sum of all weightedBackendService weights in routeAction) . The selection of a backend service is determined only for new traffic. Once a user's request has been directed to a backend service, subsequent requests are sent to the same backend service as determined by the backend service's session affinity policy. Don't configure session affinity if you're using weighted traffic splitting. If you do, the weighted traffic splitting configuration takes precedence. The value must be from 0 to 1000.", - "type": "integer", - "format": "uint32" + "setUrlMap": { + "id": "compute.targetHttpsProxies.setUrlMap", + "path": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", + "flatPath": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource whose URL map is to be set.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "request": { + "$ref": "UrlMapReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the URL map for TargetHttpsProxy." }, - "headerAction": { - "description": "Specifies changes to request and response headers that need to take effect for the selected backendService. headerAction specified here take effect before headerAction in the enclosing HttpRouteRule, PathMatcher and UrlMap. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", - "$ref": "HttpHeaderAction" - } - } - }, - "HttpHeaderAction": { - "id": "HttpHeaderAction", - "description": "The request and response header transformations that take effect before the request is passed along to the selected backendService.", - "type": "object", - "properties": { - "requestHeadersToRemove": { - "description": "A list of header names for headers that need to be removed from the request before forwarding the request to the backendService.", - "type": "array", - "items": { - "type": "string" - } + "setSslCertificates": { + "id": "compute.targetHttpsProxies.setSslCertificates", + "path": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", + "flatPath": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to set an SslCertificates resource for.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "request": { + "$ref": "TargetHttpsProxiesSetSslCertificatesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Replaces SslCertificates for TargetHttpsProxy." }, - "requestHeadersToAdd": { - "description": "Headers to add to a matching request before forwarding the request to the backendService.", - "type": "array", - "items": { - "$ref": "HttpHeaderOption" - } + "setCertificateMap": { + "id": "compute.targetHttpsProxies.setCertificateMap", + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setCertificateMap", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setCertificateMap", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "request": { + "$ref": "TargetHttpsProxiesSetCertificateMapRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the Certificate Map for TargetHttpsProxy." }, - "responseHeadersToRemove": { - "description": "A list of header names for headers that need to be removed from the response before sending the response back to the client.", - "type": "array", - "items": { - "type": "string" - } + "setSslPolicy": { + "id": "compute.targetHttpsProxies.setSslPolicy", + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setSslPolicy", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setSslPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "request": { + "$ref": "SslPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the SSL policy for TargetHttpsProxy. The SSL policy specifies the server-side support for SSL features. This affects connections between clients and the HTTPS proxy load balancer. They do not affect the connection between the load balancer and the backends." }, - "responseHeadersToAdd": { - "description": "Headers to add the response before sending the response back to the client.", - "type": "array", - "items": { - "$ref": "HttpHeaderOption" - } + "setQuicOverride": { + "id": "compute.targetHttpsProxies.setQuicOverride", + "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setQuicOverride", + "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setQuicOverride", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to set the QUIC override policy for. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetHttpsProxy" + ], + "request": { + "$ref": "TargetHttpsProxiesSetQuicOverrideRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the QUIC override policy for TargetHttpsProxy." } } }, - "HttpHeaderOption": { - "id": "HttpHeaderOption", - "description": "Specification determining how headers are added to requests or responses.", - "type": "object", - "properties": { - "headerName": { - "description": "The name of the header.", - "type": "string" + "regionTargetHttpsProxies": { + "methods": { + "list": { + "id": "compute.regionTargetHttpsProxies.list", + "path": "projects/{project}/regions/{region}/targetHttpsProxies", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "TargetHttpsProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of TargetHttpsProxy resources available to the specified project in the specified region." }, - "headerValue": { - "description": "The value of the header to add.", - "type": "string" + "get": { + "id": "compute.regionTargetHttpsProxies.get", + "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetHttpsProxy" + ], + "response": { + "$ref": "TargetHttpsProxy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified TargetHttpsProxy resource in the specified region." }, - "replace": { - "description": "If false, headerValue is appended to any values that already exist for the header. If true, headerValue is set for the header, discarding any values that were set for that header. The default value is false. ", - "type": "boolean" - } - } - }, - "UrlRewrite": { - "id": "UrlRewrite", - "description": "The spec for modifying the path before sending the request to the matched backend service.", - "type": "object", - "properties": { - "pathPrefixRewrite": { - "description": "Before forwarding the request to the selected backend service, the matching portion of the request's path is replaced by pathPrefixRewrite. The value must be from 1 to 1024 characters.", - "type": "string" + "insert": { + "id": "compute.regionTargetHttpsProxies.insert", + "path": "projects/{project}/regions/{region}/targetHttpsProxies", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "TargetHttpsProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a TargetHttpsProxy resource in the specified project and region using the data included in the request." }, - "hostRewrite": { - "description": "Before forwarding the request to the selected service, the request's host header is replaced with contents of hostRewrite. The value must be from 1 to 255 characters.", - "type": "string" + "delete": { + "id": "compute.regionTargetHttpsProxies.delete", + "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetHttpsProxy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified TargetHttpsProxy resource." }, - "pathTemplateRewrite": { - "description": " If specified, the pattern rewrites the URL path (based on the :path header) using the HTTP template syntax. A corresponding path_template_match must be specified. Any template variables must exist in the path_template_match field. - -At least one variable must be specified in the path_template_match field - You can omit variables from the rewritten URL - The * and ** operators cannot be matched unless they have a corresponding variable name - e.g. {format=*} or {var=**}. For example, a path_template_match of /static/{format=**} could be rewritten as /static/content/{format} to prefix /content to the URL. Variables can also be re-ordered in a rewrite, so that /{country}/{format}/{suffix=**} can be rewritten as /content/{format}/{country}/{suffix}. At least one non-empty routeRules[].matchRules[].path_template_match is required. Only one of path_prefix_rewrite or path_template_rewrite may be specified.", - "type": "string" - } - } - }, - "HttpRetryPolicy": { - "id": "HttpRetryPolicy", - "description": "The retry policy associates with HttpRouteRule", - "type": "object", - "properties": { - "retryConditions": { - "description": "Specifies one or more conditions when this retry policy applies. Valid values are: - 5xx: retry is attempted if the instance or endpoint responds with any 5xx response code, or if the instance or endpoint does not respond at all. For example, disconnects, reset, read timeout, connection failure, and refused streams. - gateway-error: Similar to 5xx, but only applies to response codes 502, 503 or 504. - connect-failure: a retry is attempted on failures connecting to the instance or endpoint. For example, connection timeouts. - retriable-4xx: a retry is attempted if the instance or endpoint responds with a 4xx response code. The only error that you can retry is error code 409. - refused-stream: a retry is attempted if the instance or endpoint resets the stream with a REFUSED_STREAM error code. This reset type indicates that it is safe to retry. - cancelled: a retry is attempted if the gRPC status code in the response header is set to cancelled. - deadline-exceeded: a retry is attempted if the gRPC status code in the response header is set to deadline-exceeded. - internal: a retry is attempted if the gRPC status code in the response header is set to internal. - resource-exhausted: a retry is attempted if the gRPC status code in the response header is set to resource-exhausted. - unavailable: a retry is attempted if the gRPC status code in the response header is set to unavailable. Only the following codes are supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true. - cancelled - deadline-exceeded - internal - resource-exhausted - unavailable ", - "type": "array", - "items": { - "type": "string" - } + "patch": { + "id": "compute.regionTargetHttpsProxies.patch", + "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetHttpsProxy" + ], + "request": { + "$ref": "TargetHttpsProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified regional TargetHttpsProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." }, - "numRetries": { - "description": "Specifies the allowed number retries. This number must be \u003e 0. If not specified, defaults to 1.", - "type": "integer", - "format": "uint32" + "setUrlMap": { + "id": "compute.regionTargetHttpsProxies.setUrlMap", + "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy to set a URL map for.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetHttpsProxy" + ], + "request": { + "$ref": "UrlMapReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the URL map for TargetHttpsProxy." }, - "perTryTimeout": { - "description": "Specifies a non-zero timeout per retry attempt. If not specified, will use the timeout set in the HttpRouteAction field. If timeout in the HttpRouteAction field is not set, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", - "$ref": "Duration" - } - } - }, - "RequestMirrorPolicy": { - "id": "RequestMirrorPolicy", - "description": "A policy that specifies how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer doesn't wait for responses from the shadow service. Before sending traffic to the shadow service, the host or authority header is suffixed with -shadow.", - "type": "object", - "properties": { - "backendService": { - "description": "The full or partial URL to the BackendService resource being mirrored to. The backend service configured for a mirroring policy must reference backends that are of the same type as the original backend service matched in the URL map. Serverless NEG backends are not currently supported as a mirrored backend service. ", - "type": "string" + "setSslCertificates": { + "id": "compute.regionTargetHttpsProxies.setSslCertificates", + "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", + "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetHttpsProxy": { + "description": "Name of the TargetHttpsProxy resource to set an SslCertificates resource for.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetHttpsProxy" + ], + "request": { + "$ref": "RegionTargetHttpsProxiesSetSslCertificatesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Replaces SslCertificates for TargetHttpsProxy." } } }, - "CorsPolicy": { - "id": "CorsPolicy", - "description": "The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard.", - "type": "object", - "properties": { - "allowOrigins": { - "description": "Specifies the list of origins that is allowed to do CORS requests. An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes.", - "type": "array", - "items": { - "type": "string" - } - }, - "allowOriginRegexes": { - "description": "Specifies a regular expression that matches allowed origins. For more information, see regular expression syntax . An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED.", - "type": "array", - "items": { - "type": "string" - } - }, - "allowMethods": { - "description": "Specifies the content for the Access-Control-Allow-Methods header.", - "type": "array", - "items": { - "type": "string" - } - }, - "allowHeaders": { - "description": "Specifies the content for the Access-Control-Allow-Headers header.", - "type": "array", - "items": { - "type": "string" - } - }, - "exposeHeaders": { - "description": "Specifies the content for the Access-Control-Expose-Headers header.", - "type": "array", - "items": { - "type": "string" - } + "targetInstances": { + "methods": { + "list": { + "id": "compute.targetInstances.list", + "path": "projects/{project}/zones/{zone}/targetInstances", + "flatPath": "projects/{project}/zones/{zone}/targetInstances", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "TargetInstanceList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of TargetInstance resources available to the specified project and zone." }, - "maxAge": { - "description": "Specifies how long results of a preflight request can be cached in seconds. This field translates to the Access-Control-Max-Age header.", - "type": "integer", - "format": "int32" + "aggregatedList": { + "id": "compute.targetInstances.aggregatedList", + "path": "projects/{project}/aggregated/targetInstances", + "flatPath": "projects/{project}/aggregated/targetInstances", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "TargetInstanceAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of target instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "allowCredentials": { - "description": "In response to a preflight request, setting this to true indicates that the actual request can include user credentials. This field translates to the Access-Control-Allow-Credentials header. Default is false.", - "type": "boolean" + "get": { + "id": "compute.targetInstances.get", + "path": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", + "flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "targetInstance": { + "description": "Name of the TargetInstance resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "targetInstance" + ], + "response": { + "$ref": "TargetInstance" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified TargetInstance resource." }, - "disabled": { - "description": "If true, disables the CORS policy. The default value is false, which indicates that the CORS policy is in effect.", - "type": "boolean" - } - } - }, - "HttpFaultInjection": { - "id": "HttpFaultInjection", - "description": "The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by the load balancer on a percentage of requests before sending those request to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests.", - "type": "object", - "properties": { - "delay": { - "description": "The specification for how client requests are delayed as part of fault injection, before being sent to a backend service.", - "$ref": "HttpFaultDelay" + "insert": { + "id": "compute.targetInstances.insert", + "path": "projects/{project}/zones/{zone}/targetInstances", + "flatPath": "projects/{project}/zones/{zone}/targetInstances", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "request": { + "$ref": "TargetInstance" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a TargetInstance resource in the specified project and zone using the data included in the request." }, - "abort": { - "description": "The specification for how client requests are aborted as part of fault injection.", - "$ref": "HttpFaultAbort" - } - } - }, - "HttpFaultDelay": { - "id": "HttpFaultDelay", - "description": "Specifies the delay introduced by the load balancer before forwarding the request to the backend service as part of fault injection.", - "type": "object", - "properties": { - "fixedDelay": { - "description": "Specifies the value of the fixed delay interval.", - "$ref": "Duration" + "delete": { + "id": "compute.targetInstances.delete", + "path": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", + "flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetInstance": { + "description": "Name of the TargetInstance resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "targetInstance" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified TargetInstance resource." }, - "percentage": { - "description": "The percentage of traffic for connections, operations, or requests for which a delay is introduced as part of fault injection. The value must be from 0.0 to 100.0 inclusive.", - "type": "number", - "format": "double" + "setSecurityPolicy": { + "id": "compute.targetInstances.setSecurityPolicy", + "path": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}/setSecurityPolicy", + "flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}/setSecurityPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetInstance": { + "description": "Name of the TargetInstance resource to which the security policy should be set. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone", + "targetInstance" + ], + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the Google Cloud Armor security policy for the specified target instance. For more information, see Google Cloud Armor Overview" } } }, - "HttpFaultAbort": { - "id": "HttpFaultAbort", - "description": "Specification for how requests are aborted as part of fault injection.", - "type": "object", - "properties": { - "httpStatus": { - "description": "The HTTP status code used to abort the request. The value must be from 200 to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP status code according to this mapping table. HTTP status 200 is mapped to gRPC status UNKNOWN. Injecting an OK status is currently not supported by Traffic Director.", - "type": "integer", - "format": "uint32" + "targetPools": { + "methods": { + "list": { + "id": "compute.targetPools.list", + "path": "projects/{project}/regions/{region}/targetPools", + "flatPath": "projects/{project}/regions/{region}/targetPools", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "TargetPoolList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of target pools available to the specified project and region." }, - "percentage": { - "description": "The percentage of traffic for connections, operations, or requests that is aborted as part of fault injection. The value must be from 0.0 to 100.0 inclusive.", - "type": "number", - "format": "double" - } - } - }, - "HttpRedirectAction": { - "id": "HttpRedirectAction", - "description": "Specifies settings for an HTTP redirect.", - "type": "object", - "properties": { - "hostRedirect": { - "description": "The host that is used in the redirect response instead of the one that was supplied in the request. The value must be from 1 to 255 characters.", - "type": "string" + "aggregatedList": { + "id": "compute.targetPools.aggregatedList", + "path": "projects/{project}/aggregated/targetPools", + "flatPath": "projects/{project}/aggregated/targetPools", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "TargetPoolAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of target pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "pathRedirect": { - "description": "The path that is used in the redirect response instead of the one that was supplied in the request. pathRedirect cannot be supplied together with prefixRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters.", - "type": "string" + "get": { + "id": "compute.targetPools.get", + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "response": { + "$ref": "TargetPool" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified target pool." }, - "prefixRedirect": { - "description": "The prefix that replaces the prefixMatch specified in the HttpRouteRuleMatch, retaining the remaining portion of the URL before redirecting the request. prefixRedirect cannot be supplied together with pathRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters.", - "type": "string" + "insert": { + "id": "compute.targetPools.insert", + "path": "projects/{project}/regions/{region}/targetPools", + "flatPath": "projects/{project}/regions/{region}/targetPools", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "TargetPool" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a target pool in the specified project and region using the data included in the request." }, - "redirectResponseCode": { - "description": "The HTTP Status code to use for this RedirectAction. Supported values are: - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds to 301. - FOUND, which corresponds to 302. - SEE_OTHER which corresponds to 303. - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request method is retained. - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request method is retained. ", - "type": "string", - "enumDescriptions": [ - "Http Status Code 302 - Found.", - "Http Status Code 301 - Moved Permanently.", - "Http Status Code 308 - Permanent Redirect maintaining HTTP method.", - "Http Status Code 303 - See Other.", - "Http Status Code 307 - Temporary Redirect maintaining HTTP method." + "delete": { + "id": "compute.targetPools.delete", + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetPool" ], - "enum": [ - "FOUND", - "MOVED_PERMANENTLY_DEFAULT", - "PERMANENT_REDIRECT", - "SEE_OTHER", - "TEMPORARY_REDIRECT" - ] + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified target pool." }, - "httpsRedirect": { - "description": "If set to true, the URL scheme in the redirected request is set to HTTPS. If set to false, the URL scheme of the redirected request remains the same as that of the request. This must only be set for URL maps used in TargetHttpProxys. Setting this true for TargetHttpsProxy is not permitted. The default is set to false.", - "type": "boolean" + "getHealth": { + "id": "compute.targetPools.getHealth", + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/getHealth", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/getHealth", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to which the queried instance belongs.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "request": { + "$ref": "InstanceReference" + }, + "response": { + "$ref": "TargetPoolInstanceHealth" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Gets the most recent health check results for each IP for the instance that is referenced by the given target pool." }, - "stripQuery": { - "description": "If set to true, any accompanying query portion of the original URL is removed before redirecting the request. If set to false, the query portion of the original URL is retained. The default is set to false. ", - "type": "boolean" - } - } - }, - "PathRule": { - "id": "PathRule", - "description": "A path-matching rule for a URL. If matched, will use the specified BackendService to handle the traffic arriving at this URL.", - "type": "object", - "properties": { - "service": { - "description": "The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. However, if service is specified, routeAction cannot contain any weightedBackendServices. Conversely, if routeAction specifies any weightedBackendServices, service must not be specified. Only one of urlRedirect, service or routeAction.weightedBackendService must be set.", - "type": "string" + "addHealthCheck": { + "id": "compute.targetPools.addHealthCheck", + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/addHealthCheck", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/addHealthCheck", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the target pool to add a health check to.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "request": { + "$ref": "TargetPoolsAddHealthCheckRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Adds health check URLs to a target pool." }, - "routeAction": { - "description": "In response to a matching path, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If routeAction specifies any weightedBackendServices, service must not be set. Conversely if service is set, routeAction cannot contain any weightedBackendServices. Only one of routeAction or urlRedirect must be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a path rule's routeAction.", - "$ref": "HttpRouteAction" + "removeHealthCheck": { + "id": "compute.targetPools.removeHealthCheck", + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeHealthCheck", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeHealthCheck", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the target pool to remove health checks from.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "request": { + "$ref": "TargetPoolsRemoveHealthCheckRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Removes health check URL from a target pool." }, - "urlRedirect": { - "description": "When a path pattern is matched, the request is redirected to a URL specified by urlRedirect. If urlRedirect is specified, service or routeAction must not be set. Not supported when the URL map is bound to a target gRPC proxy.", - "$ref": "HttpRedirectAction" + "addInstance": { + "id": "compute.targetPools.addInstance", + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/addInstance", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/addInstance", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to add instances to.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "request": { + "$ref": "TargetPoolsAddInstanceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Adds an instance to a target pool." }, - "paths": { - "description": "The list of path patterns to match. Each must start with / and the only place a * is allowed is at the end following a /. The string fed to the path matcher does not include any text after the first ? or #, and those chars are not allowed here.", - "type": "array", - "items": { - "type": "string" - } + "removeInstance": { + "id": "compute.targetPools.removeInstance", + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeInstance", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeInstance", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to remove instances from.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "request": { + "$ref": "TargetPoolsRemoveInstanceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Removes instance URL from a target pool." }, - "customErrorResponsePolicy": { - "description": "customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the PathRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A PathRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in PathRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. customErrorResponsePolicy is supported only for global external Application Load Balancers.", - "$ref": "CustomErrorResponsePolicy" - } - } - }, - "CustomErrorResponsePolicy": { - "id": "CustomErrorResponsePolicy", - "description": "Specifies the custom error response policy that must be applied when the backend service or backend bucket responds with an error.", - "type": "object", - "properties": { - "errorResponseRules": { - "description": "Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for 401 (Un-authorized) code, and another for all 4 series error codes (4XX). If the backend service returns a 401, then the rule for 401 will be applied. However if the backend service returns a 403, the rule for 4xx takes effect.", - "type": "array", - "items": { - "$ref": "CustomErrorResponsePolicyCustomErrorResponseRule" - } + "setBackup": { + "id": "compute.targetPools.setBackup", + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/setBackup", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/setBackup", + "httpMethod": "POST", + "parameters": { + "failoverRatio": { + "description": "New failoverRatio value for the target pool.", + "location": "query", + "type": "number", + "format": "float" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to set a backup pool for.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "request": { + "$ref": "TargetReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes a backup target pool's configurations." }, - "errorService": { - "description": "The full or partial URL to the BackendBucket resource that contains the custom error content. Examples are: - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket - compute/v1/projects/project/global/backendBuckets/myBackendBucket - global/backendBuckets/myBackendBucket If errorService is not specified at lower levels like pathMatcher, pathRule and routeRule, an errorService specified at a higher level in the UrlMap will be used. If UrlMap.defaultCustomErrorResponsePolicy contains one or more errorResponseRules[], it must specify errorService. If load balancer cannot reach the backendBucket, a simple Not Found Error will be returned, with the original response code (or overrideResponseCode if configured). errorService is not supported for internal or regional HTTP/HTTPS load balancers.", - "type": "string" + "setSecurityPolicy": { + "id": "compute.targetPools.setSecurityPolicy", + "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/setSecurityPolicy", + "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/setSecurityPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetPool": { + "description": "Name of the TargetPool resource to which the security policy should be set. The name should conform to RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetPool" + ], + "request": { + "$ref": "SecurityPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the Google Cloud Armor security policy for the specified target pool. For more information, see Google Cloud Armor Overview" } } }, - "CustomErrorResponsePolicyCustomErrorResponseRule": { - "id": "CustomErrorResponsePolicyCustomErrorResponseRule", - "description": "Specifies the mapping between the response code that will be returned along with the custom error content and the response code returned by the backend service.", - "type": "object", - "properties": { - "matchResponseCodes": { - "description": "Valid values include: - A number between 400 and 599: For example 401 or 503, in which case the load balancer applies the policy if the error code exactly matches this value. - 5xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 500 to 599. - 4xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 400 to 499. Values must be unique within matchResponseCodes and across all errorResponseRules of CustomErrorResponsePolicy.", - "type": "array", - "items": { - "type": "string" - } - }, - "path": { - "description": "The full path to a file within backendBucket . For example: /errors/defaultError.html path must start with a leading slash. path cannot have trailing slashes. If the file is not available in backendBucket or the load balancer cannot reach the BackendBucket, a simple Not Found Error is returned to the client. The value must be from 1 to 1024 characters", - "type": "string" + "targetSslProxies": { + "methods": { + "list": { + "id": "compute.targetSslProxies.list", + "path": "projects/{project}/global/targetSslProxies", + "flatPath": "projects/{project}/global/targetSslProxies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "TargetSslProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of TargetSslProxy resources available to the specified project." }, - "overrideResponseCode": { - "description": "The HTTP status code returned with the response containing the custom error content. If overrideResponseCode is not supplied, the same response code returned by the original backend bucket or backend service is returned to the client.", - "type": "integer", - "format": "int32" - } - } - }, - "HttpRouteRule": { - "id": "HttpRouteRule", - "description": "The HttpRouteRule setting specifies how to match an HTTP request and the corresponding routing action that load balancing proxies perform.", - "type": "object", - "properties": { - "priority": { - "description": "For routeRules within a given pathMatcher, priority determines the order in which a load balancer interprets routeRules. RouteRules are evaluated in order of priority, from the lowest to highest number. The priority of a rule decreases as its number increases (1, 2, 3, N+1). The first rule that matches the request is applied. You cannot configure two or more routeRules with the same priority. Priority for each rule must be set to a number from 0 to 2147483647 inclusive. Priority numbers can have gaps, which enable you to add or remove rules in the future without affecting the rest of the rules. For example, 1, 2, 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future without any impact on existing rules.", - "type": "integer", - "format": "int32" + "get": { + "id": "compute.targetSslProxies.get", + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "response": { + "$ref": "TargetSslProxy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified TargetSslProxy resource." }, - "description": { - "description": "The short description conveying the intent of this routeRule. The description can have a maximum length of 1024 characters.", - "type": "string" + "insert": { + "id": "compute.targetSslProxies.insert", + "path": "projects/{project}/global/targetSslProxies", + "flatPath": "projects/{project}/global/targetSslProxies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "TargetSslProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a TargetSslProxy resource in the specified project using the data included in the request." }, - "matchRules": { - "description": "The list of criteria for matching attributes of a request to this routeRule. This list has OR semantics: the request matches this routeRule when any of the matchRules are satisfied. However predicates within a given matchRule have AND semantics. All predicates within a matchRule must match for the request to match the rule.", - "type": "array", - "items": { - "$ref": "HttpRouteRuleMatch" - } + "delete": { + "id": "compute.targetSslProxies.delete", + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified TargetSslProxy resource." }, - "service": { - "description": "The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. However, if service is specified, routeAction cannot contain any weightedBackendServices. Conversely, if routeAction specifies any weightedBackendServices, service must not be specified. Only one of urlRedirect, service or routeAction.weightedBackendService must be set.", - "type": "string" + "setBackendService": { + "id": "compute.targetSslProxies.setBackendService", + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setBackendService", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setBackendService", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource whose BackendService resource is to be set.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "request": { + "$ref": "TargetSslProxiesSetBackendServiceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the BackendService for TargetSslProxy." }, - "routeAction": { - "description": "In response to a matching matchRule, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If routeAction specifies any weightedBackendServices, service must not be set. Conversely if service is set, routeAction cannot contain any weightedBackendServices. Only one of urlRedirect, service or routeAction.weightedBackendService must be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a route rule's routeAction.", - "$ref": "HttpRouteAction" + "setSslCertificates": { + "id": "compute.targetSslProxies.setSslCertificates", + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslCertificates", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslCertificates", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource whose SslCertificate resource is to be set.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "request": { + "$ref": "TargetSslProxiesSetSslCertificatesRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes SslCertificates for TargetSslProxy." }, - "urlRedirect": { - "description": "When this rule is matched, the request is redirected to a URL specified by urlRedirect. If urlRedirect is specified, service or routeAction must not be set. Not supported when the URL map is bound to a target gRPC proxy.", - "$ref": "HttpRedirectAction" + "setCertificateMap": { + "id": "compute.targetSslProxies.setCertificateMap", + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setCertificateMap", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setCertificateMap", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "request": { + "$ref": "TargetSslProxiesSetCertificateMapRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the Certificate Map for TargetSslProxy." }, - "headerAction": { - "description": "Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction value specified here is applied before the matching pathMatchers[].headerAction and after pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", - "$ref": "HttpHeaderAction" + "setProxyHeader": { + "id": "compute.targetSslProxies.setProxyHeader", + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setProxyHeader", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setProxyHeader", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource whose ProxyHeader is to be set.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "request": { + "$ref": "TargetSslProxiesSetProxyHeaderRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the ProxyHeaderType for TargetSslProxy." }, - "customErrorResponsePolicy": { - "description": "customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the RouteRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with routeRules.routeAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the customErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the customErrorResponsePolicy is ignored and the response from the service is returned to the client. customErrorResponsePolicy is supported only for global external Application Load Balancers.", - "$ref": "CustomErrorResponsePolicy" + "setSslPolicy": { + "id": "compute.targetSslProxies.setSslPolicy", + "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslPolicy", + "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslPolicy", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetSslProxy": { + "description": "Name of the TargetSslProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035.", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetSslProxy" + ], + "request": { + "$ref": "SslPolicyReference" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the SSL policy for TargetSslProxy. The SSL policy specifies the server-side support for SSL features. This affects connections between clients and the load balancer. They do not affect the connection between the load balancer and the backends." } } }, - "HttpRouteRuleMatch": { - "id": "HttpRouteRuleMatch", - "description": "HttpRouteRuleMatch specifies a set of criteria for matching requests to an HttpRouteRule. All specified criteria must be satisfied for a match to occur.", - "type": "object", - "properties": { - "prefixMatch": { - "description": "For satisfying the matchRule condition, the request's path must begin with the specified prefixMatch. prefixMatch must begin with a /. The value must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified.", - "type": "string" - }, - "fullPathMatch": { - "description": "For satisfying the matchRule condition, the path of the request must exactly match the value specified in fullPathMatch after removing any query parameters and anchor that may be part of the original URL. fullPathMatch must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified.", - "type": "string" + "targetTcpProxies": { + "methods": { + "list": { + "id": "compute.targetTcpProxies.list", + "path": "projects/{project}/global/targetTcpProxies", + "flatPath": "projects/{project}/global/targetTcpProxies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "TargetTcpProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of TargetTcpProxy resources available to the specified project." }, - "regexMatch": { - "description": "For satisfying the matchRule condition, the path of the request must satisfy the regular expression specified in regexMatch after removing any query parameters and anchor supplied with the original URL. For more information about regular expression syntax, see Syntax. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED.", - "type": "string" + "aggregatedList": { + "id": "compute.targetTcpProxies.aggregatedList", + "path": "projects/{project}/aggregated/targetTcpProxies", + "flatPath": "projects/{project}/aggregated/targetTcpProxies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "TargetTcpProxyAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of all TargetTcpProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "ignoreCase": { - "description": "Specifies that prefixMatch and fullPathMatch matches are case sensitive. The default value is false. ignoreCase must not be used with regexMatch. Not supported when the URL map is bound to a target gRPC proxy.", - "type": "boolean" + "get": { + "id": "compute.targetTcpProxies.get", + "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", + "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetTcpProxy" + ], + "response": { + "$ref": "TargetTcpProxy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified TargetTcpProxy resource." }, - "headerMatches": { - "description": "Specifies a list of header match criteria, all of which must match corresponding headers in the request.", - "type": "array", - "items": { - "$ref": "HttpHeaderMatch" - } + "insert": { + "id": "compute.targetTcpProxies.insert", + "path": "projects/{project}/global/targetTcpProxies", + "flatPath": "projects/{project}/global/targetTcpProxies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "TargetTcpProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a TargetTcpProxy resource in the specified project using the data included in the request." }, - "queryParameterMatches": { - "description": "Specifies a list of query parameter match criteria, all of which must match corresponding query parameters in the request. Not supported when the URL map is bound to a target gRPC proxy.", - "type": "array", - "items": { - "$ref": "HttpQueryParameterMatch" - } + "delete": { + "id": "compute.targetTcpProxies.delete", + "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", + "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetTcpProxy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified TargetTcpProxy resource." }, - "metadataFilters": { - "description": "Opaque filter criteria used by the load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to the load balancer, xDS clients present node metadata. When there is a match, the relevant routing configuration is made available to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadata filters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here is applied after those specified in ForwardingRule that refers to the UrlMap this HttpRouteRuleMatch belongs to. metadataFilters only applies to load balancers that have loadBalancingScheme set to INTERNAL_SELF_MANAGED. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", - "type": "array", - "items": { - "$ref": "MetadataFilter" - } + "setBackendService": { + "id": "compute.targetTcpProxies.setBackendService", + "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setBackendService", + "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setBackendService", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource whose BackendService resource is to be set.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetTcpProxy" + ], + "request": { + "$ref": "TargetTcpProxiesSetBackendServiceRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the BackendService for TargetTcpProxy." }, - "pathTemplateMatch": { - "description": "If specified, the route is a pattern match expression that must match the :path header once the query string is removed. A pattern match allows you to match - The value must be between 1 and 1024 characters - The pattern must start with a leading slash (\"/\") - There may be no more than 5 operators in pattern Precisely one of prefix_match, full_path_match, regex_match or path_template_match must be set.", - "type": "string" + "setProxyHeader": { + "id": "compute.targetTcpProxies.setProxyHeader", + "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setProxyHeader", + "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setProxyHeader", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource whose ProxyHeader is to be set.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "targetTcpProxy" + ], + "request": { + "$ref": "TargetTcpProxiesSetProxyHeaderRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Changes the ProxyHeaderType for TargetTcpProxy." } } }, - "HttpHeaderMatch": { - "id": "HttpHeaderMatch", - "description": "matchRule criteria for request header matches.", - "type": "object", - "properties": { - "headerName": { - "description": "The name of the HTTP header to match. For matching against the HTTP request's authority, use a headerMatch with the header name \":authority\". For matching a request's method, use the headerName \":method\". When the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true, only non-binary user-specified custom metadata and the `content-type` header are supported. The following transport-level headers cannot be used in header matching rules: `:authority`, `:method`, `:path`, `:scheme`, `user-agent`, `accept-encoding`, `content-encoding`, `grpc-accept-encoding`, `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`, `grpc-timeout` and `grpc-trace-bin`.", - "type": "string" - }, - "exactMatch": { - "description": "The value should exactly match contents of exactMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set.", - "type": "string" - }, - "regexMatch": { - "description": "The value of the header must match the regular expression specified in regexMatch. For more information about regular expression syntax, see Syntax. For matching against a port specified in the HTTP request, use a headerMatch with headerName set to PORT and a regular expression that satisfies the RFC2616 Host header's port specifier. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED.", - "type": "string" - }, - "rangeMatch": { - "description": "The header value must be an integer and its value must be in the range specified in rangeMatch. If the header does not contain an integer, number or is empty, the match fails. For example for a range [-5, 0] - -3 will match. - 0 will not match. - 0.25 will not match. - -3someString will not match. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. rangeMatch is not supported for load balancers that have loadBalancingScheme set to EXTERNAL.", - "$ref": "Int64RangeMatch" - }, - "presentMatch": { - "description": "A header with the contents of headerName must exist. The match takes place whether or not the request's header has a value. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set.", - "type": "boolean" + "regionTargetTcpProxies": { + "methods": { + "list": { + "id": "compute.regionTargetTcpProxies.list", + "path": "projects/{project}/regions/{region}/targetTcpProxies", + "flatPath": "projects/{project}/regions/{region}/targetTcpProxies", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "TargetTcpProxyList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of TargetTcpProxy resources available to the specified project in a given region." }, - "prefixMatch": { - "description": "The value of the header must start with the contents of prefixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set.", - "type": "string" + "get": { + "id": "compute.regionTargetTcpProxies.get", + "path": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", + "flatPath": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetTcpProxy" + ], + "response": { + "$ref": "TargetTcpProxy" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified TargetTcpProxy resource." }, - "suffixMatch": { - "description": "The value of the header must end with the contents of suffixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set.", - "type": "string" + "insert": { + "id": "compute.regionTargetTcpProxies.insert", + "path": "projects/{project}/regions/{region}/targetTcpProxies", + "flatPath": "projects/{project}/regions/{region}/targetTcpProxies", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "TargetTcpProxy" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a TargetTcpProxy resource in the specified project and region using the data included in the request." }, - "invertMatch": { - "description": "If set to false, the headerMatch is considered a match if the preceding match criteria are met. If set to true, the headerMatch is considered a match if the preceding match criteria are NOT met. The default setting is false. ", - "type": "boolean" + "delete": { + "id": "compute.regionTargetTcpProxies.delete", + "path": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", + "flatPath": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetTcpProxy": { + "description": "Name of the TargetTcpProxy resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetTcpProxy" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified TargetTcpProxy resource." } } }, - "Int64RangeMatch": { - "id": "Int64RangeMatch", - "description": "HttpRouteRuleMatch criteria for field values that must stay within the specified integer range.", - "type": "object", - "properties": { - "rangeStart": { - "description": "The start of the range (inclusive) in signed long integer format.", - "type": "string", - "format": "int64" + "targetVpnGateways": { + "methods": { + "list": { + "id": "compute.targetVpnGateways.list", + "path": "projects/{project}/regions/{region}/targetVpnGateways", + "flatPath": "projects/{project}/regions/{region}/targetVpnGateways", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "TargetVpnGatewayList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of target VPN gateways available to the specified project and region." + }, + "aggregatedList": { + "id": "compute.targetVpnGateways.aggregatedList", + "path": "projects/{project}/aggregated/targetVpnGateways", + "flatPath": "projects/{project}/aggregated/targetVpnGateways", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "TargetVpnGatewayAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of target VPN gateways. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "rangeEnd": { - "description": "The end of the range (exclusive) in signed long integer format.", - "type": "string", - "format": "int64" - } - } - }, - "HttpQueryParameterMatch": { - "id": "HttpQueryParameterMatch", - "description": "HttpRouteRuleMatch criteria for a request's query parameter.", - "type": "object", - "properties": { - "name": { - "description": "The name of the query parameter to match. The query parameter must exist in the request, in the absence of which the request match fails.", - "type": "string" + "get": { + "id": "compute.targetVpnGateways.get", + "path": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", + "flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "targetVpnGateway": { + "description": "Name of the target VPN gateway to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetVpnGateway" + ], + "response": { + "$ref": "TargetVpnGateway" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified target VPN gateway." }, - "presentMatch": { - "description": "Specifies that the queryParameterMatch matches if the request contains the query parameter, irrespective of whether the parameter has a value or not. Only one of presentMatch, exactMatch, or regexMatch must be set. ", - "type": "boolean" + "insert": { + "id": "compute.targetVpnGateways.insert", + "path": "projects/{project}/regions/{region}/targetVpnGateways", + "flatPath": "projects/{project}/regions/{region}/targetVpnGateways", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "TargetVpnGateway" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a target VPN gateway in the specified project and region using the data included in the request." }, - "exactMatch": { - "description": "The queryParameterMatch matches if the value of the parameter exactly matches the contents of exactMatch. Only one of presentMatch, exactMatch, or regexMatch must be set. ", - "type": "string" + "delete": { + "id": "compute.targetVpnGateways.delete", + "path": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", + "flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "targetVpnGateway": { + "description": "Name of the target VPN gateway to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "targetVpnGateway" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified target VPN gateway." }, - "regexMatch": { - "description": "The queryParameterMatch matches if the value of the parameter matches the regular expression specified by regexMatch. For more information about regular expression syntax, see Syntax. Only one of presentMatch, exactMatch, or regexMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. ", - "type": "string" + "setLabels": { + "id": "compute.targetVpnGateways.setLabels", + "path": "projects/{project}/regions/{region}/targetVpnGateways/{resource}/setLabels", + "flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on a TargetVpnGateway. To learn more about labels, read the Labeling Resources documentation." } } }, - "UrlMapTest": { - "id": "UrlMapTest", - "description": "Message for the expected URL mappings.", - "type": "object", - "properties": { - "description": { - "description": "Description of this test case.", - "type": "string" + "urlMaps": { + "methods": { + "list": { + "id": "compute.urlMaps.list", + "path": "projects/{project}/global/urlMaps", + "flatPath": "projects/{project}/global/urlMaps", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "UrlMapList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of UrlMap resources available to the specified project." }, - "host": { - "description": "Host portion of the URL. If headers contains a host header, then host must also match the header value.", - "type": "string" + "aggregatedList": { + "id": "compute.urlMaps.aggregatedList", + "path": "projects/{project}/aggregated/urlMaps", + "flatPath": "projects/{project}/aggregated/urlMaps", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Name of the project scoping this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "UrlMapsAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of all UrlMap resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "path": { - "description": "Path portion of the URL.", - "type": "string" + "get": { + "id": "compute.urlMaps.get", + "path": "projects/{project}/global/urlMaps/{urlMap}", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "urlMap" + ], + "response": { + "$ref": "UrlMap" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified UrlMap resource." }, - "headers": { - "description": "HTTP headers for this request. If headers contains a host header, then host must also match the header value.", - "type": "array", - "items": { - "$ref": "UrlMapTestHeader" - } + "insert": { + "id": "compute.urlMaps.insert", + "path": "projects/{project}/global/urlMaps", + "flatPath": "projects/{project}/global/urlMaps", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project" + ], + "request": { + "$ref": "UrlMap" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a UrlMap resource in the specified project using the data included in the request." }, - "service": { - "description": "Expected BackendService or BackendBucket resource the given URL should be mapped to. The service field cannot be set if expectedRedirectResponseCode is set.", - "type": "string" + "delete": { + "id": "compute.urlMaps.delete", + "path": "projects/{project}/global/urlMaps/{urlMap}", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "urlMap" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified UrlMap resource." }, - "expectedOutputUrl": { - "description": "The expected output URL evaluated by the load balancer containing the scheme, host, path and query parameters. For rules that forward requests to backends, the test passes only when expectedOutputUrl matches the request forwarded by the load balancer to backends. For rules with urlRewrite, the test verifies that the forwarded request matches hostRewrite and pathPrefixRewrite in the urlRewrite action. When service is specified, expectedOutputUrl`s scheme is ignored. For rules with urlRedirect, the test passes only if expectedOutputUrl matches the URL in the load balancer's redirect response. If urlRedirect specifies https_redirect, the test passes only if the scheme in expectedOutputUrl is also set to HTTPS. If urlRedirect specifies strip_query, the test passes only if expectedOutputUrl does not contain any query parameters. expectedOutputUrl is optional when service is specified.", - "type": "string" + "update": { + "id": "compute.urlMaps.update", + "path": "projects/{project}/global/urlMaps/{urlMap}", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}", + "httpMethod": "PUT", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "urlMap" + ], + "request": { + "$ref": "UrlMap" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified UrlMap resource with the data included in the request." + }, + "patch": { + "id": "compute.urlMaps.patch", + "path": "projects/{project}/global/urlMaps/{urlMap}", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "urlMap" + ], + "request": { + "$ref": "UrlMap" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified UrlMap resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." }, - "expectedRedirectResponseCode": { - "description": "For rules with urlRedirect, the test passes only if expectedRedirectResponseCode matches the HTTP status code in load balancer's redirect response. expectedRedirectResponseCode cannot be set when service is set.", - "type": "integer", - "format": "int32" - } - } - }, - "UrlMapTestHeader": { - "id": "UrlMapTestHeader", - "description": "HTTP headers used in UrlMapTests.", - "type": "object", - "properties": { - "name": { - "description": "Header name.", - "type": "string" + "validate": { + "id": "compute.urlMaps.validate", + "path": "projects/{project}/global/urlMaps/{urlMap}/validate", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}/validate", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to be validated as.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "urlMap" + ], + "request": { + "$ref": "UrlMapsValidateRequest" + }, + "response": { + "$ref": "UrlMapsValidateResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap." }, - "value": { - "description": "Header value.", - "type": "string" + "invalidateCache": { + "id": "compute.urlMaps.invalidateCache", + "path": "projects/{project}/global/urlMaps/{urlMap}/invalidateCache", + "flatPath": "projects/{project}/global/urlMaps/{urlMap}/invalidateCache", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "urlMap" + ], + "request": { + "$ref": "CacheInvalidationRule" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Initiates a cache invalidation operation, invalidating the specified path, scoped to the specified UrlMap. For more information, see [Invalidating cached content](/cdn/docs/invalidating-cached-content)." } } }, - "UrlMapsAggregatedList": { - "id": "UrlMapsAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "Type of resource.", - "default": "compute#urlMapsAggregatedList", - "type": "string" + "regionUrlMaps": { + "methods": { + "list": { + "id": "compute.regionUrlMaps.list", + "path": "projects/{project}/regions/{region}/urlMaps", + "flatPath": "projects/{project}/regions/{region}/urlMaps", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "UrlMapList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of UrlMap resources available to the specified project in the specified region." }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" + "get": { + "id": "compute.regionUrlMaps.get", + "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "urlMap" + ], + "response": { + "$ref": "UrlMap" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified UrlMap resource." }, - "items": { - "description": "A list of UrlMapsScopedList resources.", - "type": "object", - "additionalProperties": { - "description": "Name of the scope containing this set of UrlMaps.", - "$ref": "UrlMapsScopedList" - } + "insert": { + "id": "compute.regionUrlMaps.insert", + "path": "projects/{project}/regions/{region}/urlMaps", + "flatPath": "projects/{project}/regions/{region}/urlMaps", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "begin_interface: MixerMutationRequestBuilder Request ID to support idempotency.", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "UrlMap" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a UrlMap resource in the specified project using the data included in the request." }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" + "delete": { + "id": "compute.regionUrlMaps.delete", + "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "begin_interface: MixerMutationRequestBuilder Request ID to support idempotency.", + "location": "query", + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "urlMap" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified UrlMap resource." }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "update": { + "id": "compute.regionUrlMaps.update", + "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "httpMethod": "PUT", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "begin_interface: MixerMutationRequestBuilder Request ID to support idempotency.", + "location": "query", + "type": "string" + }, + "urlMap": { + "description": "Name of the UrlMap resource to update.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "urlMap" + ], + "request": { + "$ref": "UrlMap" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Updates the specified UrlMap resource with the data included in the request." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "patch": { + "id": "compute.regionUrlMaps.patch", + "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", + "httpMethod": "PATCH", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "requestId": { + "description": "begin_interface: MixerMutationRequestBuilder Request ID to support idempotency.", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "urlMap": { + "description": "Name of the UrlMap resource to patch.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "UrlMapsScopedList": { - "id": "UrlMapsScopedList", - "type": "object", - "properties": { - "urlMaps": { - "description": "A list of UrlMaps contained in this scope.", - "type": "array", - "items": { + }, + "parameterOrder": [ + "project", + "region", + "urlMap" + ], + "request": { "$ref": "UrlMap" - } + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Patches the specified UrlMap resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." }, - "warning": { - "description": "Informational warning which replaces the list of backend services when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "validate": { + "id": "compute.regionUrlMaps.validate", + "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}/validate", + "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}/validate", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region scoping this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "urlMap": { + "description": "Name of the UrlMap resource to be validated as.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "UrlMapsValidateRequest": { - "id": "UrlMapsValidateRequest", - "type": "object", - "properties": { - "resource": { - "description": "Content of the UrlMap to be validated.", - "$ref": "UrlMap" - }, - "loadBalancingSchemes": { - "description": "Specifies the load balancer type(s) this validation request is for. Use EXTERNAL_MANAGED for global external Application Load Balancers and regional external Application Load Balancers. Use EXTERNAL for classic Application Load Balancers. Use INTERNAL_MANAGED for internal Application Load Balancers. For more information, refer to Choosing a load balancer. If unspecified, the load balancing scheme will be inferred from the backend service resources this URL map references. If that can not be inferred (for example, this URL map only references backend buckets, or this Url map is for rewrites and redirects only and doesn't reference any backends), EXTERNAL will be used as the default type. If specified, the scheme(s) must not conflict with the load balancing scheme of the backend service resources this Url map references.", - "type": "array", - "items": { - "type": "string", - "enumDescriptions": [ - "Signifies that this will be used for classic Application Load Balancers.", - "Signifies that this will be used for Envoy-based global external Application Load Balancers.", - "If unspecified, the validation will try to infer the scheme from the backend service resources this Url map references. If the inference is not possible, EXTERNAL will be used as the default type." - ], - "enum": [ - "EXTERNAL", - "EXTERNAL_MANAGED", - "LOAD_BALANCING_SCHEME_UNSPECIFIED" - ] - } - } - } - }, - "UrlMapsValidateResponse": { - "id": "UrlMapsValidateResponse", - "type": "object", - "properties": { - "result": { - "$ref": "UrlMapValidationResult" - } - } - }, - "UrlMapValidationResult": { - "id": "UrlMapValidationResult", - "description": "Message representing the validation result for a UrlMap.", - "type": "object", - "properties": { - "loadSucceeded": { - "description": "Whether the given UrlMap can be successfully loaded. If false, 'loadErrors' indicates the reasons.", - "type": "boolean" - }, - "loadErrors": { - "type": "array", - "items": { - "type": "string" - } - }, - "testPassed": { - "description": "If successfully loaded, this field indicates whether the test passed. If false, 'testFailures's indicate the reason of failure.", - "type": "boolean" - }, - "testFailures": { - "type": "array", - "items": { - "$ref": "TestFailure" - } + }, + "parameterOrder": [ + "project", + "region", + "urlMap" + ], + "request": { + "$ref": "RegionUrlMapsValidateRequest" + }, + "response": { + "$ref": "UrlMapsValidateResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap." } } }, - "TestFailure": { - "id": "TestFailure", - "type": "object", - "properties": { - "host": { - "description": "Host portion of the URL.", - "type": "string" - }, - "path": { - "description": "Path portion including query parameters in the URL.", - "type": "string" - }, - "headers": { - "description": "HTTP headers of the request.", - "type": "array", - "items": { - "$ref": "UrlMapTestHeader" - } + "vpnGateways": { + "methods": { + "list": { + "id": "compute.vpnGateways.list", + "path": "projects/{project}/regions/{region}/vpnGateways", + "flatPath": "projects/{project}/regions/{region}/vpnGateways", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "VpnGatewayList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of VPN gateways available to the specified project and region." }, - "expectedService": { - "description": "Expected BackendService or BackendBucket resource the given URL should be mapped to.", - "type": "string" + "aggregatedList": { + "id": "compute.vpnGateways.aggregatedList", + "path": "projects/{project}/aggregated/vpnGateways", + "flatPath": "projects/{project}/aggregated/vpnGateways", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", + "type": "string", + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "VpnGatewayAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of VPN gateways. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." }, - "actualService": { - "description": "BackendService or BackendBucket returned by load balancer.", - "type": "string" + "get": { + "id": "compute.vpnGateways.get", + "path": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", + "flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "vpnGateway": { + "description": "Name of the VPN gateway to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "vpnGateway" + ], + "response": { + "$ref": "VpnGateway" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified VPN gateway." }, - "expectedOutputUrl": { - "description": "The expected output URL evaluated by a load balancer containing the scheme, host, path and query parameters.", - "type": "string" + "getStatus": { + "id": "compute.vpnGateways.getStatus", + "path": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}/getStatus", + "flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}/getStatus", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "vpnGateway": { + "description": "Name of the VPN gateway to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "vpnGateway" + ], + "response": { + "$ref": "VpnGatewaysGetStatusResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the status for the specified VPN gateway." }, - "actualOutputUrl": { - "description": "The actual output URL evaluated by a load balancer containing the scheme, host, path and query parameters.", - "type": "string" + "insert": { + "id": "compute.vpnGateways.insert", + "path": "projects/{project}/regions/{region}/vpnGateways", + "flatPath": "projects/{project}/regions/{region}/vpnGateways", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "request": { + "$ref": "VpnGateway" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Creates a VPN gateway in the specified project and region using the data included in the request." }, - "expectedRedirectResponseCode": { - "description": "Expected HTTP status code for rule with `urlRedirect` calculated by load balancer", - "type": "integer", - "format": "int32" + "delete": { + "id": "compute.vpnGateways.delete", + "path": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", + "flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "vpnGateway": { + "description": "Name of the VPN gateway to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "vpnGateway" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified VPN gateway." }, - "actualRedirectResponseCode": { - "description": "Actual HTTP status code for rule with `urlRedirect` calculated by load balancer", - "type": "integer", - "format": "int32" - } - } - }, - "CacheInvalidationRule": { - "id": "CacheInvalidationRule", - "type": "object", - "properties": { - "path": { - "type": "string" + "testIamPermissions": { + "id": "compute.vpnGateways.testIamPermissions", + "path": "projects/{project}/regions/{region}/vpnGateways/{resource}/testIamPermissions", + "flatPath": "projects/{project}/regions/{region}/vpnGateways/{resource}/testIamPermissions", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "TestPermissionsRequest" + }, + "response": { + "$ref": "TestPermissionsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns permissions that a caller has on the specified resource." }, - "host": { - "description": "If set, this invalidation rule will only apply to requests with a Host header matching host.", - "type": "string" - } - } - }, - "RegionUrlMapsValidateRequest": { - "id": "RegionUrlMapsValidateRequest", - "type": "object", - "properties": { - "resource": { - "description": "Content of the UrlMap to be validated.", - "$ref": "UrlMap" + "setLabels": { + "id": "compute.vpnGateways.setLabels", + "path": "projects/{project}/regions/{region}/vpnGateways/{resource}/setLabels", + "flatPath": "projects/{project}/regions/{region}/vpnGateways/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "The region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on a VpnGateway. To learn more about labels, read the Labeling Resources documentation." } } }, - "VpnGatewayList": { - "id": "VpnGatewayList", - "description": "Contains a list of VpnGateway resources.", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#vpnGateway for VPN gateways.", - "default": "compute#vpnGatewayList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of VpnGateway resources.", - "type": "array", - "items": { - "$ref": "VpnGateway" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "vpnTunnels": { + "methods": { + "list": { + "id": "compute.vpnTunnels.list", + "path": "projects/{project}/regions/{region}/vpnTunnels", + "flatPath": "projects/{project}/regions/{region}/vpnTunnels", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" + ], + "response": { + "$ref": "VpnTunnelList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves a list of VpnTunnel resources contained in the specified project and region." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "aggregatedList": { + "id": "compute.vpnTunnels.aggregatedList", + "path": "projects/{project}/aggregated/vpnTunnels", + "flatPath": "projects/{project}/aggregated/vpnTunnels", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "includeAllScopes": { + "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", + "location": "query", + "type": "boolean" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + }, + "serviceProjectNumber": { + "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", + "location": "query", "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "format": "int64" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "VpnTunnelAggregatedList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves an aggregated list of VPN tunnels. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + }, + "get": { + "id": "compute.vpnTunnels.get", + "path": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", + "flatPath": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "vpnTunnel": { + "description": "Name of the VpnTunnel resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "region", + "vpnTunnel" + ], + "response": { + "$ref": "VpnTunnel" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified VpnTunnel resource." + }, + "insert": { + "id": "compute.vpnTunnels.insert", + "path": "projects/{project}/regions/{region}/vpnTunnels", + "flatPath": "projects/{project}/regions/{region}/vpnTunnels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" } - } - } - } - }, - "VpnGateway": { - "id": "VpnGateway", - "description": "Represents a HA VPN gateway. HA VPN is a high-availability (HA) Cloud VPN solution that lets you securely connect your on-premises network to your Google Cloud Virtual Private Cloud network through an IPsec VPN connection in a single region. For more information about Cloud HA VPN solutions, see Cloud VPN topologies .", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#vpnGateway for VPN gateways.", - "default": "compute#vpnGateway", - "type": "string" - }, - "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", - "type": "string", - "format": "uint64" - }, - "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", - "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])?", - "annotations": { - "required": [ - "compute.vpnGateways.insert" - ] - }, - "type": "string" - }, - "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the VPN gateway resides.", - "type": "string" - }, - "network": { - "description": "URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created.", - "annotations": { - "required": [ - "compute.vpnGateways.insert" - ] }, - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", - "type": "string" - }, - "labels": { - "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this VpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnGateway.", - "type": "string", - "format": "byte" - }, - "vpnInterfaces": { - "description": "The list of VPN interfaces associated with this VPN gateway.", - "type": "array", - "items": { - "$ref": "VpnGatewayVpnGatewayInterface" - } - }, - "stackType": { - "description": "The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not specified, IPV4_ONLY is used if the gateway IP version is IPV4, or IPV4_IPV6 if the gateway IP version is IPV6.", - "type": "string", - "enumDescriptions": [ - "Enable VPN gateway with both IPv4 and IPv6 protocols.", - "Enable VPN gateway with only IPv4 protocol.", - "Enable VPN gateway with only IPv6 protocol." + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "IPV4_IPV6", - "IPV4_ONLY", - "IPV6_ONLY" - ] - }, - "gatewayIpVersion": { - "description": "The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not specified, IPV4 will be used.", - "type": "string", - "enumDescriptions": [ - "Every HA-VPN gateway interface is configured with an IPv4 address.", - "Every HA-VPN gateway interface is configured with an IPv6 address." + "request": { + "$ref": "VpnTunnel" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" ], - "enum": [ - "IPV4", - "IPV6" - ] - } - } - }, - "VpnGatewayVpnGatewayInterface": { - "id": "VpnGatewayVpnGatewayInterface", - "description": "A VPN gateway interface.", - "type": "object", - "properties": { - "id": { - "description": "[Output Only] Numeric identifier for this VPN interface associated with the VPN gateway.", - "type": "integer", - "format": "uint32" - }, - "ipAddress": { - "description": "[Output Only] IP address for this VPN interface associated with the VPN gateway. The IP address could be either a regional external IP address or a regional internal IP address. The two IP addresses for a VPN gateway must be all regional external or regional internal IP addresses. There cannot be a mix of regional external IP addresses and regional internal IP addresses. For HA VPN over Cloud Interconnect, the IP addresses for both interfaces could either be regional internal IP addresses or regional external IP addresses. For regular (non HA VPN over Cloud Interconnect) HA VPN tunnels, the IP address must be a regional external IP address.", - "type": "string" - }, - "ipv6Address": { - "description": "[Output Only] IPv6 address for this VPN interface associated with the VPN gateway. The IPv6 address must be a regional external IPv6 address. The format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).", - "type": "string" - }, - "interconnectAttachment": { - "description": "URL of the VLAN attachment (interconnectAttachment) resource for this VPN gateway interface. When the value of this field is present, the VPN gateway is used for HA VPN over Cloud Interconnect; all egress or ingress traffic for this VPN gateway interface goes through the specified VLAN attachment resource.", - "type": "string" - } - } - }, - "VpnGatewayAggregatedList": { - "id": "VpnGatewayAggregatedList", - "type": "object", - "properties": { - "kind": { - "description": "[Output Only] Type of resource. Always compute#vpnGateway for VPN gateways.", - "default": "compute#vpnGatewayAggregatedList", - "type": "string" - }, - "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", - "type": "string" - }, - "items": { - "description": "A list of VpnGateway resources.", - "type": "object", - "additionalProperties": { - "description": "[Output Only] Name of the scope containing this set of VPN gateways.", - "$ref": "VpnGatewaysScopedList" - } - }, - "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", - "type": "string" - }, - "selfLink": { - "description": "[Output Only] Server-defined URL for this resource.", - "type": "string" + "description": "Creates a VpnTunnel resource in the specified project and region using the data included in the request." }, - "warning": { - "description": "[Output Only] Informational warning message.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "delete": { + "id": "compute.vpnTunnels.delete", + "path": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", + "flatPath": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", + "httpMethod": "DELETE", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "Name of the region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", + "type": "string" + }, + "vpnTunnel": { + "description": "Name of the VpnTunnel resource to delete.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - }, - "unreachables": { - "description": "[Output Only] Unreachable resources.", - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "VpnGatewaysScopedList": { - "id": "VpnGatewaysScopedList", - "type": "object", - "properties": { - "vpnGateways": { - "description": "[Output Only] A list of VPN gateways contained in this scope.", - "type": "array", - "items": { - "$ref": "VpnGateway" - } + }, + "parameterOrder": [ + "project", + "region", + "vpnTunnel" + ], + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Deletes the specified VpnTunnel resource." }, - "warning": { - "description": "[Output Only] Informational warning which replaces the list of addresses when the list is empty.", - "type": "object", - "properties": { - "code": { - "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", - "type": "string", - "enumDescriptions": [ - "Warning about failed cleanup of transient changes made by a failed operation.", - "A link to a deprecated resource was created.", - "When deploying and at least one of the resources has a type marked as deprecated", - "The user created a boot disk that is larger than image size.", - "When deploying and at least one of the resources has a type marked as experimental", - "Warning that is present in an external api call", - "Warning that value of a field has been overridden. Deprecated unused field.", - "The operation involved use of an injected kernel, which is deprecated.", - "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", - "When deploying a deployment with a exceedingly large number of resources", - "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", - "A resource depends on a missing type", - "The route's nextHopIp address is not assigned to an instance on the network.", - "The route's next hop instance cannot ip forward.", - "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", - "The route's nextHopInstance URL refers to an instance that does not exist.", - "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", - "The route's next hop instance does not have a status of RUNNING.", - "Error which is not critical. We decided to continue the process despite the mentioned error.", - "No results are present on a particular list page.", - "Success is reported, but some results may be missing due to errors", - "The user attempted to use a resource that requires a TOS they have not accepted.", - "Warning that a resource is in use.", - "One or more of the resources set to auto-delete could not be deleted because they were in use.", - "When a resource schema validation is ignored.", - "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", - "When undeclared properties in the schema are present", - "A given scope cannot be reached." - ], - "enumDeprecated": [ - false, - false, - false, - false, - false, - false, - true, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false, - false - ], - "enum": [ - "CLEANUP_FAILED", - "DEPRECATED_RESOURCE_USED", - "DEPRECATED_TYPE_USED", - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", - "EXPERIMENTAL_TYPE_USED", - "EXTERNAL_API_WARNING", - "FIELD_VALUE_OVERRIDEN", - "INJECTED_KERNELS_DEPRECATED", - "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", - "LARGE_DEPLOYMENT_WARNING", - "LIST_OVERHEAD_QUOTA_EXCEED", - "MISSING_TYPE_DEPENDENCY", - "NEXT_HOP_ADDRESS_NOT_ASSIGNED", - "NEXT_HOP_CANNOT_IP_FORWARD", - "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", - "NEXT_HOP_INSTANCE_NOT_FOUND", - "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", - "NEXT_HOP_NOT_RUNNING", - "NOT_CRITICAL_ERROR", - "NO_RESULTS_ON_PAGE", - "PARTIAL_SUCCESS", - "REQUIRED_TOS_AGREEMENT", - "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", - "RESOURCE_NOT_DELETED", - "SCHEMA_VALIDATION_IGNORED", - "SINGLE_INSTANCE_PROPERTY_TEMPLATE", - "UNDECLARED_PROPERTIES", - "UNREACHABLE" - ] + "setLabels": { + "id": "compute.vpnTunnels.setLabels", + "path": "projects/{project}/regions/{region}/vpnTunnels/{resource}/setLabels", + "flatPath": "projects/{project}/regions/{region}/vpnTunnels/{resource}/setLabels", + "httpMethod": "POST", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" }, - "message": { - "description": "[Output Only] A human-readable description of the warning code.", + "region": { + "description": "The region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "requestId": { + "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", + "location": "query", "type": "string" }, - "data": { - "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", - "type": "array", - "items": { - "type": "object", - "properties": { - "key": { - "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", - "type": "string" - }, - "value": { - "description": "[Output Only] A warning data value corresponding to the key.", - "type": "string" - } - } - } + "resource": { + "description": "Name or id of the resource for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" } - } - } - } - }, - "VpnGatewaysGetStatusResponse": { - "id": "VpnGatewaysGetStatusResponse", - "type": "object", - "properties": { - "result": { - "$ref": "VpnGatewayStatus" - } - } - }, - "VpnGatewayStatus": { - "id": "VpnGatewayStatus", - "type": "object", - "properties": { - "vpnConnections": { - "description": "List of VPN connection for this VpnGateway.", - "type": "array", - "items": { - "$ref": "VpnGatewayStatusVpnConnection" - } - } - } - }, - "VpnGatewayStatusVpnConnection": { - "id": "VpnGatewayStatusVpnConnection", - "description": "A VPN connection contains all VPN tunnels connected from this VpnGateway to the same peer gateway. The peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway.", - "type": "object", - "properties": { - "peerExternalGateway": { - "description": "URL reference to the peer external VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway.", - "type": "string" - }, - "peerGcpGateway": { - "description": "URL reference to the peer side VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway.", - "type": "string" - }, - "tunnels": { - "description": "List of VPN tunnels that are in this VPN connection.", - "type": "array", - "items": { - "$ref": "VpnGatewayStatusTunnel" - } - }, - "state": { - "description": "HighAvailabilityRequirementState for the VPN connection.", - "$ref": "VpnGatewayStatusHighAvailabilityRequirementState" + }, + "parameterOrder": [ + "project", + "region", + "resource" + ], + "request": { + "$ref": "RegionSetLabelsRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute" + ], + "description": "Sets the labels on a VpnTunnel. To learn more about labels, read the Labeling Resources documentation." } } }, - "VpnGatewayStatusTunnel": { - "id": "VpnGatewayStatusTunnel", - "description": "Contains some information about a VPN tunnel.", - "type": "object", - "properties": { - "localGatewayInterface": { - "description": "The VPN gateway interface this VPN tunnel is associated with.", - "type": "integer", - "format": "uint32" - }, - "peerGatewayInterface": { - "description": "The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway.", - "type": "integer", - "format": "uint32" + "zones": { + "methods": { + "list": { + "id": "compute.zones.list", + "path": "projects/{project}/zones", + "flatPath": "projects/{project}/zones", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project" + ], + "response": { + "$ref": "ZoneList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Retrieves the list of Zone resources available to the specified project." }, - "tunnelUrl": { - "description": "URL reference to the VPN tunnel.", - "type": "string" + "get": { + "id": "compute.zones.get", + "path": "projects/{project}/zones/{zone}", + "flatPath": "projects/{project}/zones/{zone}", + "httpMethod": "GET", + "parameters": { + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "zone": { + "description": "Name of the zone resource to return.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", + "location": "path", + "required": true, + "type": "string" + } + }, + "parameterOrder": [ + "project", + "zone" + ], + "response": { + "$ref": "Zone" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" + ], + "description": "Returns the specified Zone resource." } } }, - "VpnGatewayStatusHighAvailabilityRequirementState": { - "id": "VpnGatewayStatusHighAvailabilityRequirementState", - "description": "Describes the high availability requirement state for the VPN connection between this Cloud VPN gateway and a peer gateway.", - "type": "object", - "properties": { - "state": { - "description": "Indicates the high availability requirement state for the VPN connection. Valid values are CONNECTION_REDUNDANCY_MET, CONNECTION_REDUNDANCY_NOT_MET.", - "type": "string", - "enumDescriptions": [ - "VPN tunnels are configured with adequate redundancy from Cloud VPN gateway to the peer VPN gateway. For both GCP-to-non-GCP and GCP-to-GCP connections, the adequate redundancy is a pre-requirement for users to get 99.99% availability on GCP side; please note that for any connection, end-to-end 99.99% availability is subject to proper configuration on the peer VPN gateway.", - "VPN tunnels are not configured with adequate redundancy from the Cloud VPN gateway to the peer gateway" + "regionZones": { + "methods": { + "list": { + "id": "compute.regionZones.list", + "path": "projects/{project}/regions/{region}/zones", + "flatPath": "projects/{project}/regions/{region}/zones", + "httpMethod": "GET", + "parameters": { + "filter": { + "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", + "location": "query", + "type": "string" + }, + "maxResults": { + "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", + "default": "500", + "minimum": "0", + "location": "query", + "type": "integer", + "format": "uint32" + }, + "orderBy": { + "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", + "location": "query", + "type": "string" + }, + "pageToken": { + "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", + "location": "query", + "type": "string" + }, + "project": { + "description": "Project ID for this request.", + "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", + "location": "path", + "required": true, + "type": "string" + }, + "region": { + "description": "Region for this request.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "location": "path", + "required": true, + "type": "string" + }, + "returnPartialSuccess": { + "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", + "location": "query", + "type": "boolean" + } + }, + "parameterOrder": [ + "project", + "region" ], - "enum": [ - "CONNECTION_REDUNDANCY_MET", - "CONNECTION_REDUNDANCY_NOT_MET" - ] - }, - "unsatisfiedReason": { - "description": "Indicates the reason why the VPN connection does not meet the high availability redundancy criteria/requirement. Valid values is INCOMPLETE_TUNNELS_COVERAGE.", - "type": "string", - "enumDescriptions": [ - "" + "response": { + "$ref": "ZoneList" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/compute", + "https://www.googleapis.com/auth/compute.readonly" ], - "enum": [ - "INCOMPLETE_TUNNELS_COVERAGE" - ] + "description": "Retrieves the list of Zone resources under the specific region available to the specified project." } } - }, - "VpnTunnelList": { - "id": "VpnTunnelList", - "description": "Contains a list of VpnTunnel resources.", + } + }, + "basePath": "/compute/v1/", + "servicePath": "compute/v1/", + "revision": "20241015", + "discoveryVersion": "v1", + "title": "Compute Engine API", + "name": "compute", + "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" + }, + "mtlsRootUrl": "https://compute.mtls.googleapis.com/", + "schemas": { + "AcceleratorTypeList": { + "id": "AcceleratorTypeList", + "description": "Contains a list of accelerator types.", "type": "object", "properties": { "kind": { - "description": "[Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels.", - "default": "compute#vpnTunnelList", + "description": "[Output Only] Type of resource. Always compute#acceleratorTypeList for lists of accelerator types.", + "default": "compute#acceleratorTypeList", "type": "string" }, "id": { @@ -47023,10 +37410,10 @@ "type": "string" }, "items": { - "description": "A list of VpnTunnel resources.", + "description": "A list of AcceleratorType resources.", "type": "array", "items": { - "$ref": "VpnTunnel" + "$ref": "AcceleratorType" } }, "nextPageToken": { @@ -47160,14 +37547,14 @@ } } }, - "VpnTunnel": { - "id": "VpnTunnel", - "description": "Represents a Cloud VPN Tunnel resource. For more information about VPN, read the the Cloud VPN Overview.", + "AcceleratorType": { + "id": "AcceleratorType", + "description": "Represents an Accelerator Type resource. Google Cloud Platform provides graphics processing units (accelerators) that you can add to VM instances to improve or accelerate performance when working with intensive workloads. For more information, read GPUs on Compute Engine.", "type": "object", "properties": { "kind": { - "description": "[Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels.", - "default": "compute#vpnTunnel", + "description": "[Output Only] The type of the resource. Always compute#acceleratorType for accelerator types.", + "default": "compute#acceleratorType", "type": "string" }, "id": { @@ -47180,147 +37567,79 @@ "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.", + "description": "[Output Only] Name of the resource.", "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "annotations": { - "required": [ - "compute.vpnTunnels.insert" - ] - }, "type": "string" }, "description": { - "description": "An optional description of this resource. Provide this property when you create the resource.", - "type": "string" - }, - "region": { - "description": "[Output Only] URL of the region where the VPN tunnel resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "description": "[Output Only] An optional textual description of the resource.", "type": "string" }, - "targetVpnGateway": { - "description": "URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This field can be set only for Classic VPN tunnels.", - "type": "string" + "deprecated": { + "description": "[Output Only] The deprecation status associated with this accelerator type.", + "$ref": "DeprecationStatus" }, - "vpnGateway": { - "description": "URL of the VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This must be used (instead of target_vpn_gateway) if a High Availability VPN gateway resource is created.", + "zone": { + "description": "[Output Only] The name of the zone where the accelerator type resides, such as us-central1-a. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", "type": "string" }, - "vpnGatewayInterface": { - "description": "The interface ID of the VPN gateway with which this VPN tunnel is associated. Possible values are: `0`, `1`.", - "type": "integer", - "format": "int32" - }, - "peerExternalGateway": { - "description": "URL of the peer side external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field is exclusive with the field peerGcpGateway.", + "selfLink": { + "description": "[Output Only] Server-defined, fully qualified URL for this resource.", "type": "string" }, - "peerExternalGatewayInterface": { - "description": "The interface ID of the external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the external VPN gateway redundancy type.", + "maximumCardsPerInstance": { + "description": "[Output Only] Maximum number of accelerator cards allowed per instance.", "type": "integer", "format": "int32" - }, - "peerGcpGateway": { - "description": "URL of the peer side HA VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field can be used when creating highly available VPN from VPC network to VPC network, the field is exclusive with the field peerExternalGateway. If provided, the VPN tunnel will automatically use the same vpnGatewayInterface ID in the peer Google Cloud VPN gateway.", - "type": "string" - }, - "router": { - "description": "URL of the router resource to be used for dynamic routing.", - "type": "string" - }, - "peerIp": { - "description": "IP address of the peer VPN gateway. Only IPv4 is supported. This field can be set only for Classic VPN tunnels.", - "type": "string" - }, - "sharedSecret": { - "description": "Shared secret used to set the secure session between the Cloud VPN gateway and the peer VPN gateway.", - "type": "string" - }, - "sharedSecretHash": { - "description": "Hash of the shared secret.", - "type": "string" - }, - "status": { - "description": "[Output Only] The status of the VPN tunnel, which can be one of the following: - PROVISIONING: Resource is being allocated for the VPN tunnel. - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs from the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route resources are needed to setup the VPN tunnel. - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. - ESTABLISHED: Secure session is successfully established with the peer VPN. - NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS - AUTHORIZATION_ERROR: Auth error (for example, bad shared secret). - NEGOTIATION_FAILURE: Handshake failed. - DEPROVISIONING: Resources are being deallocated for the VPN tunnel. - FAILED: Tunnel creation has failed and the tunnel is not ready to be used. - NO_INCOMING_PACKETS: No incoming packets from peer. - REJECTED: Tunnel configuration was rejected, can be result of being denied access. - ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all required resources. - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted for Classic VPN tunnels or the project is in frozen state. - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, probably behind NAT. - TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing not allowed for an HA-VPN tunnel. ", + } + } + }, + "DeprecationStatus": { + "id": "DeprecationStatus", + "description": "Deprecation status for a public resource.", + "type": "object", + "properties": { + "state": { + "description": "The deprecation state of this resource. This can be ACTIVE, DEPRECATED, OBSOLETE, or DELETED. Operations which communicate the end of life date for an image, can use ACTIVE. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.", "type": "string", "enumDescriptions": [ - "Cloud VPN is in the process of allocating all required resources (specifically, a borg task).", - "Auth error (e.g. bad shared secret).", - "Resources is being deallocated for the VPN tunnel.", - "Secure session is successfully established with peer VPN.", - "Tunnel creation has failed and the tunnel is not ready to be used.", - "Successful first handshake with peer VPN.", - "Handshake failed.", - "Deprecated, replaced by NO_INCOMING_PACKETS", - "No incoming packets from peer", - "Resource is being allocated for the VPN tunnel.", - "Tunnel configuration was rejected, can be result of being denylisted.", - "Tunnel is stopped due to its Forwarding Rules being deleted.", - "Waiting to receive all VPN-related configs from user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule and Route resources are needed to setup VPN tunnel." + "", + "", + "", + "" ], "enum": [ - "ALLOCATING_RESOURCES", - "AUTHORIZATION_ERROR", - "DEPROVISIONING", - "ESTABLISHED", - "FAILED", - "FIRST_HANDSHAKE", - "NEGOTIATION_FAILURE", - "NETWORK_ERROR", - "NO_INCOMING_PACKETS", - "PROVISIONING", - "REJECTED", - "STOPPED", - "WAITING_FOR_FULL_CONFIG" + "ACTIVE", + "DELETED", + "DEPRECATED", + "OBSOLETE" ] }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", + "replacement": { + "description": "The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.", "type": "string" }, - "ikeVersion": { - "description": "IKE protocol version to use when establishing the VPN tunnel with the peer VPN gateway. Acceptable IKE versions are 1 or 2. The default version is 2.", - "type": "integer", - "format": "int32" - }, - "detailedStatus": { - "description": "[Output Only] Detailed status message for the VPN tunnel.", + "deprecated": { + "description": "An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DEPRECATED. This is only informational and the status will not change unless the client explicitly changes it.", "type": "string" }, - "localTrafficSelector": { - "description": "Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels.", - "type": "array", - "items": { - "type": "string" - } - }, - "remoteTrafficSelector": { - "description": "Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels.", - "type": "array", - "items": { - "type": "string" - } - }, - "labels": { - "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", - "type": "object", - "additionalProperties": { - "type": "string" - } + "obsolete": { + "description": "An optional RFC3339 timestamp on or after which the state of this resource is intended to change to OBSOLETE. This is only informational and the status will not change unless the client explicitly changes it.", + "type": "string" }, - "labelFingerprint": { - "description": "A fingerprint for the labels being applied to this VpnTunnel, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnTunnel.", - "type": "string", - "format": "byte" + "deleted": { + "description": "An optional RFC3339 timestamp on or after which the state of this resource is intended to change to DELETED. This is only informational and the status will not change unless the client explicitly changes it.", + "type": "string" } } }, - "VpnTunnelAggregatedList": { - "id": "VpnTunnelAggregatedList", + "AcceleratorTypeAggregatedList": { + "id": "AcceleratorTypeAggregatedList", "type": "object", "properties": { "kind": { - "description": "[Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels.", - "default": "compute#vpnTunnelAggregatedList", + "description": "[Output Only] Type of resource. Always compute#acceleratorTypeAggregatedList for aggregated lists of accelerator types.", + "default": "compute#acceleratorTypeAggregatedList", "type": "string" }, "id": { @@ -47328,11 +37647,11 @@ "type": "string" }, "items": { - "description": "A list of VpnTunnelsScopedList resources.", + "description": "A list of AcceleratorTypesScopedList resources.", "type": "object", "additionalProperties": { - "description": "Name of the scope containing this set of VPN tunnels.", - "$ref": "VpnTunnelsScopedList" + "description": "[Output Only] Name of the scope containing this set of accelerator types.", + "$ref": "AcceleratorTypesScopedList" } }, "nextPageToken": { @@ -47473,19 +37792,19 @@ } } }, - "VpnTunnelsScopedList": { - "id": "VpnTunnelsScopedList", + "AcceleratorTypesScopedList": { + "id": "AcceleratorTypesScopedList", "type": "object", "properties": { - "vpnTunnels": { - "description": "A list of VPN tunnels contained in this scope.", + "acceleratorTypes": { + "description": "[Output Only] A list of accelerator types contained in this scope.", "type": "array", "items": { - "$ref": "VpnTunnel" + "$ref": "AcceleratorType" } }, "warning": { - "description": "Informational warning which replaces the list of addresses when the list is empty.", + "description": "[Output Only] An informational warning that appears when the accelerator types list is empty.", "type": "object", "properties": { "code": { @@ -47607,29 +37926,29 @@ } } }, - "ZoneList": { - "id": "ZoneList", - "description": "Contains a list of zone resources.", + "OperationList": { + "id": "OperationList", + "description": "Contains a list of Operation resources.", "type": "object", "properties": { "kind": { - "description": "Type of resource.", - "default": "compute#zoneList", + "description": "[Output Only] Type of resource. Always `compute#operations` for Operations resource.", + "default": "compute#operationList", "type": "string" }, "id": { - "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", "type": "string" }, "items": { - "description": "A list of Zone resources.", + "description": "[Output Only] A list of Operation resources.", "type": "array", "items": { - "$ref": "Zone" + "$ref": "Operation" } }, "nextPageToken": { - "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results.", "type": "string" }, "selfLink": { @@ -47758,37843 +38077,46291 @@ } } } - }, - "Zone": { - "id": "Zone", - "description": "Represents a Zone resource. A zone is a deployment area. These deployment areas are subsets of a region. For example the zone us-east1-b is located in the us-east1 region. For more information, read Regions and Zones.", + }, + "Operation": { + "id": "Operation", + "description": "Represents an Operation resource. Google Compute Engine has three Operation resources: * [Global](/compute/docs/reference/rest/v1/globalOperations) * [Regional](/compute/docs/reference/rest/v1/regionOperations) * [Zonal](/compute/docs/reference/rest/v1/zoneOperations) You can use an operation resource to manage asynchronous API requests. For more information, read Handling API responses. Operations can be global, regional or zonal. - For global operations, use the `globalOperations` resource. - For regional operations, use the `regionOperations` resource. - For zonal operations, use the `zoneOperations` resource. For more information, read Global, Regional, and Zonal Resources. Note that completed Operation resources have a limited retention period.", "type": "object", "properties": { "kind": { - "description": "[Output Only] Type of the resource. Always compute#zone for zones.", - "default": "compute#zone", + "description": "[Output Only] Type of the resource. Always `compute#operation` for Operation resources.", + "default": "compute#operation", "type": "string" }, "id": { - "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "description": "[Output Only] The unique identifier for the operation. This identifier is defined by the server.", "type": "string", "format": "uint64" }, "creationTimestamp": { - "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "description": "[Deprecated] This field is deprecated.", "type": "string" }, "name": { - "description": "[Output Only] Name of the resource.", + "description": "[Output Only] Name of the operation.", "type": "string" }, - "description": { - "description": "[Output Only] Textual description of the resource.", + "zone": { + "description": "[Output Only] The URL of the zone where the operation resides. Only applicable when performing per-zone operations.", + "type": "string" + }, + "clientOperationId": { + "description": "[Output Only] The value of `requestId` if you provided it in the request. Not present otherwise.", + "type": "string" + }, + "operationType": { + "description": "[Output Only] The type of operation, such as `insert`, `update`, or `delete`, and so on.", + "type": "string" + }, + "targetLink": { + "description": "[Output Only] The URL of the resource that the operation modifies. For operations related to creating a snapshot, this points to the disk that the snapshot was created from.", "type": "string" }, + "targetId": { + "description": "[Output Only] The unique target ID, which identifies a specific incarnation of the target resource.", + "type": "string", + "format": "uint64" + }, "status": { - "description": "[Output Only] Status of the zone, either UP or DOWN.", + "description": "[Output Only] The status of the operation, which can be one of the following: `PENDING`, `RUNNING`, or `DONE`.", "type": "string", "enumDescriptions": [ + "", "", "" ], "enum": [ - "DOWN", - "UP" + "DONE", + "PENDING", + "RUNNING" ] }, - "deprecated": { - "description": "[Output Only] The deprecation status associated with this zone.", - "$ref": "DeprecationStatus" - }, - "region": { - "description": "[Output Only] Full URL reference to the region which hosts the zone.", + "statusMessage": { + "description": "[Output Only] An optional textual description of the current status of the operation.", "type": "string" }, - "selfLink": { - "description": "[Output Only] Server-defined URL for the resource.", + "user": { + "description": "[Output Only] User who requested the operation, for example: `user@example.com` or `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.", "type": "string" }, - "availableCpuPlatforms": { - "description": "[Output Only] Available cpu/platform selections for the zone.", - "type": "array", - "items": { - "type": "string" - } - }, - "supportsPzs": { - "description": "[Output Only] Reserved for future use.", - "type": "boolean" - } - } - }, - "AuditConfig": { - "id": "AuditConfig", - "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.", - "type": "object", - "properties": { - "exemptedMembers": { - "description": "This is deprecated and has no effect. Do not use.", - "type": "array", - "items": { - "type": "string" - } + "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 when the operation will be complete. This number should monotonically increase as the operation progresses.", + "type": "integer", + "format": "int32" }, - "auditLogConfigs": { - "description": "The configuration for logging of each type of permission.", - "type": "array", - "items": { - "$ref": "AuditLogConfig" - } + "insertTime": { + "description": "[Output Only] The time that this operation was requested. This value is in RFC3339 text format.", + "type": "string" }, - "service": { - "description": "Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.", + "startTime": { + "description": "[Output Only] The time that this operation was started by the server. This value is in RFC3339 text format.", "type": "string" - } - } - } - }, - "protocol": "rest", - "revision": "20240903", - "documentationLink": "https://cloud.google.com/compute/", - "basePath": "/compute/v1/", - "resources": { - "acceleratorTypes": { - "methods": { - "list": { - "id": "compute.acceleratorTypes.list", - "path": "projects/{project}/zones/{zone}/acceleratorTypes", - "flatPath": "projects/{project}/zones/{zone}/acceleratorTypes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "AcceleratorTypeList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of accelerator types that are available to the specified project." }, - "aggregatedList": { - "id": "compute.acceleratorTypes.aggregatedList", - "path": "projects/{project}/aggregated/acceleratorTypes", - "flatPath": "projects/{project}/aggregated/acceleratorTypes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "AcceleratorTypeAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of accelerator types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "endTime": { + "description": "[Output Only] The time that this operation was completed. This value is in RFC3339 text format.", + "type": "string" }, - "get": { - "id": "compute.acceleratorTypes.get", - "path": "projects/{project}/zones/{zone}/acceleratorTypes/{acceleratorType}", - "flatPath": "projects/{project}/zones/{zone}/acceleratorTypes/{acceleratorType}", - "httpMethod": "GET", - "parameters": { - "acceleratorType": { - "description": "Name of the accelerator type to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "acceleratorType" - ], - "response": { - "$ref": "AcceleratorType" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified accelerator type." - } - } - }, - "globalOperations": { - "methods": { - "list": { - "id": "compute.globalOperations.list", - "path": "projects/{project}/global/operations", - "flatPath": "projects/{project}/global/operations", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "error": { + "description": "[Output Only] If errors are generated during processing of the operation, this field will be populated.", + "type": "object", + "properties": { + "errors": { + "description": "[Output Only] The array of errors encountered while processing this operation.", + "type": "array", + "items": { + "type": "object", + "properties": { + "code": { + "description": "[Output Only] The error type identifier for this error.", + "type": "string" + }, + "location": { + "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", + "type": "string" + }, + "message": { + "description": "[Output Only] An optional, human-readable error message.", + "type": "string" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", + "type": "array", + "items": { + "type": "object", + "properties": { + "errorInfo": { + "$ref": "ErrorInfo" + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo" + }, + "help": { + "$ref": "Help" + }, + "localizedMessage": { + "$ref": "LocalizedMessage" + } + } + } + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "OperationList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of Operation resources contained within the specified project." + } }, - "aggregatedList": { - "id": "compute.globalOperations.aggregatedList", - "path": "projects/{project}/aggregated/operations", - "flatPath": "projects/{project}/aggregated/operations", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "warnings": { + "description": "[Output Only] If warning messages are generated during processing of the operation, this field will be populated.", + "type": "array", + "items": { + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "OperationAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of all operations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + } }, - "get": { - "id": "compute.globalOperations.get", - "path": "projects/{project}/global/operations/{operation}", - "flatPath": "projects/{project}/global/operations/{operation}", - "httpMethod": "GET", - "parameters": { - "operation": { - "description": "Name of the Operations resource to return, or its unique numeric identifier.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "operation" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the specified Operations resource." + "httpErrorStatusCode": { + "description": "[Output Only] If the operation fails, this field contains the HTTP error status code that was returned. For example, a `404` means the resource was not found.", + "type": "integer", + "format": "int32" }, - "wait": { - "id": "compute.globalOperations.wait", - "path": "projects/{project}/global/operations/{operation}/wait", - "flatPath": "projects/{project}/global/operations/{operation}/wait", - "httpMethod": "POST", - "parameters": { - "operation": { - "description": "Name of the Operations resource to return, or its unique numeric identifier.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "operation" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. " + "httpErrorMessage": { + "description": "[Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as `NOT FOUND`.", + "type": "string" }, - "delete": { - "id": "compute.globalOperations.delete", - "path": "projects/{project}/global/operations/{operation}", - "flatPath": "projects/{project}/global/operations/{operation}", - "httpMethod": "DELETE", - "parameters": { - "operation": { - "description": "Name of the Operations resource to delete, or its unique numeric identifier.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "operation" - ], - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified Operations resource." + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] The URL of the region where the operation resides. Only applicable when performing regional operations.", + "type": "string" + }, + "description": { + "description": "[Output Only] A textual description of the operation, which is set when the operation is created.", + "type": "string" + }, + "operationGroupId": { + "description": "[Output Only] An ID that represents a group of operations, such as when a group of operations results from a `bulkInsert` API request.", + "type": "string" + }, + "setCommonInstanceMetadataOperationMetadata": { + "description": "[Output Only] If the operation is for projects.setCommonInstanceMetadata, this field will contain information on all underlying zonal actions and their state.", + "$ref": "SetCommonInstanceMetadataOperationMetadata" + }, + "instancesBulkInsertOperationMetadata": { + "$ref": "InstancesBulkInsertOperationMetadata" } } }, - "globalOrganizationOperations": { - "methods": { - "list": { - "id": "compute.globalOrganizationOperations.list", - "path": "locations/global/operations", - "flatPath": "locations/global/operations", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "parentId": { - "description": "Parent ID for this request.", - "location": "query", - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "response": { - "$ref": "OperationList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of Operation resources contained within the specified organization." + "ErrorInfo": { + "id": "ErrorInfo", + "description": "Describes the cause of the error with structured details. Example of an error when contacting the \"pubsub.googleapis.com\" API when it is not enabled: { \"reason\": \"API_DISABLED\" \"domain\": \"googleapis.com\" \"metadata\": { \"resource\": \"projects/123\", \"service\": \"pubsub.googleapis.com\" } } This response indicates that the pubsub.googleapis.com API is not enabled. Example of an error that is returned when attempting to create a Spanner instance in a region that is out of stock: { \"reason\": \"STOCKOUT\" \"domain\": \"spanner.googleapis.com\", \"metadata\": { \"availableRegions\": \"us-central1,us-east2\" } }", + "type": "object", + "properties": { + "reason": { + "description": "The reason of the error. This is a constant value that identifies the proximate cause of the error. Error reasons are unique within a particular domain of errors. This should be at most 63 characters and match a regular expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE.", + "type": "string" }, - "get": { - "id": "compute.globalOrganizationOperations.get", - "path": "locations/global/operations/{operation}", - "flatPath": "locations/global/operations/{operation}", - "httpMethod": "GET", - "parameters": { - "operation": { - "description": "Name of the Operations resource to return, or its unique numeric identifier.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "parentId": { - "description": "Parent ID for this request.", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "operation" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the specified Operations resource. Gets a list of operations by making a `list()` request." + "domain": { + "description": "The logical grouping to which the \"reason\" belongs. The error domain is typically the registered service name of the tool or product that generates the error. Example: \"pubsub.googleapis.com\". If the error is generated by some common infrastructure, the error domain must be a globally unique value that identifies the infrastructure. For Google API infrastructure, the error domain is \"googleapis.com\".", + "type": "string" }, - "delete": { - "id": "compute.globalOrganizationOperations.delete", - "path": "locations/global/operations/{operation}", - "flatPath": "locations/global/operations/{operation}", - "httpMethod": "DELETE", - "parameters": { - "operation": { - "description": "Name of the Operations resource to delete, or its unique numeric identifier.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "parentId": { - "description": "Parent ID for this request.", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "operation" - ], - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified Operations resource." + "metadatas": { + "description": "Additional structured details about this error. Keys must match /a-z+/ but should ideally be lowerCamelCase. Also they must be limited to 64 characters in length. When identifying the current value of an exceeded limit, the units should be contained in the key, not the value. For example, rather than {\"instanceLimit\": \"100/request\"}, should be returned as, {\"instanceLimitPerRequest\": \"100\"}, if the client exceeds the number of instances that can be created in a single (batch) request.", + "type": "object", + "additionalProperties": { + "type": "string" + } } } }, - "zoneOperations": { - "methods": { - "list": { - "id": "compute.zoneOperations.list", - "path": "projects/{project}/zones/{zone}/operations", - "flatPath": "projects/{project}/zones/{zone}/operations", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "Name of the zone for request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "OperationList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of Operation resources contained within the specified zone." + "QuotaExceededInfo": { + "id": "QuotaExceededInfo", + "description": "Additional details for quota exceeded error for resource quota.", + "type": "object", + "properties": { + "metricName": { + "description": "The Compute Engine quota metric name.", + "type": "string" }, - "get": { - "id": "compute.zoneOperations.get", - "path": "projects/{project}/zones/{zone}/operations/{operation}", - "flatPath": "projects/{project}/zones/{zone}/operations/{operation}", - "httpMethod": "GET", - "parameters": { - "operation": { - "description": "Name of the Operations resource to return, or its unique numeric identifier.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "operation" + "limitName": { + "description": "The name of the quota limit.", + "type": "string" + }, + "dimensions": { + "description": "The map holding related quota dimensions.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "limit": { + "description": "Current effective quota limit. The limit's unit depends on the quota type or metric.", + "type": "number", + "format": "double" + }, + "futureLimit": { + "description": "Future quota limit being rolled out. The limit's unit depends on the quota type or metric.", + "type": "number", + "format": "double" + }, + "rolloutStatus": { + "description": "Rollout status of the future quota limit.", + "type": "string", + "enumDescriptions": [ + "IN_PROGRESS - A rollout is in process which will change the limit value to future limit.", + "ROLLOUT_STATUS_UNSPECIFIED - Rollout status is not specified. The default value." ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "IN_PROGRESS", + "ROLLOUT_STATUS_UNSPECIFIED" + ] + } + } + }, + "Help": { + "id": "Help", + "description": "Provides links to documentation or for performing an out of band action. For example, if a quota check failed with an error indicating the calling project hasn't enabled the accessed service, this can contain a URL pointing directly to the right place in the developer console to flip the bit.", + "type": "object", + "properties": { + "links": { + "description": "URL(s) pointing to additional information on handling the current error.", + "type": "array", + "items": { + "$ref": "HelpLink" + } + } + } + }, + "HelpLink": { + "id": "HelpLink", + "description": "Describes a URL link.", + "type": "object", + "properties": { + "description": { + "description": "Describes what the link offers.", + "type": "string" + }, + "url": { + "description": "The URL of the link.", + "type": "string" + } + } + }, + "LocalizedMessage": { + "id": "LocalizedMessage", + "description": "Provides a localized error message that is safe to return to the user which can be attached to an RPC error.", + "type": "object", + "properties": { + "locale": { + "description": "The locale used following the specification defined at https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: \"en-US\", \"fr-CH\", \"es-MX\"", + "type": "string" + }, + "message": { + "description": "The localized error message in the above locale.", + "type": "string" + } + } + }, + "SetCommonInstanceMetadataOperationMetadata": { + "id": "SetCommonInstanceMetadataOperationMetadata", + "type": "object", + "properties": { + "clientOperationId": { + "description": "[Output Only] The client operation id.", + "type": "string" + }, + "perLocationOperations": { + "description": "[Output Only] Status information per location (location name is key). Example key: zones/us-central1-a", + "type": "object", + "additionalProperties": { + "$ref": "SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo" + } + } + } + }, + "SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo": { + "id": "SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo", + "type": "object", + "properties": { + "state": { + "description": "[Output Only] Status of the action, which can be one of the following: `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.", + "type": "string", + "enumDescriptions": [ + "Operation not tracked in this location e.g. zone is marked as DOWN.", + "Operation has completed successfully.", + "Operation is in an error state.", + "Operation is confirmed to be in the location.", + "Operation is not yet confirmed to have been created in the location.", + "" ], - "description": "Retrieves the specified zone-specific Operations resource." + "enum": [ + "ABANDONED", + "DONE", + "FAILED", + "PROPAGATED", + "PROPAGATING", + "UNSPECIFIED" + ] }, - "wait": { - "id": "compute.zoneOperations.wait", - "path": "projects/{project}/zones/{zone}/operations/{operation}/wait", - "flatPath": "projects/{project}/zones/{zone}/operations/{operation}/wait", - "httpMethod": "POST", - "parameters": { - "operation": { - "description": "Name of the Operations resource to return, or its unique numeric identifier.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "operation" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method waits for no more than the 2 minutes and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. " + "error": { + "description": "[Output Only] If state is `ABANDONED` or `FAILED`, this field is populated.", + "$ref": "Status" + } + } + }, + "Status": { + "id": "Status", + "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", + "type": "object", + "properties": { + "code": { + "description": "The status code, which should be an enum value of google.rpc.Code.", + "type": "integer", + "format": "int32" }, - "delete": { - "id": "compute.zoneOperations.delete", - "path": "projects/{project}/zones/{zone}/operations/{operation}", - "flatPath": "projects/{project}/zones/{zone}/operations/{operation}", - "httpMethod": "DELETE", - "parameters": { - "operation": { - "description": "Name of the Operations resource to delete, or its unique numeric identifier.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "message": { + "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", + "type": "string" + }, + "details": { + "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", + "type": "array", + "items": { + "type": "object", + "additionalProperties": { + "type": "any", + "description": "Properties of the object. Contains field @type with type URL." } - }, - "parameterOrder": [ - "project", - "zone", - "operation" - ], - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified zone-specific Operations resource." + } } } }, - "regionOperations": { - "methods": { - "list": { - "id": "compute.regionOperations.list", - "path": "projects/{project}/regions/{region}/operations", - "flatPath": "projects/{project}/regions/{region}/operations", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "OperationList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "InstancesBulkInsertOperationMetadata": { + "id": "InstancesBulkInsertOperationMetadata", + "type": "object", + "properties": { + "perLocationStatus": { + "description": "Status information per location (location name is key). Example key: zones/us-central1-a", + "type": "object", + "additionalProperties": { + "$ref": "BulkInsertOperationStatus" + } + } + } + }, + "BulkInsertOperationStatus": { + "id": "BulkInsertOperationStatus", + "type": "object", + "properties": { + "status": { + "description": "[Output Only] Creation status of BulkInsert operation - information if the flow is rolling forward or rolling back.", + "type": "string", + "enumDescriptions": [ + "Rolling forward - creating VMs.", + "Done", + "Rolling back - cleaning up after an error.", + "" ], - "description": "Retrieves a list of Operation resources contained within the specified region." + "enum": [ + "CREATING", + "DONE", + "ROLLING_BACK", + "STATUS_UNSPECIFIED" + ] }, - "get": { - "id": "compute.regionOperations.get", - "path": "projects/{project}/regions/{region}/operations/{operation}", - "flatPath": "projects/{project}/regions/{region}/operations/{operation}", - "httpMethod": "GET", - "parameters": { - "operation": { - "description": "Name of the Operations resource to return, or its unique numeric identifier.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "operation" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the specified region-specific Operations resource." + "targetVmCount": { + "description": "[Output Only] Count of VMs originally planned to be created.", + "type": "integer", + "format": "int32" }, - "wait": { - "id": "compute.regionOperations.wait", - "path": "projects/{project}/regions/{region}/operations/{operation}/wait", - "flatPath": "projects/{project}/regions/{region}/operations/{operation}/wait", - "httpMethod": "POST", - "parameters": { - "operation": { - "description": "Name of the Operations resource to return, or its unique numeric identifier.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "operation" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. This method is called on a best-effort basis. Specifically: - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. " + "createdVmCount": { + "description": "[Output Only] Count of VMs successfully created so far.", + "type": "integer", + "format": "int32" }, - "delete": { - "id": "compute.regionOperations.delete", - "path": "projects/{project}/regions/{region}/operations/{operation}", - "flatPath": "projects/{project}/regions/{region}/operations/{operation}", - "httpMethod": "DELETE", - "parameters": { - "operation": { - "description": "Name of the Operations resource to delete, or its unique numeric identifier.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "operation" - ], - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified region-specific Operations resource." + "failedToCreateVmCount": { + "description": "[Output Only] Count of VMs that started creating but encountered an error.", + "type": "integer", + "format": "int32" + }, + "deletedVmCount": { + "description": "[Output Only] Count of VMs that got deleted during rollback.", + "type": "integer", + "format": "int32" } } }, - "globalAddresses": { - "methods": { - "list": { - "id": "compute.globalAddresses.list", - "path": "projects/{project}/global/addresses", - "flatPath": "projects/{project}/global/addresses", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "AddressList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of global addresses." + "OperationAggregatedList": { + "id": "OperationAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always `compute#operationAggregatedList` for aggregated lists of operations.", + "default": "compute#operationAggregatedList", + "type": "string" }, - "get": { - "id": "compute.globalAddresses.get", - "path": "projects/{project}/global/addresses/{address}", - "flatPath": "projects/{project}/global/addresses/{address}", - "httpMethod": "GET", - "parameters": { - "address": { - "description": "Name of the address resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "address" - ], - "response": { - "$ref": "Address" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified address resource." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.globalAddresses.insert", - "path": "projects/{project}/global/addresses", - "flatPath": "projects/{project}/global/addresses", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "Address" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates an address resource in the specified project by using the data included in the request." + "items": { + "description": "[Output Only] A map of scoped operation lists.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of operations.", + "$ref": "OperationsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than `maxResults`, use the `nextPageToken` as a value for the query parameter `pageToken` in the next list request. Subsequent list requests will have their own `nextPageToken` to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" }, - "delete": { - "id": "compute.globalAddresses.delete", - "path": "projects/{project}/global/addresses/{address}", - "flatPath": "projects/{project}/global/addresses/{address}", - "httpMethod": "DELETE", - "parameters": { - "address": { - "description": "Name of the address resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "address" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified address resource." + } }, - "move": { - "id": "compute.globalAddresses.move", - "path": "projects/{project}/global/addresses/{address}/move", - "flatPath": "projects/{project}/global/addresses/{address}/move", - "httpMethod": "POST", - "parameters": { - "address": { - "description": "Name of the address resource to move.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Source project ID which the Address is moved from.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "address" - ], - "request": { - "$ref": "GlobalAddressesMoveRequest" - }, - "response": { + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "OperationsScopedList": { + "id": "OperationsScopedList", + "type": "object", + "properties": { + "operations": { + "description": "[Output Only] A list of operations contained in this scope.", + "type": "array", + "items": { "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Moves the specified address resource from one project to another project." + } }, - "setLabels": { - "id": "compute.globalAddresses.setLabels", - "path": "projects/{project}/global/addresses/{resource}/setLabels", - "flatPath": "projects/{project}/global/addresses/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] Informational warning which replaces the list of operations when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on a GlobalAddress. To learn more about labels, read the Labeling Resources documentation." + } } } }, - "addresses": { - "methods": { - "list": { - "id": "compute.addresses.list", - "path": "projects/{project}/regions/{region}/addresses", - "flatPath": "projects/{project}/regions/{region}/addresses", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "AddressList": { + "id": "AddressList", + "description": "Contains a list of addresses.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#addressList for lists of addresses.", + "default": "compute#addressList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Address resources.", + "type": "array", + "items": { + "$ref": "Address" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "AddressList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of addresses contained within the specified region." + } }, - "aggregatedList": { - "id": "compute.addresses.aggregatedList", - "path": "projects/{project}/aggregated/addresses", - "flatPath": "projects/{project}/aggregated/addresses", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + } + } + }, + "Address": { + "id": "Address", + "description": "Represents an IP Address resource. Google Compute Engine has two IP Address resources: * [Global (external and internal)](https://cloud.google.com/compute/docs/reference/rest/v1/globalAddresses) * [Regional (external and internal)](https://cloud.google.com/compute/docs/reference/rest/v1/addresses) For more information, see Reserving a static external IP address.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#address for addresses.", + "default": "compute#address", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "annotations": { + "required": [ + "compute.addresses.insert" + ] }, - "parameterOrder": [ - "project" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this field when you create the resource.", + "type": "string" + }, + "address": { + "description": "The static IP address represented by this resource.", + "type": "string" + }, + "prefixLength": { + "description": "The prefix length if the resource represents an IP range.", + "type": "integer", + "format": "int32" + }, + "status": { + "description": "[Output Only] The status of the address, which can be one of RESERVING, RESERVED, or IN_USE. An address that is RESERVING is currently in the process of being reserved. A RESERVED address is currently reserved and available to use. An IN_USE address is currently being used by another resource and is not available.", + "type": "string", + "enumDescriptions": [ + "Address is being used by another resource and is not available.", + "Address is reserved and available to use.", + "Address is being reserved." ], - "response": { - "$ref": "AddressAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "IN_USE", + "RESERVED", + "RESERVING" + ] + }, + "region": { + "description": "[Output Only] The URL of the region where a regional address resides. For regional addresses, you must specify the region as a path parameter in the HTTP request URL. *This field is not applicable to global addresses.*", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "users": { + "description": "[Output Only] The URLs of the resources that are using this address.", + "type": "array", + "items": { + "type": "string" + } + }, + "networkTier": { + "description": "This signifies the networking tier used for configuring this address and can only take the following values: PREMIUM or STANDARD. Internal IP addresses are always Premium Tier; global external IP addresses are always Premium Tier; regional external IP addresses can be either Standard or Premium Tier. If this field is not specified, it is assumed to be PREMIUM.", + "type": "string", + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking products.", + "Public internet quality, only limited support for other networking products.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." ], - "description": "Retrieves an aggregated list of addresses. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" + ] }, - "get": { - "id": "compute.addresses.get", - "path": "projects/{project}/regions/{region}/addresses/{address}", - "flatPath": "projects/{project}/regions/{region}/addresses/{address}", - "httpMethod": "GET", - "parameters": { - "address": { - "description": "Name of the address resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "address" + "labels": { + "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this Address, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Address.", + "type": "string", + "format": "byte" + }, + "ipVersion": { + "description": "The IP version that will be used by this address. Valid options are IPV4 or IPV6.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "response": { - "$ref": "Address" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "IPV4", + "IPV6", + "UNSPECIFIED_VERSION" + ] + }, + "addressType": { + "description": "The type of address to reserve, either INTERNAL or EXTERNAL. If unspecified, defaults to EXTERNAL.", + "type": "string", + "enumDescriptions": [ + "A publicly visible external IP address.", + "A private network IP address, for use with an Instance or Internal Load Balancer forwarding rule.", + "" ], - "description": "Returns the specified address resource." + "enum": [ + "EXTERNAL", + "INTERNAL", + "UNSPECIFIED_TYPE" + ] }, - "insert": { - "id": "compute.addresses.insert", - "path": "projects/{project}/regions/{region}/addresses", - "flatPath": "projects/{project}/regions/{region}/addresses", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" + "purpose": { + "description": "The purpose of this resource, which can be one of the following values: - GCE_ENDPOINT for addresses that are used by VM instances, alias IP ranges, load balancers, and similar resources. - DNS_RESOLVER for a DNS resolver address in a subnetwork for a Cloud DNS inbound forwarder IP addresses (regional internal IP address in a subnet of a VPC network) - VPC_PEERING for global internal IP addresses used for private services access allocated ranges. - NAT_AUTO for the regional external IP addresses used by Cloud NAT when allocating addresses using automatic NAT IP address allocation. - IPSEC_INTERCONNECT for addresses created from a private IP range that are reserved for a VLAN attachment in an *HA VPN over Cloud Interconnect* configuration. These addresses are regional resources. - `SHARED_LOADBALANCER_VIP` for an internal IP address that is assigned to multiple internal forwarding rules. - `PRIVATE_SERVICE_CONNECT` for a private network address that is used to configure Private Service Connect. Only global internal addresses can use this purpose. ", + "type": "string", + "enumDescriptions": [ + "DNS resolver address in the subnetwork.", + "VM internal/alias IP, Internal LB service IP, etc.", + "A regional internal IP address range reserved for the VLAN attachment that is used in HA VPN over Cloud Interconnect. This regional internal IP address range must not overlap with any IP address range of subnet/route in the VPC network and its peering networks. After the VLAN attachment is created with the reserved IP address range, when creating a new VPN gateway, its interface IP address is allocated from the associated VLAN attachment’s IP address range.", + "External IP automatically reserved for Cloud NAT.", + "A private network IP address that can be used to configure Private Service Connect. This purpose can be specified only for GLOBAL addresses of Type INTERNAL", + "A regional internal IP address range reserved for Serverless.", + "A private network IP address that can be shared by multiple Internal Load Balancer forwarding rules.", + "IP range for peer networks." ], - "request": { - "$ref": "Address" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "DNS_RESOLVER", + "GCE_ENDPOINT", + "IPSEC_INTERCONNECT", + "NAT_AUTO", + "PRIVATE_SERVICE_CONNECT", + "SERVERLESS", + "SHARED_LOADBALANCER_VIP", + "VPC_PEERING" + ] + }, + "subnetwork": { + "description": "The URL of the subnetwork in which to reserve the address. If an IP address is specified, it must be within the subnetwork's IP range. This field can only be used with INTERNAL type with a GCE_ENDPOINT or DNS_RESOLVER purpose.", + "type": "string" + }, + "network": { + "description": "The URL of the network in which to reserve the address. This field can only be used with INTERNAL type with the VPC_PEERING purpose.", + "type": "string" + }, + "ipv6EndpointType": { + "description": "The endpoint type of this address, which should be VM or NETLB. This is used for deciding which type of endpoint this address can be used after the external IPv6 address reservation.", + "type": "string", + "enumDescriptions": [ + "Reserved IPv6 address can be used on network load balancer.", + "Reserved IPv6 address can be used on VM." ], - "description": "Creates an address resource in the specified project by using the data included in the request." + "enum": [ + "NETLB", + "VM" + ] + } + } + }, + "GlobalAddressesMoveRequest": { + "id": "GlobalAddressesMoveRequest", + "type": "object", + "properties": { + "destinationAddress": { + "description": "The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project /global/addresses/address - projects/project/global/addresses/address Note that destination project must be different from the source project. So /global/addresses/address is not valid partial url.", + "type": "string" }, - "delete": { - "id": "compute.addresses.delete", - "path": "projects/{project}/regions/{region}/addresses/{address}", - "flatPath": "projects/{project}/regions/{region}/addresses/{address}", - "httpMethod": "DELETE", - "parameters": { - "address": { - "description": "Name of the address resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "description": { + "description": "An optional destination address description if intended to be different from the source.", + "type": "string" + } + } + }, + "GlobalSetLabelsRequest": { + "id": "GlobalSetLabelsRequest", + "type": "object", + "properties": { + "labels": { + "description": "A list of labels to apply for this resource. Each label must comply with the requirements for labels. For example, \"webserver-frontend\": \"images\". A label value can also be empty (e.g. \"my-label\": \"\").", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash when updating or changing labels, otherwise the request will fail with error 412 conditionNotMet. Make a get() request to the resource to get the latest fingerprint.", + "type": "string", + "format": "byte" + } + } + }, + "AddressAggregatedList": { + "id": "AddressAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#addressAggregatedList for aggregated lists of addresses.", + "default": "compute#addressAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of AddressesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of addresses.", + "$ref": "AddressesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "address" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified address resource." + } }, - "move": { - "id": "compute.addresses.move", - "path": "projects/{project}/regions/{region}/addresses/{address}/move", - "flatPath": "projects/{project}/regions/{region}/addresses/{address}/move", - "httpMethod": "POST", - "parameters": { - "address": { - "description": "Name of the address resource to move.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Source project ID which the Address is moved from.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "address" - ], - "request": { - "$ref": "RegionAddressesMoveRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Moves the specified address resource." + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "AddressesScopedList": { + "id": "AddressesScopedList", + "type": "object", + "properties": { + "addresses": { + "description": "[Output Only] A list of addresses contained in this scope.", + "type": "array", + "items": { + "$ref": "Address" + } }, - "setLabels": { - "id": "compute.addresses.setLabels", - "path": "projects/{project}/regions/{region}/addresses/{resource}/setLabels", - "flatPath": "projects/{project}/regions/{region}/addresses/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] Informational warning which replaces the list of addresses when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on an Address. To learn more about labels, read the Labeling Resources documentation." + } } } }, - "images": { - "methods": { - "list": { - "id": "compute.images.list", - "path": "projects/{project}/global/images", - "flatPath": "projects/{project}/global/images", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ImageList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of custom images available to the specified project. Custom images are images you create that belong to your project. This method does not get any images that belong to other projects, including publicly-available images, like Debian 8. If you want to get a list of publicly-available images, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud." + "RegionAddressesMoveRequest": { + "id": "RegionAddressesMoveRequest", + "type": "object", + "properties": { + "destinationAddress": { + "description": "The URL of the destination address to move to. This can be a full or partial URL. For example, the following are all valid URLs to a address: - https://www.googleapis.com/compute/v1/projects/project/regions/region /addresses/address - projects/project/regions/region/addresses/address Note that destination project must be different from the source project. So /regions/region/addresses/address is not valid partial url.", + "type": "string" }, - "get": { - "id": "compute.images.get", - "path": "projects/{project}/global/images/{image}", - "flatPath": "projects/{project}/global/images/{image}", - "httpMethod": "GET", - "parameters": { - "image": { - "description": "Name of the image resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "description": { + "description": "An optional destination address description if intended to be different from the source.", + "type": "string" + } + } + }, + "RegionSetLabelsRequest": { + "id": "RegionSetLabelsRequest", + "type": "object", + "properties": { + "labels": { + "description": "The labels to set for this resource.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint.", + "type": "string", + "format": "byte" + } + } + }, + "ImageList": { + "id": "ImageList", + "description": "Contains a list of images.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#imageList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Image resources.", + "type": "array", + "items": { + "$ref": "Image" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "image" - ], - "response": { - "$ref": "Image" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified image." - }, - "getFromFamily": { - "id": "compute.images.getFromFamily", - "path": "projects/{project}/global/images/family/{family}", - "flatPath": "projects/{project}/global/images/family/{family}", - "httpMethod": "GET", - "parameters": { - "family": { - "description": "Name of the image family to search for.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "project": { - "description": "The image project that the image belongs to. For example, to get a CentOS image, specify centos-cloud as the image project.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "family" - ], - "response": { - "$ref": "Image" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the latest image that is part of an image family and is not deprecated. For more information on image families, see Public image families documentation." + } + } + } + }, + "Image": { + "id": "Image", + "description": "Represents an Image resource. You can use images to create boot disks for your VM instances. For more information, read Images.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#image for images.", + "default": "compute#image", + "type": "string" }, - "insert": { - "id": "compute.images.insert", - "path": "projects/{project}/global/images", - "flatPath": "projects/{project}/global/images", - "httpMethod": "POST", - "parameters": { - "forceCreate": { - "description": "Force image creation if true.", - "location": "query", - "type": "boolean" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "Image" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/devstorage.full_control", - "https://www.googleapis.com/auth/devstorage.read_only", - "https://www.googleapis.com/auth/devstorage.read_write" - ], - "description": "Creates an image in the specified project using the data included in the request." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "setLabels": { - "id": "compute.images.setLabels", - "path": "projects/{project}/global/images/{resource}/setLabels", - "flatPath": "projects/{project}/global/images/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on an image. To learn more about labels, read the Labeling Resources documentation." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "delete": { - "id": "compute.images.delete", - "path": "projects/{project}/global/images/{image}", - "flatPath": "projects/{project}/global/images/{image}", - "httpMethod": "DELETE", - "parameters": { - "image": { - "description": "Name of the image resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "image" - ], - "response": { - "$ref": "Operation" + "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])?", + "annotations": { + "required": [ + "compute.images.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "sourceType": { + "description": "The type of the image used to create this disk. The default and only valid value is RAW.", + "default": "RAW", + "type": "string", + "enumDescriptions": [ + "" ], - "description": "Deletes the specified image." + "enum": [ + "RAW" + ] }, - "deprecate": { - "id": "compute.images.deprecate", - "path": "projects/{project}/global/images/{image}/deprecate", - "flatPath": "projects/{project}/global/images/{image}/deprecate", - "httpMethod": "POST", - "parameters": { - "image": { - "description": "Image name.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "rawDisk": { + "description": "The parameters of the raw disk image.", + "type": "object", + "properties": { + "source": { + "description": "The full Google Cloud Storage URL where the raw disk image archive is stored. The following are valid formats for the URL: - https://storage.googleapis.com/bucket_name/image_archive_name - https://storage.googleapis.com/bucket_name/folder_name/ image_archive_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL ", "type": "string" }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "sha1Checksum": { + "description": "[Deprecated] This field is deprecated. An optional SHA1 checksum of the disk image before unpackaging provided by the client when the disk image is created.", + "pattern": "[a-f0-9]{40}", + "deprecated": true, "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "containerType": { + "description": "The format used to encode and transmit the block device, which should be TAR. This is just a container and transmission format and not a runtime format. Provided by the client when the disk image is created.", + "type": "string", + "enumDescriptions": [ + "" + ], + "enum": [ + "TAR" + ] } - }, - "parameterOrder": [ - "project", - "image" - ], - "request": { - "$ref": "DeprecationStatus" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + } + }, + "deprecated": { + "description": "The deprecation status associated with this image.", + "$ref": "DeprecationStatus" + }, + "status": { + "description": "[Output Only] The status of the image. An image can be used to create other resources, such as instances, only after the image has been successfully created and the status is set to READY. Possible values are FAILED, PENDING, or READY.", + "type": "string", + "enumDescriptions": [ + "Image is deleting.", + "Image creation failed due to an error.", + "Image hasn't been created as yet.", + "Image has been successfully created." ], - "description": "Sets the deprecation status of an image. If an empty request body is given, clears the deprecation status instead." + "enum": [ + "DELETING", + "FAILED", + "PENDING", + "READY" + ] }, - "getIamPolicy": { - "id": "compute.images.getIamPolicy", - "path": "projects/{project}/global/images/{resource}/getIamPolicy", - "flatPath": "projects/{project}/global/images/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" + "archiveSizeBytes": { + "description": "Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).", + "type": "string", + "format": "int64" + }, + "diskSizeGb": { + "description": "Size of the image when restored onto a persistent disk (in GB).", + "type": "string", + "format": "int64" + }, + "sourceDisk": { + "description": "URL of the source disk used to create this image. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL ", + "type": "string" + }, + "sourceDiskId": { + "description": "[Output Only] 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" + }, + "licenses": { + "description": "Any applicable license URI.", + "type": "array", + "items": { + "type": "string" + } + }, + "family": { + "description": "The name of the image family to which this image belongs. The image family name can be from a publicly managed image family provided by Compute Engine, or from a custom image family you create. For example, centos-stream-9 is a publicly available image family. For more information, see Image family best practices. When creating disks, you can specify an image family instead of a specific image name. The image family always returns its latest image that is not deprecated. The name of the image family must comply with RFC1035.", + "type": "string" + }, + "imageEncryptionKey": { + "description": "Encrypts the image using a customer-supplied encryption key. After you encrypt an image with a customer-supplied key, you must provide the same key if you use the image later (e.g. to create a disk from the image). Customer-supplied encryption keys do not protect access to metadata of the disk. If you do not provide an encryption key when creating the image, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the image later.", + "$ref": "CustomerEncryptionKey" + }, + "sourceDiskEncryptionKey": { + "description": "The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key.", + "$ref": "CustomerEncryptionKey" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "labels": { + "description": "Labels to apply to this image. These can be later modified by the setLabels method.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this image, which is essentially a hash of the labels used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an image.", + "type": "string", + "format": "byte" + }, + "guestOsFeatures": { + "description": "A list of features to enable on the guest operating system. Applicable only for bootable images. To see a list of available options, see the guestOSfeatures[].type parameter.", + "type": "array", + "items": { + "$ref": "GuestOsFeature" + } + }, + "licenseCodes": { + "description": "Integer license codes indicating which licenses are attached to this image.", + "type": "array", + "items": { + "type": "string", + "format": "int64" + } + }, + "sourceImage": { + "description": "URL of the source image used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ images/image_name - projects/project_id/global/images/image_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL ", + "type": "string" + }, + "sourceImageId": { + "description": "[Output Only] The ID value of the image 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 image name.", + "type": "string" + }, + "sourceImageEncryptionKey": { + "description": "The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key.", + "$ref": "CustomerEncryptionKey" + }, + "sourceSnapshot": { + "description": "URL of the source snapshot used to create this image. The following are valid formats for the URL: - https://www.googleapis.com/compute/v1/projects/project_id/global/ snapshots/snapshot_name - projects/project_id/global/snapshots/snapshot_name In order to create an image, you must provide the full or partial URL of one of the following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The sourceSnapshot URL ", + "type": "string" + }, + "sourceSnapshotId": { + "description": "[Output Only] The ID value of the snapshot used to create this image. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given snapshot name.", + "type": "string" + }, + "sourceSnapshotEncryptionKey": { + "description": "The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key.", + "$ref": "CustomerEncryptionKey" + }, + "storageLocations": { + "description": "Cloud Storage bucket storage location of the image (regional or multi-regional).", + "type": "array", + "items": { + "type": "string" + } + }, + "shieldedInstanceInitialState": { + "description": "Set the secure boot keys of shielded instance.", + "$ref": "InitialStateConfig" + }, + "satisfiesPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "architecture": { + "description": "The architecture of the image. Valid values are ARM64 or X86_64.", + "type": "string", + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" + ] + }, + "enableConfidentialCompute": { + "description": "Whether this image is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk.", + "type": "boolean" + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + } + } + }, + "CustomerEncryptionKey": { + "id": "CustomerEncryptionKey", + "type": "object", + "properties": { + "rawKey": { + "description": "Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 base64 to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: \"rawKey\": \"SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=\" ", + "type": "string" + }, + "rsaEncryptedKey": { + "description": "Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit customer-supplied encryption key to either encrypt or decrypt this resource. You can provide either the rawKey or the rsaEncryptedKey. For example: \"rsaEncryptedKey\": \"ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==\" The key must meet the following requirements before you can provide it to Compute Engine: 1. The key is wrapped using a RSA public key certificate provided by Google. 2. After being wrapped, the key must be encoded in RFC 4648 base64 encoding. Gets the RSA public key certificate provided by Google at: https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem ", + "type": "string" + }, + "kmsKeyName": { + "description": "The name of the encryption key that is stored in Google Cloud KMS. For example: \"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key The fully-qualifed key name may be returned for resource GET requests. For example: \"kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeyVersions/1 ", + "type": "string" + }, + "sha256": { + "description": "[Output only] The RFC 4648 base64 encoded SHA-256 hash of the customer-supplied encryption key that protects this resource.", + "type": "string" + }, + "kmsKeyServiceAccount": { + "description": "The service account being used for the encryption request for the given KMS key. If absent, the Compute Engine default service account is used. For example: \"kmsKeyServiceAccount\": \"name@project_id.iam.gserviceaccount.com/ ", + "type": "string" + } + } + }, + "GuestOsFeature": { + "id": "GuestOsFeature", + "description": "Guest OS features.", + "type": "object", + "properties": { + "type": { + "description": "The ID of a supported feature. To add multiple values, use commas to separate values. Set to one or more of the following values: - VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE_V2 - SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF For more information, see Enabling guest operating system features.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "enum": [ + "FEATURE_TYPE_UNSPECIFIED", + "GVNIC", + "IDPF", + "MULTI_IP_SUBNET", + "SECURE_BOOT", + "SEV_CAPABLE", + "SEV_LIVE_MIGRATABLE", + "SEV_LIVE_MIGRATABLE_V2", + "SEV_SNP_CAPABLE", + "TDX_CAPABLE", + "UEFI_COMPATIBLE", + "VIRTIO_SCSI_MULTIQUEUE", + "WINDOWS" + ] + } + } + }, + "InitialStateConfig": { + "id": "InitialStateConfig", + "description": "Initial State for shielded instance, these are public keys which are safe to store in public", + "type": "object", + "properties": { + "pk": { + "description": "The Platform Key (PK).", + "$ref": "FileContentBuffer" }, - "patch": { - "id": "compute.images.patch", - "path": "projects/{project}/global/images/{image}", - "flatPath": "projects/{project}/global/images/{image}", - "httpMethod": "PATCH", - "parameters": { - "image": { - "description": "Name of the image resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "image" - ], - "request": { - "$ref": "Image" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified image with the data included in the request. Only the following fields can be modified: family, description, deprecation status." + "keks": { + "description": "The Key Exchange Key (KEK).", + "type": "array", + "items": { + "$ref": "FileContentBuffer" + } }, - "setIamPolicy": { - "id": "compute.images.setIamPolicy", - "path": "projects/{project}/global/images/{resource}/setIamPolicy", - "flatPath": "projects/{project}/global/images/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "dbs": { + "description": "The Key Database (db).", + "type": "array", + "items": { + "$ref": "FileContentBuffer" + } }, - "testIamPermissions": { - "id": "compute.images.testIamPermissions", - "path": "projects/{project}/global/images/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/images/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + "dbxs": { + "description": "The forbidden key database (dbx).", + "type": "array", + "items": { + "$ref": "FileContentBuffer" + } } } }, - "imageFamilyViews": { - "methods": { - "get": { - "id": "compute.imageFamilyViews.get", - "path": "projects/{project}/zones/{zone}/imageFamilyViews/{family}", - "flatPath": "projects/{project}/zones/{zone}/imageFamilyViews/{family}", - "httpMethod": "GET", - "parameters": { - "family": { - "description": "Name of the image family to search for.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "family" - ], - "response": { - "$ref": "ImageFamilyView" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "FileContentBuffer": { + "id": "FileContentBuffer", + "type": "object", + "properties": { + "content": { + "description": "The raw content in the secure keys file.", + "type": "string", + "format": "byte" + }, + "fileType": { + "description": "The file type of source file.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "description": "Returns the latest image that is part of an image family, is not deprecated and is rolled out in the specified zone." + "enum": [ + "BIN", + "UNDEFINED", + "X509" + ] } } }, - "snapshots": { - "methods": { - "list": { - "id": "compute.snapshots.list", - "path": "projects/{project}/global/snapshots", - "flatPath": "projects/{project}/global/snapshots", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "SnapshotList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of Snapshot resources contained within the specified project." + "Policy": { + "id": "Policy", + "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).", + "type": "object", + "properties": { + "version": { + "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "type": "integer", + "format": "int32" }, - "get": { - "id": "compute.snapshots.get", - "path": "projects/{project}/global/snapshots/{snapshot}", - "flatPath": "projects/{project}/global/snapshots/{snapshot}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "snapshot": { - "description": "Name of the Snapshot resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "snapshot" - ], - "response": { - "$ref": "Snapshot" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified Snapshot resource." + "bindings": { + "description": "Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.", + "type": "array", + "items": { + "$ref": "Binding" + } }, - "insert": { - "id": "compute.snapshots.insert", - "path": "projects/{project}/global/snapshots", - "flatPath": "projects/{project}/global/snapshots", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "Snapshot" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a snapshot in the specified project using the data included in the request. For regular snapshot creation, consider using this method instead of disks.createSnapshot, as this method supports more features, such as creating snapshots in a project different from the source disk project." + "auditConfigs": { + "description": "Specifies cloud audit logging configuration for this policy.", + "type": "array", + "items": { + "$ref": "AuditConfig" + } }, - "setLabels": { - "id": "compute.snapshots.setLabels", - "path": "projects/{project}/global/snapshots/{resource}/setLabels", - "flatPath": "projects/{project}/global/snapshots/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on a snapshot. To learn more about labels, read the Labeling Resources documentation." + "etag": { + "description": "`etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.", + "type": "string", + "format": "byte" + } + } + }, + "Binding": { + "id": "Binding", + "description": "Associates `members`, or principals, with a `role`.", + "type": "object", + "properties": { + "role": { + "description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).", + "type": "string" }, - "delete": { - "id": "compute.snapshots.delete", - "path": "projects/{project}/global/snapshots/{snapshot}", - "flatPath": "projects/{project}/global/snapshots/{snapshot}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "snapshot": { - "description": "Name of the Snapshot resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "snapshot" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "members": { + "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.", + "type": "array", + "items": { + "type": "string" + } + }, + "condition": { + "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", + "$ref": "Expr" + } + } + }, + "Expr": { + "id": "Expr", + "description": "Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: \"Summary size limit\" description: \"Determines if a summary is less than 100 chars\" expression: \"document.summary.size() \u003c 100\" Example (Equality): title: \"Requestor is owner\" description: \"Determines if requestor is the document owner\" expression: \"document.owner == request.auth.claims.email\" Example (Logic): title: \"Public documents\" description: \"Determine whether the document should be publicly visible\" expression: \"document.type != 'private' && document.type != 'internal'\" Example (Data Manipulation): title: \"Notification string\" description: \"Create a notification string with a timestamp.\" expression: \"'New message received at ' + string(document.create_time)\" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.", + "type": "object", + "properties": { + "expression": { + "description": "Textual representation of an expression in Common Expression Language syntax.", + "type": "string" + }, + "title": { + "description": "Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.", + "type": "string" + }, + "description": { + "description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.", + "type": "string" + }, + "location": { + "description": "Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.", + "type": "string" + } + } + }, + "AuditConfig": { + "id": "AuditConfig", + "description": "Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { \"audit_configs\": [ { \"service\": \"allServices\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" }, { \"log_type\": \"ADMIN_READ\" } ] }, { \"service\": \"sampleservice.googleapis.com\", \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\" }, { \"log_type\": \"DATA_WRITE\", \"exempted_members\": [ \"user:aliya@example.com\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.", + "type": "object", + "properties": { + "service": { + "description": "Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.", + "type": "string" + }, + "auditLogConfigs": { + "description": "The configuration for logging of each type of permission.", + "type": "array", + "items": { + "$ref": "AuditLogConfig" + } + } + } + }, + "AuditLogConfig": { + "id": "AuditLogConfig", + "description": "Provides the configuration for logging a type of permissions. Example: { \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:jose@example.com\" ] }, { \"log_type\": \"DATA_WRITE\" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.", + "type": "object", + "properties": { + "logType": { + "description": "The log type that this config enables.", + "type": "string", + "enumDescriptions": [ + "Admin reads. Example: CloudIAM getIamPolicy", + "Data reads. Example: CloudSQL Users list", + "Data writes. Example: CloudSQL Users create", + "Default case. Should never be this." ], - "description": "Deletes the specified Snapshot resource. Keep in mind that deleting a single snapshot might not necessarily delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next corresponding snapshot. For more information, see Deleting snapshots." + "enum": [ + "ADMIN_READ", + "DATA_READ", + "DATA_WRITE", + "LOG_TYPE_UNSPECIFIED" + ] }, - "getIamPolicy": { - "id": "compute.snapshots.getIamPolicy", - "path": "projects/{project}/global/snapshots/{resource}/getIamPolicy", - "flatPath": "projects/{project}/global/snapshots/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "exemptedMembers": { + "description": "Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "GlobalSetPolicyRequest": { + "id": "GlobalSetPolicyRequest", + "type": "object", + "properties": { + "policy": { + "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them.", + "$ref": "Policy" }, - "setIamPolicy": { - "id": "compute.snapshots.setIamPolicy", - "path": "projects/{project}/global/snapshots/{resource}/setIamPolicy", - "flatPath": "projects/{project}/global/snapshots/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "bindings": { + "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings.", + "type": "array", + "items": { + "$ref": "Binding" + } }, - "testIamPermissions": { - "id": "compute.snapshots.testIamPermissions", - "path": "projects/{project}/global/snapshots/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/snapshots/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + "etag": { + "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.", + "type": "string", + "format": "byte" } } }, - "disks": { - "methods": { - "list": { - "id": "compute.disks.list", - "path": "projects/{project}/zones/{zone}/disks", - "flatPath": "projects/{project}/zones/{zone}/disks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "DiskList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of persistent disks contained within the specified zone." + "TestPermissionsRequest": { + "id": "TestPermissionsRequest", + "type": "object", + "properties": { + "permissions": { + "description": "The set of permissions to check for the 'resource'. Permissions with wildcards (such as '*' or 'storage.*') are not allowed.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "TestPermissionsResponse": { + "id": "TestPermissionsResponse", + "type": "object", + "properties": { + "permissions": { + "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "ImageFamilyView": { + "id": "ImageFamilyView", + "type": "object", + "properties": { + "image": { + "description": "The latest image that is part of the specified image family in the requested location, and that is not deprecated.", + "$ref": "Image" + } + } + }, + "SnapshotList": { + "id": "SnapshotList", + "description": "Contains a list of Snapshot resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#snapshotList", + "type": "string" }, - "aggregatedList": { - "id": "compute.disks.aggregatedList", - "path": "projects/{project}/aggregated/disks", - "flatPath": "projects/{project}/aggregated/disks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "DiskAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of persistent disks. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "get": { - "id": "compute.disks.get", - "path": "projects/{project}/zones/{zone}/disks/{disk}", - "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", - "httpMethod": "GET", - "parameters": { - "disk": { - "description": "Name of the persistent disk to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "disk" - ], - "response": { - "$ref": "Disk" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified persistent disk." + "items": { + "description": "A list of Snapshot resources.", + "type": "array", + "items": { + "$ref": "Snapshot" + } }, - "insert": { - "id": "compute.disks.insert", - "path": "projects/{project}/zones/{zone}/disks", - "flatPath": "projects/{project}/zones/{zone}/disks", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "sourceImage": { - "description": "Source image to restore onto a disk. This field is optional.", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "Disk" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a persistent disk in the specified project using the data in the request. You can create a disk from a source (sourceImage, sourceSnapshot, or sourceDisk) or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property." + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "setLabels": { - "id": "compute.disks.setLabels", - "path": "projects/{project}/zones/{zone}/disks/{resource}/setLabels", - "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "request": { - "$ref": "ZoneSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on a disk. To learn more about labels, read the Labeling Resources documentation." + } + } + } + }, + "Snapshot": { + "id": "Snapshot", + "description": "Represents a Persistent Disk Snapshot resource. You can use snapshots to back up data on a regular interval. For more information, read Creating persistent disk snapshots.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#snapshot for Snapshot resources.", + "default": "compute#snapshot", + "type": "string" }, - "delete": { - "id": "compute.disks.delete", - "path": "projects/{project}/zones/{zone}/disks/{disk}", - "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", - "httpMethod": "DELETE", - "parameters": { - "disk": { - "description": "Name of the persistent disk to delete.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.disks.createSnapshot", + "compute.snapshots.insert" + ] }, - "parameterOrder": [ - "project", - "zone", - "disk" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the snapshot. This can be CREATING, DELETING, FAILED, READY, or UPLOADING.", + "type": "string", + "enumDescriptions": [ + "Snapshot creation is in progress.", + "Snapshot is currently being deleted.", + "Snapshot creation failed.", + "Snapshot has been created successfully.", + "Snapshot is being uploaded." ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY", + "UPLOADING" + ] + }, + "sourceDisk": { + "description": "The source disk used to create this snapshot.", + "type": "string" + }, + "sourceDiskId": { + "description": "[Output Only] The ID value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name.", + "type": "string" + }, + "diskSizeGb": { + "description": "[Output Only] Size of the source disk, specified in GB.", + "type": "string", + "format": "int64" + }, + "storageBytes": { + "description": "[Output Only] A size of the storage used by the snapshot. As snapshots share storage, this number is expected to change with snapshot creation/deletion.", + "type": "string", + "format": "int64" + }, + "storageBytesStatus": { + "description": "[Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Deletes the specified persistent disk. Deleting a disk removes its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots." + "enum": [ + "UPDATING", + "UP_TO_DATE" + ] }, - "createSnapshot": { - "id": "compute.disks.createSnapshot", - "path": "projects/{project}/zones/{zone}/disks/{disk}/createSnapshot", - "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/createSnapshot", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "Name of the persistent disk to snapshot.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "guestFlush": { - "description": "[Input Only] Whether to attempt an application consistent snapshot by informing the OS to prepare for the snapshot process.", - "location": "query", - "type": "boolean" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "disk" + "licenses": { + "description": "[Output Only] A list of public visible licenses that apply to this snapshot. This can be because the original image had licenses attached (such as a Windows image).", + "type": "array", + "items": { + "type": "string" + } + }, + "snapshotEncryptionKey": { + "description": "Encrypts the snapshot using a customer-supplied encryption key. After you encrypt a snapshot using a customer-supplied key, you must provide the same key if you use the snapshot later. For example, you must provide the encryption key when you create a disk from the encrypted snapshot in a future request. Customer-supplied encryption keys do not protect access to metadata of the snapshot. If you do not provide an encryption key when creating the snapshot, then the snapshot will be encrypted using an automatically generated key and you do not need to provide a key to use the snapshot later.", + "$ref": "CustomerEncryptionKey" + }, + "sourceDiskEncryptionKey": { + "description": "The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key.", + "$ref": "CustomerEncryptionKey" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "labels": { + "description": "Labels to apply to this snapshot. These can be later modified by the setLabels method. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this snapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a snapshot.", + "type": "string", + "format": "byte" + }, + "licenseCodes": { + "description": "[Output Only] Integer license codes indicating which licenses are attached to this snapshot.", + "type": "array", + "items": { + "type": "string", + "format": "int64" + } + }, + "storageLocations": { + "description": "Cloud Storage bucket storage location of the snapshot (regional or multi-regional).", + "type": "array", + "items": { + "type": "string" + } + }, + "autoCreated": { + "description": "[Output Only] Set to true if snapshots are automatically created by applying resource policy on the target disk.", + "type": "boolean" + }, + "guestOsFeatures": { + "description": "[Output Only] A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options.", + "type": "array", + "items": { + "$ref": "GuestOsFeature" + } + }, + "downloadBytes": { + "description": "[Output Only] Number of bytes downloaded to restore a snapshot to a disk.", + "type": "string", + "format": "int64" + }, + "chainName": { + "description": "Creates the new snapshot in the snapshot chain labeled with the specified name. The chain name must be 1-63 characters long and comply with RFC1035. This is an uncommon option only for advanced service owners who needs to create separate snapshot chains, for example, for chargeback tracking. When you describe your snapshot resource, this field is visible only if it has a non-empty value.", + "type": "string" + }, + "satisfiesPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "locationHint": { + "description": "An opaque location hint used to place the snapshot close to other resources. This field is for use by internal tools that use the public API.", + "type": "string" + }, + "sourceSnapshotSchedulePolicy": { + "description": "[Output Only] URL of the resource policy which created this scheduled snapshot.", + "type": "string" + }, + "sourceSnapshotSchedulePolicyId": { + "description": "[Output Only] ID of the resource policy which created this scheduled snapshot.", + "type": "string" + }, + "sourceInstantSnapshot": { + "description": "The source instant snapshot used to create this snapshot. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot ", + "type": "string" + }, + "sourceInstantSnapshotId": { + "description": "[Output Only] The unique ID of the instant snapshot used to create this snapshot. This value identifies the exact instant snapshot that was used to create this persistent disk. For example, if you created the persistent disk from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact instant snapshot that was used.", + "type": "string" + }, + "architecture": { + "description": "[Output Only] The architecture of the snapshot. Valid values are ARM64 or X86_64.", + "type": "string", + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "request": { - "$ref": "Snapshot" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" + ] + }, + "snapshotType": { + "description": "Indicates the type of the snapshot.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project." + "enum": [ + "ARCHIVE", + "STANDARD" + ] }, - "resize": { - "id": "compute.disks.resize", - "path": "projects/{project}/zones/{zone}/disks/{disk}/resize", - "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/resize", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "The name of the persistent disk.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "creationSizeBytes": { + "description": "[Output Only] Size in bytes of the snapshot at creation time.", + "type": "string", + "format": "int64" + }, + "enableConfidentialCompute": { + "description": "Whether this snapshot is created from a confidential compute mode disk. [Output Only]: This field is not set by user, but from source disk.", + "type": "boolean" + }, + "sourceDiskForRecoveryCheckpoint": { + "description": "The source disk whose recovery checkpoint will be used to create this snapshot.", + "type": "string" + }, + "sourceInstantSnapshotEncryptionKey": { + "description": "Customer provided encryption key when creating Snapshot from Instant Snapshot.", + "$ref": "CustomerEncryptionKey" + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + } + } + }, + "DiskList": { + "id": "DiskList", + "description": "A list of Disk resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#diskList for lists of disks.", + "default": "compute#diskList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Disk resources.", + "type": "array", + "items": { + "$ref": "Disk" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "disk" - ], - "request": { - "$ref": "DisksResizeRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Resizes the specified persistent disk. You can only increase the size of the disk." + } + } + } + }, + "Disk": { + "id": "Disk", + "description": "Represents a Persistent Disk resource. Google Compute Engine has two Disk resources: * [Zonal](/compute/docs/reference/rest/v1/disks) * [Regional](/compute/docs/reference/rest/v1/regionDisks) Persistent disks are required for running your VM instances. Create both boot and non-boot (data) persistent disks. For more information, read Persistent Disks. For more storage options, read Storage options. The disks resource represents a zonal persistent disk. For more information, read Zonal persistent disks. The regionDisks resource represents a regional persistent disk. For more information, read Regional resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#disk for disks.", + "default": "compute#disk", + "type": "string" }, - "addResourcePolicies": { - "id": "compute.disks.addResourcePolicies", - "path": "projects/{project}/zones/{zone}/disks/{disk}/addResourcePolicies", - "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/addResourcePolicies", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "The disk name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "disk" - ], - "request": { - "$ref": "DisksAddResourcePoliciesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Adds existing resource policies to a disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "removeResourcePolicies": { - "id": "compute.disks.removeResourcePolicies", - "path": "projects/{project}/zones/{zone}/disks/{disk}/removeResourcePolicies", - "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/removeResourcePolicies", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "The disk name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "disk" - ], - "request": { - "$ref": "DisksRemoveResourcePoliciesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes resource policies from a disk." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "getIamPolicy": { - "id": "compute.disks.getIamPolicy", - "path": "projects/{project}/zones/{zone}/disks/{resource}/getIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "response": { - "$ref": "Policy" + "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])?", + "annotations": { + "required": [ + "compute.disks.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "type": "string" }, - "setIamPolicy": { - "id": "compute.disks.setIamPolicy", - "path": "projects/{project}/zones/{zone}/disks/{resource}/setIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "request": { - "$ref": "ZoneSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" }, - "testIamPermissions": { - "id": "compute.disks.testIamPermissions", - "path": "projects/{project}/zones/{zone}/disks/{resource}/testIamPermissions", - "flatPath": "projects/{project}/zones/{zone}/disks/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" + "sizeGb": { + "description": "Size, in GB, of the persistent disk. You can specify this field when creating a persistent disk using the sourceImage, sourceSnapshot, or sourceDisk parameter, or specify it alone to create an empty persistent disk. If you specify this field along with a source, the value of sizeGb must not be less than the size of the source. Acceptable values are greater than 0.", + "type": "string", + "format": "int64" + }, + "zone": { + "description": "[Output Only] URL of the zone where the disk resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of disk creation. - CREATING: Disk is provisioning. - RESTORING: Source data is being copied into the disk. - FAILED: Disk creation failed. - READY: Disk is ready for use. - DELETING: Disk is deleting. ", + "type": "string", + "enumDescriptions": [ + "Disk is provisioning", + "Disk is deleting.", + "Disk creation failed.", + "Disk is ready for use.", + "Source data is being copied into the disk.", + "Disk is currently unavailable and cannot be accessed, attached or detached." ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY", + "RESTORING", + "UNAVAILABLE" + ] + }, + "sourceSnapshot": { + "description": "The source snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project /global/snapshots/snapshot - projects/project/global/snapshots/snapshot - global/snapshots/snapshot ", + "type": "string" + }, + "sourceSnapshotId": { + "description": "[Output Only] The unique ID of the snapshot used to create this disk. This value identifies the exact snapshot that was used to create this persistent disk. For example, if you created the persistent disk from a snapshot that was later deleted and recreated under the same name, the source snapshot ID would identify the exact version of the snapshot that was used.", + "type": "string" + }, + "sourceStorageObject": { + "description": "The full Google Cloud Storage URI where the disk image is stored. This file must be a gzip-compressed tarball whose name ends in .tar.gz or virtual machine disk whose name ends in vmdk. Valid URIs may start with gs:// or https://storage.googleapis.com/. This flag is not optimized for creating multiple disks from a source storage object. To create many disks from a source storage object, use gcloud compute images import instead.", + "type": "string" + }, + "options": { + "description": "Internal use only.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined fully-qualified URL for this resource.", + "type": "string" + }, + "sourceImage": { + "description": "The source image used to create this disk. If the source image is deleted, this field will not be set. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family ", + "type": "string" + }, + "sourceImageId": { + "description": "[Output Only] The ID value of the image used to create this disk. This value identifies the exact image that was used to create this persistent disk. For example, if you created the persistent disk from an image that was later deleted and recreated under the same name, the source image ID would identify the exact version of the image that was used.", + "type": "string" + }, + "type": { + "description": "URL of the disk type resource describing which disk type to use to create the disk. Provide this when creating the disk. For example: projects/project /zones/zone/diskTypes/pd-ssd . See Persistent disk types.", + "type": "string" + }, + "licenses": { + "description": "A list of publicly visible licenses. Reserved for Google's use.", + "type": "array", + "items": { + "type": "string" + } + }, + "guestOsFeatures": { + "description": "A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options.", + "type": "array", + "items": { + "$ref": "GuestOsFeature" + } + }, + "lastAttachTimestamp": { + "description": "[Output Only] Last attach timestamp in RFC3339 text format.", + "type": "string" + }, + "lastDetachTimestamp": { + "description": "[Output Only] Last detach timestamp in RFC3339 text format.", + "type": "string" + }, + "users": { + "description": "[Output Only] Links to the users of the disk (attached instances) in form: projects/project/zones/zone/instances/instance", + "type": "array", + "items": { + "type": "string" + } + }, + "diskEncryptionKey": { + "description": "Encrypts the disk using a customer-supplied encryption key or a customer-managed encryption key. Encryption keys do not protect access to metadata of the disk. After you encrypt a disk with a customer-supplied key, you must provide the same key if you use the disk later. For example, to create a disk snapshot, to create a disk image, to create a machine image, or to attach the disk to a virtual machine. After you encrypt a disk with a customer-managed key, the diskEncryptionKey.kmsKeyName is set to a key *version* name once the disk is created. The disk is encrypted with this version of the key. In the response, diskEncryptionKey.kmsKeyName appears in the following format: \"diskEncryptionKey.kmsKeyName\": \"projects/kms_project_id/locations/region/keyRings/ key_region/cryptoKeys/key /cryptoKeysVersions/version If you do not provide an encryption key when creating the disk, then the disk is encrypted using an automatically generated key and you don't need to provide a key to use the disk later.", + "$ref": "CustomerEncryptionKey" + }, + "sourceImageEncryptionKey": { + "description": "The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key.", + "$ref": "CustomerEncryptionKey" + }, + "sourceSnapshotEncryptionKey": { + "description": "The customer-supplied encryption key of the source snapshot. Required if the source snapshot is protected by a customer-supplied encryption key.", + "$ref": "CustomerEncryptionKey" + }, + "labels": { + "description": "Labels to apply to this disk. These can be later modified by the setLabels method.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this disk, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a disk.", + "type": "string", + "format": "byte" + }, + "region": { + "description": "[Output Only] URL of the region where the disk resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "replicaZones": { + "description": "URLs of the zones where the disk should be replicated to. Only applicable for regional resources.", + "type": "array", + "items": { + "type": "string" + } + }, + "licenseCodes": { + "description": "Integer license codes indicating which licenses are attached to this disk.", + "type": "array", + "items": { + "type": "string", + "format": "int64" + } + }, + "physicalBlockSizeBytes": { + "description": "Physical block size of the persistent disk, in bytes. If not present in a request, a default value is used. The currently supported size is 4096, other sizes may be added in the future. If an unsupported value is requested, the error message will list the supported values for the caller's project.", + "type": "string", + "format": "int64" + }, + "resourcePolicies": { + "description": "Resource policies applied to this disk for automatic snapshot creations.", + "type": "array", + "items": { + "type": "string" + } + }, + "sourceDisk": { + "description": "The source disk used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk ", + "type": "string" + }, + "sourceDiskId": { + "description": "[Output Only] The unique ID of the disk used to create this disk. This value identifies the exact disk that was used to create this persistent disk. For example, if you created the persistent disk from a disk that was later deleted and recreated under the same name, the source disk ID would identify the exact version of the disk that was used.", + "type": "string" + }, + "provisionedIops": { + "description": "Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation.", + "type": "string", + "format": "int64" + }, + "provisionedThroughput": { + "description": "Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must be greater than or equal to 1.", + "type": "string", + "format": "int64" + }, + "enableConfidentialCompute": { + "description": "Whether this disk is using confidential compute mode.", + "type": "boolean" + }, + "sourceInstantSnapshot": { + "description": "The source instant snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instantSnapshots/instantSnapshot - projects/project/zones/zone/instantSnapshots/instantSnapshot - zones/zone/instantSnapshots/instantSnapshot ", + "type": "string" + }, + "sourceInstantSnapshotId": { + "description": "[Output Only] The unique ID of the instant snapshot used to create this disk. This value identifies the exact instant snapshot that was used to create this persistent disk. For example, if you created the persistent disk from an instant snapshot that was later deleted and recreated under the same name, the source instant snapshot ID would identify the exact version of the instant snapshot that was used.", + "type": "string" + }, + "satisfiesPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + }, + "locationHint": { + "description": "An opaque location hint used to place the disk close to other resources. This field is for use by internal tools that use the public API.", + "type": "string" + }, + "storagePool": { + "description": "The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool ", + "type": "string" + }, + "accessMode": { + "description": "The access mode of the disk. - READ_WRITE_SINGLE: The default AccessMode, means the disk can be attached to single instance in RW mode. - READ_WRITE_MANY: The AccessMode means the disk can be attached to multiple instances in RW mode. - READ_ONLY_MANY: The AccessMode means the disk can be attached to multiple instances in RO mode. The AccessMode is only valid for Hyperdisk disk types.", + "type": "string", + "enumDescriptions": [ + "The AccessMode means the disk can be attached to multiple instances in RO mode.", + "The AccessMode means the disk can be attached to multiple instances in RW mode.", + "The default AccessMode, means the disk can be attached to single instance in RW mode." ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "READ_ONLY_MANY", + "READ_WRITE_MANY", + "READ_WRITE_SINGLE" + ] }, - "update": { - "id": "compute.disks.update", - "path": "projects/{project}/zones/{zone}/disks/{disk}", - "flatPath": "projects/{project}/zones/{zone}/disks/{disk}", - "httpMethod": "PATCH", - "parameters": { - "disk": { - "description": "The disk name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "paths": { - "location": "query", - "repeated": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "updateMask": { - "description": "update_mask indicates fields to be updated as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "disk" + "asyncPrimaryDisk": { + "description": "Disk asynchronously replicated into this disk.", + "$ref": "DiskAsyncReplication" + }, + "asyncSecondaryDisks": { + "description": "[Output Only] A list of disks this disk is asynchronously replicated to.", + "type": "object", + "additionalProperties": { + "$ref": "DiskAsyncReplicationList" + } + }, + "resourceStatus": { + "description": "[Output Only] Status information for the disk resource.", + "$ref": "DiskResourceStatus" + }, + "sourceConsistencyGroupPolicy": { + "description": "[Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group.", + "type": "string" + }, + "sourceConsistencyGroupPolicyId": { + "description": "[Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk that was created using a consistency group.", + "type": "string" + }, + "architecture": { + "description": "The architecture of the disk. Valid values are ARM64 or X86_64.", + "type": "string", + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "request": { - "$ref": "Disk" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" + ] + }, + "params": { + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.", + "$ref": "DiskParams" + } + } + }, + "DiskAsyncReplication": { + "id": "DiskAsyncReplication", + "type": "object", + "properties": { + "disk": { + "description": "The other disk asynchronously replicated to or from the current disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk ", + "type": "string" + }, + "diskId": { + "description": "[Output Only] The unique ID of the other disk asynchronously replicated to or from the current disk. This value identifies the exact disk that was used to create this replication. For example, if you started replicating the persistent disk from a disk that was later deleted and recreated under the same name, the disk ID would identify the exact version of the disk that was used.", + "type": "string" + }, + "consistencyGroupPolicy": { + "description": "[Output Only] URL of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group.", + "type": "string" + }, + "consistencyGroupPolicyId": { + "description": "[Output Only] ID of the DiskConsistencyGroupPolicy if replication was started on the disk as a member of a group.", + "type": "string" + } + } + }, + "DiskAsyncReplicationList": { + "id": "DiskAsyncReplicationList", + "type": "object", + "properties": { + "asyncReplicationDisk": { + "$ref": "DiskAsyncReplication" + } + } + }, + "DiskResourceStatus": { + "id": "DiskResourceStatus", + "type": "object", + "properties": { + "asyncPrimaryDisk": { + "$ref": "DiskResourceStatusAsyncReplicationStatus" + }, + "asyncSecondaryDisks": { + "description": "Key: disk, value: AsyncReplicationStatus message", + "type": "object", + "additionalProperties": { + "$ref": "DiskResourceStatusAsyncReplicationStatus" + } + } + } + }, + "DiskResourceStatusAsyncReplicationStatus": { + "id": "DiskResourceStatusAsyncReplicationStatus", + "type": "object", + "properties": { + "state": { + "type": "string", + "enumDescriptions": [ + "Replication is active.", + "Secondary disk is created and is waiting for replication to start.", + "Replication is starting.", + "", + "Replication is stopped.", + "Replication is stopping." ], - "description": "Updates the specified disk with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: user_license." + "enum": [ + "ACTIVE", + "CREATED", + "STARTING", + "STATE_UNSPECIFIED", + "STOPPED", + "STOPPING" + ] + } + } + }, + "DiskParams": { + "id": "DiskParams", + "description": "Additional disk params.", + "type": "object", + "properties": { + "resourceManagerTags": { + "description": "Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } + }, + "DiskAggregatedList": { + "id": "DiskAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#diskAggregatedList for aggregated lists of persistent disks.", + "default": "compute#diskAggregatedList", + "type": "string" }, - "startAsyncReplication": { - "id": "compute.disks.startAsyncReplication", - "path": "projects/{project}/zones/{zone}/disks/{disk}/startAsyncReplication", - "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/startAsyncReplication", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "The name of the persistent disk.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of DisksScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of disks.", + "$ref": "DisksScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "disk" - ], - "request": { - "$ref": "DisksStartAsyncReplicationRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Starts asynchronous replication. Must be invoked on the primary disk." + } }, - "stopAsyncReplication": { - "id": "compute.disks.stopAsyncReplication", - "path": "projects/{project}/zones/{zone}/disks/{disk}/stopAsyncReplication", - "flatPath": "projects/{project}/zones/{zone}/disks/{disk}/stopAsyncReplication", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "The name of the persistent disk.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "DisksScopedList": { + "id": "DisksScopedList", + "type": "object", + "properties": { + "disks": { + "description": "[Output Only] A list of disks contained in this scope.", + "type": "array", + "items": { + "$ref": "Disk" + } + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of disks when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "disk" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Stops asynchronous replication. Can be invoked either on the primary or on the secondary disk." + } + } + } + }, + "ZoneSetLabelsRequest": { + "id": "ZoneSetLabelsRequest", + "type": "object", + "properties": { + "labels": { + "description": "The labels to set for this resource.", + "type": "object", + "additionalProperties": { + "type": "string" + } }, - "stopGroupAsyncReplication": { - "id": "compute.disks.stopGroupAsyncReplication", - "path": "projects/{project}/zones/{zone}/disks/stopGroupAsyncReplication", - "flatPath": "projects/{project}/zones/{zone}/disks/stopGroupAsyncReplication", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request. This must be the zone of the primary or secondary disks in the consistency group.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "DisksStopGroupAsyncReplicationResource" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope." + "labelFingerprint": { + "description": "The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. Make a get() request to the resource to get the latest fingerprint.", + "type": "string", + "format": "byte" + } + } + }, + "DisksResizeRequest": { + "id": "DisksResizeRequest", + "type": "object", + "properties": { + "sizeGb": { + "description": "The new size of the persistent disk, which is specified in GB.", + "type": "string", + "format": "int64" + } + } + }, + "DisksAddResourcePoliciesRequest": { + "id": "DisksAddResourcePoliciesRequest", + "type": "object", + "properties": { + "resourcePolicies": { + "description": "Full or relative path to the resource policy to be added to this disk. You can only specify one resource policy.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "DisksRemoveResourcePoliciesRequest": { + "id": "DisksRemoveResourcePoliciesRequest", + "type": "object", + "properties": { + "resourcePolicies": { + "description": "Resource policies to be removed from this disk.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "ZoneSetPolicyRequest": { + "id": "ZoneSetPolicyRequest", + "type": "object", + "properties": { + "policy": { + "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them.", + "$ref": "Policy" }, - "bulkInsert": { - "id": "compute.disks.bulkInsert", - "path": "projects/{project}/zones/{zone}/disks/bulkInsert", - "flatPath": "projects/{project}/zones/{zone}/disks/bulkInsert", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "BulkInsertDiskResource" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Bulk create a set of disks." + "bindings": { + "description": "Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings.", + "type": "array", + "items": { + "$ref": "Binding" + } + }, + "etag": { + "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.", + "type": "string", + "format": "byte" } } }, - "regionDisks": { - "methods": { - "list": { - "id": "compute.regionDisks.list", - "path": "projects/{project}/regions/{region}/disks", - "flatPath": "projects/{project}/regions/{region}/disks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "DiskList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of persistent disks contained within the specified region." + "DisksStartAsyncReplicationRequest": { + "id": "DisksStartAsyncReplicationRequest", + "type": "object", + "properties": { + "asyncSecondaryDisk": { + "description": "The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk ", + "type": "string" + } + } + }, + "DisksStopGroupAsyncReplicationResource": { + "id": "DisksStopGroupAsyncReplicationResource", + "description": "A transient resource used in compute.disks.stopGroupAsyncReplication and compute.regionDisks.stopGroupAsyncReplication. It is only used to process requests and is not persisted.", + "type": "object", + "properties": { + "resourcePolicy": { + "description": "The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy ", + "type": "string" + } + } + }, + "BulkInsertDiskResource": { + "id": "BulkInsertDiskResource", + "description": "A transient resource used in compute.disks.bulkInsert and compute.regionDisks.bulkInsert. It is only used to process requests and is not persisted.", + "type": "object", + "properties": { + "sourceConsistencyGroupPolicy": { + "description": "The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. This may be a full or partial URL, such as: - https://www.googleapis.com/compute/v1/projects/project/regions/region /resourcePolicies/resourcePolicy - projects/project/regions/region/resourcePolicies/resourcePolicy - regions/region/resourcePolicies/resourcePolicy ", + "type": "string" + } + } + }, + "RegionDisksResizeRequest": { + "id": "RegionDisksResizeRequest", + "type": "object", + "properties": { + "sizeGb": { + "description": "The new size of the regional persistent disk, which is specified in GB.", + "type": "string", + "format": "int64" + } + } + }, + "RegionDisksAddResourcePoliciesRequest": { + "id": "RegionDisksAddResourcePoliciesRequest", + "type": "object", + "properties": { + "resourcePolicies": { + "description": "Resource policies to be added to this disk.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "RegionDisksRemoveResourcePoliciesRequest": { + "id": "RegionDisksRemoveResourcePoliciesRequest", + "type": "object", + "properties": { + "resourcePolicies": { + "description": "Resource policies to be removed from this disk.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "RegionSetPolicyRequest": { + "id": "RegionSetPolicyRequest", + "type": "object", + "properties": { + "policy": { + "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them.", + "$ref": "Policy" }, - "get": { - "id": "compute.regionDisks.get", - "path": "projects/{project}/regions/{region}/disks/{disk}", - "flatPath": "projects/{project}/regions/{region}/disks/{disk}", - "httpMethod": "GET", - "parameters": { - "disk": { - "description": "Name of the regional persistent disk to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "bindings": { + "description": "Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings.", + "type": "array", + "items": { + "$ref": "Binding" + } + }, + "etag": { + "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.", + "type": "string", + "format": "byte" + } + } + }, + "RegionDisksStartAsyncReplicationRequest": { + "id": "RegionDisksStartAsyncReplicationRequest", + "type": "object", + "properties": { + "asyncSecondaryDisk": { + "description": "The secondary disk to start asynchronous replication to. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk ", + "type": "string" + } + } + }, + "FirewallList": { + "id": "FirewallList", + "description": "Contains a list of firewalls.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#firewallList for lists of firewalls.", + "default": "compute#firewallList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Firewall resources.", + "type": "array", + "items": { + "$ref": "Firewall" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "disk" - ], - "response": { - "$ref": "Disk" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns a specified regional persistent disk." + } + } + } + }, + "Firewall": { + "id": "Firewall", + "description": "Represents a Firewall Rule resource. Firewall rules allow or deny ingress traffic to, and egress traffic from your instances. For more information, read Firewall rules.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#firewall for firewall rules.", + "default": "compute#firewall", + "type": "string" }, - "insert": { - "id": "compute.regionDisks.insert", - "path": "projects/{project}/regions/{region}/disks", - "flatPath": "projects/{project}/regions/{region}/disks", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "sourceImage": { - "description": "Source image to restore onto a disk. This field is optional.", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "Disk" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a persistent regional disk in the specified project using the data included in the request." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "setLabels": { - "id": "compute.regionDisks.setLabels", - "path": "projects/{project}/regions/{region}/disks/{resource}/setLabels", - "flatPath": "projects/{project}/regions/{region}/disks/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on the target regional disk." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "delete": { - "id": "compute.regionDisks.delete", - "path": "projects/{project}/regions/{region}/disks/{disk}", - "flatPath": "projects/{project}/regions/{region}/disks/{disk}", - "httpMethod": "DELETE", - "parameters": { - "disk": { - "description": "Name of the regional persistent disk to delete.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "disk" - ], - "response": { - "$ref": "Operation" + "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])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "annotations": { + "required": [ + "compute.firewalls.insert", + "compute.firewalls.patch" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified regional persistent disk. Deleting a regional disk removes all the replicas of its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots." + "type": "string" }, - "createSnapshot": { - "id": "compute.regionDisks.createSnapshot", - "path": "projects/{project}/regions/{region}/disks/{disk}/createSnapshot", - "flatPath": "projects/{project}/regions/{region}/disks/{disk}/createSnapshot", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "Name of the regional persistent disk to snapshot.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "disk" - ], - "request": { - "$ref": "Snapshot" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a snapshot of a specified persistent disk. For regular snapshot creation, consider using snapshots.insert instead, as that method supports more features, such as creating snapshots in a project different from the source disk project." + "description": { + "description": "An optional description of this resource. Provide this field when you create the resource.", + "type": "string" }, - "resize": { - "id": "compute.regionDisks.resize", - "path": "projects/{project}/regions/{region}/disks/{disk}/resize", - "flatPath": "projects/{project}/regions/{region}/disks/{disk}/resize", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "Name of the regional persistent disk.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "The project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "disk" - ], - "request": { - "$ref": "RegionDisksResizeRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Resizes the specified regional persistent disk." + "network": { + "description": "URL of the network resource for this firewall rule. If not specified when creating a firewall rule, the default network is used: global/networks/default If you choose to specify this field, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network - projects/myproject/global/networks/my-network - global/networks/default ", + "type": "string" }, - "addResourcePolicies": { - "id": "compute.regionDisks.addResourcePolicies", - "path": "projects/{project}/regions/{region}/disks/{disk}/addResourcePolicies", - "flatPath": "projects/{project}/regions/{region}/disks/{disk}/addResourcePolicies", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "The disk name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "disk" - ], - "request": { - "$ref": "RegionDisksAddResourcePoliciesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Adds existing resource policies to a regional disk. You can only add one policy which will be applied to this disk for scheduling snapshot creation." + "priority": { + "description": "Priority for this rule. This is an integer between `0` and `65535`, both inclusive. The default value is `1000`. Relative priorities determine which rule takes effect if multiple rules apply. Lower values indicate higher priority. For example, a rule with priority `0` has higher precedence than a rule with priority `1`. DENY rules take precedence over ALLOW rules if they have equal priority. Note that VPC networks have implied rules with a priority of `65535`. To avoid conflicts with the implied rules, use a priority number less than `65535`.", + "type": "integer", + "format": "int32" }, - "removeResourcePolicies": { - "id": "compute.regionDisks.removeResourcePolicies", - "path": "projects/{project}/regions/{region}/disks/{disk}/removeResourcePolicies", - "flatPath": "projects/{project}/regions/{region}/disks/{disk}/removeResourcePolicies", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "The disk name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "disk" - ], - "request": { - "$ref": "RegionDisksRemoveResourcePoliciesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes resource policies from a regional disk." + "sourceRanges": { + "description": "If source ranges are specified, the firewall rule applies only to traffic that has a source IP address in these ranges. These ranges must be expressed in CIDR format. One or both of sourceRanges and sourceTags may be set. If both fields are set, the rule applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the rule to apply. Both IPv4 and IPv6 are supported.", + "type": "array", + "items": { + "type": "string" + } }, - "getIamPolicy": { - "id": "compute.regionDisks.getIamPolicy", - "path": "projects/{project}/regions/{region}/disks/{resource}/getIamPolicy", - "flatPath": "projects/{project}/regions/{region}/disks/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "destinationRanges": { + "description": "If destination ranges are specified, the firewall rule applies only to traffic that has destination IP address in these ranges. These ranges must be expressed in CIDR format. Both IPv4 and IPv6 are supported.", + "type": "array", + "items": { + "type": "string" + } + }, + "sourceTags": { + "description": "If source tags are specified, the firewall rule applies only to traffic with source IPs that match the primary network interfaces of VM instances that have the tag and are in the same VPC network. Source tags cannot be used to control traffic to an instance's external IP address, it only applies to traffic between instances in the same virtual network. Because tags are associated with instances, not IP addresses. One or both of sourceRanges and sourceTags may be set. If both fields are set, the firewall applies to traffic that has a source IP address within sourceRanges OR a source IP from a resource with a matching tag listed in the sourceTags field. The connection does not need to match both fields for the firewall to apply.", + "type": "array", + "items": { + "type": "string" + } + }, + "targetTags": { + "description": "A list of tags that controls which instances the firewall rule applies to. If targetTags are specified, then the firewall rule applies only to instances in the VPC network that have one of those tags. If no targetTags are specified, the firewall rule applies to all instances on the specified network.", + "type": "array", + "items": { + "type": "string" + } + }, + "sourceServiceAccounts": { + "description": "If source service accounts are specified, the firewall rules apply only to traffic originating from an instance with a service account in this list. Source service accounts cannot be used to control traffic to an instance's external IP address because service accounts are associated with an instance, not an IP address. sourceRanges can be set at the same time as sourceServiceAccounts. If both are set, the firewall applies to traffic that has a source IP address within the sourceRanges OR a source IP that belongs to an instance with service account listed in sourceServiceAccount. The connection does not need to match both fields for the firewall to apply. sourceServiceAccounts cannot be used at the same time as sourceTags or targetTags.", + "type": "array", + "items": { + "type": "string" + } + }, + "targetServiceAccounts": { + "description": "A list of service accounts indicating sets of instances located in the network that may make network connections as specified in allowed[]. targetServiceAccounts cannot be used at the same time as targetTags or sourceTags. If neither targetServiceAccounts nor targetTags are specified, the firewall rule applies to all instances on the specified network.", + "type": "array", + "items": { + "type": "string" + } + }, + "allowed": { + "description": "The list of ALLOW rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.", + "type": "array", + "items": { + "type": "object", + "properties": { + "IPProtocol": { + "description": "The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number.", + "type": "string" + }, + "ports": { + "description": "An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: [\"22\"], [\"80\",\"443\"], and [\"12345-12349\"].", + "type": "array", + "items": { + "type": "string" + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" + } + }, + "denied": { + "description": "The list of DENY rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a denied connection.", + "type": "array", + "items": { + "type": "object", + "properties": { + "IPProtocol": { + "description": "The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP protocol number.", + "type": "string" + }, + "ports": { + "description": "An optional list of ports to which this rule applies. This field is only applicable for the UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: [\"22\"], [\"80\",\"443\"], and [\"12345-12349\"].", + "type": "array", + "items": { + "type": "string" + } + } + } + } + }, + "direction": { + "description": "Direction of traffic to which this firewall applies, either `INGRESS` or `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot specify the sourceTags fields.", + "type": "string", + "enumDescriptions": [ + "Indicates that firewall should apply to outgoing traffic.", + "Indicates that firewall should apply to incoming traffic." ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "EGRESS", + "INGRESS" + ] + }, + "logConfig": { + "description": "This field denotes the logging options for a particular firewall rule. If logging is enabled, logs will be exported to Cloud Logging.", + "$ref": "FirewallLogConfig" + }, + "disabled": { + "description": "Denotes whether the firewall rule is disabled. When set to true, the firewall rule is not enforced and the network behaves as if it did not exist. If this is unspecified, the firewall rule will be enabled.", + "type": "boolean" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + } + } + }, + "FirewallLogConfig": { + "id": "FirewallLogConfig", + "description": "The available logging options for a firewall rule.", + "type": "object", + "properties": { + "enable": { + "description": "This field denotes whether to enable logging for a particular firewall rule.", + "type": "boolean" + }, + "metadata": { + "description": "This field can only be specified for a particular firewall rule if logging is enabled for that rule. This field denotes whether to include or exclude metadata for firewall logs.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "enum": [ + "EXCLUDE_ALL_METADATA", + "INCLUDE_ALL_METADATA" + ] + } + } + }, + "FirewallPolicyList": { + "id": "FirewallPolicyList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#firewallPolicyList for listsof FirewallPolicies", + "default": "compute#firewallPolicyList", + "type": "string" }, - "setIamPolicy": { - "id": "compute.regionDisks.setIamPolicy", - "path": "projects/{project}/regions/{region}/disks/{resource}/setIamPolicy", - "flatPath": "projects/{project}/regions/{region}/disks/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of FirewallPolicy resources.", + "type": "array", + "items": { + "$ref": "FirewallPolicy" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + } + } + } + }, + "FirewallPolicy": { + "id": "FirewallPolicy", + "description": "Represents a Firewall Policy resource.", + "type": "object", + "properties": { + "kind": { + "description": "[Output only] Type of the resource. Always compute#firewallPolicyfor firewall policies", + "default": "compute#firewallPolicy", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "Name of the resource. For Organization Firewall Policies it's a [Output Only] numeric ID allocated by Google Cloud which uniquely identifies the Organization Firewall Policy.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "rules": { + "description": "A list of rules that belong to this policy. There must always be a default rule (rule with priority 2147483647 and match \"*\"). If no rules are provided when creating a firewall policy, a default rule with action \"allow\" will be added.", + "type": "array", + "items": { + "$ref": "FirewallPolicyRule" + } + }, + "fingerprint": { + "description": "Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the firewall policy.", + "type": "string", + "format": "byte" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource with the resource id.", + "type": "string" + }, + "associations": { + "description": "A list of associations that belong to this firewall policy.", + "type": "array", + "items": { + "$ref": "FirewallPolicyAssociation" + } + }, + "ruleTupleCount": { + "description": "[Output Only] Total count of all firewall policy rule tuples. A firewall policy can not exceed a set number of tuples.", + "type": "integer", + "format": "int32" + }, + "shortName": { + "description": "User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. 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" + }, + "displayName": { + "description": "Deprecated, please use short name instead. User-provided name of the Organization firewall policy. The name should be unique in the organization in which the firewall policy is created. This field is not applicable to network firewall policies. This name must be set on creation and cannot be changed. 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])?", + "deprecated": true, + "type": "string" + }, + "parent": { + "description": "[Output Only] The parent of the firewall policy. This field is not applicable to network firewall policies.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the regional firewall policy resides. This field is not applicable to global firewall policies. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + } + } + }, + "FirewallPolicyRule": { + "id": "FirewallPolicyRule", + "description": "Represents a rule that describes one or more match conditions along with the action to be taken when traffic matches this condition (allow or deny).", + "type": "object", + "properties": { + "kind": { + "description": "[Output only] Type of the resource. Returns compute#firewallPolicyRule for firewall rules and compute#packetMirroringRule for packet mirroring rules.", + "default": "compute#firewallPolicyRule", + "type": "string" + }, + "ruleName": { + "description": "An optional name for the rule. This field is not a unique identifier and can be updated.", + "type": "string" + }, + "description": { + "description": "An optional description for this resource.", + "type": "string" + }, + "priority": { + "description": "An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority.", + "type": "integer", + "format": "int32" + }, + "match": { + "description": "A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced.", + "$ref": "FirewallPolicyRuleMatcher" + }, + "action": { + "description": "The Action to perform when the client connection triggers the rule. Valid actions for firewall rules are: \"allow\", \"deny\", \"apply_security_profile_group\" and \"goto_next\". Valid actions for packet mirroring rules are: \"mirror\", \"do_not_mirror\" and \"goto_next\".", + "type": "string" + }, + "securityProfileGroup": { + "description": "A fully-qualified URL of a SecurityProfile resource instance. Example: https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group Must be specified if action is one of 'apply_security_profile_group' or 'mirror'. Cannot be specified for other actions.", + "type": "string" + }, + "tlsInspect": { + "description": "Boolean flag indicating if the traffic should be TLS decrypted. Can be set only if action = 'apply_security_profile_group' and cannot be set for other actions.", + "type": "boolean" + }, + "direction": { + "description": "The direction in which this rule applies.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "enum": [ + "EGRESS", + "INGRESS" + ] + }, + "targetResources": { + "description": "A list of network resource URLs to which this rule applies. This field allows you to control which network's VMs get this rule. If this field is left blank, all VMs within the organization will receive the rule.", + "type": "array", + "items": { + "type": "string" + } + }, + "enableLogging": { + "description": "Denotes whether to enable logging for a particular rule. If logging is enabled, logs will be exported to the configured export destination in Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you cannot enable logging on \"goto_next\" rules.", + "type": "boolean" + }, + "ruleTupleCount": { + "description": "[Output Only] Calculation of the complexity of a single firewall policy rule.", + "type": "integer", + "format": "int32" + }, + "targetServiceAccounts": { + "description": "A list of service accounts indicating the sets of instances that are applied with this rule.", + "type": "array", + "items": { + "type": "string" + } + }, + "targetSecureTags": { + "description": "A list of secure tags that controls which instances the firewall rule applies to. If targetSecureTag are specified, then the firewall rule applies only to instances in the VPC network that have one of those EFFECTIVE secure tags, if all the target_secure_tag are in INEFFECTIVE state, then this rule will be ignored. targetSecureTag may not be set at the same time as targetServiceAccounts. If neither targetServiceAccounts nor targetSecureTag are specified, the firewall rule applies to all instances on the specified network. Maximum number of target label tags allowed is 256.", + "type": "array", + "items": { + "$ref": "FirewallPolicyRuleSecureTag" + } + }, + "disabled": { + "description": "Denotes whether the firewall policy rule is disabled. When set to true, the firewall policy rule is not enforced and traffic behaves as if it did not exist. If this is unspecified, the firewall policy rule will be enabled.", + "type": "boolean" + } + } + }, + "FirewallPolicyRuleMatcher": { + "id": "FirewallPolicyRuleMatcher", + "description": "Represents a match condition that incoming traffic is evaluated against. Exactly one field must be specified.", + "type": "object", + "properties": { + "srcIpRanges": { + "description": "CIDR IP address range. Maximum number of source CIDR IP ranges allowed is 5000.", + "type": "array", + "items": { + "type": "string" + } + }, + "destIpRanges": { + "description": "CIDR IP address range. Maximum number of destination CIDR IP ranges allowed is 5000.", + "type": "array", + "items": { + "type": "string" + } + }, + "layer4Configs": { + "description": "Pairs of IP protocols and ports that the rule should match.", + "type": "array", + "items": { + "$ref": "FirewallPolicyRuleMatcherLayer4Config" + } + }, + "srcSecureTags": { + "description": "List of secure tag values, which should be matched at the source of the traffic. For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, and there is no srcIpRange, this rule will be ignored. Maximum number of source tag values allowed is 256.", + "type": "array", + "items": { + "$ref": "FirewallPolicyRuleSecureTag" + } + }, + "destAddressGroups": { + "description": "Address groups which should be matched against the traffic destination. Maximum number of destination address groups is 10.", + "type": "array", + "items": { + "type": "string" + } + }, + "srcAddressGroups": { + "description": "Address groups which should be matched against the traffic source. Maximum number of source address groups is 10.", + "type": "array", + "items": { + "type": "string" + } + }, + "srcFqdns": { + "description": "Fully Qualified Domain Name (FQDN) which should be matched against traffic source. Maximum number of source fqdn allowed is 100.", + "type": "array", + "items": { + "type": "string" + } + }, + "destFqdns": { + "description": "Fully Qualified Domain Name (FQDN) which should be matched against traffic destination. Maximum number of destination fqdn allowed is 100.", + "type": "array", + "items": { + "type": "string" + } + }, + "srcRegionCodes": { + "description": "Region codes whose IP addresses will be used to match for source of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex.\"US\" Maximum number of source region codes allowed is 5000.", + "type": "array", + "items": { + "type": "string" + } }, - "testIamPermissions": { - "id": "compute.regionDisks.testIamPermissions", - "path": "projects/{project}/regions/{region}/disks/{resource}/testIamPermissions", - "flatPath": "projects/{project}/regions/{region}/disks/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + "destRegionCodes": { + "description": "Region codes whose IP addresses will be used to match for destination of traffic. Should be specified as 2 letter country code defined as per ISO 3166 alpha-2 country codes. ex.\"US\" Maximum number of dest region codes allowed is 5000.", + "type": "array", + "items": { + "type": "string" + } }, - "update": { - "id": "compute.regionDisks.update", - "path": "projects/{project}/regions/{region}/disks/{disk}", - "flatPath": "projects/{project}/regions/{region}/disks/{disk}", - "httpMethod": "PATCH", - "parameters": { - "disk": { - "description": "The disk name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "paths": { - "location": "query", - "repeated": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "updateMask": { - "description": "update_mask indicates fields to be updated as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - } - }, - "parameterOrder": [ - "project", - "region", - "disk" - ], - "request": { - "$ref": "Disk" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Update the specified disk with the data included in the request. Update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: user_license." + "destThreatIntelligences": { + "description": "Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic destination.", + "type": "array", + "items": { + "type": "string" + } }, - "startAsyncReplication": { - "id": "compute.regionDisks.startAsyncReplication", - "path": "projects/{project}/regions/{region}/disks/{disk}/startAsyncReplication", - "flatPath": "projects/{project}/regions/{region}/disks/{disk}/startAsyncReplication", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "The name of the persistent disk.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "disk" - ], - "request": { - "$ref": "RegionDisksStartAsyncReplicationRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Starts asynchronous replication. Must be invoked on the primary disk." + "srcThreatIntelligences": { + "description": "Names of Network Threat Intelligence lists. The IPs in these lists will be matched against traffic source.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "FirewallPolicyRuleMatcherLayer4Config": { + "id": "FirewallPolicyRuleMatcherLayer4Config", + "type": "object", + "properties": { + "ipProtocol": { + "description": "The IP protocol to which this rule applies. The protocol type is required when creating a firewall rule. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp), or the IP protocol number.", + "type": "string" }, - "stopAsyncReplication": { - "id": "compute.regionDisks.stopAsyncReplication", - "path": "projects/{project}/regions/{region}/disks/{disk}/stopAsyncReplication", - "flatPath": "projects/{project}/regions/{region}/disks/{disk}/stopAsyncReplication", - "httpMethod": "POST", - "parameters": { - "disk": { - "description": "The name of the persistent disk.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "disk" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Stops asynchronous replication. Can be invoked either on the primary or on the secondary disk." + "ports": { + "description": "An optional list of ports to which this rule applies. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, this rule applies to connections through any port. Example inputs include: [\"22\"], [\"80\",\"443\"], and [\"12345-12349\"].", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "FirewallPolicyRuleSecureTag": { + "id": "FirewallPolicyRuleSecureTag", + "type": "object", + "properties": { + "name": { + "description": "Name of the secure tag, created with TagManager's TagValue API.", + "pattern": "tagValues/[0-9]+", + "type": "string" }, - "stopGroupAsyncReplication": { - "id": "compute.regionDisks.stopGroupAsyncReplication", - "path": "projects/{project}/regions/{region}/disks/stopGroupAsyncReplication", - "flatPath": "projects/{project}/regions/{region}/disks/stopGroupAsyncReplication", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request. This must be the region of the primary or secondary disks in the consistency group.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "DisksStopGroupAsyncReplicationResource" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "state": { + "description": "[Output Only] State of the secure tag, either `EFFECTIVE` or `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted or its network is deleted.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Stops asynchronous replication for a consistency group of disks. Can be invoked either in the primary or secondary scope." + "enum": [ + "EFFECTIVE", + "INEFFECTIVE" + ] + } + } + }, + "FirewallPolicyAssociation": { + "id": "FirewallPolicyAssociation", + "type": "object", + "properties": { + "name": { + "description": "The name for an association.", + "type": "string" }, - "bulkInsert": { - "id": "compute.regionDisks.bulkInsert", - "path": "projects/{project}/regions/{region}/disks/bulkInsert", - "flatPath": "projects/{project}/regions/{region}/disks/bulkInsert", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "BulkInsertDiskResource" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Bulk create a set of disks." + "attachmentTarget": { + "description": "The target that the firewall policy is attached to.", + "type": "string" + }, + "firewallPolicyId": { + "description": "[Output Only] The firewall policy ID of the association.", + "type": "string" + }, + "shortName": { + "description": "[Output Only] The short name of the firewall policy of the association.", + "type": "string" + }, + "displayName": { + "description": "[Output Only] Deprecated, please use short name instead. The display name of the firewall policy of the association.", + "deprecated": true, + "type": "string" } } }, - "firewalls": { - "methods": { - "list": { - "id": "compute.firewalls.list", - "path": "projects/{project}/global/firewalls", - "flatPath": "projects/{project}/global/firewalls", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "FirewallList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of firewall rules available to the specified project." + "FirewallPoliciesListAssociationsResponse": { + "id": "FirewallPoliciesListAssociationsResponse", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of firewallPolicy associations. Always compute#FirewallPoliciesListAssociations for lists of firewallPolicy associations.", + "default": "compute#firewallPoliciesListAssociationsResponse", + "type": "string" }, - "get": { - "id": "compute.firewalls.get", - "path": "projects/{project}/global/firewalls/{firewall}", - "flatPath": "projects/{project}/global/firewalls/{firewall}", - "httpMethod": "GET", - "parameters": { - "firewall": { - "description": "Name of the firewall rule to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewall" - ], - "response": { - "$ref": "Firewall" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified firewall." + "associations": { + "description": "A list of associations.", + "type": "array", + "items": { + "$ref": "FirewallPolicyAssociation" + } + } + } + }, + "GlobalOrganizationSetPolicyRequest": { + "id": "GlobalOrganizationSetPolicyRequest", + "type": "object", + "properties": { + "policy": { + "description": "REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them.", + "$ref": "Policy" }, - "insert": { - "id": "compute.firewalls.insert", - "path": "projects/{project}/global/firewalls", - "flatPath": "projects/{project}/global/firewalls", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { + "bindings": { + "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify bindings.", + "type": "array", + "items": { + "$ref": "Binding" + } + }, + "etag": { + "description": "Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.", + "type": "string", + "format": "byte" + } + } + }, + "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse": { + "id": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse", + "type": "object", + "properties": { + "firewalls": { + "description": "Effective firewalls on the network.", + "type": "array", + "items": { "$ref": "Firewall" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a firewall rule in the specified project using the data included in the request." + } }, - "delete": { - "id": "compute.firewalls.delete", - "path": "projects/{project}/global/firewalls/{firewall}", - "flatPath": "projects/{project}/global/firewalls/{firewall}", - "httpMethod": "DELETE", - "parameters": { - "firewall": { - "description": "Name of the firewall rule to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewall" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified firewall." + "firewallPolicys": { + "description": "[Output only] Effective firewalls from firewall policy. It applies to Regional Network Firewall Policies in the specified region, Global Network Firewall Policies and Hierachial Firewall Policies which are associated with the network.", + "type": "array", + "items": { + "$ref": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy" + } + } + } + }, + "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { + "id": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", + "type": "object", + "properties": { + "name": { + "description": "[Output Only] The name of the firewall policy.", + "type": "string" }, - "update": { - "id": "compute.firewalls.update", - "path": "projects/{project}/global/firewalls/{firewall}", - "flatPath": "projects/{project}/global/firewalls/{firewall}", - "httpMethod": "PUT", - "parameters": { - "firewall": { - "description": "Name of the firewall rule to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewall" - ], - "request": { - "$ref": "Firewall" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": { + "description": "[Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Updates the specified firewall rule with the data included in the request. Note that all fields will be updated if using PUT, even fields that are not specified. To update individual fields, please use PATCH instead." + "enum": [ + "HIERARCHY", + "NETWORK", + "NETWORK_REGIONAL", + "UNSPECIFIED" + ] }, - "patch": { - "id": "compute.firewalls.patch", - "path": "projects/{project}/global/firewalls/{firewall}", - "flatPath": "projects/{project}/global/firewalls/{firewall}", - "httpMethod": "PATCH", - "parameters": { - "firewall": { - "description": "Name of the firewall rule to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewall" - ], - "request": { - "$ref": "Firewall" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified firewall rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + "displayName": { + "description": "[Output Only] The display name of the firewall policy.", + "type": "string" + }, + "rules": { + "description": "[Output only] The rules that apply to the network.", + "type": "array", + "items": { + "$ref": "FirewallPolicyRule" + } } } }, - "firewallPolicies": { - "methods": { - "list": { - "id": "compute.firewallPolicies.list", - "path": "locations/global/firewallPolicies", - "flatPath": "locations/global/firewallPolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "SecurityPolicyList": { + "id": "SecurityPolicyList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#securityPolicyList for listsof securityPolicies", + "default": "compute#securityPolicyList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of SecurityPolicy resources.", + "type": "array", + "items": { + "$ref": "SecurityPolicy" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "parentId": { - "description": "Parent ID for this request. The ID can be either be \"folders/[FOLDER_ID]\" if the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the parent is an organization.", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "response": { - "$ref": "FirewallPolicyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all the policies that have been configured for the specified folder or organization." + } + } + } + }, + "SecurityPolicy": { + "id": "SecurityPolicy", + "description": "Represents a Google Cloud Armor security policy resource. Only external backend services that use load balancers can reference a security policy. For more information, see Google Cloud Armor security policy overview.", + "type": "object", + "properties": { + "userDefinedFields": { + "description": "Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A user-defined field consists of up to 4 bytes extracted from a fixed offset in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an optional mask to select certain bits. Rules may then specify matching values for these fields. Example: userDefinedFields: - name: \"ipv4_fragment_offset\" base: IPV4 offset: 6 size: 2 mask: \"0x1fff\"", + "type": "array", + "items": { + "$ref": "SecurityPolicyUserDefinedField" + } }, - "get": { - "id": "compute.firewallPolicies.get", - "path": "locations/global/firewallPolicies/{firewallPolicy}", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}", - "httpMethod": "GET", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to get.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified firewall policy." + "kind": { + "description": "[Output only] Type of the resource. Always compute#securityPolicyfor security policies", + "default": "compute#securityPolicy", + "type": "string" }, - "insert": { - "id": "compute.firewallPolicies.insert", - "path": "locations/global/firewallPolicies", - "flatPath": "locations/global/firewallPolicies", - "httpMethod": "POST", - "parameters": { - "parentId": { - "description": "Parent ID for this request. The ID can be either be \"folders/[FOLDER_ID]\" if the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the parent is an organization.", - "location": "query", - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "request": { - "$ref": "FirewallPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a new policy in the specified project using the data included in the request." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "delete": { - "id": "compute.firewallPolicies.delete", - "path": "locations/global/firewallPolicies/{firewallPolicy}", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}", - "httpMethod": "DELETE", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to delete.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "rules": { + "description": "A list of rules that belong to this policy. There must always be a default rule which is a rule with priority 2147483647 and match all condition (for the match condition this means match \"*\" for srcIpRanges and for the networkMatch condition every field must be either match \"*\" or not set). If no rules are provided when creating a security policy, a default rule with action \"allow\" will be added.", + "type": "array", + "items": { + "$ref": "SecurityPolicyRule" + } + }, + "adaptiveProtectionConfig": { + "$ref": "SecurityPolicyAdaptiveProtectionConfig" + }, + "ddosProtectionConfig": { + "$ref": "SecurityPolicyDdosProtectionConfig" + }, + "advancedOptionsConfig": { + "$ref": "SecurityPolicyAdvancedOptionsConfig" + }, + "recaptchaOptionsConfig": { + "$ref": "SecurityPolicyRecaptchaOptionsConfig" + }, + "fingerprint": { + "description": "Specifies a fingerprint for this resource, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make get() request to the security policy.", + "type": "string", + "format": "byte" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "type": { + "description": "The type indicates the intended use of the security policy. - CLOUD_ARMOR: Cloud Armor backend security policies can be configured to filter incoming HTTP requests targeting backend services. They filter requests before they hit the origin servers. - CLOUD_ARMOR_EDGE: Cloud Armor edge security policies can be configured to filter incoming HTTP requests targeting backend services (including Cloud CDN-enabled) as well as backend buckets (Cloud Storage). They filter requests before the request is served from Google's cache. - CLOUD_ARMOR_INTERNAL_SERVICE: Cloud Armor internal service policies can be configured to filter HTTP requests targeting services managed by Traffic Director in a service mesh. They filter requests before the request is served from the application. - CLOUD_ARMOR_NETWORK: Cloud Armor network policies can be configured to filter packets targeting network load balancing resources such as backend services, target pools, target instances, and instances with external IPs. They filter requests before the request is served from the application. This field can be set only at resource creation time.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "description": "Deletes the specified policy." + "enum": [ + "CLOUD_ARMOR", + "CLOUD_ARMOR_EDGE", + "CLOUD_ARMOR_NETWORK" + ] }, - "patch": { - "id": "compute.firewallPolicies.patch", - "path": "locations/global/firewallPolicies/{firewallPolicy}", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}", - "httpMethod": "PATCH", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified policy with the data included in the request." + "labels": { + "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } }, - "getRule": { - "id": "compute.firewallPolicies.getRule", - "path": "locations/global/firewallPolicies/{firewallPolicy}/getRule", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/getRule", - "httpMethod": "GET", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to which the queried rule belongs.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - }, - "priority": { - "description": "The priority of the rule to get from the firewall policy.", - "location": "query", - "type": "integer", - "format": "int32" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicyRule" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets a rule of the specified priority." + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this security policy, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the security policy.", + "type": "string", + "format": "byte" }, - "addRule": { - "id": "compute.firewallPolicies.addRule", - "path": "locations/global/firewallPolicies/{firewallPolicy}/addRule", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/addRule", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Inserts a rule into a firewall policy." + "region": { + "description": "[Output Only] URL of the region where the regional security policy resides. This field is not applicable to global security policies.", + "type": "string" + } + } + }, + "SecurityPolicyUserDefinedField": { + "id": "SecurityPolicyUserDefinedField", + "type": "object", + "properties": { + "name": { + "description": "The name of this field. Must be unique within the policy.", + "type": "string" }, - "removeRule": { - "id": "compute.firewallPolicies.removeRule", - "path": "locations/global/firewallPolicies/{firewallPolicy}/removeRule", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/removeRule", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - }, - "priority": { - "description": "The priority of the rule to remove from the firewall policy.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "base": { + "description": "The base relative to which 'offset' is measured. Possible values are: - IPV4: Points to the beginning of the IPv4 header. - IPV6: Points to the beginning of the IPv6 header. - TCP: Points to the beginning of the TCP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. - UDP: Points to the beginning of the UDP header, skipping over any IPv4 options or IPv6 extension headers. Not present for non-first fragments. required", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Deletes a rule of the specified priority." + "enum": [ + "IPV4", + "IPV6", + "TCP", + "UDP" + ] }, - "patchRule": { - "id": "compute.firewallPolicies.patchRule", - "path": "locations/global/firewallPolicies/{firewallPolicy}/patchRule", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/patchRule", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - }, - "priority": { - "description": "The priority of the rule to patch.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches a rule of the specified priority." + "offset": { + "description": "Offset of the first byte of the field (in network byte order) relative to 'base'.", + "type": "integer", + "format": "int32" }, - "addAssociation": { - "id": "compute.firewallPolicies.addAssociation", - "path": "locations/global/firewallPolicies/{firewallPolicy}/addAssociation", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/addAssociation", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - }, - "replaceExistingAssociation": { - "description": "Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists.", - "location": "query", - "type": "boolean" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyAssociation" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Inserts an association for the specified firewall policy." + "size": { + "description": "Size of the field in bytes. Valid values: 1-4.", + "type": "integer", + "format": "int32" }, - "removeAssociation": { - "id": "compute.firewallPolicies.removeAssociation", - "path": "locations/global/firewallPolicies/{firewallPolicy}/removeAssociation", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/removeAssociation", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - }, - "name": { - "description": "Name for the attachment that will be removed.", - "location": "query", - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes an association for the specified firewall policy." + "mask": { + "description": "If specified, apply this mask (bitwise AND) to the field to ignore bits before matching. Encoded as a hexadecimal number (starting with \"0x\"). The last byte of the field (in network byte order) corresponds to the least significant byte of the mask.", + "type": "string" + } + } + }, + "SecurityPolicyRule": { + "id": "SecurityPolicyRule", + "description": "Represents a rule that describes one or more match conditions along with the action to be taken when traffic matches this condition (allow or deny).", + "type": "object", + "properties": { + "kind": { + "description": "[Output only] Type of the resource. Always compute#securityPolicyRule for security policy rules", + "default": "compute#securityPolicyRule", + "type": "string" }, - "listAssociations": { - "id": "compute.firewallPolicies.listAssociations", - "path": "locations/global/firewallPolicies/listAssociations", - "flatPath": "locations/global/firewallPolicies/listAssociations", - "httpMethod": "GET", - "parameters": { - "targetResource": { - "description": "The target resource to list associations. It is an organization, or a folder.", - "location": "query", - "type": "string" - } - }, - "response": { - "$ref": "FirewallPoliciesListAssociationsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists associations of a specified target, i.e., organization or folder." + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" }, - "getAssociation": { - "id": "compute.firewallPolicies.getAssociation", - "path": "locations/global/firewallPolicies/{firewallPolicy}/getAssociation", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/getAssociation", - "httpMethod": "GET", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to which the queried rule belongs.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - }, - "name": { - "description": "The name of the association to get from the firewall policy.", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicyAssociation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets an association with the specified name." + "priority": { + "description": "An integer indicating the priority of a rule in the list. The priority must be a positive value between 0 and 2147483647. Rules are evaluated from highest to lowest priority where 0 is the highest priority and 2147483647 is the lowest priority.", + "type": "integer", + "format": "int32" }, - "cloneRules": { - "id": "compute.firewallPolicies.cloneRules", - "path": "locations/global/firewallPolicies/{firewallPolicy}/cloneRules", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/cloneRules", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "sourceFirewallPolicy": { - "description": "The firewall policy from which to copy rules.", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Copies rules to the specified firewall policy." + "match": { + "description": "A match condition that incoming traffic is evaluated against. If it evaluates to true, the corresponding 'action' is enforced.", + "$ref": "SecurityPolicyRuleMatcher" }, - "move": { - "id": "compute.firewallPolicies.move", - "path": "locations/global/firewallPolicies/{firewallPolicy}/move", - "flatPath": "locations/global/firewallPolicies/{firewallPolicy}/move", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - }, - "parentId": { - "description": "The new parent of the firewall policy. The ID can be either be \"folders/[FOLDER_ID]\" if the parent is a folder or \"organizations/[ORGANIZATION_ID]\" if the parent is an organization.", - "location": "query", - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Moves the specified firewall policy." + "networkMatch": { + "description": "A match condition that incoming packets are evaluated against for CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding 'action' is enforced. The match criteria for a rule consists of built-in match fields (like 'srcIpRanges') and potentially multiple user-defined match fields ('userDefinedFields'). Field values may be extracted directly from the packet or derived from it (e.g. 'srcRegionCodes'). Some fields may not be present in every packet (e.g. 'srcPorts'). A user-defined field is only present if the base header is found in the packet and the entire field is in bounds. Each match field may specify which values can match it, listing one or more ranges, prefixes, or exact values that are considered a match for the field. A field value must be present in order to match a specified match field. If no match values are specified for a match field, then any field value is considered to match it, and it's not required to be present. For strings specifying '*' is also equivalent to match all. For a packet to match a rule, all specified match fields must match the corresponding field values derived from the packet. Example: networkMatch: srcIpRanges: - \"192.0.2.0/24\" - \"198.51.100.0/24\" userDefinedFields: - name: \"ipv4_fragment_offset\" values: - \"1-0x1fff\" The above match condition matches packets with a source IP in 192.0.2.0/24 or 198.51.100.0/24 and a user-defined field named \"ipv4_fragment_offset\" with a value between 1 and 0x1fff inclusive.", + "$ref": "SecurityPolicyRuleNetworkMatcher" }, - "getIamPolicy": { - "id": "compute.firewallPolicies.getIamPolicy", - "path": "locations/global/firewallPolicies/{resource}/getIamPolicy", - "flatPath": "locations/global/firewallPolicies/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "action": { + "description": "The Action to perform when the rule is matched. The following are the valid actions: - allow: allow access to target. - deny(STATUS): deny access to target, returns the HTTP response code specified. Valid values for `STATUS` are 403, 404, and 502. - rate_based_ban: limit client traffic to the configured threshold and ban the client if the traffic exceeds the threshold. Configure parameters for this action in RateLimitOptions. Requires rate_limit_options to be set. - redirect: redirect to a different target. This can either be an internal reCAPTCHA redirect, or an external URL-based redirect via a 302 response. Parameters for this action can be configured via redirectOptions. This action is only supported in Global Security Policies of type CLOUD_ARMOR. - throttle: limit client traffic to the configured threshold. Configure parameters for this action in rateLimitOptions. Requires rate_limit_options to be set for this. ", + "type": "string" + }, + "preview": { + "description": "If set to true, the specified action is not enforced.", + "type": "boolean" + }, + "rateLimitOptions": { + "description": "Must be specified if the action is \"rate_based_ban\" or \"throttle\". Cannot be specified for any other actions.", + "$ref": "SecurityPolicyRuleRateLimitOptions" + }, + "headerAction": { + "description": "Optional, additional actions that are performed on headers. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", + "$ref": "SecurityPolicyRuleHttpHeaderAction" + }, + "redirectOptions": { + "description": "Parameters defining the redirect action. Cannot be specified for any other actions. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", + "$ref": "SecurityPolicyRuleRedirectOptions" + }, + "preconfiguredWafConfig": { + "description": "Preconfigured WAF configuration to be applied for the rule. If the rule does not evaluate preconfigured WAF rules, i.e., if evaluatePreconfiguredWaf() is not used, this field will have no effect.", + "$ref": "SecurityPolicyRulePreconfiguredWafConfig" + } + } + }, + "SecurityPolicyRuleMatcher": { + "id": "SecurityPolicyRuleMatcher", + "description": "Represents a match condition that incoming traffic is evaluated against. Exactly one field must be specified.", + "type": "object", + "properties": { + "expr": { + "description": "User defined CEVAL expression. A CEVAL expression is used to specify match criteria such as origin.ip, source.region_code and contents in the request header. Expressions containing `evaluateThreatIntelligence` require Cloud Armor Managed Protection Plus tier and are not supported in Edge Policies nor in Regional Policies. Expressions containing `evaluatePreconfiguredExpr('sourceiplist-*')` require Cloud Armor Managed Protection Plus tier and are only supported in Global Security Policies.", + "$ref": "Expr" }, - "setIamPolicy": { - "id": "compute.firewallPolicies.setIamPolicy", - "path": "locations/global/firewallPolicies/{resource}/setIamPolicy", - "flatPath": "locations/global/firewallPolicies/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "resource" - ], - "request": { - "$ref": "GlobalOrganizationSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "exprOptions": { + "description": "The configuration options available when specifying a user defined CEVAL expression (i.e., 'expr').", + "$ref": "SecurityPolicyRuleMatcherExprOptions" }, - "testIamPermissions": { - "id": "compute.firewallPolicies.testIamPermissions", - "path": "locations/global/firewallPolicies/{resource}/testIamPermissions", - "flatPath": "locations/global/firewallPolicies/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "(firewallPolicies/)?[0-9]{0,20}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "versionedExpr": { + "description": "Preconfigured versioned expression. If this field is specified, config must also be specified. Available preconfigured expressions along with their requirements are: SRC_IPS_V1 - must specify the corresponding src_ip_range field in config.", + "type": "string", + "enumDescriptions": [ + "Matches the source IP address of a request to the IP ranges supplied in config." ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "SRC_IPS_V1" + ] + }, + "config": { + "description": "The configuration options available when specifying versioned_expr. This field must be specified if versioned_expr is specified and cannot be specified if versioned_expr is not specified.", + "$ref": "SecurityPolicyRuleMatcherConfig" } } }, - "networkFirewallPolicies": { - "methods": { - "list": { - "id": "compute.networkFirewallPolicies.list", - "path": "projects/{project}/global/firewallPolicies", - "flatPath": "projects/{project}/global/firewallPolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "FirewallPolicyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all the policies that have been configured for the specified project." + "SecurityPolicyRuleMatcherExprOptions": { + "id": "SecurityPolicyRuleMatcherExprOptions", + "type": "object", + "properties": { + "recaptchaOptions": { + "description": "reCAPTCHA configuration options to be applied for the rule. If the rule does not evaluate reCAPTCHA tokens, this field has no effect.", + "$ref": "SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions" + } + } + }, + "SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions": { + "id": "SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions", + "type": "object", + "properties": { + "actionTokenSiteKeys": { + "description": "A list of site keys to be used during the validation of reCAPTCHA action-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created.", + "type": "array", + "items": { + "type": "string" + } }, - "get": { - "id": "compute.networkFirewallPolicies.get", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", - "httpMethod": "GET", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to get.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified network firewall policy." + "sessionTokenSiteKeys": { + "description": "A list of site keys to be used during the validation of reCAPTCHA session-tokens. The provided site keys need to be created from reCAPTCHA API under the same project where the security policy is created.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SecurityPolicyRuleMatcherConfig": { + "id": "SecurityPolicyRuleMatcherConfig", + "type": "object", + "properties": { + "srcIpRanges": { + "description": "CIDR IP address range. Maximum number of src_ip_ranges allowed is 10.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SecurityPolicyRuleNetworkMatcher": { + "id": "SecurityPolicyRuleNetworkMatcher", + "description": "Represents a match condition that incoming network traffic is evaluated against.", + "type": "object", + "properties": { + "userDefinedFields": { + "description": "User-defined fields. Each element names a defined field and lists the matching values for that field.", + "type": "array", + "items": { + "$ref": "SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch" + } }, - "insert": { - "id": "compute.networkFirewallPolicies.insert", - "path": "projects/{project}/global/firewallPolicies", - "flatPath": "projects/{project}/global/firewallPolicies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "FirewallPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a new policy in the specified project using the data included in the request." + "srcIpRanges": { + "description": "Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format.", + "type": "array", + "items": { + "type": "string" + } }, - "delete": { - "id": "compute.networkFirewallPolicies.delete", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", - "httpMethod": "DELETE", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified policy." + "destIpRanges": { + "description": "Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text format.", + "type": "array", + "items": { + "type": "string" + } }, - "patch": { - "id": "compute.networkFirewallPolicies.patch", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}", - "httpMethod": "PATCH", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified policy with the data included in the request." + "ipProtocols": { + "description": "IPv4 protocol / IPv6 next header (after extension headers). Each element can be an 8-bit unsigned decimal number (e.g. \"6\"), range (e.g. \"253-254\"), or one of the following protocol names: \"tcp\", \"udp\", \"icmp\", \"esp\", \"ah\", \"ipip\", or \"sctp\".", + "type": "array", + "items": { + "type": "string" + } }, - "getRule": { - "id": "compute.networkFirewallPolicies.getRule", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getRule", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getRule", - "httpMethod": "GET", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to which the queried rule belongs.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "priority": { - "description": "The priority of the rule to get from the firewall policy.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicyRule" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets a rule of the specified priority." + "srcPorts": { + "description": "Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. \"80\") or range (e.g. \"0-1023\").", + "type": "array", + "items": { + "type": "string" + } }, - "addRule": { - "id": "compute.networkFirewallPolicies.addRule", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addRule", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addRule", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "maxPriority": { - "description": "When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority\u003e. This field is exclusive with rule.priority.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "minPriority": { - "description": "When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority\u003e. This field is exclusive with rule.priority.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "destPorts": { + "description": "Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned decimal number (e.g. \"80\") or range (e.g. \"0-1023\").", + "type": "array", + "items": { + "type": "string" + } + }, + "srcRegionCodes": { + "description": "Two-letter ISO 3166-1 alpha-2 country code associated with the source IP address.", + "type": "array", + "items": { + "type": "string" + } + }, + "srcAsns": { + "description": "BGP Autonomous System Number associated with the source IP address.", + "type": "array", + "items": { + "type": "integer", + "format": "uint32" + } + } + } + }, + "SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch": { + "id": "SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch", + "type": "object", + "properties": { + "name": { + "description": "Name of the user-defined field, as given in the definition.", + "type": "string" + }, + "values": { + "description": "Matching values of the field. Each element can be a 32-bit unsigned decimal or hexadecimal (starting with \"0x\") number (e.g. \"64\") or range (e.g. \"0x400-0x7ff\").", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SecurityPolicyRuleRateLimitOptions": { + "id": "SecurityPolicyRuleRateLimitOptions", + "type": "object", + "properties": { + "rateLimitThreshold": { + "description": "Threshold at which to begin ratelimiting.", + "$ref": "SecurityPolicyRuleRateLimitOptionsThreshold" + }, + "conformAction": { + "description": "Action to take for requests that are under the configured rate limit threshold. Valid option is \"allow\" only.", + "type": "string" + }, + "exceedAction": { + "description": "Action to take for requests that are above the configured rate limit threshold, to either deny with a specified HTTP response code, or redirect to a different endpoint. Valid options are `deny(STATUS)`, where valid values for `STATUS` are 403, 404, 429, and 502, and `redirect`, where the redirect parameters come from `exceedRedirectOptions` below. The `redirect` action is only supported in Global Security Policies of type CLOUD_ARMOR.", + "type": "string" + }, + "exceedRedirectOptions": { + "description": "Parameters defining the redirect action that is used as the exceed action. Cannot be specified if the exceed action is not redirect. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", + "$ref": "SecurityPolicyRuleRedirectOptions" + }, + "enforceOnKey": { + "description": "Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if \"enforceOnKey\" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under \"enforceOnKeyName\". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under \"enforceOnKeyName\". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on \"userIpRequestHeaders\" configured with the security policy. If there is no \"userIpRequestHeaders\" configuration or an IP address cannot be resolved from it, the key type defaults to IP. ", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Inserts a rule into a firewall policy." + "enum": [ + "ALL", + "HTTP_COOKIE", + "HTTP_HEADER", + "HTTP_PATH", + "IP", + "REGION_CODE", + "SNI", + "TLS_JA3_FINGERPRINT", + "USER_IP", + "XFF_IP" + ] }, - "removeRule": { - "id": "compute.networkFirewallPolicies.removeRule", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeRule", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeRule", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "priority": { - "description": "The priority of the rule to remove from the firewall policy.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes a rule of the specified priority." + "enforceOnKeyName": { + "description": "Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value.", + "type": "string" }, - "patchRule": { - "id": "compute.networkFirewallPolicies.patchRule", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchRule", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/patchRule", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "priority": { - "description": "The priority of the rule to patch.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches a rule of the specified priority." + "enforceOnKeyConfigs": { + "description": "If specified, any combination of values of enforce_on_key_type/enforce_on_key_name is treated as the key on which ratelimit threshold/action is enforced. You can specify up to 3 enforce_on_key_configs. If enforce_on_key_configs is specified, enforce_on_key must not be specified.", + "type": "array", + "items": { + "$ref": "SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig" + } }, - "getIamPolicy": { - "id": "compute.networkFirewallPolicies.getIamPolicy", - "path": "projects/{project}/global/firewallPolicies/{resource}/getIamPolicy", - "flatPath": "projects/{project}/global/firewallPolicies/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "banThreshold": { + "description": "Can only be specified if the action for the rule is \"rate_based_ban\". If specified, the key will be banned for the configured 'ban_duration_sec' when the number of requests that exceed the 'rate_limit_threshold' also exceed this 'ban_threshold'.", + "$ref": "SecurityPolicyRuleRateLimitOptionsThreshold" }, - "setIamPolicy": { - "id": "compute.networkFirewallPolicies.setIamPolicy", - "path": "projects/{project}/global/firewallPolicies/{resource}/setIamPolicy", - "flatPath": "projects/{project}/global/firewallPolicies/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "banDurationSec": { + "description": "Can only be specified if the action for the rule is \"rate_based_ban\". If specified, determines the time (in seconds) the traffic will continue to be banned by the rate limit after the rate falls below the threshold.", + "type": "integer", + "format": "int32" + } + } + }, + "SecurityPolicyRuleRateLimitOptionsThreshold": { + "id": "SecurityPolicyRuleRateLimitOptionsThreshold", + "type": "object", + "properties": { + "count": { + "description": "Number of HTTP(S) requests for calculating the threshold.", + "type": "integer", + "format": "int32" }, - "testIamPermissions": { - "id": "compute.networkFirewallPolicies.testIamPermissions", - "path": "projects/{project}/global/firewallPolicies/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/firewallPolicies/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "intervalSec": { + "description": "Interval over which the threshold is computed.", + "type": "integer", + "format": "int32" + } + } + }, + "SecurityPolicyRuleRedirectOptions": { + "id": "SecurityPolicyRuleRedirectOptions", + "type": "object", + "properties": { + "type": { + "description": "Type of the redirect action.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "EXTERNAL_302", + "GOOGLE_RECAPTCHA" + ] }, - "addAssociation": { - "id": "compute.networkFirewallPolicies.addAssociation", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addAssociation", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/addAssociation", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "replaceExistingAssociation": { - "description": "Indicates whether or not to replace it if an association of the attachment already exists. This is false by default, in which case an error will be returned if an association already exists.", - "location": "query", - "type": "boolean" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyAssociation" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "target": { + "description": "Target for the redirect action. This is required if the type is EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA.", + "type": "string" + } + } + }, + "SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig": { + "id": "SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig", + "type": "object", + "properties": { + "enforceOnKeyType": { + "description": "Determines the key to enforce the rate_limit_threshold on. Possible values are: - ALL: A single rate limit threshold is applied to all the requests matching this rule. This is the default value if \"enforceOnKeyConfigs\" is not configured. - IP: The source IP address of the request is the key. Each IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP header whose name is configured under \"enforceOnKeyName\". The key value is truncated to the first 128 bytes of the header value. If no such header is present in the request, the key type defaults to ALL. - XFF_IP: The first IP address (i.e. the originating client IP address) specified in the list of IPs under X-Forwarded-For HTTP header. If no such header is present or the value is not a valid IP, the key defaults to the source IP address of the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie whose name is configured under \"enforceOnKeyName\". The key value is truncated to the first 128 bytes of the cookie value. If no such cookie is present in the request, the key type defaults to ALL. - HTTP_PATH: The URL path of the HTTP request. The key value is truncated to the first 128 bytes. - SNI: Server name indication in the TLS session of the HTTPS request. The key value is truncated to the first 128 bytes. The key type defaults to ALL on a HTTP session. - REGION_CODE: The country/region from which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not available, the key type defaults to ALL. - USER_IP: The IP address of the originating client, which is resolved based on \"userIpRequestHeaders\" configured with the security policy. If there is no \"userIpRequestHeaders\" configuration or an IP address cannot be resolved from it, the key type defaults to IP. ", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Inserts an association for the specified firewall policy." + "enum": [ + "ALL", + "HTTP_COOKIE", + "HTTP_HEADER", + "HTTP_PATH", + "IP", + "REGION_CODE", + "SNI", + "TLS_JA3_FINGERPRINT", + "USER_IP", + "XFF_IP" + ] }, - "removeAssociation": { - "id": "compute.networkFirewallPolicies.removeAssociation", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeAssociation", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/removeAssociation", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "name": { - "description": "Name for the attachment that will be removed.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes an association for the specified firewall policy." + "enforceOnKeyName": { + "description": "Rate limit key name applicable only for the following key types: HTTP_HEADER -- Name of the HTTP header whose value is taken as the key value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the key value.", + "type": "string" + } + } + }, + "SecurityPolicyRuleHttpHeaderAction": { + "id": "SecurityPolicyRuleHttpHeaderAction", + "type": "object", + "properties": { + "requestHeadersToAdds": { + "description": "The list of request headers to add or overwrite if they're already present.", + "type": "array", + "items": { + "$ref": "SecurityPolicyRuleHttpHeaderActionHttpHeaderOption" + } + } + } + }, + "SecurityPolicyRuleHttpHeaderActionHttpHeaderOption": { + "id": "SecurityPolicyRuleHttpHeaderActionHttpHeaderOption", + "type": "object", + "properties": { + "headerName": { + "description": "The name of the header to set.", + "type": "string" }, - "getAssociation": { - "id": "compute.networkFirewallPolicies.getAssociation", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getAssociation", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/getAssociation", - "httpMethod": "GET", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to which the queried association belongs.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "name": { - "description": "The name of the association to get from the firewall policy.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicyAssociation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets an association with the specified name." + "headerValue": { + "description": "The value to set the named header to.", + "type": "string" + } + } + }, + "SecurityPolicyRulePreconfiguredWafConfig": { + "id": "SecurityPolicyRulePreconfiguredWafConfig", + "type": "object", + "properties": { + "exclusions": { + "description": "A list of exclusions to apply during preconfigured WAF evaluation.", + "type": "array", + "items": { + "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusion" + } + } + } + }, + "SecurityPolicyRulePreconfiguredWafConfigExclusion": { + "id": "SecurityPolicyRulePreconfiguredWafConfigExclusion", + "type": "object", + "properties": { + "targetRuleSet": { + "description": "Target WAF rule set to apply the preconfigured WAF exclusion.", + "type": "string" + }, + "targetRuleIds": { + "description": "A list of target rule IDs under the WAF rule set to apply the preconfigured WAF exclusion. If omitted, it refers to all the rule IDs under the WAF rule set.", + "type": "array", + "items": { + "type": "string" + } + }, + "requestHeadersToExclude": { + "description": "A list of request header names whose value will be excluded from inspection during preconfigured WAF evaluation.", + "type": "array", + "items": { + "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" + } + }, + "requestCookiesToExclude": { + "description": "A list of request cookie names whose value will be excluded from inspection during preconfigured WAF evaluation.", + "type": "array", + "items": { + "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" + } + }, + "requestQueryParamsToExclude": { + "description": "A list of request query parameter names whose value will be excluded from inspection during preconfigured WAF evaluation. Note that the parameter can be in the query string or in the POST body.", + "type": "array", + "items": { + "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" + } }, - "cloneRules": { - "id": "compute.networkFirewallPolicies.cloneRules", - "path": "projects/{project}/global/firewallPolicies/{firewallPolicy}/cloneRules", - "flatPath": "projects/{project}/global/firewallPolicies/{firewallPolicy}/cloneRules", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "sourceFirewallPolicy": { - "description": "The firewall policy from which to copy rules.", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Copies rules to the specified firewall policy." + "requestUrisToExclude": { + "description": "A list of request URIs from the request line to be excluded from inspection during preconfigured WAF evaluation. When specifying this field, the query or fragment part should be excluded.", + "type": "array", + "items": { + "$ref": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams" + } } } }, - "regionNetworkFirewallPolicies": { - "methods": { - "list": { - "id": "compute.regionNetworkFirewallPolicies.list", - "path": "projects/{project}/regions/{region}/firewallPolicies", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "FirewallPolicyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all the network firewall policies that have been configured for the specified project in the given region." + "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams": { + "id": "SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams", + "type": "object", + "properties": { + "val": { + "description": "The value of the field.", + "type": "string" }, - "get": { - "id": "compute.regionNetworkFirewallPolicies.get", - "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", - "httpMethod": "GET", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to get.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "op": { + "description": "The match operator for the field.", + "type": "string", + "enumDescriptions": [ + "The operator matches if the field value contains the specified value.", + "The operator matches if the field value ends with the specified value.", + "The operator matches if the field value equals the specified value.", + "The operator matches if the field value is any value.", + "The operator matches if the field value starts with the specified value." ], - "description": "Returns the specified network firewall policy." + "enum": [ + "CONTAINS", + "ENDS_WITH", + "EQUALS", + "EQUALS_ANY", + "STARTS_WITH" + ] + } + } + }, + "SecurityPolicyAdaptiveProtectionConfig": { + "id": "SecurityPolicyAdaptiveProtectionConfig", + "description": "Configuration options for Cloud Armor Adaptive Protection (CAAP).", + "type": "object", + "properties": { + "layer7DdosDefenseConfig": { + "description": "If set to true, enables Cloud Armor Machine Learning.", + "$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig" + } + } + }, + "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig": { + "id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig", + "description": "Configuration options for L7 DDoS detection. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", + "type": "object", + "properties": { + "enable": { + "description": "If set to true, enables CAAP for L7 DDoS detection. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", + "type": "boolean" }, - "insert": { - "id": "compute.regionNetworkFirewallPolicies.insert", - "path": "projects/{project}/regions/{region}/firewallPolicies", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "FirewallPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "ruleVisibility": { + "description": "Rule visibility can be one of the following: STANDARD - opaque rules. (default) PREMIUM - transparent rules. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Creates a new network firewall policy in the specified project and region." + "enum": [ + "PREMIUM", + "STANDARD" + ] }, - "delete": { - "id": "compute.regionNetworkFirewallPolicies.delete", - "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", - "httpMethod": "DELETE", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified network firewall policy." + "thresholdConfigs": { + "description": "Configuration options for layer7 adaptive protection for various customizable thresholds.", + "type": "array", + "items": { + "$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig" + } + } + } + }, + "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig": { + "id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig", + "type": "object", + "properties": { + "name": { + "description": "The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the security policy.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" }, - "patch": { - "id": "compute.regionNetworkFirewallPolicies.patch", - "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}", - "httpMethod": "PATCH", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified network firewall policy." + "autoDeployLoadThreshold": { + "type": "number", + "format": "float" }, - "getRule": { - "id": "compute.regionNetworkFirewallPolicies.getRule", - "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getRule", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getRule", - "httpMethod": "GET", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to which the queried rule belongs.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "priority": { - "description": "The priority of the rule to get from the firewall policy.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicyRule" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets a rule of the specified priority." + "autoDeployConfidenceThreshold": { + "type": "number", + "format": "float" }, - "addRule": { - "id": "compute.regionNetworkFirewallPolicies.addRule", - "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addRule", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addRule", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "maxPriority": { - "description": "When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority\u003e. This field is exclusive with rule.priority.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "minPriority": { - "description": "When rule.priority is not specified, auto choose a unused priority between minPriority and maxPriority\u003e. This field is exclusive with rule.priority.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "autoDeployImpactedBaselineThreshold": { + "type": "number", + "format": "float" + }, + "autoDeployExpirationSec": { + "type": "integer", + "format": "int32" + }, + "detectionLoadThreshold": { + "type": "number", + "format": "float" + }, + "detectionAbsoluteQps": { + "type": "number", + "format": "float" + }, + "detectionRelativeToBaselineQps": { + "type": "number", + "format": "float" + }, + "trafficGranularityConfigs": { + "description": "Configuration options for enabling Adaptive Protection to operate on specified granular traffic units.", + "type": "array", + "items": { + "$ref": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig" + } + } + } + }, + "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig": { + "id": "SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig", + "description": "Configurations to specifc granular traffic units processed by Adaptive Protection.", + "type": "object", + "properties": { + "type": { + "description": "Type of this configuration.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "description": "Inserts a rule into a network firewall policy." + "enum": [ + "HTTP_HEADER_HOST", + "HTTP_PATH", + "UNSPECIFIED_TYPE" + ] }, - "removeRule": { - "id": "compute.regionNetworkFirewallPolicies.removeRule", - "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeRule", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeRule", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "priority": { - "description": "The priority of the rule to remove from the firewall policy.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" + "value": { + "description": "Requests that match this value constitute a granular traffic unit.", + "type": "string" + }, + "enableEachUniqueValue": { + "description": "If enabled, traffic matching each unique value for the specified type constitutes a separate traffic unit. It can only be set to true if `value` is empty.", + "type": "boolean" + } + } + }, + "SecurityPolicyDdosProtectionConfig": { + "id": "SecurityPolicyDdosProtectionConfig", + "type": "object", + "properties": { + "ddosProtection": { + "type": "string", + "enumDescriptions": [ + "", + "" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ADVANCED", + "STANDARD" + ] + } + } + }, + "SecurityPolicyAdvancedOptionsConfig": { + "id": "SecurityPolicyAdvancedOptionsConfig", + "type": "object", + "properties": { + "jsonParsing": { + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "description": "Deletes a rule of the specified priority." + "enum": [ + "DISABLED", + "STANDARD", + "STANDARD_WITH_GRAPHQL" + ] }, - "patchRule": { - "id": "compute.regionNetworkFirewallPolicies.patchRule", - "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/patchRule", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/patchRule", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "priority": { - "description": "The priority of the rule to patch.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "jsonCustomConfig": { + "description": "Custom configuration to apply the JSON parsing. Only applicable when json_parsing is set to STANDARD.", + "$ref": "SecurityPolicyAdvancedOptionsConfigJsonCustomConfig" + }, + "logLevel": { + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Patches a rule of the specified priority." + "enum": [ + "NORMAL", + "VERBOSE" + ] }, - "cloneRules": { - "id": "compute.regionNetworkFirewallPolicies.cloneRules", - "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/cloneRules", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/cloneRules", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "userIpRequestHeaders": { + "description": "An optional list of case-insensitive request header names to use for resolving the callers client IP address.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SecurityPolicyAdvancedOptionsConfigJsonCustomConfig": { + "id": "SecurityPolicyAdvancedOptionsConfigJsonCustomConfig", + "type": "object", + "properties": { + "contentTypes": { + "description": "A list of custom Content-Type header values to apply the JSON parsing. As per RFC 1341, a Content-Type header value has the following format: Content-Type := type \"/\" subtype *[\";\" parameter] When configuring a custom Content-Type header value, only the type/subtype needs to be specified, and the parameters should be excluded.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SecurityPolicyRecaptchaOptionsConfig": { + "id": "SecurityPolicyRecaptchaOptionsConfig", + "type": "object", + "properties": { + "redirectSiteKey": { + "description": "An optional field to supply a reCAPTCHA site key to be used for all the rules using the redirect action with the type of GOOGLE_RECAPTCHA under the security policy. The specified site key needs to be created from the reCAPTCHA API. The user is responsible for the validity of the specified site key. If not specified, a Google-managed site key is used. This field is only supported in Global Security Policies of type CLOUD_ARMOR.", + "type": "string" + } + } + }, + "SecurityPoliciesListPreconfiguredExpressionSetsResponse": { + "id": "SecurityPoliciesListPreconfiguredExpressionSetsResponse", + "type": "object", + "properties": { + "preconfiguredExpressionSets": { + "$ref": "SecurityPoliciesWafConfig" + } + } + }, + "SecurityPoliciesWafConfig": { + "id": "SecurityPoliciesWafConfig", + "type": "object", + "properties": { + "wafRules": { + "$ref": "PreconfiguredWafSet" + } + } + }, + "PreconfiguredWafSet": { + "id": "PreconfiguredWafSet", + "type": "object", + "properties": { + "expressionSets": { + "description": "List of entities that are currently supported for WAF rules.", + "type": "array", + "items": { + "$ref": "WafExpressionSet" + } + } + } + }, + "WafExpressionSet": { + "id": "WafExpressionSet", + "type": "object", + "properties": { + "id": { + "description": "Google specified expression set ID. The format should be: - E.g. XSS-20170329 required", + "type": "string" + }, + "aliases": { + "description": "A list of alternate IDs. The format should be: - E.g. XSS-stable Generic suffix like \"stable\" is particularly useful if a policy likes to avail newer set of expressions without having to change the policy. A given alias name can't be used for more than one entity set.", + "type": "array", + "items": { + "type": "string" + } + }, + "expressions": { + "description": "List of available expressions.", + "type": "array", + "items": { + "$ref": "WafExpressionSetExpression" + } + } + } + }, + "WafExpressionSetExpression": { + "id": "WafExpressionSetExpression", + "type": "object", + "properties": { + "id": { + "description": "Expression ID should uniquely identify the origin of the expression. E.g. owasp-crs-v020901-id973337 identifies Owasp core rule set version 2.9.1 rule id 973337. The ID could be used to determine the individual attack definition that has been detected. It could also be used to exclude it from the policy in case of false positive. required", + "type": "string" + }, + "sensitivity": { + "description": "The sensitivity value associated with the WAF rule ID. This corresponds to the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for opt-in only rules.", + "type": "integer", + "format": "int32" + } + } + }, + "SecurityPoliciesAggregatedList": { + "id": "SecurityPoliciesAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#securityPolicyAggregatedList for lists of Security Policies.", + "default": "compute#securityPoliciesAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of SecurityPoliciesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of security policies.", + "$ref": "SecurityPoliciesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } + } + } + }, + "etag": { + "type": "string" + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SecurityPoliciesScopedList": { + "id": "SecurityPoliciesScopedList", + "type": "object", + "properties": { + "securityPolicies": { + "description": "A list of SecurityPolicies contained in this scope.", + "type": "array", + "items": { + "$ref": "SecurityPolicy" + } + }, + "warning": { + "description": "Informational warning which replaces the list of security policies when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "sourceFirewallPolicy": { - "description": "The firewall policy from which to copy rules.", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Copies rules to the specified network firewall policy." + } + } + } + }, + "InstanceList": { + "id": "InstanceList", + "description": "Contains a list of instances.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#instanceList for lists of Instance resources.", + "default": "compute#instanceList", + "type": "string" }, - "getAssociation": { - "id": "compute.regionNetworkFirewallPolicies.getAssociation", - "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getAssociation", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/getAssociation", - "httpMethod": "GET", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to which the queried association belongs.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "name": { - "description": "The name of the association to get from the firewall policy.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "response": { - "$ref": "FirewallPolicyAssociation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets an association with the specified name." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "addAssociation": { - "id": "compute.regionNetworkFirewallPolicies.addAssociation", - "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addAssociation", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/addAssociation", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of Instance resources.", + "type": "array", + "items": { + "$ref": "Instance" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "replaceExistingAssociation": { - "description": "Indicates whether or not to replace it if an association already exists. This is false by default, in which case an error will be returned if an association already exists.", - "location": "query", - "type": "boolean" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } + } + } + } + }, + "Instance": { + "id": "Instance", + "description": "Represents an Instance resource. An instance is a virtual machine that is hosted on Google Cloud Platform. For more information, read Virtual Machine Instances.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#instance for instances.", + "default": "compute#instance", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "annotations": { + "required": [ + "compute.instances.insert" + ] }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "request": { - "$ref": "FirewallPolicyAssociation" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "tags": { + "description": "Tags to apply to this instance. Tags are used to identify valid sources or targets for network firewalls and are specified by the client during instance creation. The tags can be later modified by the setTags method. Each tag within the list must comply with RFC1035. Multiple tags can be specified via the 'tags.items' field.", + "$ref": "Tags" + }, + "machineType": { + "description": "Full or partial URL of the machine type resource to use for this instance, in the format: zones/zone/machineTypes/machine-type. This is provided by the client when the instance is created. For example, the following is a valid partial url to a predefined machine type: zones/us-central1-f/machineTypes/n1-standard-1 To create a custom machine type, provide a URL to a machine type in the following format, where CPUS is 1 or an even number up to 32 (2, 4, 6, ... 24, etc), and MEMORY is the total memory for this instance. Memory must be a multiple of 256 MB and must be supplied in MB (e.g. 5 GB of memory is 5120 MB): zones/zone/machineTypes/custom-CPUS-MEMORY For example: zones/us-central1-f/machineTypes/custom-4-5120 For a full list of restrictions, read the Specifications for custom machine types.", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the instance. One of the following values: PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING, and TERMINATED. For more information about the status of the instance, see Instance life cycle.", + "type": "string", + "enumDescriptions": [ + "The instance is halted and we are performing tear down tasks like network deprogramming, releasing quota, IP, tearing down disks etc.", + "Resources are being allocated for the instance.", + "The instance is in repair.", + "The instance is running.", + "All required resources have been allocated and the instance is being started.", + "The instance has stopped successfully.", + "The instance is currently stopping (either being deleted or killed).", + "The instance has suspended.", + "The instance is suspending.", + "The instance has stopped (either by explicit action or underlying failure)." ], - "description": "Inserts an association for the specified network firewall policy." + "enum": [ + "DEPROVISIONING", + "PROVISIONING", + "REPAIRING", + "RUNNING", + "STAGING", + "STOPPED", + "STOPPING", + "SUSPENDED", + "SUSPENDING", + "TERMINATED" + ] + }, + "statusMessage": { + "description": "[Output Only] An optional, human-readable explanation of the status.", + "type": "string" + }, + "zone": { + "description": "[Output Only] URL of the zone where the instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "canIpForward": { + "description": "Allows this instance to send and receive packets with non-matching destination or source IPs. This is required if you plan to use this instance to forward routes. For more information, see Enabling IP Forwarding .", + "type": "boolean" + }, + "networkInterfaces": { + "description": "An array of network configurations for this instance. These specify how interfaces are configured to interact with other network services, such as connecting to the internet. Multiple interfaces are supported per instance.", + "type": "array", + "items": { + "$ref": "NetworkInterface" + } + }, + "disks": { + "description": "Array of disks associated with this instance. Persistent disks must be created before you can assign them.", + "type": "array", + "items": { + "$ref": "AttachedDisk" + } + }, + "metadata": { + "description": "The metadata key/value pairs assigned to this instance. This includes custom metadata and predefined keys.", + "$ref": "Metadata" + }, + "serviceAccounts": { + "description": "A list of service accounts, with their specified scopes, authorized for this instance. Only one service account per VM instance is supported. Service accounts generate access tokens that can be accessed through the metadata server and used to authenticate applications on the instance. See Service Accounts for more information.", + "type": "array", + "items": { + "$ref": "ServiceAccount" + } + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "scheduling": { + "description": "Sets the scheduling options for this instance.", + "$ref": "Scheduling" + }, + "cpuPlatform": { + "description": "[Output Only] The CPU platform used by this instance.", + "type": "string" + }, + "labels": { + "description": "Labels to apply to this instance. These can be later modified by the setLabels method.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "params": { + "description": "Input only. [Input Only] Additional params passed with the request, but not persisted as part of resource payload.", + "$ref": "InstanceParams" + }, + "labelFingerprint": { + "description": "A fingerprint for this request, which is essentially a hash of the label's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make get() request to the instance.", + "type": "string", + "format": "byte" + }, + "instanceEncryptionKey": { + "description": "Encrypts suspended data for an instance with a customer-managed encryption key. If you are creating a new instance, this field will encrypt the local SSD and in-memory contents of the instance during the suspend operation. If you do not provide an encryption key when creating the instance, then the local SSD and in-memory contents will be encrypted using an automatically generated key during the suspend operation.", + "$ref": "CustomerEncryptionKey" + }, + "minCpuPlatform": { + "description": "Specifies a minimum CPU platform for the VM instance. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: \"Intel Haswell\" or minCpuPlatform: \"Intel Sandy Bridge\".", + "type": "string" + }, + "guestAccelerators": { + "description": "A list of the type and count of accelerator cards attached to the instance.", + "type": "array", + "items": { + "$ref": "AcceleratorConfig" + } + }, + "startRestricted": { + "description": "[Output Only] Whether a VM has been restricted for start because Compute Engine has detected suspicious activity.", + "type": "boolean" + }, + "deletionProtection": { + "description": "Whether the resource should be protected against deletion.", + "type": "boolean" + }, + "resourcePolicies": { + "description": "Resource policies applied to this instance.", + "type": "array", + "items": { + "type": "string" + } + }, + "sourceMachineImage": { + "description": "Source machine image", + "type": "string" + }, + "reservationAffinity": { + "description": "Specifies the reservations that this instance can consume from.", + "$ref": "ReservationAffinity" + }, + "hostname": { + "description": "Specifies the hostname of the instance. The specified hostname must be RFC1035 compliant. If hostname is not specified, the default hostname is [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS.", + "type": "string" + }, + "displayDevice": { + "description": "Enables display device for the instance.", + "$ref": "DisplayDevice" + }, + "shieldedInstanceConfig": { + "$ref": "ShieldedInstanceConfig" }, - "removeAssociation": { - "id": "compute.regionNetworkFirewallPolicies.removeAssociation", - "path": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeAssociation", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{firewallPolicy}/removeAssociation", - "httpMethod": "POST", - "parameters": { - "firewallPolicy": { - "description": "Name of the firewall policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "name": { - "description": "Name for the association that will be removed.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "firewallPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes an association for the specified network firewall policy." + "shieldedInstanceIntegrityPolicy": { + "$ref": "ShieldedInstanceIntegrityPolicy" }, - "getEffectiveFirewalls": { - "id": "compute.regionNetworkFirewallPolicies.getEffectiveFirewalls", - "path": "projects/{project}/regions/{region}/firewallPolicies/getEffectiveFirewalls", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/getEffectiveFirewalls", - "httpMethod": "GET", - "parameters": { - "network": { - "description": "Network reference", - "location": "query", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "network" - ], - "response": { - "$ref": "RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the effective firewalls on a given network." + "sourceMachineImageEncryptionKey": { + "description": "Source machine image encryption key when creating an instance from a machine image.", + "$ref": "CustomerEncryptionKey" }, - "getIamPolicy": { - "id": "compute.regionNetworkFirewallPolicies.getIamPolicy", - "path": "projects/{project}/regions/{region}/firewallPolicies/{resource}/getIamPolicy", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "confidentialInstanceConfig": { + "$ref": "ConfidentialInstanceConfig" }, - "setIamPolicy": { - "id": "compute.regionNetworkFirewallPolicies.setIamPolicy", - "path": "projects/{project}/regions/{region}/firewallPolicies/{resource}/setIamPolicy", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "fingerprint": { + "description": "Specifies a fingerprint for this resource, which is essentially a hash of the instance's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance. You must always provide an up-to-date fingerprint hash in order to update the instance. To see the latest fingerprint, make get() request to the instance.", + "type": "string", + "format": "byte" }, - "testIamPermissions": { - "id": "compute.regionNetworkFirewallPolicies.testIamPermissions", - "path": "projects/{project}/regions/{region}/firewallPolicies/{resource}/testIamPermissions", - "flatPath": "projects/{project}/regions/{region}/firewallPolicies/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" + "privateIpv6GoogleAccess": { + "description": "The private IPv6 google access type for the VM. If not specified, use INHERIT_FROM_SUBNETWORK as default.", + "type": "string", + "enumDescriptions": [ + "Bidirectional private IPv6 access to/from Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before.", + "Outbound private IPv6 access from VMs in this subnet to Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before.", + "Each network interface inherits PrivateIpv6GoogleAccess from its subnetwork." ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", + "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE", + "INHERIT_FROM_SUBNETWORK" + ] + }, + "advancedMachineFeatures": { + "description": "Controls for advanced machine-related behavior features.", + "$ref": "AdvancedMachineFeatures" + }, + "lastStartTimestamp": { + "description": "[Output Only] Last start timestamp in RFC3339 text format.", + "type": "string" + }, + "lastStopTimestamp": { + "description": "[Output Only] Last stop timestamp in RFC3339 text format.", + "type": "string" + }, + "lastSuspendedTimestamp": { + "description": "[Output Only] Last suspended timestamp in RFC3339 text format.", + "type": "string" + }, + "satisfiesPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "satisfiesPzi": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "resourceStatus": { + "description": "[Output Only] Specifies values set for instance attributes as compared to the values requested by user in the corresponding input only field.", + "$ref": "ResourceStatus" + }, + "networkPerformanceConfig": { + "$ref": "NetworkPerformanceConfig" + }, + "keyRevocationActionType": { + "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and \"NONE\". The default value is \"NONE\" if it is not specified.", + "type": "string", + "enumDescriptions": [ + "Default value. This value is unused.", + "Indicates user chose no operation.", + "Indicates user chose to opt for VM shutdown on key revocation." ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", + "NONE", + "STOP" + ] } } }, - "securityPolicies": { - "methods": { - "list": { - "id": "compute.securityPolicies.list", - "path": "projects/{project}/global/securityPolicies", - "flatPath": "projects/{project}/global/securityPolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "SecurityPolicyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "List all the policies that have been configured for the specified project." + "Tags": { + "id": "Tags", + "description": "A set of instance tags.", + "type": "object", + "properties": { + "items": { + "description": "An array of tags. Each tag must be 1-63 characters long, and comply with RFC1035.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "array", + "items": { + "type": "string" + } }, - "get": { - "id": "compute.securityPolicies.get", - "path": "projects/{project}/global/securityPolicies/{securityPolicy}", - "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to get.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "securityPolicy" + "fingerprint": { + "description": "Specifies a fingerprint for this request, which is essentially a hash of the tags' contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update tags. You must always provide an up-to-date fingerprint hash in order to update or change tags. To see the latest fingerprint, make get() request to the instance.", + "type": "string", + "format": "byte" + } + } + }, + "NetworkInterface": { + "id": "NetworkInterface", + "description": "A network interface resource attached to an instance.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#networkInterface for network interfaces.", + "default": "compute#networkInterface", + "type": "string" + }, + "network": { + "description": "URL of the VPC network resource for this instance. When creating an instance, if neither the network nor the subnetwork is specified, the default network global/networks/default is used. If the selected project doesn't have the default network, you must specify a network or subnet. If the network is not specified but the subnetwork is specified, the network is inferred. If you specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/global/networks/ network - projects/project/global/networks/network - global/networks/default ", + "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: - https://www.googleapis.com/compute/v1/projects/project/regions/region /subnetworks/subnetwork - regions/region/subnetworks/subnetwork ", + "type": "string" + }, + "networkIP": { + "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" + }, + "ipv6Address": { + "description": "An IPv6 internal network address for this network interface. To use a static internal IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an internal IPv6 address from the instance's subnetwork.", + "type": "string" + }, + "internalIpv6PrefixLength": { + "description": "The prefix length of the primary internal IPv6 range.", + "type": "integer", + "format": "int32" + }, + "name": { + "description": "[Output Only] The name of the network interface, which is generated by the server. For a VM, the network interface uses the nicN naming format. Where N is a value between 0 and 7. The default interface value is nic0.", + "type": "string" + }, + "accessConfigs": { + "description": "An array of configurations for this interface. Currently, only one access config, ONE_TO_ONE_NAT, is supported. If there are no accessConfigs specified, then this instance will have no external internet access.", + "type": "array", + "items": { + "$ref": "AccessConfig" + } + }, + "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.", + "type": "array", + "items": { + "$ref": "AccessConfig" + } + }, + "aliasIpRanges": { + "description": "An array of alias IP ranges for this network interface. You can only specify this field for network interfaces in VPC networks.", + "type": "array", + "items": { + "$ref": "AliasIpRange" + } + }, + "fingerprint": { + "description": "Fingerprint hash of contents stored in this network interface. This field will be ignored when inserting an Instance or adding a NetworkInterface. An up-to-date fingerprint must be provided in order to update the NetworkInterface. The request will fail with error 400 Bad Request if the fingerprint is not provided, or 412 Precondition Failed if the fingerprint is out of date.", + "type": "string", + "format": "byte" + }, + "stackType": { + "description": "The stack type for this network interface. To assign only IPv4 addresses, use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, use IPV4_IPV6. If not specified, IPV4_ONLY is used. This field can be both set at instance creation and update network interface operations.", + "type": "string", + "enumDescriptions": [ + "The network interface can have both IPv4 and IPv6 addresses.", + "The network interface will only be assigned IPv4 addresses.", + "The network interface will only be assigned IPv6 addresses." ], - "response": { - "$ref": "SecurityPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY", + "IPV6_ONLY" + ] + }, + "ipv6AccessType": { + "description": "[Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be accessed from the Internet. This field is always inherited from its subnetwork. Valid only if stackType is IPV4_IPV6.", + "type": "string", + "enumDescriptions": [ + "This network interface can have external IPv6.", + "This network interface can have internal IPv6." ], - "description": "List all of the ordered rules present in a single specified policy." + "enum": [ + "EXTERNAL", + "INTERNAL" + ] }, - "insert": { - "id": "compute.securityPolicies.insert", - "path": "projects/{project}/global/securityPolicies", - "flatPath": "projects/{project}/global/securityPolicies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "validateOnly": { - "description": "If true, the request will not be committed.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" + "queueCount": { + "description": "The networking queue count that's specified by users for the network interface. Both Rx and Tx queues will be set to this number. It'll be empty if not specified by the users.", + "type": "integer", + "format": "int32" + }, + "nicType": { + "description": "The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.", + "type": "string", + "enumDescriptions": [ + "GVNIC", + "IDPF", + "No type specified.", + "VIRTIO" ], - "request": { - "$ref": "SecurityPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "GVNIC", + "IDPF", + "UNSPECIFIED_NIC_TYPE", + "VIRTIO_NET" + ] + }, + "networkAttachment": { + "description": "The URL of the network attachment that this interface should connect to in the following format: projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.", + "type": "string" + } + } + }, + "AccessConfig": { + "id": "AccessConfig", + "description": "An access configuration attached to an instance's network interface. Only one access config per instance is supported.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#accessConfig for access configs.", + "default": "compute#accessConfig", + "type": "string" + }, + "type": { + "description": "The type of configuration. In accessConfigs (IPv4), the default and only option is ONE_TO_ONE_NAT. In ipv6AccessConfigs, the default and only option is DIRECT_IPV6.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Creates a new policy in the specified project using the data included in the request." + "enum": [ + "DIRECT_IPV6", + "ONE_TO_ONE_NAT" + ] }, - "delete": { - "id": "compute.securityPolicies.delete", - "path": "projects/{project}/global/securityPolicies/{securityPolicy}", - "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "securityPolicy" + "name": { + "description": "The name of this access configuration. In accessConfigs (IPv4), the default and recommended name is External NAT, but you can use any arbitrary string, such as My external IP or Network Access. In ipv6AccessConfigs, the recommend name is External IPv6.", + "type": "string" + }, + "natIP": { + "description": "Applies to accessConfigs (IPv4) only. An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.", + "type": "string" + }, + "externalIpv6": { + "description": "Applies to ipv6AccessConfigs only. The first IPv6 address of the external IPv6 range associated with this instance, prefix length is stored in externalIpv6PrefixLength in ipv6AccessConfig. To use a static external IP address, it must be unused and in the same region as the instance's zone. If not specified, Google Cloud will automatically assign an external IPv6 address from the instance's subnetwork.", + "type": "string" + }, + "externalIpv6PrefixLength": { + "description": "Applies to ipv6AccessConfigs only. The prefix length of the external IPv6 range.", + "type": "integer", + "format": "int32" + }, + "setPublicPtr": { + "description": "Specifies whether a public DNS 'PTR' record should be created to map the external IP address of the instance to a DNS domain name. This field is not used in ipv6AccessConfig. A default PTR record will be created if the VM has external IPv6 range associated.", + "type": "boolean" + }, + "publicPtrDomainName": { + "description": "The DNS domain name for the public PTR record. You can set this field only if the `setPublicPtr` field is enabled in accessConfig. If this field is unspecified in ipv6AccessConfig, a default PTR record will be created for first IP in associated external IPv6 range.", + "type": "string" + }, + "networkTier": { + "description": "This signifies the networking tier used for configuring this access configuration and can only take the following values: PREMIUM, STANDARD. If an AccessConfig is specified without a valid external IP address, an ephemeral IP will be created with this networkTier. If an AccessConfig with a valid external IP address is specified, it must match that of the networkTier associated with the Address resource owning that IP.", + "type": "string", + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking products.", + "Public internet quality, only limited support for other networking products.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" + ] + }, + "securityPolicy": { + "description": "[Output Only] The resource URL for the security policy associated with this access config.", + "type": "string" + } + } + }, + "AliasIpRange": { + "id": "AliasIpRange", + "description": "An alias IP range attached to an instance's network interface.", + "type": "object", + "properties": { + "ipCidrRange": { + "description": "The IP alias ranges to allocate for this interface. This IP CIDR range must belong to the specified subnetwork and cannot contain IP addresses reserved by system or used by other network interfaces. This range may be a single IP address (such as 10.2.3.4), a netmask (such as /24) or a CIDR-formatted string (such as 10.1.2.0/24).", + "type": "string" + }, + "subnetworkRangeName": { + "description": "The name of a subnetwork secondary IP range from which to allocate an IP alias range. If not specified, the primary range of the subnetwork is used.", + "type": "string" + } + } + }, + "AttachedDisk": { + "id": "AttachedDisk", + "description": "An instance-attached disk resource.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#attachedDisk for attached disks.", + "default": "compute#attachedDisk", + "type": "string" + }, + "type": { + "description": "Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Deletes the specified policy." + "enum": [ + "PERSISTENT", + "SCRATCH" + ] }, - "patch": { - "id": "compute.securityPolicies.patch", - "path": "projects/{project}/global/securityPolicies/{securityPolicy}", - "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "Indicates fields to be cleared as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - } - }, - "parameterOrder": [ - "project", - "securityPolicy" + "mode": { + "description": "The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.", + "type": "string", + "enumDescriptions": [ + "Attaches this disk in read-only mode. Multiple virtual machines can use a disk in read-only mode at a time.", + "*[Default]* Attaches this disk in read-write mode. Only one virtual machine at a time can be attached to a disk in read-write mode." ], - "request": { - "$ref": "SecurityPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "READ_ONLY", + "READ_WRITE" + ] + }, + "savedState": { + "description": "For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this field is set to PRESERVED if the LocalSSD data has been saved to a persistent location by customer request. (see the discard_local_ssd option on Stop/Suspend). Read-only in the api.", + "type": "string", + "enumDescriptions": [ + "*[Default]* Disk state has not been preserved.", + "Disk state has been preserved." ], - "description": "Patches the specified policy with the data included in the request. To clear fields in the policy, leave the fields empty and specify them in the updateMask. This cannot be used to be update the rules in the policy. Please use the per rule methods like addRule, patchRule, and removeRule instead." + "enum": [ + "DISK_SAVED_STATE_UNSPECIFIED", + "PRESERVED" + ] }, - "getRule": { - "id": "compute.securityPolicies.getRule", - "path": "projects/{project}/global/securityPolicies/{securityPolicy}/getRule", - "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/getRule", - "httpMethod": "GET", - "parameters": { - "priority": { - "description": "The priority of the rule to get from the security policy.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to which the queried rule belongs.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "securityPolicy" + "source": { + "description": "Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks. Note that for InstanceTemplate, specify the disk name for zonal disk, and the URL for regional disk.", + "type": "string" + }, + "deviceName": { + "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. If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks.", + "type": "string" + }, + "index": { + "description": "[Output Only] A zero-based index to this disk, where 0 is reserved for the boot disk. If you have many disks attached to an instance, each disk would have a unique index number.", + "type": "integer", + "format": "int32" + }, + "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" + }, + "initializeParams": { + "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. This property is mutually exclusive with the source property; you can only define one or the other, but not both.", + "$ref": "AttachedDiskInitializeParams" + }, + "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" + }, + "licenses": { + "description": "[Output Only] Any valid publicly visible licenses.", + "type": "array", + "items": { + "type": "string" + } + }, + "interface": { + "description": "Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. For most machine types, the default is SCSI. Local SSDs can use either NVME or SCSI. In certain configurations, persistent disks can use NVMe. For more information, see About persistent disks.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "response": { - "$ref": "SecurityPolicyRule" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "NVME", + "SCSI" + ] + }, + "guestOsFeatures": { + "description": "A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options.", + "type": "array", + "items": { + "$ref": "GuestOsFeature" + } + }, + "diskEncryptionKey": { + "description": "Encrypts or decrypts a disk using a customer-supplied encryption key. If you are creating a new disk, this field encrypts the new disk using an encryption key that you provide. If you are attaching an existing disk that is already encrypted, this field decrypts the disk using the customer-supplied encryption key. If you encrypt a disk using a customer-supplied key, you must provide the same key again when you attempt to use this resource at a later time. For example, you must provide the key when you create a snapshot or an image from the disk or when you attach the disk to a virtual machine instance. If you do not provide an encryption key, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the disk later. Note: Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt disks in a managed instance group. You cannot create VMs that have disks with customer-supplied keys using the bulk insert method.", + "$ref": "CustomerEncryptionKey" + }, + "diskSizeGb": { + "description": "The size of the disk in GB.", + "type": "string", + "format": "int64" + }, + "shieldedInstanceInitialState": { + "description": "[Output Only] shielded vm initial state stored on disk", + "$ref": "InitialStateConfig" + }, + "forceAttach": { + "description": "[Input Only] Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error.", + "type": "boolean" + }, + "architecture": { + "description": "[Output Only] The architecture of the attached disk. Valid values are ARM64 or X86_64.", + "type": "string", + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "description": "Gets a rule at the specified priority." + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" + ] + } + } + }, + "AttachedDiskInitializeParams": { + "id": "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. This field is persisted and returned for instanceTemplate and not returned in the context of instance. This property is mutually exclusive with the source property; you can only define one or the other, but not both.", + "type": "object", + "properties": { + "diskName": { + "description": "Specifies the disk name. If not specified, the default is to use the name of the instance. If a disk with the same name already exists in the given region, the existing disk is attached to the new instance and the new disk is not created.", + "type": "string" }, - "addRule": { - "id": "compute.securityPolicies.addRule", - "path": "projects/{project}/global/securityPolicies/{securityPolicy}/addRule", - "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/addRule", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "validateOnly": { - "description": "If true, the request will not be committed.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "securityPolicy" + "sourceImage": { + "description": "The source image to create this disk. When creating a new instance boot disk, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required. To create a disk with one of the public operating system images, specify the image by its family name. For example, specify family/debian-9 to use the latest Debian 9 image: projects/debian-cloud/global/images/family/debian-9 Alternatively, use a specific version of a public operating system image: projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a disk with a custom image that you created, specify the image name in the following format: global/images/my-custom-image You can also specify a custom image by its image family, which returns the latest version of the image in that family. Replace the image name with family/family-name: global/images/family/my-image-family If the source image is deleted later, this field will not be set.", + "type": "string" + }, + "diskSizeGb": { + "description": "Specifies the size of the disk in base-2 GB. The size must be at least 10 GB. If you specify a sourceImage, which is required for boot disks, the default size is the size of the sourceImage. If you do not specify a sourceImage, the default disk size is 500 GB.", + "type": "string", + "format": "int64" + }, + "diskType": { + "description": "Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/pd-standard For a full list of acceptable values, see Persistent disk types. If you specify this field when creating a VM, you can provide either the full or partial URL. For example, the following values are valid: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /diskTypes/diskType - projects/project/zones/zone/diskTypes/diskType - zones/zone/diskTypes/diskType If you specify this field when creating or updating an instance template or all-instances configuration, specify the type of the disk, not the URL. For example: pd-standard.", + "type": "string" + }, + "sourceImageEncryptionKey": { + "description": "The customer-supplied encryption key of the source image. Required if the source image is protected by a customer-supplied encryption key. InstanceTemplate and InstancePropertiesPatch do not store customer-supplied encryption keys, so you cannot create disks for instances in a managed instance group if the source images are encrypted with your own keys.", + "$ref": "CustomerEncryptionKey" + }, + "labels": { + "description": "Labels to apply to this disk. These can be later modified by the disks.setLabels method. This field is only applicable for persistent disks.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "sourceSnapshot": { + "description": "The source snapshot to create this disk. When creating a new instance boot disk, one of initializeParams.sourceSnapshot or initializeParams.sourceImage or disks.source is required. To create a disk with a snapshot that you created, specify the snapshot name in the following format: global/snapshots/my-backup If the source snapshot is deleted later, this field will not be set.", + "type": "string" + }, + "sourceSnapshotEncryptionKey": { + "description": "The customer-supplied encryption key of the source snapshot.", + "$ref": "CustomerEncryptionKey" + }, + "description": { + "description": "An optional description. Provide this property when creating the disk.", + "type": "string" + }, + "replicaZones": { + "description": "Required for each regional disk associated with the instance. Specify the URLs of the zones where the disk should be replicated to. You must provide exactly two replica zones, and one zone must be the same as the instance zone.", + "type": "array", + "items": { + "type": "string" + } + }, + "resourcePolicies": { + "description": "Resource policies applied to this disk for automatic snapshot creations. Specified using the full or partial URL. For instance template, specify only the resource policy name.", + "type": "array", + "items": { + "type": "string" + } + }, + "onUpdateAction": { + "description": "Specifies which action to take on instance update with this disk. Default is to use the existing disk.", + "type": "string", + "enumDescriptions": [ + "Always recreate the disk.", + "Recreate the disk if source (image, snapshot) of this disk is different from source of existing disk.", + "Use the existing disk, this is the default behaviour." ], - "request": { - "$ref": "SecurityPolicyRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "RECREATE_DISK", + "RECREATE_DISK_IF_SOURCE_CHANGED", + "USE_EXISTING_DISK" + ] + }, + "provisionedIops": { + "description": "Indicates how many IOPS to provision for the disk. This sets the number of I/O operations per second that the disk can handle. Values must be between 10,000 and 120,000. For more details, see the Extreme persistent disk documentation.", + "type": "string", + "format": "int64" + }, + "licenses": { + "description": "A list of publicly visible licenses. Reserved for Google's use.", + "type": "array", + "items": { + "type": "string" + } + }, + "architecture": { + "description": "The architecture of the attached disk. Valid values are arm64 or x86_64.", + "type": "string", + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "description": "Inserts a rule into a security policy." + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" + ] + }, + "resourceManagerTags": { + "description": "Resource manager tags to be bound to the disk. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "provisionedThroughput": { + "description": "Indicates how much throughput to provision for the disk. This sets the number of throughput mb per second that the disk can handle. Values must greater than or equal to 1.", + "type": "string", + "format": "int64" + }, + "enableConfidentialCompute": { + "description": "Whether this disk is using confidential compute mode.", + "type": "boolean" + }, + "storagePool": { + "description": "The storage pool in which the new disk is created. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /storagePools/storagePool - projects/project/zones/zone/storagePools/storagePool - zones/zone/storagePools/storagePool ", + "type": "string" + } + } + }, + "Metadata": { + "id": "Metadata", + "description": "A metadata key/value entry.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#metadata for metadata.", + "default": "compute#metadata", + "type": "string" }, - "removeRule": { - "id": "compute.securityPolicies.removeRule", - "path": "projects/{project}/global/securityPolicies/{securityPolicy}/removeRule", - "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/removeRule", - "httpMethod": "POST", - "parameters": { - "priority": { - "description": "The priority of the rule to remove from the security policy.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "fingerprint": { + "description": "Specifies a fingerprint for this request, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource.", + "type": "string", + "format": "byte" + }, + "items": { + "description": "Array of key/value pairs. The total size of all keys and values must be less than 512 KB.", + "type": "array", + "items": { + "description": "Metadata", + "type": "object", + "properties": { + "key": { + "description": "Key for the metadata entry. Keys must conform to the following regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is reflected as part of a URL in the metadata server. Additionally, to avoid ambiguity, keys must not conflict with any other metadata keys for the project.", + "pattern": "[a-zA-Z0-9-_]{1,128}", + "annotations": { + "required": [ + "compute.instances.insert", + "compute.projects.setCommonInstanceMetadata" + ] + }, + "type": "string" + }, + "value": { + "description": "Value for the metadata entry. These are free-form strings, and only have meaning as interpreted by the image running in the instance. The only restriction placed on values is that their size must be less than or equal to 262144 bytes (256 KiB).", + "annotations": { + "required": [ + "compute.instances.insert", + "compute.projects.setCommonInstanceMetadata" + ] + }, + "type": "string" + } } - }, - "parameterOrder": [ - "project", - "securityPolicy" + } + } + } + }, + "ServiceAccount": { + "id": "ServiceAccount", + "description": "A service account.", + "type": "object", + "properties": { + "email": { + "description": "Email address of the service account.", + "type": "string" + }, + "scopes": { + "description": "The list of scopes to be made available for this service account.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "Scheduling": { + "id": "Scheduling", + "description": "Sets the scheduling options for an Instance.", + "type": "object", + "properties": { + "onHostMaintenance": { + "description": "Defines the maintenance behavior for this instance. For standard instances, the default behavior is MIGRATE. For preemptible instances, the default and only possible behavior is TERMINATE. For more information, see Set VM host maintenance policy.", + "type": "string", + "enumDescriptions": [ + "*[Default]* Allows Compute Engine to automatically migrate instances out of the way of maintenance events.", + "Tells Compute Engine to terminate and (optionally) restart the instance away from the maintenance activity. If you would like your instance to be restarted, set the automaticRestart flag to true. Your instance may be restarted more than once, and it may be restarted outside the window of maintenance events." ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "MIGRATE", + "TERMINATE" + ] + }, + "automaticRestart": { + "description": "Specifies whether the instance should be automatically restarted if it is terminated by Compute Engine (not terminated by a user). You can only set the automatic restart option for standard instances. Preemptible instances cannot be automatically restarted. By default, this is set to true so an instance is automatically restarted if it is terminated by Compute Engine.", + "type": "boolean" + }, + "preemptible": { + "description": "Defines whether the instance is preemptible. This can only be set during instance creation or while the instance is stopped and therefore, in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states.", + "type": "boolean" + }, + "nodeAffinities": { + "description": "A set of node affinity and anti-affinity configurations. Refer to Configuring node affinity for more information. Overrides reservationAffinity.", + "type": "array", + "items": { + "$ref": "SchedulingNodeAffinity" + } + }, + "minNodeCpus": { + "description": "The minimum number of virtual CPUs this instance will consume when running on a sole-tenant node.", + "type": "integer", + "format": "int32" + }, + "locationHint": { + "description": "An opaque location hint used to place the instance close to other resources. This field is for use by internal tools that use the public API.", + "type": "string" + }, + "availabilityDomain": { + "description": "Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance.", + "type": "integer", + "format": "int32" + }, + "provisioningModel": { + "description": "Specifies the provisioning model of the instance.", + "type": "string", + "enumDescriptions": [ + "Heavily discounted, no guaranteed runtime.", + "Standard provisioning with user controlled runtime, no discounts." ], - "description": "Deletes a rule at the specified priority." + "enum": [ + "SPOT", + "STANDARD" + ] }, - "patchRule": { - "id": "compute.securityPolicies.patchRule", - "path": "projects/{project}/global/securityPolicies/{securityPolicy}/patchRule", - "flatPath": "projects/{project}/global/securityPolicies/{securityPolicy}/patchRule", - "httpMethod": "POST", - "parameters": { - "priority": { - "description": "The priority of the rule to patch.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "Indicates fields to be cleared as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - }, - "validateOnly": { - "description": "If true, the request will not be committed.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "securityPolicy" + "instanceTerminationAction": { + "description": "Specifies the termination action for the instance.", + "type": "string", + "enumDescriptions": [ + "Delete the VM.", + "Default value. This value is unused.", + "Stop the VM without storing in-memory content. default action." ], - "request": { - "$ref": "SecurityPolicyRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "DELETE", + "INSTANCE_TERMINATION_ACTION_UNSPECIFIED", + "STOP" + ] + }, + "maxRunDuration": { + "description": "Specifies the max run duration for the given instance. If specified, the instance termination action will be performed at the end of the run duration.", + "$ref": "Duration" + }, + "terminationTime": { + "description": "Specifies the timestamp, when the instance will be terminated, in RFC3339 text format. If specified, the instance termination action will be performed at the termination time.", + "type": "string" + }, + "onInstanceStopAction": { + "$ref": "SchedulingOnInstanceStopAction" + }, + "localSsdRecoveryTimeout": { + "description": "Specifies the maximum amount of time a Local Ssd Vm should wait while recovery of the Local Ssd state is attempted. Its value should be in between 0 and 168 hours with hour granularity and the default value being 1 hour.", + "$ref": "Duration" + } + } + }, + "SchedulingNodeAffinity": { + "id": "SchedulingNodeAffinity", + "description": "Node Affinity: the configuration of desired nodes onto which this Instance could be scheduled.", + "type": "object", + "properties": { + "key": { + "description": "Corresponds to the label key of Node resource.", + "type": "string" + }, + "operator": { + "description": "Defines the operation of node selection. Valid operators are IN for affinity and NOT_IN for anti-affinity.", + "type": "string", + "enumDescriptions": [ + "Requires Compute Engine to seek for matched nodes.", + "Requires Compute Engine to avoid certain nodes.", + "" ], - "description": "Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty and specify them in the updateMask." + "enum": [ + "IN", + "NOT_IN", + "OPERATOR_UNSPECIFIED" + ] }, - "listPreconfiguredExpressionSets": { - "id": "compute.securityPolicies.listPreconfiguredExpressionSets", - "path": "projects/{project}/global/securityPolicies/listPreconfiguredExpressionSets", - "flatPath": "projects/{project}/global/securityPolicies/listPreconfiguredExpressionSets", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" + "values": { + "description": "Corresponds to the label values of Node resource.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "Duration": { + "id": "Duration", + "description": "A Duration represents a fixed-length span of time represented as a count of seconds and fractions of seconds at nanosecond resolution. It is independent of any calendar and concepts like \"day\" or \"month\". Range is approximately 10,000 years.", + "type": "object", + "properties": { + "seconds": { + "description": "Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years", + "type": "string", + "format": "int64" + }, + "nanos": { + "description": "Span of time that's a fraction of a second at nanosecond resolution. Durations less than one second are represented with a 0 `seconds` field and a positive `nanos` field. Must be from 0 to 999,999,999 inclusive.", + "type": "integer", + "format": "int32" + } + } + }, + "SchedulingOnInstanceStopAction": { + "id": "SchedulingOnInstanceStopAction", + "description": "Defines the behaviour for instances with the instance_termination_action STOP.", + "type": "object", + "properties": { + "discardLocalSsd": { + "description": "If true, the contents of any attached Local SSD disks will be discarded else, the Local SSD data will be preserved when the instance is stopped at the end of the run duration/termination time.", + "type": "boolean" + } + } + }, + "InstanceParams": { + "id": "InstanceParams", + "description": "Additional instance params.", + "type": "object", + "properties": { + "resourceManagerTags": { + "description": "Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } + }, + "AcceleratorConfig": { + "id": "AcceleratorConfig", + "description": "A specification of the type and number of accelerator cards attached to the instance.", + "type": "object", + "properties": { + "acceleratorType": { + "description": "Full or partial URL of the accelerator type resource to attach to this instance. For example: projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100 If you are creating an instance template, specify only the accelerator name. See GPUs on Compute Engine for a full list of accelerator types.", + "type": "string" + }, + "acceleratorCount": { + "description": "The number of the guest accelerator cards exposed to this instance.", + "type": "integer", + "format": "int32" + } + } + }, + "ReservationAffinity": { + "id": "ReservationAffinity", + "description": "Specifies the reservations that this instance can consume from.", + "type": "object", + "properties": { + "consumeReservationType": { + "description": "Specifies the type of reservation from which this instance can consume resources: ANY_RESERVATION (default), SPECIFIC_RESERVATION, or NO_RESERVATION. See Consuming reserved instances for examples.", + "type": "string", + "enumDescriptions": [ + "Consume any allocation available.", + "Do not consume from any allocated capacity.", + "Must consume from a specific reservation. Must specify key value fields for specifying the reservations.", + "" ], - "response": { - "$ref": "SecurityPoliciesListPreconfiguredExpressionSetsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "ANY_RESERVATION", + "NO_RESERVATION", + "SPECIFIC_RESERVATION", + "UNSPECIFIED" + ] + }, + "key": { + "description": "Corresponds to the label key of a reservation resource. To target a SPECIFIC_RESERVATION by name, specify googleapis.com/reservation-name as the key and specify the name of your reservation as its value.", + "type": "string" + }, + "values": { + "description": "Corresponds to the label values of a reservation resource. This can be either a name to a reservation in the same project or \"projects/different-project/reservations/some-reservation-name\" to target a shared reservation in the same zone but in a different project.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "DisplayDevice": { + "id": "DisplayDevice", + "description": "A set of Display Device options", + "type": "object", + "properties": { + "enableDisplay": { + "description": "Defines whether the instance has Display enabled.", + "type": "boolean" + } + } + }, + "ShieldedInstanceConfig": { + "id": "ShieldedInstanceConfig", + "description": "A set of Shielded Instance options.", + "type": "object", + "properties": { + "enableSecureBoot": { + "description": "Defines whether the instance has Secure Boot enabled. Disabled by default.", + "type": "boolean" + }, + "enableVtpm": { + "description": "Defines whether the instance has the vTPM enabled. Enabled by default.", + "type": "boolean" + }, + "enableIntegrityMonitoring": { + "description": "Defines whether the instance has integrity monitoring enabled. Enabled by default.", + "type": "boolean" + } + } + }, + "ShieldedInstanceIntegrityPolicy": { + "id": "ShieldedInstanceIntegrityPolicy", + "description": "The policy describes the baseline against which Instance boot integrity is measured.", + "type": "object", + "properties": { + "updateAutoLearnPolicy": { + "description": "Updates the integrity policy baseline using the measurements from the VM instance's most recent boot.", + "type": "boolean" + } + } + }, + "ConfidentialInstanceConfig": { + "id": "ConfidentialInstanceConfig", + "description": "A set of Confidential Instance options.", + "type": "object", + "properties": { + "enableConfidentialCompute": { + "description": "Defines whether the instance should have confidential compute enabled.", + "type": "boolean" + }, + "confidentialInstanceType": { + "description": "Defines the type of technology used by the confidential instance.", + "type": "string", + "enumDescriptions": [ + "No type specified. Do not use this value.", + "AMD Secure Encrypted Virtualization.", + "AMD Secure Encrypted Virtualization - Secure Nested Paging.", + "Intel Trust Domain eXtension." ], - "description": "Gets the current list of preconfigured Web Application Firewall (WAF) expressions." + "enum": [ + "CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED", + "SEV", + "SEV_SNP", + "TDX" + ] + } + } + }, + "AdvancedMachineFeatures": { + "id": "AdvancedMachineFeatures", + "description": "Specifies options for controlling advanced machine features. Options that would traditionally be configured in a BIOS belong here. Features that require operating system support may have corresponding entries in the GuestOsFeatures of an Image (e.g., whether or not the OS in the Image supports nested virtualization being enabled or disabled).", + "type": "object", + "properties": { + "enableNestedVirtualization": { + "description": "Whether to enable nested virtualization or not (default is false).", + "type": "boolean" }, - "setLabels": { - "id": "compute.securityPolicies.setLabels", - "path": "projects/{project}/global/securityPolicies/{resource}/setLabels", - "flatPath": "projects/{project}/global/securityPolicies/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" + "threadsPerCore": { + "description": "The number of threads per physical core. To disable simultaneous multithreading (SMT) set this to 1. If unset, the maximum number of threads supported per core by the underlying processor is assumed.", + "type": "integer", + "format": "int32" + }, + "visibleCoreCount": { + "description": "The number of physical cores to expose to an instance. Multiply by the number of threads per core to compute the total number of virtual CPUs to expose to the instance. If unset, the number of cores is inferred from the instance's nominal CPU count and the underlying platform's SMT width.", + "type": "integer", + "format": "int32" + }, + "enableUefiNetworking": { + "description": "Whether to enable UEFI networking for instance creation.", + "type": "boolean" + }, + "performanceMonitoringUnit": { + "description": "Type of Performance Monitoring Unit requested on instance.", + "type": "string", + "enumDescriptions": [ + "Architecturally defined non-LLC events.", + "Most documented core/L2 and LLC events.", + "", + "Most documented core/L2 events." ], - "request": { - "$ref": "GlobalSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ARCHITECTURAL", + "ENHANCED", + "PERFORMANCE_MONITORING_UNIT_UNSPECIFIED", + "STANDARD" + ] + }, + "turboMode": { + "description": "Turbo frequency mode to use for the instance. Supported modes include: * ALL_CORE_MAX Using empty string or not setting this field will use the platform-specific default turbo mode.", + "type": "string" + } + } + }, + "ResourceStatus": { + "id": "ResourceStatus", + "description": "Contains output only fields. Use this sub-message for actual values set on Instance attributes as compared to the value requested by the user (intent) in their instance CRUD calls.", + "type": "object", + "properties": { + "scheduling": { + "$ref": "ResourceStatusScheduling" + }, + "upcomingMaintenance": { + "$ref": "UpcomingMaintenance" + }, + "physicalHost": { + "description": "[Output Only] An opaque ID of the host on which the VM is running.", + "type": "string" + } + } + }, + "ResourceStatusScheduling": { + "id": "ResourceStatusScheduling", + "type": "object", + "properties": { + "availabilityDomain": { + "description": "Specifies the availability domain to place the instance in. The value must be a number between 1 and the number of availability domains specified in the spread placement policy attached to the instance.", + "type": "integer", + "format": "int32" + } + } + }, + "UpcomingMaintenance": { + "id": "UpcomingMaintenance", + "description": "Upcoming Maintenance notification information.", + "type": "object", + "properties": { + "type": { + "description": "Defines the type of maintenance.", + "type": "string", + "enumDescriptions": [ + "Scheduled maintenance (e.g. maintenance after uptime guarantee is complete).", + "No type specified. Do not use this value.", + "Unscheduled maintenance (e.g. emergency maintenance during uptime guarantee)." ], - "description": "Sets the labels on a security policy. To learn more about labels, read the Labeling Resources documentation." + "enum": [ + "SCHEDULED", + "UNKNOWN_TYPE", + "UNSCHEDULED" + ] }, - "aggregatedList": { - "id": "compute.securityPolicies.aggregatedList", - "path": "projects/{project}/aggregated/securityPolicies", - "flatPath": "projects/{project}/aggregated/securityPolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" + "canReschedule": { + "description": "Indicates if the maintenance can be customer triggered.", + "type": "boolean" + }, + "windowStartTime": { + "description": "The current start time of the maintenance window. This timestamp value is in RFC3339 text format.", + "type": "string" + }, + "windowEndTime": { + "description": "The time by which the maintenance disruption will be completed. This timestamp value is in RFC3339 text format.", + "type": "string" + }, + "latestWindowStartTime": { + "description": "The latest time for the planned maintenance window to start. This timestamp value is in RFC3339 text format.", + "type": "string" + }, + "maintenanceStatus": { + "type": "string", + "enumDescriptions": [ + "There is ongoing maintenance on this VM.", + "There is pending maintenance.", + "Unknown maintenance status. Do not use this value." ], - "response": { - "$ref": "SecurityPoliciesAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "ONGOING", + "PENDING", + "UNKNOWN" + ] + } + } + }, + "NetworkPerformanceConfig": { + "id": "NetworkPerformanceConfig", + "type": "object", + "properties": { + "totalEgressBandwidthTier": { + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves the list of all SecurityPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "DEFAULT", + "TIER_1" + ] } } }, - "regionSecurityPolicies": { - "methods": { - "list": { - "id": "compute.regionSecurityPolicies.list", - "path": "projects/{project}/regions/{region}/securityPolicies", - "flatPath": "projects/{project}/regions/{region}/securityPolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "InstanceAggregatedList": { + "id": "InstanceAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#instanceAggregatedList for aggregated lists of Instance resources.", + "default": "compute#instanceAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "An object that contains a list of instances scoped by zone.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of instances.", + "$ref": "InstancesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "SecurityPolicyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "List all the policies that have been configured for the specified project and region." + } }, - "get": { - "id": "compute.regionSecurityPolicies.get", - "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", - "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "InstancesScopedList": { + "id": "InstancesScopedList", + "type": "object", + "properties": { + "instances": { + "description": "[Output Only] A list of instances contained in this scope.", + "type": "array", + "items": { + "$ref": "Instance" + } + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of instances when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "securityPolicy": { - "description": "Name of the security policy to get.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" - ], - "response": { - "$ref": "SecurityPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "List all of the ordered rules present in a single specified policy." + } + } + } + }, + "InstanceListReferrers": { + "id": "InstanceListReferrers", + "description": "Contains a list of instance referrers.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#instanceListReferrers for lists of Instance referrers.", + "default": "compute#instanceListReferrers", + "type": "string" }, - "insert": { - "id": "compute.regionSecurityPolicies.insert", - "path": "projects/{project}/regions/{region}/securityPolicies", - "flatPath": "projects/{project}/regions/{region}/securityPolicies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "validateOnly": { - "description": "If true, the request will not be committed.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "SecurityPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a new policy in the specified project using the data included in the request." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "delete": { - "id": "compute.regionSecurityPolicies.delete", - "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", - "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of Reference resources.", + "type": "array", + "items": { + "$ref": "Reference" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "securityPolicy": { - "description": "Name of the security policy to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified policy." + } + } + } + }, + "Reference": { + "id": "Reference", + "description": "Represents a reference to a resource.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#reference for references.", + "default": "compute#reference", + "type": "string" + }, + "target": { + "description": "URL of the resource to which this reference points.", + "type": "string" + }, + "referenceType": { + "description": "A description of the reference type with no implied semantics. Possible values include: 1. MEMBER_OF ", + "type": "string" + }, + "referrer": { + "description": "URL of the resource which refers to the target.", + "type": "string" + } + } + }, + "SerialPortOutput": { + "id": "SerialPortOutput", + "description": "An instance serial console output.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#serialPortOutput for serial port output.", + "default": "compute#serialPortOutput", + "type": "string" + }, + "contents": { + "description": "[Output Only] The contents of the console output.", + "type": "string" + }, + "start": { + "description": "The starting byte position of the output that was returned. This should match the start parameter sent with the request. If the serial console output exceeds the size of the buffer (1 MB), older output is overwritten by newer content. The output start value will indicate the byte position of the output that was returned, which might be different than the `start` value that was specified in the request.", + "type": "string", + "format": "int64" + }, + "next": { + "description": "[Output Only] The position of the next byte of content, regardless of whether the content exists, following the output returned in the `contents` property. Use this value in the next request as the start parameter.", + "type": "string", + "format": "int64" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + } + } + }, + "Screenshot": { + "id": "Screenshot", + "description": "An instance's screenshot.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#screenshot for the screenshots.", + "default": "compute#screenshot", + "type": "string" + }, + "contents": { + "description": "[Output Only] The Base64-encoded screenshot data.", + "type": "string" + } + } + }, + "GuestAttributes": { + "id": "GuestAttributes", + "description": "A guest attributes entry.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#guestAttributes for guest attributes entry.", + "default": "compute#guestAttributes", + "type": "string" + }, + "variableKey": { + "description": "The key to search for.", + "type": "string" + }, + "variableValue": { + "description": "[Output Only] The value found for the requested key.", + "type": "string" + }, + "queryPath": { + "description": "The path to be queried. This can be the default namespace ('') or a nested namespace ('\\/') or a specified key ('\\/\\').", + "type": "string" + }, + "queryValue": { + "description": "[Output Only] The value of the requested queried path.", + "$ref": "GuestAttributesValue" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + } + } + }, + "GuestAttributesValue": { + "id": "GuestAttributesValue", + "description": "Array of guest attribute namespace/key/value tuples.", + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "GuestAttributesEntry" + } + } + } + }, + "GuestAttributesEntry": { + "id": "GuestAttributesEntry", + "description": "A guest attributes namespace/key/value entry.", + "type": "object", + "properties": { + "namespace": { + "description": "Namespace for the guest attribute entry.", + "type": "string" + }, + "key": { + "description": "Key for the guest attribute entry.", + "type": "string" + }, + "value": { + "description": "Value for the guest attribute entry.", + "type": "string" + } + } + }, + "InstancesSetMachineResourcesRequest": { + "id": "InstancesSetMachineResourcesRequest", + "type": "object", + "properties": { + "guestAccelerators": { + "description": "A list of the type and count of accelerator cards attached to the instance.", + "type": "array", + "items": { + "$ref": "AcceleratorConfig" + } + } + } + }, + "InstancesSetMachineTypeRequest": { + "id": "InstancesSetMachineTypeRequest", + "type": "object", + "properties": { + "machineType": { + "description": "Full or partial URL of the machine type resource. See Machine Types for a full list of machine types. For example: zones/us-central1-f/machineTypes/n1-standard-1", + "type": "string" + } + } + }, + "InstancesSetMinCpuPlatformRequest": { + "id": "InstancesSetMinCpuPlatformRequest", + "type": "object", + "properties": { + "minCpuPlatform": { + "description": "Minimum cpu/platform this instance should be started at.", + "type": "string" + } + } + }, + "InstancesSetLabelsRequest": { + "id": "InstancesSetLabelsRequest", + "type": "object", + "properties": { + "labels": { + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "Fingerprint of the previous set of labels for this resource, used to prevent conflicts. Provide the latest fingerprint value when making a request to add or change labels.", + "type": "string", + "format": "byte" + } + } + }, + "InstancesSetNameRequest": { + "id": "InstancesSetNameRequest", + "type": "object", + "properties": { + "name": { + "description": "The name to be applied to the instance. Needs to be RFC 1035 compliant.", + "type": "string" + }, + "currentName": { + "description": "The current name of this resource, used to prevent conflicts. Provide the latest name when making a request to change name.", + "type": "string" + } + } + }, + "InstancesStartWithEncryptionKeyRequest": { + "id": "InstancesStartWithEncryptionKeyRequest", + "type": "object", + "properties": { + "disks": { + "description": "Array of disks associated with this instance that are protected with a customer-supplied encryption key. In order to start the instance, the disk url and its corresponding key must be provided. If the disk is not protected with a customer-supplied encryption key it should not be specified.", + "type": "array", + "items": { + "$ref": "CustomerEncryptionKeyProtectedDisk" + } + } + } + }, + "CustomerEncryptionKeyProtectedDisk": { + "id": "CustomerEncryptionKeyProtectedDisk", + "type": "object", + "properties": { + "source": { + "description": "Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks. For example: \"source\": \"/compute/v1/projects/project_id/zones/zone/disks/ disk_name ", + "type": "string" }, - "patch": { - "id": "compute.regionSecurityPolicies.patch", - "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", - "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "Indicates fields to be cleared as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - } - }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" - ], - "request": { - "$ref": "SecurityPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified policy with the data included in the request. To clear fields in the policy, leave the fields empty and specify them in the updateMask. This cannot be used to be update the rules in the policy. Please use the per rule methods like addRule, patchRule, and removeRule instead." + "diskEncryptionKey": { + "description": "Decrypts data associated with the disk with a customer-supplied encryption key.", + "$ref": "CustomerEncryptionKey" + } + } + }, + "InstancesSetServiceAccountRequest": { + "id": "InstancesSetServiceAccountRequest", + "type": "object", + "properties": { + "email": { + "description": "Email address of the service account.", + "type": "string" }, - "getRule": { - "id": "compute.regionSecurityPolicies.getRule", - "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/getRule", - "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/getRule", - "httpMethod": "GET", - "parameters": { - "priority": { - "description": "The priority of the rule to get from the security policy.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to which the queried rule belongs.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" - ], - "response": { - "$ref": "SecurityPolicyRule" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets a rule at the specified priority." + "scopes": { + "description": "The list of scopes to be made available for this service account.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "InstancesAddResourcePoliciesRequest": { + "id": "InstancesAddResourcePoliciesRequest", + "type": "object", + "properties": { + "resourcePolicies": { + "description": "Resource policies to be added to this instance.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "InstancesRemoveResourcePoliciesRequest": { + "id": "InstancesRemoveResourcePoliciesRequest", + "type": "object", + "properties": { + "resourcePolicies": { + "description": "Resource policies to be removed from this instance.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "InstancesSetSecurityPolicyRequest": { + "id": "InstancesSetSecurityPolicyRequest", + "type": "object", + "properties": { + "securityPolicy": { + "description": "A full or partial URL to a security policy to add to this instance. If this field is set to an empty string it will remove the associated security policy.", + "type": "string" }, - "addRule": { - "id": "compute.regionSecurityPolicies.addRule", - "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/addRule", - "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/addRule", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "validateOnly": { - "description": "If true, the request will not be committed.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" - ], - "request": { - "$ref": "SecurityPolicyRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Inserts a rule into a security policy." + "networkInterfaces": { + "description": "The network interfaces that the security policy will be applied to. Network interfaces use the nicN naming format. You can only set a security policy for network interfaces with an access config.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "ShieldedInstanceIdentity": { + "id": "ShieldedInstanceIdentity", + "description": "A Shielded Instance Identity.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#shieldedInstanceIdentity for shielded Instance identity entry.", + "default": "compute#shieldedInstanceIdentity", + "type": "string" }, - "removeRule": { - "id": "compute.regionSecurityPolicies.removeRule", - "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/removeRule", - "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/removeRule", - "httpMethod": "POST", - "parameters": { - "priority": { - "description": "The priority of the rule to remove from the security policy.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes a rule at the specified priority." + "signingKey": { + "description": "An Attestation Key (AK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM.", + "$ref": "ShieldedInstanceIdentityEntry" }, - "patchRule": { - "id": "compute.regionSecurityPolicies.patchRule", - "path": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/patchRule", - "flatPath": "projects/{project}/regions/{region}/securityPolicies/{securityPolicy}/patchRule", - "httpMethod": "POST", - "parameters": { - "priority": { - "description": "The priority of the rule to patch.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "securityPolicy": { - "description": "Name of the security policy to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "Indicates fields to be cleared as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - }, - "validateOnly": { - "description": "If true, the request will not be committed.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region", - "securityPolicy" - ], - "request": { - "$ref": "SecurityPolicyRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches a rule at the specified priority. To clear fields in the rule, leave the fields empty and specify them in the updateMask." + "encryptionKey": { + "description": "An Endorsement Key (EK) made by the RSA 2048 algorithm issued to the Shielded Instance's vTPM.", + "$ref": "ShieldedInstanceIdentityEntry" } } }, - "instances": { - "methods": { - "list": { - "id": "compute.instances.list", - "path": "projects/{project}/zones/{zone}/instances", - "flatPath": "projects/{project}/zones/{zone}/instances", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "InstanceList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of instances contained within the specified zone." + "ShieldedInstanceIdentityEntry": { + "id": "ShieldedInstanceIdentityEntry", + "description": "A Shielded Instance Identity Entry.", + "type": "object", + "properties": { + "ekCert": { + "description": "A PEM-encoded X.509 certificate. This field can be empty.", + "type": "string" }, - "aggregatedList": { - "id": "compute.instances.aggregatedList", - "path": "projects/{project}/aggregated/instances", - "flatPath": "projects/{project}/aggregated/instances", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InstanceAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of all of the instances in your project across all regions and zones. The performance of this method degrades when a filter is specified on a project that has a very large number of instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "ekPub": { + "description": "A PEM-encoded public key.", + "type": "string" + } + } + }, + "BulkInsertInstanceResource": { + "id": "BulkInsertInstanceResource", + "description": "A transient resource used in compute.instances.bulkInsert and compute.regionInstances.bulkInsert . This resource is not persisted anywhere, it is used only for processing the requests.", + "type": "object", + "properties": { + "count": { + "description": "The maximum number of instances to create.", + "type": "string", + "format": "int64" + }, + "minCount": { + "description": "The minimum number of instances to create. If no min_count is specified then count is used as the default value. If min_count instances cannot be created, then no instances will be created and instances already created will be deleted.", + "type": "string", + "format": "int64" + }, + "namePattern": { + "description": "The string pattern used for the names of the VMs. Either name_pattern or per_instance_properties must be set. The pattern must contain one continuous sequence of placeholder hash characters (#) with each character corresponding to one digit of the generated instance name. Example: a name_pattern of inst-#### generates instance names such as inst-0001 and inst-0002. If existing instances in the same project and zone have names that match the name pattern then the generated instance numbers start after the biggest existing number. For example, if there exists an instance with name inst-0050, then instance names generated using the pattern inst-#### begin with inst-0051. The name pattern placeholder #...# can contain up to 18 characters.", + "type": "string" + }, + "perInstanceProperties": { + "description": "Per-instance properties to be set on individual instances. Keys of this map specify requested instance names. Can be empty if name_pattern is used.", + "type": "object", + "additionalProperties": { + "$ref": "BulkInsertInstanceResourcePerInstanceProperties" + } + }, + "sourceInstanceTemplate": { + "description": "Specifies the instance template from which to create instances. You may combine sourceInstanceTemplate with instanceProperties to override specific values from an existing instance template. Bulk API follows the semantics of JSON Merge Patch described by RFC 7396. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate This field is optional.", + "type": "string" + }, + "instanceProperties": { + "description": "The instance properties defining the VM instances to be created. Required if sourceInstanceTemplate is not provided.", + "$ref": "InstanceProperties" }, - "listReferrers": { - "id": "compute.instances.listReferrers", - "path": "projects/{project}/zones/{zone}/instances/{instance}/referrers", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/referrers", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "instance": { - "description": "Name of the target instance scoping this request, or '-' if the request should span over all instances in the container.", - "pattern": "-|[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "InstanceListReferrers" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of resources that refer to the VM instance specified in the request. For example, if the VM instance is part of a managed or unmanaged instance group, the referrers list includes the instance group. For more information, read Viewing referrers to VM instances." + "locationPolicy": { + "description": "Policy for choosing target zone. For more information, see Create VMs in bulk.", + "$ref": "LocationPolicy" + } + } + }, + "BulkInsertInstanceResourcePerInstanceProperties": { + "id": "BulkInsertInstanceResourcePerInstanceProperties", + "description": "Per-instance properties to be set on individual instances. To be extended in the future.", + "type": "object", + "properties": { + "name": { + "description": "This field is only temporary. It will be removed. Do not use it.", + "type": "string" }, - "get": { - "id": "compute.instances.get", - "path": "projects/{project}/zones/{zone}/instances/{instance}", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}", - "httpMethod": "GET", - "parameters": { - "instance": { - "description": "Name of the instance resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Instance" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified Instance resource." + "hostname": { + "description": "Specifies the hostname of the instance. More details in: https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention", + "type": "string" + } + } + }, + "InstanceProperties": { + "id": "InstanceProperties", + "type": "object", + "properties": { + "description": { + "description": "An optional text description for the instances that are created from these properties.", + "type": "string" }, - "insert": { - "id": "compute.instances.insert", - "path": "projects/{project}/zones/{zone}/instances", - "flatPath": "projects/{project}/zones/{zone}/instances", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "sourceInstanceTemplate": { - "description": "Specifies instance template to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate ", - "location": "query", - "type": "string" - }, - "sourceMachineImage": { - "description": "Specifies the machine image to use to create the instance. This field is optional. It can be a full or partial URL. For example, the following are all valid URLs to a machine image: - https://www.googleapis.com/compute/v1/projects/project/global/global /machineImages/machineImage - projects/project/global/global/machineImages/machineImage - global/machineImages/machineImage ", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "Instance" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates an instance resource in the specified project using the data included in the request." + "tags": { + "description": "A list of tags to apply to the instances that are created from these properties. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035.", + "$ref": "Tags" }, - "delete": { - "id": "compute.instances.delete", - "path": "projects/{project}/zones/{zone}/instances/{instance}", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}", - "httpMethod": "DELETE", - "parameters": { - "instance": { - "description": "Name of the instance resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified Instance resource. For more information, see Deleting an instance." + "resourceManagerTags": { + "description": "Resource manager tags to be bound to the instance. Tag keys and values have the same definition as resource manager tags. Keys must be in the format `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The field is ignored (both PUT & PATCH) when empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } }, - "reset": { - "id": "compute.instances.reset", - "path": "projects/{project}/zones/{zone}/instances/{instance}/reset", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/reset", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Operation" + "machineType": { + "description": "The machine type to use for instances that are created from these properties. This field only accepts a machine type name, for example `n2-standard-4`. If you use the machine type full or partial URL, for example `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`, the request will result in an `INTERNAL_ERROR`.", + "annotations": { + "required": [ + "compute.instanceTemplates.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Performs a reset on the instance. This is a hard reset. The VM does not do a graceful shutdown. For more information, see Resetting an instance." + "type": "string" }, - "simulateMaintenanceEvent": { - "id": "compute.instances.simulateMaintenanceEvent", - "path": "projects/{project}/zones/{zone}/instances/{instance}/simulateMaintenanceEvent", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/simulateMaintenanceEvent", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "withExtendedNotifications": { - "description": "Determines whether the customers receive notifications before migration. Only applicable to SF vms.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Simulates a host maintenance event on a VM. For more information, see Simulate a host maintenance event." + "canIpForward": { + "description": "Enables instances created based on these properties to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information.", + "type": "boolean" }, - "performMaintenance": { - "id": "compute.instances.performMaintenance", - "path": "projects/{project}/zones/{zone}/instances/{instance}/performMaintenance", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/performMaintenance", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Perform a manual maintenance on the instance." + "networkInterfaces": { + "description": "An array of network access configurations for this interface.", + "type": "array", + "items": { + "$ref": "NetworkInterface" + } }, - "addAccessConfig": { - "id": "compute.instances.addAccessConfig", - "path": "projects/{project}/zones/{zone}/instances/{instance}/addAccessConfig", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addAccessConfig", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "The instance name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "networkInterface": { - "description": "The name of the network interface to add to this instance.", - "location": "query", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance", - "networkInterface" + "disks": { + "description": "An array of disks that are associated with the instances that are created from these properties.", + "type": "array", + "items": { + "$ref": "AttachedDisk" + } + }, + "metadata": { + "description": "The metadata key/value pairs to assign to instances that are created from these properties. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information.", + "$ref": "Metadata" + }, + "serviceAccounts": { + "description": "A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from these properties. Use metadata queries to obtain the access tokens for these instances.", + "type": "array", + "items": { + "$ref": "ServiceAccount" + } + }, + "scheduling": { + "description": "Specifies the scheduling options for the instances that are created from these properties.", + "$ref": "Scheduling" + }, + "labels": { + "description": "Labels to apply to instances that are created from these properties.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "guestAccelerators": { + "description": "A list of guest accelerator cards' type and count to use for instances created from these properties.", + "type": "array", + "items": { + "$ref": "AcceleratorConfig" + } + }, + "minCpuPlatform": { + "description": "Minimum cpu/platform to be used by instances. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: \"Intel Haswell\" or minCpuPlatform: \"Intel Sandy Bridge\". For more information, read Specifying a Minimum CPU Platform.", + "type": "string" + }, + "reservationAffinity": { + "description": "Specifies the reservations that instances can consume from. Note that for MachineImage, this is not supported yet.", + "$ref": "ReservationAffinity" + }, + "shieldedInstanceConfig": { + "description": "Note that for MachineImage, this is not supported yet.", + "$ref": "ShieldedInstanceConfig" + }, + "resourcePolicies": { + "description": "Resource policies (names, not URLs) applied to instances created from these properties. Note that for MachineImage, this is not supported yet.", + "type": "array", + "items": { + "type": "string" + } + }, + "confidentialInstanceConfig": { + "description": "Specifies the Confidential Instance options. Note that for MachineImage, this is not supported yet.", + "$ref": "ConfidentialInstanceConfig" + }, + "privateIpv6GoogleAccess": { + "description": "The private IPv6 google access type for VMs. If not specified, use INHERIT_FROM_SUBNETWORK as default. Note that for MachineImage, this is not supported yet.", + "type": "string", + "enumDescriptions": [ + "Bidirectional private IPv6 access to/from Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before.", + "Outbound private IPv6 access from VMs in this subnet to Google services. If specified, the subnetwork who is attached to the instance's default network interface will be assigned an internal IPv6 prefix if it doesn't have before.", + "Each network interface inherits PrivateIpv6GoogleAccess from its subnetwork." ], - "request": { - "$ref": "AccessConfig" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", + "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE", + "INHERIT_FROM_SUBNETWORK" + ] + }, + "advancedMachineFeatures": { + "description": "Controls for advanced machine-related behavior features. Note that for MachineImage, this is not supported yet.", + "$ref": "AdvancedMachineFeatures" + }, + "networkPerformanceConfig": { + "description": "Note that for MachineImage, this is not supported yet.", + "$ref": "NetworkPerformanceConfig" + }, + "keyRevocationActionType": { + "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and \"NONE\". The default value is \"NONE\" if it is not specified.", + "type": "string", + "enumDescriptions": [ + "Default value. This value is unused.", + "Indicates user chose no operation.", + "Indicates user chose to opt for VM shutdown on key revocation." ], - "description": "Adds an access config to an instance's network interface." + "enum": [ + "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", + "NONE", + "STOP" + ] + } + } + }, + "LocationPolicy": { + "id": "LocationPolicy", + "description": "Configuration for location policy among multiple possible locations (e.g. preferences for zone selection among zones in a single region).", + "type": "object", + "properties": { + "locations": { + "description": "Location configurations mapped by location name. Currently only zone names are supported and must be represented as valid internal URLs, such as zones/us-central1-a.", + "type": "object", + "additionalProperties": { + "$ref": "LocationPolicyLocation" + } }, - "deleteAccessConfig": { - "id": "compute.instances.deleteAccessConfig", - "path": "projects/{project}/zones/{zone}/instances/{instance}/deleteAccessConfig", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/deleteAccessConfig", - "httpMethod": "POST", - "parameters": { - "accessConfig": { - "description": "The name of the access config to delete.", - "location": "query", - "required": true, - "type": "string" - }, - "instance": { - "description": "The instance name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "networkInterface": { - "description": "The name of the network interface.", - "location": "query", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance", - "accessConfig", - "networkInterface" + "targetShape": { + "description": "Strategy for distributing VMs across zones in a region.", + "type": "string", + "enumDescriptions": [ + "GCE picks zones for creating VM instances to fulfill the requested number of VMs within present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads that do not require high availability.", + "GCE always selects a single zone for all the VMs, optimizing for resource quotas, available reservations and general capacity. Recommended for batch workloads that cannot tollerate distribution over multiple zones. This the default shape in Bulk Insert and Capacity Advisor APIs.", + "GCE prioritizes acquisition of resources, scheduling VMs in zones where resources are available while distributing VMs as evenly as possible across allowed zones to minimize the impact of zonal failure. Recommended for highly available serving workloads." ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ANY", + "ANY_SINGLE_ZONE", + "BALANCED" + ] + } + } + }, + "LocationPolicyLocation": { + "id": "LocationPolicyLocation", + "type": "object", + "properties": { + "preference": { + "description": "Preference for a given location. Set to either ALLOW or DENY.", + "type": "string", + "enumDescriptions": [ + "Location is allowed for use.", + "Location is prohibited.", + "Default value, unused." ], - "description": "Deletes an access config from an instance's network interface." + "enum": [ + "ALLOW", + "DENY", + "PREFERENCE_UNSPECIFIED" + ] }, - "updateAccessConfig": { - "id": "compute.instances.updateAccessConfig", - "path": "projects/{project}/zones/{zone}/instances/{instance}/updateAccessConfig", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateAccessConfig", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "The instance name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "networkInterface": { - "description": "The name of the network interface where the access config is attached.", - "location": "query", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance", - "networkInterface" - ], - "request": { - "$ref": "AccessConfig" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "constraints": { + "description": "Constraints that the caller requires on the result distribution in this zone.", + "$ref": "LocationPolicyLocationConstraints" + } + } + }, + "LocationPolicyLocationConstraints": { + "id": "LocationPolicyLocationConstraints", + "description": "Per-zone constraints on location policy for this zone.", + "type": "object", + "properties": { + "maxCount": { + "description": "Maximum number of items that are allowed to be placed in this zone. The value must be non-negative.", + "type": "integer", + "format": "int32" + } + } + }, + "InstancesGetEffectiveFirewallsResponse": { + "id": "InstancesGetEffectiveFirewallsResponse", + "type": "object", + "properties": { + "firewalls": { + "description": "Effective firewalls on the instance.", + "type": "array", + "items": { + "$ref": "Firewall" + } + }, + "firewallPolicys": { + "description": "[Output Only] Effective firewalls from firewall policies.", + "type": "array", + "items": { + "$ref": "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy" + } + } + } + }, + "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { + "id": "InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy", + "type": "object", + "properties": { + "name": { + "description": "[Output Only] The name of the firewall policy.", + "type": "string" + }, + "type": { + "description": "[Output Only] The type of the firewall policy. Can be one of HIERARCHY, NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "" ], - "description": "Updates the specified access config from an instance's network interface with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + "enum": [ + "HIERARCHY", + "NETWORK", + "NETWORK_REGIONAL", + "SYSTEM_GLOBAL", + "SYSTEM_REGIONAL", + "UNSPECIFIED" + ] }, - "updateNetworkInterface": { - "id": "compute.instances.updateNetworkInterface", - "path": "projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateNetworkInterface", - "httpMethod": "PATCH", - "parameters": { - "instance": { - "description": "The instance name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "networkInterface": { - "description": "The name of the network interface to update.", - "location": "query", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "shortName": { + "description": "[Output Only] The short name of the firewall policy.", + "type": "string" + }, + "displayName": { + "description": "[Output Only] Deprecated, please use short name instead. The display name of the firewall policy.", + "deprecated": true, + "type": "string" + }, + "rules": { + "description": "[Output Only] The rules that apply to the instance. Only rules that target the specific VM instance are returned if target service accounts or target secure tags are specified in the rules.", + "type": "array", + "items": { + "$ref": "FirewallPolicyRule" + } + }, + "priority": { + "description": "[Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY.", + "type": "integer", + "format": "int32" + } + } + }, + "ReservationList": { + "id": "ReservationList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource.Always compute#reservationsList for listsof reservations", + "default": "compute#reservationList", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string" + }, + "items": { + "description": "[Output Only] A list of Allocation resources.", + "type": "array", + "items": { + "$ref": "Reservation" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } + } + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + } + } + }, + "Reservation": { + "id": "Reservation", + "description": "Represents a reservation resource. A reservation ensures that capacity is held in a specific zone even if the reserved VMs are not running. For more information, read Reserving zonal resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#reservations for reservations.", + "default": "compute#reservation", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined fully-qualified URL for this resource.", + "type": "string" + }, + "zone": { + "description": "Zone in which the reservation resides. A zone must be provided if the reservation is created within a commitment.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "name": { + "description": "The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "annotations": { + "required": [ + "compute.instances.insert" + ] }, - "parameterOrder": [ - "project", - "zone", - "instance", - "networkInterface" - ], - "request": { - "$ref": "NetworkInterface" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "string" + }, + "specificReservation": { + "description": "Reservation for instances with specific machine shapes.", + "$ref": "AllocationSpecificSKUReservation" + }, + "aggregateReservation": { + "description": "Reservation for aggregated resources, providing shape flexibility.", + "$ref": "AllocationAggregateReservation" + }, + "commitment": { + "description": "[Output Only] Full or partial URL to a parent commitment. This field displays for reservations that are tied to a commitment.", + "type": "string" + }, + "specificReservationRequired": { + "description": "Indicates whether the reservation can be consumed by VMs with affinity for \"any\" reservation. If the field is set, then only VMs that target the reservation by name can consume from this reservation.", + "type": "boolean" + }, + "status": { + "description": "[Output Only] The status of the reservation. - CREATING: Reservation resources are being allocated. - READY: Reservation resources have been allocated, and the reservation is ready for use. - DELETING: Reservation deletion is in progress. - UPDATING: Reservation update is in progress. ", + "type": "string", + "enumDescriptions": [ + "Reservation resources are being allocated.", + "Reservation deletion is in progress.", + "", + "Reservation resources have been allocated, and the reservation is ready for use.", + "Reservation update is in progress." ], - "description": "Updates an instance's network interface. This method can only update an interface's alias IP range and attached network. See Modifying alias IP ranges for an existing instance for instructions on changing alias IP ranges. See Migrating a VM between networks for instructions on migrating an interface. This method follows PATCH semantics." + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY", + "UPDATING" + ] }, - "setScheduling": { - "id": "compute.instances.setScheduling", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setScheduling", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setScheduling", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Instance name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" + "shareSettings": { + "description": "Specify share-settings to create a shared reservation. This property is optional. For more information about the syntax and options for this field and its subfields, see the guide for creating a shared reservation.", + "$ref": "ShareSettings" + }, + "satisfiesPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "resourcePolicies": { + "description": "Resource policies to be added to this reservation. The key is defined by user, and the value is resource policy url. This is to define placement policy with reservation.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "resourceStatus": { + "description": "[Output Only] Status information for Reservation resource.", + "$ref": "AllocationResourceStatus" + } + } + }, + "AllocationSpecificSKUReservation": { + "id": "AllocationSpecificSKUReservation", + "description": "This reservation type allows to pre allocate specific instance configuration.", + "type": "object", + "properties": { + "instanceProperties": { + "description": "The instance properties for the reservation.", + "$ref": "AllocationSpecificSKUAllocationReservedInstanceProperties" + }, + "count": { + "description": "Specifies the number of resources that are allocated.", + "type": "string", + "format": "int64" + }, + "inUseCount": { + "description": "[Output Only] Indicates how many instances are in use.", + "type": "string", + "format": "int64" + }, + "assuredCount": { + "description": "[Output Only] Indicates how many instances are actually usable currently.", + "type": "string", + "format": "int64" + }, + "sourceInstanceTemplate": { + "description": "Specifies the instance template to create the reservation. If you use this field, you must exclude the instanceProperties field. This field is optional, and it can be a full or partial URL. For example, the following are all valid URLs to an instance template: - https://www.googleapis.com/compute/v1/projects/project /global/instanceTemplates/instanceTemplate - projects/project/global/instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate ", + "type": "string" + } + } + }, + "AllocationSpecificSKUAllocationReservedInstanceProperties": { + "id": "AllocationSpecificSKUAllocationReservedInstanceProperties", + "description": "Properties of the SKU instances being reserved. Next ID: 9", + "type": "object", + "properties": { + "machineType": { + "description": "Specifies type of machine (name only) which has fixed number of vCPUs and fixed amount of memory. This also includes specifying custom machine type following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.", + "type": "string" + }, + "guestAccelerators": { + "description": "Specifies accelerator type and count.", + "type": "array", + "items": { + "$ref": "AcceleratorConfig" + } + }, + "minCpuPlatform": { + "description": "Minimum cpu platform the reservation.", + "type": "string" + }, + "localSsds": { + "description": "Specifies amount of local ssd to reserve with each instance. The type of disk is local-ssd.", + "type": "array", + "items": { + "$ref": "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk" + } + }, + "locationHint": { + "description": "An opaque location hint used to place the allocation close to other resources. This field is for use by internal tools that use the public API.", + "type": "string" + } + } + }, + "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk": { + "id": "AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk", + "type": "object", + "properties": { + "diskSizeGb": { + "description": "Specifies the size of the disk in base-2 GB.", + "type": "string", + "format": "int64" + }, + "interface": { + "description": "Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "request": { - "$ref": "Scheduling" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "NVME", + "SCSI" + ] + } + } + }, + "AllocationAggregateReservation": { + "id": "AllocationAggregateReservation", + "description": "This reservation type is specified by total resource amounts (e.g. total count of CPUs) and can account for multiple instance SKUs. In other words, one can create instances of varying shapes against this reservation.", + "type": "object", + "properties": { + "vmFamily": { + "description": "The VM family that all instances scheduled against this reservation must belong to.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "description": "Sets an instance's scheduling options. You can only call this method on a stopped instance, that is, a VM instance that is in a `TERMINATED` state. See Instance Life Cycle for more information on the possible instance states. For more information about setting scheduling options for a VM, see Set VM host maintenance policy." + "enum": [ + "VM_FAMILY_CLOUD_TPU_DEVICE_CT3", + "VM_FAMILY_CLOUD_TPU_LITE_DEVICE_CT5L", + "VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT3P", + "VM_FAMILY_CLOUD_TPU_POD_SLICE_CT4P" + ] }, - "getSerialPortOutput": { - "id": "compute.instances.getSerialPortOutput", - "path": "projects/{project}/zones/{zone}/instances/{instance}/serialPort", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/serialPort", - "httpMethod": "GET", - "parameters": { - "instance": { - "description": "Name of the instance for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "port": { - "description": "Specifies which COM or serial port to retrieve data from.", - "default": "1", - "minimum": "1", - "maximum": "4", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "start": { - "description": "Specifies the starting byte position of the output to return. To start with the first byte of output to the specified port, omit this field or set it to `0`. If the output for that byte position is available, this field matches the `start` parameter sent with the request. If the amount of serial console output exceeds the size of the buffer (1 MB), the oldest output is discarded and is no longer available. If the requested start position refers to discarded output, the start position is adjusted to the oldest output still available, and the adjusted start position is returned as the `start` property value. You can also provide a negative start position, which translates to the most recent number of bytes written to the serial port. For example, -3 is interpreted as the most recent 3 bytes written to the serial console.", - "location": "query", - "type": "string", - "format": "int64" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" + "reservedResources": { + "description": "List of reserved resources (CPUs, memory, accelerators).", + "type": "array", + "items": { + "$ref": "AllocationAggregateReservationReservedResourceInfo" + } + }, + "inUseResources": { + "description": "[Output only] List of resources currently in use.", + "type": "array", + "items": { + "$ref": "AllocationAggregateReservationReservedResourceInfo" + } + }, + "workloadType": { + "description": "The workload type of the instances that will target this reservation.", + "type": "string", + "enumDescriptions": [ + "Reserved resources will be optimized for BATCH workloads, such as ML training.", + "Reserved resources will be optimized for SERVING workloads, such as ML inference.", + "" ], - "response": { - "$ref": "SerialPortOutput" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "BATCH", + "SERVING", + "UNSPECIFIED" + ] + } + } + }, + "AllocationAggregateReservationReservedResourceInfo": { + "id": "AllocationAggregateReservationReservedResourceInfo", + "type": "object", + "properties": { + "accelerator": { + "description": "Properties of accelerator resources in this reservation.", + "$ref": "AllocationAggregateReservationReservedResourceInfoAccelerator" + } + } + }, + "AllocationAggregateReservationReservedResourceInfoAccelerator": { + "id": "AllocationAggregateReservationReservedResourceInfoAccelerator", + "type": "object", + "properties": { + "acceleratorCount": { + "description": "Number of accelerators of specified type.", + "type": "integer", + "format": "int32" + }, + "acceleratorType": { + "description": "Full or partial URL to accelerator type. e.g. \"projects/{PROJECT}/zones/{ZONE}/acceleratorTypes/ct4l\"", + "type": "string" + } + } + }, + "ShareSettings": { + "id": "ShareSettings", + "description": "The share setting for reservations and sole tenancy node groups.", + "type": "object", + "properties": { + "shareType": { + "description": "Type of sharing for this shared-reservation", + "type": "string", + "enumDescriptions": [ + "Default value.", + "Shared-reservation is open to entire Organization", + "Default value. This value is unused.", + "Shared-reservation is open to specific projects" ], - "description": "Returns the last 1 MB of serial port output from the specified instance." + "enum": [ + "LOCAL", + "ORGANIZATION", + "SHARE_TYPE_UNSPECIFIED", + "SPECIFIC_PROJECTS" + ] }, - "getScreenshot": { - "id": "compute.instances.getScreenshot", - "path": "projects/{project}/zones/{zone}/instances/{instance}/screenshot", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/screenshot", - "httpMethod": "GET", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "projectMap": { + "description": "A map of project id and project config. This is only valid when share_type's value is SPECIFIC_PROJECTS.", + "type": "object", + "additionalProperties": { + "$ref": "ShareSettingsProjectConfig" + } + } + } + }, + "ShareSettingsProjectConfig": { + "id": "ShareSettingsProjectConfig", + "description": "Config for each project in the share settings.", + "type": "object", + "properties": { + "projectId": { + "description": "The project ID, should be same as the key of this project config in the parent map.", + "type": "string" + } + } + }, + "AllocationResourceStatus": { + "id": "AllocationResourceStatus", + "description": "[Output Only] Contains output only fields.", + "type": "object", + "properties": { + "specificSkuAllocation": { + "description": "Allocation Properties of this reservation.", + "$ref": "AllocationResourceStatusSpecificSKUAllocation" + } + } + }, + "AllocationResourceStatusSpecificSKUAllocation": { + "id": "AllocationResourceStatusSpecificSKUAllocation", + "description": "Contains Properties set for the reservation.", + "type": "object", + "properties": { + "sourceInstanceTemplateId": { + "description": "ID of the instance template used to populate reservation properties.", + "type": "string" + } + } + }, + "ReservationAggregatedList": { + "id": "ReservationAggregatedList", + "description": "Contains a list of reservations.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#reservationAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Allocation resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of reservations.", + "$ref": "ReservationsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Screenshot" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the screenshot from the specified instance." + } }, - "sendDiagnosticInterrupt": { - "id": "compute.instances.sendDiagnosticInterrupt", - "path": "projects/{project}/zones/{zone}/instances/{instance}/sendDiagnosticInterrupt", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/sendDiagnosticInterrupt", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sends diagnostic interrupt to the instance." + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "ReservationsScopedList": { + "id": "ReservationsScopedList", + "type": "object", + "properties": { + "reservations": { + "description": "A list of reservations contained in this scope.", + "type": "array", + "items": { + "$ref": "Reservation" + } }, - "getGuestAttributes": { - "id": "compute.instances.getGuestAttributes", - "path": "projects/{project}/zones/{zone}/instances/{instance}/getGuestAttributes", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getGuestAttributes", - "httpMethod": "GET", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "queryPath": { - "description": "Specifies the guest attributes path to be queried.", - "location": "query", - "type": "string" + "warning": { + "description": "Informational warning which replaces the list of reservations when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "variableKey": { - "description": "Specifies the key for the guest attributes entry.", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "GuestAttributes" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified guest attributes entry." + } + } + } + }, + "ReservationsResizeRequest": { + "id": "ReservationsResizeRequest", + "type": "object", + "properties": { + "specificSkuCount": { + "description": "Number of allocated resources can be resized with minimum = 1 and maximum = 1000.", + "type": "string", + "format": "int64" + } + } + }, + "InstanceGroupList": { + "id": "InstanceGroupList", + "description": "A list of InstanceGroup resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#instanceGroupList for instance group lists.", + "default": "compute#instanceGroupList", + "type": "string" }, - "attachDisk": { - "id": "compute.instances.attachDisk", - "path": "projects/{project}/zones/{zone}/instances/{instance}/attachDisk", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/attachDisk", - "httpMethod": "POST", - "parameters": { - "forceAttach": { - "description": "Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error.", - "location": "query", - "type": "boolean" - }, - "instance": { - "description": "The instance name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "AttachedDisk" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Attaches an existing Disk resource to an instance. You must first create the disk before you can attach it. It is not possible to create and attach a disk at the same time. For more information, read Adding a persistent disk to your instance." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "detachDisk": { - "id": "compute.instances.detachDisk", - "path": "projects/{project}/zones/{zone}/instances/{instance}/detachDisk", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/detachDisk", - "httpMethod": "POST", - "parameters": { - "deviceName": { - "description": "The device name of the disk to detach. Make a get() request on the instance to view currently attached disks and device names.", - "location": "query", - "required": true, - "type": "string" - }, - "instance": { - "description": "Instance name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance", - "deviceName" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Detaches a disk from an instance." + "items": { + "description": "A list of InstanceGroup resources.", + "type": "array", + "items": { + "$ref": "InstanceGroup" + } }, - "setMachineResources": { - "id": "compute.instances.setMachineResources", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setMachineResources", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMachineResources", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "InstancesSetMachineResourcesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the number and/or type of accelerator for a stopped instance to the values specified in the request." + } + } + } + }, + "InstanceGroup": { + "id": "InstanceGroup", + "description": "Represents an Instance Group resource. Instance Groups can be used to configure a target for load balancing. Instance groups can either be managed or unmanaged. To create managed instance groups, use the instanceGroupManager or regionInstanceGroupManager resource instead. Use zonal unmanaged instance groups if you need to apply load balancing to groups of heterogeneous instances or if you need to manage the instances yourself. You cannot create regional unmanaged instance groups. For more information, read Instance groups.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#instanceGroup for instance groups.", + "default": "compute#instanceGroup", + "type": "string" }, - "setMachineType": { - "id": "compute.instances.setMachineType", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setMachineType", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMachineType", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "InstancesSetMachineTypeRequest" - }, - "response": { - "$ref": "Operation" + "id": { + "description": "[Output Only] A unique identifier for this instance group, generated by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] The creation timestamp for this instance group in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "The name of the 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])?", + "annotations": { + "required": [ + "compute.instanceGroups.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the machine type for a stopped instance to the machine type specified in the request." + "type": "string" }, - "setMetadata": { - "id": "compute.instances.setMetadata", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setMetadata", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMetadata", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "namedPorts": { + "description": " Assigns a name to a port number. For example: {name: \"http\", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: \"app1\", port: 8080}, {name: \"app1\", port: 8081}, {name: \"app2\", port: 8082}] Named ports apply to all instances in this instance group. ", + "type": "array", + "items": { + "$ref": "NamedPort" + } + }, + "network": { + "description": "[Output Only] The URL of the network to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0).", + "type": "string" + }, + "fingerprint": { + "description": "[Output Only] The fingerprint of the named ports. The system uses this fingerprint to detect conflicts when multiple users change the named ports concurrently.", + "type": "string", + "format": "byte" + }, + "zone": { + "description": "[Output Only] The URL of the zone where the instance group is located (for zonal resources).", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] The URL for this instance group. The server generates this URL.", + "type": "string" + }, + "size": { + "description": "[Output Only] The total number of instances in the instance group.", + "type": "integer", + "format": "int32" + }, + "region": { + "description": "[Output Only] The URL of the region where the instance group is located (for regional resources).", + "type": "string" + }, + "subnetwork": { + "description": "[Output Only] The URL of the subnetwork to which all instances in the instance group belong. If your instance has multiple network interfaces, then the network and subnetwork fields only refer to the network and subnet used by your primary interface (nic0).", + "type": "string" + } + } + }, + "NamedPort": { + "id": "NamedPort", + "description": "The named port. For example: \u003c\"http\", 80\u003e.", + "type": "object", + "properties": { + "name": { + "description": "The name for this named port. The name must be 1-63 characters long, and comply with RFC1035.", + "type": "string" + }, + "port": { + "description": "The port number, which can be a value between 1 and 65535.", + "type": "integer", + "format": "int32" + } + } + }, + "InstanceGroupAggregatedList": { + "id": "InstanceGroupAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#instanceGroupAggregatedList for aggregated lists of instance groups.", + "default": "compute#instanceGroupAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InstanceGroupsScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "The name of the scope that contains this set of instance groups.", + "$ref": "InstanceGroupsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "Metadata" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets metadata for the specified instance to the data included in the request." + } }, - "setMinCpuPlatform": { - "id": "compute.instances.setMinCpuPlatform", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setMinCpuPlatform", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setMinCpuPlatform", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "InstanceGroupsScopedList": { + "id": "InstanceGroupsScopedList", + "type": "object", + "properties": { + "instanceGroups": { + "description": "[Output Only] The list of instance groups that are contained in this scope.", + "type": "array", + "items": { + "$ref": "InstanceGroup" + } + }, + "warning": { + "description": "[Output Only] An informational warning that replaces the list of instance groups when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "InstancesSetMinCpuPlatformRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + } + } + } + }, + "InstanceGroupsAddInstancesRequest": { + "id": "InstanceGroupsAddInstancesRequest", + "type": "object", + "properties": { + "instances": { + "description": "The list of instances to add to the instance group.", + "type": "array", + "items": { + "$ref": "InstanceReference" + } + } + } + }, + "InstanceReference": { + "id": "InstanceReference", + "type": "object", + "properties": { + "instance": { + "description": "The URL for a specific instance. @required compute.instancegroups.addInstances/removeInstances", + "type": "string" + } + } + }, + "InstanceGroupsRemoveInstancesRequest": { + "id": "InstanceGroupsRemoveInstancesRequest", + "type": "object", + "properties": { + "instances": { + "description": "The list of instances to remove from the instance group.", + "type": "array", + "items": { + "$ref": "InstanceReference" + } + } + } + }, + "InstanceGroupsListInstancesRequest": { + "id": "InstanceGroupsListInstancesRequest", + "type": "object", + "properties": { + "instanceState": { + "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.", + "type": "string", + "enumDescriptions": [ + "Includes all instances in the generated list regardless of their state.", + "Includes instances in the generated list only if they have a RUNNING state." ], - "description": "Changes the minimum CPU platform that this instance should use. This method can only be called on a stopped instance. For more information, read Specifying a Minimum CPU Platform." + "enum": [ + "ALL", + "RUNNING" + ] + } + } + }, + "InstanceGroupsListInstances": { + "id": "InstanceGroupsListInstances", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#instanceGroupsListInstances for the list of instances in the specified instance group.", + "default": "compute#instanceGroupsListInstances", + "type": "string" }, - "setTags": { - "id": "compute.instances.setTags", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setTags", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setTags", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InstanceWithNamedPorts resources.", + "type": "array", + "items": { + "$ref": "InstanceWithNamedPorts" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "Tags" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + } + } + } + }, + "InstanceWithNamedPorts": { + "id": "InstanceWithNamedPorts", + "type": "object", + "properties": { + "instance": { + "description": "[Output Only] The URL of the instance.", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the instance.", + "type": "string", + "enumDescriptions": [ + "The instance is halted and we are performing tear down tasks like network deprogramming, releasing quota, IP, tearing down disks etc.", + "Resources are being allocated for the instance.", + "The instance is in repair.", + "The instance is running.", + "All required resources have been allocated and the instance is being started.", + "The instance has stopped successfully.", + "The instance is currently stopping (either being deleted or killed).", + "The instance has suspended.", + "The instance is suspending.", + "The instance has stopped (either by explicit action or underlying failure)." ], - "description": "Sets network tags for the specified instance to the data included in the request." + "enum": [ + "DEPROVISIONING", + "PROVISIONING", + "REPAIRING", + "RUNNING", + "STAGING", + "STOPPED", + "STOPPING", + "SUSPENDED", + "SUSPENDING", + "TERMINATED" + ] }, - "setLabels": { - "id": "compute.instances.setLabels", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setLabels", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setLabels", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "namedPorts": { + "description": "[Output Only] The named ports that belong to this instance group.", + "type": "array", + "items": { + "$ref": "NamedPort" + } + } + } + }, + "InstanceGroupsSetNamedPortsRequest": { + "id": "InstanceGroupsSetNamedPortsRequest", + "type": "object", + "properties": { + "namedPorts": { + "description": "The list of named ports to set for this instance group.", + "type": "array", + "items": { + "$ref": "NamedPort" + } + }, + "fingerprint": { + "description": "The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request. A request with an incorrect fingerprint will fail with error 412 conditionNotMet.", + "type": "string", + "format": "byte" + } + } + }, + "RegionInstanceGroupList": { + "id": "RegionInstanceGroupList", + "description": "Contains a list of InstanceGroup resources.", + "type": "object", + "properties": { + "kind": { + "description": "The resource type.", + "default": "compute#regionInstanceGroupList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InstanceGroup resources.", + "type": "array", + "items": { + "$ref": "InstanceGroup" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "InstancesSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + } + } + } + }, + "RegionInstanceGroupsListInstancesRequest": { + "id": "RegionInstanceGroupsListInstancesRequest", + "type": "object", + "properties": { + "instanceState": { + "description": "Instances in which state should be returned. Valid options are: 'ALL', 'RUNNING'. By default, it lists all instances.", + "type": "string", + "enumDescriptions": [ + "Matches any status of the instances, running, non-running and others.", + "Instance is in RUNNING state if it is running." ], - "description": "Sets labels on an instance. To learn more about labels, read the Labeling Resources documentation." + "enum": [ + "ALL", + "RUNNING" + ] }, - "setName": { - "id": "compute.instances.setName", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setName", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setName", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "The instance name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "InstancesSetNameRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets name of an instance." + "portName": { + "description": "Name of port user is interested in. It is optional. If it is set, only information about this ports will be returned. If it is not set, all the named ports will be returned. Always lists all instances.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + } + } + }, + "RegionInstanceGroupsListInstances": { + "id": "RegionInstanceGroupsListInstances", + "type": "object", + "properties": { + "kind": { + "description": "The resource type.", + "default": "compute#regionInstanceGroupsListInstances", + "type": "string" }, - "setDiskAutoDelete": { - "id": "compute.instances.setDiskAutoDelete", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setDiskAutoDelete", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setDiskAutoDelete", - "httpMethod": "POST", - "parameters": { - "autoDelete": { - "description": "Whether to auto-delete the disk when the instance is deleted.", - "location": "query", - "required": true, - "type": "boolean" - }, - "deviceName": { - "description": "The device name of the disk to modify. Make a get() request on the instance to view currently attached disks and device names.", - "pattern": "\\w[\\w.-]{0,254}", - "location": "query", - "required": true, - "type": "string" - }, - "instance": { - "description": "The instance name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance", - "autoDelete", - "deviceName" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the auto-delete flag for a disk attached to an instance." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "start": { - "id": "compute.instances.start", - "path": "projects/{project}/zones/{zone}/instances/{instance}/start", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/start", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance resource to start.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of InstanceWithNamedPorts resources.", + "type": "array", + "items": { + "$ref": "InstanceWithNamedPorts" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance." + } + } + } + }, + "RegionInstanceGroupsSetNamedPortsRequest": { + "id": "RegionInstanceGroupsSetNamedPortsRequest", + "type": "object", + "properties": { + "namedPorts": { + "description": "The list of named ports to set for this instance group.", + "type": "array", + "items": { + "$ref": "NamedPort" + } }, - "startWithEncryptionKey": { - "id": "compute.instances.startWithEncryptionKey", - "path": "projects/{project}/zones/{zone}/instances/{instance}/startWithEncryptionKey", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/startWithEncryptionKey", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance resource to start.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "fingerprint": { + "description": "The fingerprint of the named ports information for this instance group. Use this optional property to prevent conflicts when multiple users change the named ports settings concurrently. Obtain the fingerprint with the instanceGroups.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request.", + "type": "string", + "format": "byte" + } + } + }, + "InstanceGroupManagerList": { + "id": "InstanceGroupManagerList", + "description": "[Output Only] A list of managed instance groups.", + "type": "object", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InstanceGroupManager resources.", + "type": "array", + "items": { + "$ref": "InstanceGroupManager" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } + } + }, + "kind": { + "description": "[Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups.", + "default": "compute#instanceGroupManagerList", + "type": "string" + } + } + }, + "InstanceGroupManager": { + "id": "InstanceGroupManager", + "description": "Represents a Managed Instance Group resource. An instance group is a collection of VM instances that you can manage as a single entity. For more information, read Instance groups. For zonal Managed Instance Group, use the instanceGroupManagers resource. For regional Managed Instance Group, use the regionInstanceGroupManagers resource.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.", + "default": "compute#instanceGroupManager", + "type": "string" + }, + "id": { + "description": "[Output Only] A unique identifier for this resource type. The server generates this identifier.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] The creation timestamp for this managed instance group in RFC3339 text format.", + "type": "string" + }, + "name": { + "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])?", + "annotations": { + "required": [ + "compute.instanceGroupManagers.insert", + "compute.regionInstanceGroupManagers.insert" + ] }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "InstancesStartWithEncryptionKeyRequest" - }, - "response": { - "$ref": "Operation" + "type": "string" + }, + "description": { + "description": "An optional description of this resource.", + "type": "string" + }, + "zone": { + "description": "[Output Only] The URL of a zone where the managed instance group is located (for zonal resources).", + "type": "string" + }, + "region": { + "description": "[Output Only] The URL of the region where the managed instance group resides (for regional resources).", + "type": "string" + }, + "distributionPolicy": { + "description": "Policy specifying the intended distribution of managed instances across zones in a regional managed instance group.", + "$ref": "DistributionPolicy" + }, + "instanceTemplate": { + "description": "The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.", + "type": "string" + }, + "versions": { + "description": "Specifies the instance templates used by this managed instance group to create instances. Each version is defined by an instanceTemplate and a name. Every version can appear at most once per instance group. This field overrides the top-level instanceTemplate field. Read more about the relationships between these fields. Exactly one version must leave the targetSize field unset. That version will be applied to all remaining instances. For more information, read about canary updates.", + "type": "array", + "items": { + "$ref": "InstanceGroupManagerVersion" + } + }, + "allInstancesConfig": { + "description": "Specifies configuration that overrides the instance template configuration for the group.", + "$ref": "InstanceGroupManagerAllInstancesConfig" + }, + "instanceGroup": { + "description": "[Output Only] The URL of the Instance Group resource.", + "type": "string" + }, + "targetPools": { + "description": "The URLs for all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.", + "type": "array", + "items": { + "type": "string" + } + }, + "baseInstanceName": { + "description": "The base instance name is a prefix that you want to attach to the names of all VMs in a MIG. The maximum character length is 58 and the name must comply with RFC1035 format. When a VM is created in the group, the MIG appends a hyphen and a random four-character string to the base instance name. If you want the MIG to assign sequential numbers instead of a random string, then end the base instance name with a hyphen followed by one or more hash symbols. The hash symbols indicate the number of digits. For example, a base instance name of \"vm-###\" results in \"vm-001\" as a VM name. @pattern [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\\\[[0-9]{1,10}\\\\])?))", + "type": "string" + }, + "fingerprint": { + "description": "Fingerprint of this resource. This field may be used in optimistic locking. It will be ignored when inserting an InstanceGroupManager. An up-to-date fingerprint must be provided in order to update the InstanceGroupManager, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InstanceGroupManager.", + "type": "string", + "format": "byte" + }, + "currentActions": { + "description": "[Output Only] The list of instance actions and the number of instances in this managed instance group that are scheduled for each of those actions.", + "$ref": "InstanceGroupManagerActionsSummary" + }, + "status": { + "description": "[Output Only] The status of this managed instance group.", + "$ref": "InstanceGroupManagerStatus" + }, + "targetSize": { + "description": "The target number of running instances for this managed instance group. You can reduce this number by using the instanceGroupManager deleteInstances or abandonInstances methods. Resizing the group also changes this number.", + "annotations": { + "required": [ + "compute.instanceGroupManagers.insert", + "compute.regionInstanceGroupManagers.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "integer", + "format": "int32" + }, + "instanceFlexibilityPolicy": { + "description": "Instance flexibility allowing MIG to create VMs from multiple types of machines. Instance flexibility configuration on MIG overrides instance template configuration.", + "$ref": "InstanceGroupManagerInstanceFlexibilityPolicy" + }, + "listManagedInstancesResults": { + "description": "Pagination behavior of the listManagedInstances API method for this managed instance group.", + "type": "string", + "enumDescriptions": [ + "(Default) Pagination is disabled for the group's listManagedInstances API method. maxResults and pageToken query parameters are ignored and all instances are returned in a single response.", + "Pagination is enabled for the group's listManagedInstances API method. maxResults and pageToken query parameters are respected." ], - "description": "Starts an instance that was stopped using the instances().stop method. For more information, see Restart an instance." + "enum": [ + "PAGELESS", + "PAGINATED" + ] }, - "stop": { - "id": "compute.instances.stop", - "path": "projects/{project}/zones/{zone}/instances/{instance}/stop", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/stop", - "httpMethod": "POST", - "parameters": { - "discardLocalSsd": { - "description": "This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded.", - "location": "query", - "type": "boolean" - }, - "instance": { - "description": "Name of the instance resource to stop.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" + "selfLink": { + "description": "[Output Only] The URL for this managed instance group. The server defines this URL.", + "type": "string" + }, + "autoHealingPolicies": { + "description": "The autohealing policy for this managed instance group. You can specify only one value.", + "type": "array", + "items": { + "$ref": "InstanceGroupManagerAutoHealingPolicy" + } + }, + "updatePolicy": { + "description": "The update policy for this managed instance group.", + "$ref": "InstanceGroupManagerUpdatePolicy" + }, + "namedPorts": { + "description": "[Output Only] Named ports configured on the Instance Groups complementary to this Instance Group Manager.", + "type": "array", + "items": { + "$ref": "NamedPort" + } + }, + "statefulPolicy": { + "description": "Stateful configuration for this Instanced Group Manager", + "$ref": "StatefulPolicy" + }, + "instanceLifecyclePolicy": { + "description": "The repair policy for this managed instance group.", + "$ref": "InstanceGroupManagerInstanceLifecyclePolicy" + }, + "satisfiesPzi": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "satisfiesPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + } + } + }, + "DistributionPolicy": { + "id": "DistributionPolicy", + "type": "object", + "properties": { + "zones": { + "description": "Zones where the regional managed instance group will create and manage its instances.", + "type": "array", + "items": { + "$ref": "DistributionPolicyZoneConfiguration" + } + }, + "targetShape": { + "description": "The distribution shape to which the group converges either proactively or on resize events (depending on the value set in updatePolicy.instanceRedistributionType).", + "type": "string", + "enumDescriptions": [ + "The group picks zones for creating VM instances to fulfill the requested number of VMs within present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads that do not require high availability.", + "The group creates all VM instances within a single zone. The zone is selected based on the present resource constraints and to maximize utilization of unused zonal reservations. Recommended for batch workloads with heavy interprocess communication.", + "The group prioritizes acquisition of resources, scheduling VMs in zones where resources are available while distributing VMs as evenly as possible across selected zones to minimize the impact of zonal failure. Recommended for highly available serving workloads.", + "The group schedules VM instance creation and deletion to achieve and maintain an even number of managed instances across the selected zones. The distribution is even when the number of managed instances does not differ by more than 1 between any two zones. Recommended for highly available serving workloads." ], - "response": { - "$ref": "Operation" + "enum": [ + "ANY", + "ANY_SINGLE_ZONE", + "BALANCED", + "EVEN" + ] + } + } + }, + "DistributionPolicyZoneConfiguration": { + "id": "DistributionPolicyZoneConfiguration", + "type": "object", + "properties": { + "zone": { + "description": "The URL of the zone. The zone must exist in the region where the managed instance group is located.", + "annotations": { + "required": [ + "compute.regionInstanceGroupManagers.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "string" + } + } + }, + "InstanceGroupManagerVersion": { + "id": "InstanceGroupManagerVersion", + "type": "object", + "properties": { + "name": { + "description": "Name of the version. Unique among all versions in the scope of this managed instance group.", + "type": "string" + }, + "instanceTemplate": { + "description": "The URL of the instance template that is specified for this managed instance group. The group uses this template to create new instances in the managed instance group until the `targetSize` for this version is reached. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE; in those cases, existing instances are updated until the `targetSize` for this version is reached.", + "type": "string" + }, + "targetSize": { + "description": "Specifies the intended number of instances to be created from the instanceTemplate. The final number of instances created from the template will be equal to: - If expressed as a fixed number, the minimum of either targetSize.fixed or instanceGroupManager.targetSize is used. - if expressed as a percent, the targetSize would be (targetSize.percent/100 * InstanceGroupManager.targetSize) If there is a remainder, the number is rounded. If unset, this version will update any remaining instances not updated by another version. Read Starting a canary update for more information.", + "$ref": "FixedOrPercent" + } + } + }, + "FixedOrPercent": { + "id": "FixedOrPercent", + "description": "Encapsulates numeric value that can be either absolute or relative.", + "type": "object", + "properties": { + "fixed": { + "description": "Specifies a fixed number of VM instances. This must be a positive integer.", + "type": "integer", + "format": "int32" + }, + "percent": { + "description": "Specifies a percentage of instances between 0 to 100%, inclusive. For example, specify 80 for 80%.", + "type": "integer", + "format": "int32" + }, + "calculated": { + "description": "[Output Only] Absolute value of VM instances calculated based on the specific mode. - If the value is fixed, then the calculated value is equal to the fixed value. - If the value is a percent, then the calculated value is percent/100 * targetSize. For example, the calculated value of a 80% of a managed instance group with 150 instances would be (80/100 * 150) = 120 VM instances. If there is a remainder, the number is rounded. ", + "type": "integer", + "format": "int32" + } + } + }, + "InstanceGroupManagerAllInstancesConfig": { + "id": "InstanceGroupManagerAllInstancesConfig", + "type": "object", + "properties": { + "properties": { + "description": "Properties to set on all instances in the group. You can add or modify properties using the instanceGroupManagers.patch or regionInstanceGroupManagers.patch. After setting allInstancesConfig on the group, you must update the group's instances to apply the configuration. To apply the configuration, set the group's updatePolicy.type field to use proactive updates or use the applyUpdatesToInstances method.", + "$ref": "InstancePropertiesPatch" + } + } + }, + "InstancePropertiesPatch": { + "id": "InstancePropertiesPatch", + "description": "Represents the change that you want to make to the instance properties.", + "type": "object", + "properties": { + "metadata": { + "description": "The metadata key-value pairs that you want to patch onto the instance. For more information, see Project and instance metadata.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labels": { + "description": "The label key-value pairs that you want to patch onto the instance.", + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } + }, + "InstanceGroupManagerActionsSummary": { + "id": "InstanceGroupManagerActionsSummary", + "type": "object", + "properties": { + "none": { + "description": "[Output Only] The number of instances in the managed instance group that are running and have no scheduled actions.", + "type": "integer", + "format": "int32" + }, + "creating": { + "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be created or are currently being created. If the group fails to create any of these instances, it tries again until it creates the instance successfully. If you have disabled creation retries, this field will not be populated; instead, the creatingWithoutRetries field will be populated.", + "type": "integer", + "format": "int32" + }, + "creatingWithoutRetries": { + "description": "[Output Only] The number of instances that the managed instance group will attempt to create. The group attempts to create each instance only once. If the group fails to create any of these instances, it decreases the group's targetSize value accordingly.", + "type": "integer", + "format": "int32" + }, + "verifying": { + "description": "[Output Only] The number of instances in the managed instance group that are being verified. See the managedInstances[].currentAction property in the listManagedInstances method documentation.", + "type": "integer", + "format": "int32" + }, + "recreating": { + "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be recreated or are currently being being recreated. Recreating an instance deletes the existing root persistent disk and creates a new disk from the image that is defined in the instance template.", + "type": "integer", + "format": "int32" + }, + "deleting": { + "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be deleted or are currently being deleted.", + "type": "integer", + "format": "int32" + }, + "abandoning": { + "description": "[Output Only] The total number of instances in the managed instance group that are scheduled to be abandoned. Abandoning an instance removes it from the managed instance group without deleting it.", + "type": "integer", + "format": "int32" + }, + "restarting": { + "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be restarted or are currently being restarted.", + "type": "integer", + "format": "int32" + }, + "refreshing": { + "description": "[Output Only] The number of instances in the managed instance group that are being reconfigured with properties that do not require a restart or a recreate action. For example, setting or removing target pools for the instance.", + "type": "integer", + "format": "int32" + }, + "suspending": { + "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be suspended or are currently being suspended.", + "type": "integer", + "format": "int32" + }, + "resuming": { + "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be resumed or are currently being resumed.", + "type": "integer", + "format": "int32" + }, + "stopping": { + "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be stopped or are currently being stopped.", + "type": "integer", + "format": "int32" + }, + "starting": { + "description": "[Output Only] The number of instances in the managed instance group that are scheduled to be started or are currently being started.", + "type": "integer", + "format": "int32" + } + } + }, + "InstanceGroupManagerStatus": { + "id": "InstanceGroupManagerStatus", + "type": "object", + "properties": { + "isStable": { + "description": "[Output Only] A bit indicating whether the managed instance group is in a stable state. A stable state means that: none of the instances in the managed instance group is currently undergoing any type of change (for example, creation, restart, or deletion); no future changes are scheduled for instances in the managed instance group; and the managed instance group itself is not being modified.", + "type": "boolean" + }, + "allInstancesConfig": { + "description": "[Output only] Status of all-instances configuration on the group.", + "$ref": "InstanceGroupManagerStatusAllInstancesConfig" + }, + "versionTarget": { + "description": "[Output Only] A status of consistency of Instances' versions with their target version specified by version field on Instance Group Manager.", + "$ref": "InstanceGroupManagerStatusVersionTarget" + }, + "stateful": { + "description": "[Output Only] Stateful status of the given Instance Group Manager.", + "$ref": "InstanceGroupManagerStatusStateful" + }, + "autoscaler": { + "description": "[Output Only] The URL of the Autoscaler that targets this instance group manager.", + "type": "string" + } + } + }, + "InstanceGroupManagerStatusAllInstancesConfig": { + "id": "InstanceGroupManagerStatusAllInstancesConfig", + "type": "object", + "properties": { + "effective": { + "description": "[Output Only] A bit indicating whether this configuration has been applied to all managed instances in the group.", + "type": "boolean" + }, + "currentRevision": { + "description": "[Output Only] Current all-instances configuration revision. This value is in RFC3339 text format.", + "type": "string" + } + } + }, + "InstanceGroupManagerStatusVersionTarget": { + "id": "InstanceGroupManagerStatusVersionTarget", + "type": "object", + "properties": { + "isReached": { + "description": "[Output Only] A bit indicating whether version target has been reached in this managed instance group, i.e. all instances are in their target version. Instances' target version are specified by version field on Instance Group Manager.", + "type": "boolean" + } + } + }, + "InstanceGroupManagerStatusStateful": { + "id": "InstanceGroupManagerStatusStateful", + "type": "object", + "properties": { + "hasStatefulConfig": { + "description": "[Output Only] A bit indicating whether the managed instance group has stateful configuration, that is, if you have configured any items in a stateful policy or in per-instance configs. The group might report that it has no stateful configuration even when there is still some preserved state on a managed instance, for example, if you have deleted all PICs but not yet applied those deletions.", + "type": "boolean" + }, + "perInstanceConfigs": { + "description": "[Output Only] Status of per-instance configurations on the instances.", + "$ref": "InstanceGroupManagerStatusStatefulPerInstanceConfigs" + } + } + }, + "InstanceGroupManagerStatusStatefulPerInstanceConfigs": { + "id": "InstanceGroupManagerStatusStatefulPerInstanceConfigs", + "type": "object", + "properties": { + "allEffective": { + "description": "A bit indicating if all of the group's per-instance configurations (listed in the output of a listPerInstanceConfigs API call) have status EFFECTIVE or there are no per-instance-configs.", + "type": "boolean" + } + } + }, + "InstanceGroupManagerInstanceFlexibilityPolicy": { + "id": "InstanceGroupManagerInstanceFlexibilityPolicy", + "type": "object", + "properties": { + "instanceSelections": { + "description": "Named instance selections configuring properties that the group will use when creating new VMs.", + "type": "object", + "additionalProperties": { + "$ref": "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection" + } + } + } + }, + "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection": { + "id": "InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection", + "type": "object", + "properties": { + "machineTypes": { + "description": "Full machine-type names, e.g. \"n1-standard-16\".", + "type": "array", + "items": { + "type": "string" + } + }, + "rank": { + "description": "Preference of this instance selection. Lower number means higher preference. MIG will first try to create a VM based on the machine-type with lowest rank and fallback to next rank based on availability. Machine types and instance selections with the same rank have the same preference.", + "type": "integer", + "format": "int32" + } + } + }, + "InstanceGroupManagerAutoHealingPolicy": { + "id": "InstanceGroupManagerAutoHealingPolicy", + "type": "object", + "properties": { + "healthCheck": { + "description": "The URL for the health check that signals autohealing.", + "type": "string" + }, + "initialDelaySec": { + "description": "The initial delay is the number of seconds that a new VM takes to initialize and run its startup script. During a VM's initial delay period, the MIG ignores unsuccessful health checks because the VM might be in the startup process. This prevents the MIG from prematurely recreating a VM. If the health check receives a healthy response during the initial delay, it indicates that the startup process is complete and the VM is ready. The value of initial delay must be between 0 and 3600 seconds. The default value is 0.", + "type": "integer", + "format": "int32" + } + } + }, + "InstanceGroupManagerUpdatePolicy": { + "id": "InstanceGroupManagerUpdatePolicy", + "type": "object", + "properties": { + "type": { + "description": "The type of update process. You can specify either PROACTIVE so that the MIG automatically updates VMs to the latest configurations or OPPORTUNISTIC so that you can select the VMs that you want to update.", + "type": "string", + "enumDescriptions": [ + "MIG will apply new configurations to existing VMs only when you selectively target specific or all VMs to be updated.", + "MIG will automatically apply new configurations to all or a subset of existing VMs and also to new VMs that are added to the group." ], - "description": "Stops a running instance, shutting it down cleanly, and allows you to restart the instance at a later time. Stopped instances do not incur VM usage charges while they are stopped. However, resources that the VM is using, such as persistent disks and static IP addresses, will continue to be charged until they are deleted. For more information, see Stopping an instance." + "enum": [ + "OPPORTUNISTIC", + "PROACTIVE" + ] }, - "getIamPolicy": { - "id": "compute.instances.getIamPolicy", - "path": "projects/{project}/zones/{zone}/instances/{resource}/getIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" + "instanceRedistributionType": { + "description": "The instance redistribution policy for regional managed instance groups. Valid values are: - PROACTIVE (default): The group attempts to maintain an even distribution of VM instances across zones in the region. - NONE: For non-autoscaled groups, proactive redistribution is disabled. ", + "type": "string", + "enumDescriptions": [ + "No action is being proactively performed in order to bring this IGM to its target instance distribution.", + "This IGM will actively converge to its target instance distribution." ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "NONE", + "PROACTIVE" + ] + }, + "minimalAction": { + "description": "Minimal action to be taken on an instance. Use this option to minimize disruption as much as possible or to apply a more disruptive action than is necessary. - To limit disruption as much as possible, set the minimal action to REFRESH. If your update requires a more disruptive action, Compute Engine performs the necessary action to execute the update. - To apply a more disruptive action than is strictly necessary, set the minimal action to RESTART or REPLACE. For example, Compute Engine does not need to restart a VM to change its metadata. But if your application reads instance metadata only when a VM is restarted, you can set the minimal action to RESTART in order to pick up metadata changes. ", + "type": "string", + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method option.", + "Stop the instance and start it again." ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" + ] }, - "setIamPolicy": { - "id": "compute.instances.setIamPolicy", - "path": "projects/{project}/zones/{zone}/instances/{resource}/setIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" + "mostDisruptiveAllowedAction": { + "description": "Most disruptive action that is allowed to be taken on an instance. You can specify either NONE to forbid any actions, REFRESH to avoid restarting the VM and to limit disruption as much as possible. RESTART to allow actions that can be applied without instance replacing or REPLACE to allow all possible actions. If the Updater determines that the minimal update action needed is more disruptive than most disruptive allowed action you specify it will not perform the update at all.", + "type": "string", + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method option.", + "Stop the instance and start it again." ], - "request": { - "$ref": "ZoneSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" + ] + }, + "maxSurge": { + "description": "The maximum number of instances that can be created above the specified targetSize during the update process. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxSurge is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxSurge.", + "$ref": "FixedOrPercent" + }, + "maxUnavailable": { + "description": "The maximum number of instances that can be unavailable during the update process. An instance is considered available if all of the following conditions are satisfied: - The instance's status is RUNNING. - If there is a health check on the instance group, the instance's health check status must be HEALTHY at least once. If there is no health check on the group, then the instance only needs to have a status of RUNNING to be considered available. This value can be either a fixed number or, if the group has 10 or more instances, a percentage. If you set a percentage, the number of instances is rounded if necessary. The default value for maxUnavailable is a fixed value equal to the number of zones in which the managed instance group operates. At least one of either maxSurge or maxUnavailable must be greater than 0. Learn more about maxUnavailable.", + "$ref": "FixedOrPercent" + }, + "replacementMethod": { + "description": "What action should be used to replace instances. See minimal_action.REPLACE", + "type": "string", + "enumDescriptions": [ + "Instances will be recreated (with the same name)", + "Default option: instances will be deleted and created (with a new name)" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "enum": [ + "RECREATE", + "SUBSTITUTE" + ] + } + } + }, + "StatefulPolicy": { + "id": "StatefulPolicy", + "type": "object", + "properties": { + "preservedState": { + "$ref": "StatefulPolicyPreservedState" + } + } + }, + "StatefulPolicyPreservedState": { + "id": "StatefulPolicyPreservedState", + "description": "Configuration of preserved resources.", + "type": "object", + "properties": { + "disks": { + "description": "Disks created on the instances that will be preserved on instance delete, update, etc. This map is keyed with the device names of the disks.", + "type": "object", + "additionalProperties": { + "$ref": "StatefulPolicyPreservedStateDiskDevice" + } }, - "testIamPermissions": { - "id": "compute.instances.testIamPermissions", - "path": "projects/{project}/zones/{zone}/instances/{resource}/testIamPermissions", - "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" + "internalIPs": { + "description": "Internal network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name.", + "type": "object", + "additionalProperties": { + "$ref": "StatefulPolicyPreservedStateNetworkIp" + } + }, + "externalIPs": { + "description": "External network IPs assigned to the instances that will be preserved on instance delete, update, etc. This map is keyed with the network interface name.", + "type": "object", + "additionalProperties": { + "$ref": "StatefulPolicyPreservedStateNetworkIp" + } + } + } + }, + "StatefulPolicyPreservedStateDiskDevice": { + "id": "StatefulPolicyPreservedStateDiskDevice", + "type": "object", + "properties": { + "autoDelete": { + "description": "These stateful disks will never be deleted during autohealing, update or VM instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "NEVER", + "ON_PERMANENT_INSTANCE_DELETION" + ] + } + } + }, + "StatefulPolicyPreservedStateNetworkIp": { + "id": "StatefulPolicyPreservedStateNetworkIp", + "type": "object", + "properties": { + "autoDelete": { + "description": "These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Returns permissions that a caller has on the specified resource." - }, - "setServiceAccount": { - "id": "compute.instances.setServiceAccount", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setServiceAccount", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setServiceAccount", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance resource to start.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" + "enum": [ + "NEVER", + "ON_PERMANENT_INSTANCE_DELETION" + ] + } + } + }, + "InstanceGroupManagerInstanceLifecyclePolicy": { + "id": "InstanceGroupManagerInstanceLifecyclePolicy", + "type": "object", + "properties": { + "forceUpdateOnRepair": { + "description": "A bit indicating whether to forcefully apply the group's latest configuration when repairing a VM. Valid options are: - NO (default): If configuration updates are available, they are not forcefully applied during repair. Instead, configuration updates are applied according to the group's update policy. - YES: If configuration updates are available, they are applied during repair. ", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "request": { - "$ref": "InstancesSetServiceAccountRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "NO", + "YES" + ] + }, + "defaultActionOnFailure": { + "description": "The action that a MIG performs on a failed or an unhealthy VM. A VM is marked as unhealthy when the application running on that VM fails a health check. Valid values are - REPAIR (default): MIG automatically repairs a failed or an unhealthy VM by recreating it. For more information, see About repairing VMs in a MIG. - DO_NOTHING: MIG does not repair a failed or an unhealthy VM. ", + "type": "string", + "enumDescriptions": [ + "MIG does not repair a failed or an unhealthy VM.", + "(Default) MIG automatically repairs a failed or an unhealthy VM by recreating it. For more information, see About repairing VMs in a MIG." ], - "description": "Sets the service account on the instance. For more information, read Changing the service account and access scopes for an instance." + "enum": [ + "DO_NOTHING", + "REPAIR" + ] + } + } + }, + "InstanceGroupManagerAggregatedList": { + "id": "InstanceGroupManagerAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#instanceGroupManagerAggregatedList for an aggregated list of managed instance groups.", + "default": "compute#instanceGroupManagerAggregatedList", + "type": "string" }, - "setDeletionProtection": { - "id": "compute.instances.setDeletionProtection", - "path": "projects/{project}/zones/{zone}/instances/{resource}/setDeletionProtection", - "flatPath": "projects/{project}/zones/{zone}/instances/{resource}/setDeletionProtection", - "httpMethod": "POST", - "parameters": { - "deletionProtection": { - "description": "Whether the resource should be protected against deletion.", - "default": "true", - "location": "query", - "type": "boolean" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InstanceGroupManagersScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] The name of the scope that contains this set of managed instance groups.", + "$ref": "InstanceGroupManagersScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets deletion protection on the instance." + } }, - "suspend": { - "id": "compute.instances.suspend", - "path": "projects/{project}/zones/{zone}/instances/{instance}/suspend", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/suspend", - "httpMethod": "POST", - "parameters": { - "discardLocalSsd": { - "description": "This property is required if the instance has any attached Local SSD disks. If false, Local SSD data will be preserved when the instance is suspended. If true, the contents of any attached Local SSD disks will be discarded.", - "location": "query", - "type": "boolean" - }, - "instance": { - "description": "Name of the instance resource to suspend.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "InstanceGroupManagersScopedList": { + "id": "InstanceGroupManagersScopedList", + "type": "object", + "properties": { + "instanceGroupManagers": { + "description": "[Output Only] The list of managed instance groups that are contained in the specified project and zone.", + "type": "array", + "items": { + "$ref": "InstanceGroupManager" + } + }, + "warning": { + "description": "[Output Only] The warning that replaces the list of managed instance groups when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + } + } + } + }, + "InstanceGroupManagersDeleteInstancesRequest": { + "id": "InstanceGroupManagersDeleteInstancesRequest", + "type": "object", + "properties": { + "instances": { + "description": "The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. Queued instances do not have URL and can be deleted only by name. One cannot specify both URLs and names in a single request.", + "type": "array", + "items": { + "type": "string" + } + }, + "skipInstancesOnValidationError": { + "description": "Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region.", + "type": "boolean" + } + } + }, + "InstanceGroupManagersAbandonInstancesRequest": { + "id": "InstanceGroupManagersAbandonInstancesRequest", + "type": "object", + "properties": { + "instances": { + "description": "The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "InstanceGroupManagersRecreateInstancesRequest": { + "id": "InstanceGroupManagersRecreateInstancesRequest", + "type": "object", + "properties": { + "instances": { + "description": "The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "InstanceGroupManagersSetInstanceTemplateRequest": { + "id": "InstanceGroupManagersSetInstanceTemplateRequest", + "type": "object", + "properties": { + "instanceTemplate": { + "description": "The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.", + "type": "string" + } + } + }, + "InstanceGroupManagersSetTargetPoolsRequest": { + "id": "InstanceGroupManagersSetTargetPoolsRequest", + "type": "object", + "properties": { + "targetPools": { + "description": "The list of target pool URLs that instances in this managed instance group belong to. The managed instance group applies these target pools to all of the instances in the group. Existing instances and new instances in the group all receive these target pool settings.", + "type": "array", + "items": { + "type": "string" + } + }, + "fingerprint": { + "description": "The fingerprint of the target pools information. Use this optional property to prevent conflicts when multiple users change the target pools settings concurrently. Obtain the fingerprint with the instanceGroupManagers.get method. Then, include the fingerprint in your request to ensure that you do not overwrite changes that were applied from another concurrent request.", + "type": "string", + "format": "byte" + } + } + }, + "InstanceGroupManagersListManagedInstancesResponse": { + "id": "InstanceGroupManagersListManagedInstancesResponse", + "type": "object", + "properties": { + "managedInstances": { + "description": "[Output Only] The list of instances in the managed instance group.", + "type": "array", + "items": { + "$ref": "ManagedInstance" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + } + } + }, + "ManagedInstance": { + "id": "ManagedInstance", + "description": "A Managed Instance resource.", + "type": "object", + "properties": { + "name": { + "description": "[Output Only] The name of the instance. The name always exists even if the instance has not yet been created.", + "type": "string" + }, + "instance": { + "description": "[Output Only] The URL of the instance. The URL can exist even if the instance has not yet been created.", + "type": "string" + }, + "id": { + "description": "[Output only] The unique identifier for this resource. This field is empty when instance does not exist.", + "type": "string", + "format": "uint64" + }, + "instanceStatus": { + "description": "[Output Only] The status of the instance. This field is empty when the instance does not exist.", + "type": "string", + "enumDescriptions": [ + "The instance is halted and we are performing tear down tasks like network deprogramming, releasing quota, IP, tearing down disks etc.", + "Resources are being allocated for the instance.", + "The instance is in repair.", + "The instance is running.", + "All required resources have been allocated and the instance is being started.", + "The instance has stopped successfully.", + "The instance is currently stopping (either being deleted or killed).", + "The instance has suspended.", + "The instance is suspending.", + "The instance has stopped (either by explicit action or underlying failure)." ], - "description": "This method suspends a running instance, saving its state to persistent storage, and allows you to resume the instance at a later time. Suspended instances have no compute costs (cores or RAM), and incur only storage charges for the saved VM memory and localSSD data. Any charged resources the virtual machine was using, such as persistent disks and static IP addresses, will continue to be charged while the instance is suspended. For more information, see Suspending and resuming an instance." + "enum": [ + "DEPROVISIONING", + "PROVISIONING", + "REPAIRING", + "RUNNING", + "STAGING", + "STOPPED", + "STOPPING", + "SUSPENDED", + "SUSPENDING", + "TERMINATED" + ] }, - "resume": { - "id": "compute.instances.resume", - "path": "projects/{project}/zones/{zone}/instances/{instance}/resume", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/resume", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the instance resource to resume.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" + "version": { + "description": "[Output Only] Intended version of this instance.", + "$ref": "ManagedInstanceVersion" + }, + "preservedStateFromPolicy": { + "description": "[Output Only] Preserved state generated based on stateful policy for this instance.", + "$ref": "PreservedState" + }, + "preservedStateFromConfig": { + "description": "[Output Only] Preserved state applied from per-instance config for this instance.", + "$ref": "PreservedState" + }, + "currentAction": { + "description": "[Output Only] The current action that the managed instance group has scheduled for the instance. Possible values: - NONE The instance is running, and the managed instance group does not have any scheduled actions for this instance. - CREATING The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased instead. - RECREATING The managed instance group is recreating this instance. - DELETING The managed instance group is permanently deleting this instance. - ABANDONING The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. - RESTARTING The managed instance group is restarting the instance. - REFRESHING The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. - VERIFYING The managed instance group has created the instance and it is in the process of being verified. ", + "type": "string", + "enumDescriptions": [ + "The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group.", + "The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful.", + "The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased.", + "The managed instance group is permanently deleting this instance.", + "The managed instance group has not scheduled any actions for this instance.", + "The managed instance group is recreating this instance.", + "The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance.", + "The managed instance group is restarting this instance.", + "The managed instance group is resuming this instance.", + "The managed instance group is starting this instance.", + "The managed instance group is stopping this instance.", + "The managed instance group is suspending this instance.", + "The managed instance group is verifying this already created instance. Verification happens every time the instance is (re)created or restarted and consists of: 1. Waiting until health check specified as part of this managed instance group's autohealing policy reports HEALTHY. Note: Applies only if autohealing policy has a health check specified 2. Waiting for addition verification steps performed as post-instance creation (subject to future extensions)." ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ABANDONING", + "CREATING", + "CREATING_WITHOUT_RETRIES", + "DELETING", + "NONE", + "RECREATING", + "REFRESHING", + "RESTARTING", + "RESUMING", + "STARTING", + "STOPPING", + "SUSPENDING", + "VERIFYING" + ] + }, + "instanceHealth": { + "description": "[Output Only] Health state of the instance per health-check.", + "type": "array", + "items": { + "$ref": "ManagedInstanceInstanceHealth" + } + }, + "lastAttempt": { + "description": "[Output Only] Information about the last attempt to create or delete the instance.", + "$ref": "ManagedInstanceLastAttempt" + }, + "propertiesFromFlexibilityPolicy": { + "description": "[Output Only] Instance properties selected for this instance resulting from InstanceFlexibilityPolicy.", + "$ref": "ManagedInstancePropertiesFromFlexibilityPolicy" + } + } + }, + "ManagedInstanceVersion": { + "id": "ManagedInstanceVersion", + "type": "object", + "properties": { + "name": { + "description": "[Output Only] Name of the version.", + "type": "string" + }, + "instanceTemplate": { + "description": "[Output Only] The intended template of the instance. This field is empty when current_action is one of { DELETING, ABANDONING }.", + "type": "string" + } + } + }, + "PreservedState": { + "id": "PreservedState", + "description": "Preserved state for a given instance.", + "type": "object", + "properties": { + "disks": { + "description": "Preserved disks defined for this instance. This map is keyed with the device names of the disks.", + "type": "object", + "additionalProperties": { + "$ref": "PreservedStatePreservedDisk" + } + }, + "metadata": { + "description": "Preserved metadata defined for this instance.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "internalIPs": { + "description": "Preserved internal IPs defined for this instance. This map is keyed with the name of the network interface.", + "type": "object", + "additionalProperties": { + "$ref": "PreservedStatePreservedNetworkIp" + } + }, + "externalIPs": { + "description": "Preserved external IPs defined for this instance. This map is keyed with the name of the network interface.", + "type": "object", + "additionalProperties": { + "$ref": "PreservedStatePreservedNetworkIp" + } + } + } + }, + "PreservedStatePreservedDisk": { + "id": "PreservedStatePreservedDisk", + "type": "object", + "properties": { + "source": { + "description": "The URL of the disk resource that is stateful and should be attached to the VM instance.", + "type": "string" + }, + "mode": { + "description": "The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.", + "type": "string", + "enumDescriptions": [ + "Attaches this disk in read-only mode. Multiple VM instances can use a disk in READ_ONLY mode at a time.", + "*[Default]* Attaches this disk in READ_WRITE mode. Only one VM instance at a time can be attached to a disk in READ_WRITE mode." ], - "description": "Resumes an instance that was suspended using the instances().suspend method." + "enum": [ + "READ_ONLY", + "READ_WRITE" + ] }, - "addResourcePolicies": { - "id": "compute.instances.addResourcePolicies", - "path": "projects/{project}/zones/{zone}/instances/{instance}/addResourcePolicies", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/addResourcePolicies", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "The instance name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" + "autoDelete": { + "description": "These stateful disks will never be deleted during autohealing, update, instance recreate operations. This flag is used to configure if the disk should be deleted after it is no longer used by the group, e.g. when the given instance or the whole MIG is deleted. Note: disks attached in READ_ONLY mode cannot be auto-deleted.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "request": { - "$ref": "InstancesAddResourcePoliciesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "NEVER", + "ON_PERMANENT_INSTANCE_DELETION" + ] + } + } + }, + "PreservedStatePreservedNetworkIp": { + "id": "PreservedStatePreservedNetworkIp", + "type": "object", + "properties": { + "autoDelete": { + "description": "These stateful IPs will never be released during autohealing, update or VM instance recreate operations. This flag is used to configure if the IP reservation should be deleted after it is no longer used by the group, e.g. when the given instance or the whole group is deleted.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Adds existing resource policies to an instance. You can only add one policy right now which will be applied to this instance for scheduling live migrations." + "enum": [ + "NEVER", + "ON_PERMANENT_INSTANCE_DELETION" + ] }, - "removeResourcePolicies": { - "id": "compute.instances.removeResourcePolicies", - "path": "projects/{project}/zones/{zone}/instances/{instance}/removeResourcePolicies", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/removeResourcePolicies", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "The instance name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" + "ipAddress": { + "description": "Ip address representation", + "$ref": "PreservedStatePreservedNetworkIpIpAddress" + } + } + }, + "PreservedStatePreservedNetworkIpIpAddress": { + "id": "PreservedStatePreservedNetworkIpIpAddress", + "type": "object", + "properties": { + "literal": { + "description": "An IPv4 internal network address to assign to the instance for this network interface.", + "type": "string" + }, + "address": { + "description": "The URL of the reservation for this IP address.", + "type": "string" + } + } + }, + "ManagedInstanceInstanceHealth": { + "id": "ManagedInstanceInstanceHealth", + "type": "object", + "properties": { + "healthCheck": { + "description": "[Output Only] The URL for the health check that verifies whether the instance is healthy.", + "type": "string" + }, + "detailedHealthState": { + "description": "[Output Only] The current detailed instance health state.", + "type": "string", + "enumDescriptions": [ + "The instance is being drained. The existing connections to the instance have time to complete, but the new ones are being refused.", + "The instance is reachable i.e. a connection to the application health checking endpoint can be established, and conforms to the requirements defined by the health check.", + "The instance is unreachable i.e. a connection to the application health checking endpoint cannot be established, or the server does not respond within the specified timeout.", + "The instance is reachable, but does not conform to the requirements defined by the health check.", + "The health checking system is aware of the instance but its health is not known at the moment." ], - "request": { - "$ref": "InstancesRemoveResourcePoliciesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "DRAINING", + "HEALTHY", + "TIMEOUT", + "UNHEALTHY", + "UNKNOWN" + ] + } + } + }, + "ManagedInstanceLastAttempt": { + "id": "ManagedInstanceLastAttempt", + "type": "object", + "properties": { + "errors": { + "description": "[Output Only] Encountered errors during the last attempt to create or delete the instance.", + "type": "object", + "properties": { + "errors": { + "description": "[Output Only] The array of errors encountered while processing this operation.", + "type": "array", + "items": { + "type": "object", + "properties": { + "code": { + "description": "[Output Only] The error type identifier for this error.", + "type": "string" + }, + "location": { + "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", + "type": "string" + }, + "message": { + "description": "[Output Only] An optional, human-readable error message.", + "type": "string" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", + "type": "array", + "items": { + "type": "object", + "properties": { + "errorInfo": { + "$ref": "ErrorInfo" + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo" + }, + "help": { + "$ref": "Help" + }, + "localizedMessage": { + "$ref": "LocalizedMessage" + } + } + } + } + } + } + } + } + } + } + }, + "ManagedInstancePropertiesFromFlexibilityPolicy": { + "id": "ManagedInstancePropertiesFromFlexibilityPolicy", + "type": "object", + "properties": { + "machineType": { + "description": "The machine type to be used for this instance.", + "type": "string" + } + } + }, + "InstanceGroupManagersListErrorsResponse": { + "id": "InstanceGroupManagersListErrorsResponse", + "type": "object", + "properties": { + "items": { + "description": "[Output Only] The list of errors of the managed instance group.", + "type": "array", + "items": { + "$ref": "InstanceManagedByIgmError" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + } + } + }, + "InstanceManagedByIgmError": { + "id": "InstanceManagedByIgmError", + "type": "object", + "properties": { + "error": { + "description": "[Output Only] Contents of the error.", + "$ref": "InstanceManagedByIgmErrorManagedInstanceError" + }, + "timestamp": { + "description": "[Output Only] The time that this error occurred. This value is in RFC3339 text format.", + "type": "string" + }, + "instanceActionDetails": { + "description": "[Output Only] Details of the instance action that triggered this error. May be null, if the error was not caused by an action on an instance. This field is optional.", + "$ref": "InstanceManagedByIgmErrorInstanceActionDetails" + } + } + }, + "InstanceManagedByIgmErrorManagedInstanceError": { + "id": "InstanceManagedByIgmErrorManagedInstanceError", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] Error code.", + "type": "string" + }, + "message": { + "description": "[Output Only] Error message.", + "type": "string" + } + } + }, + "InstanceManagedByIgmErrorInstanceActionDetails": { + "id": "InstanceManagedByIgmErrorInstanceActionDetails", + "type": "object", + "properties": { + "action": { + "description": "[Output Only] Action that managed instance group was executing on the instance when the error occurred. Possible values:", + "type": "string", + "enumDescriptions": [ + "The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group.", + "The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful.", + "The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased.", + "The managed instance group is permanently deleting this instance.", + "The managed instance group has not scheduled any actions for this instance.", + "The managed instance group is recreating this instance.", + "The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance.", + "The managed instance group is restarting this instance.", + "The managed instance group is resuming this instance.", + "The managed instance group is starting this instance.", + "The managed instance group is stopping this instance.", + "The managed instance group is suspending this instance.", + "The managed instance group is verifying this already created instance. Verification happens every time the instance is (re)created or restarted and consists of: 1. Waiting until health check specified as part of this managed instance group's autohealing policy reports HEALTHY. Note: Applies only if autohealing policy has a health check specified 2. Waiting for addition verification steps performed as post-instance creation (subject to future extensions)." ], - "description": "Removes resource policies from an instance." + "enum": [ + "ABANDONING", + "CREATING", + "CREATING_WITHOUT_RETRIES", + "DELETING", + "NONE", + "RECREATING", + "REFRESHING", + "RESTARTING", + "RESUMING", + "STARTING", + "STOPPING", + "SUSPENDING", + "VERIFYING" + ] }, - "update": { - "id": "compute.instances.update", - "path": "projects/{project}/zones/{zone}/instances/{instance}", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}", - "httpMethod": "PUT", - "parameters": { - "instance": { - "description": "Name of the instance resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "minimalAction": { - "description": "Specifies the action to take when updating an instance even if the updated properties do not require it. If not specified, then Compute Engine acts based on the minimum action that the updated properties require.", - "location": "query", + "instance": { + "description": "[Output Only] The URL of the instance. The URL can be set even if the instance has not yet been created.", + "type": "string" + }, + "version": { + "description": "[Output Only] Version this instance was created from, or was being created from, but the creation failed. Corresponds to one of the versions that were set on the Instance Group Manager resource at the time this instance was being created.", + "$ref": "ManagedInstanceVersion" + } + } + }, + "InstanceGroupManagersListPerInstanceConfigsResp": { + "id": "InstanceGroupManagersListPerInstanceConfigsResp", + "type": "object", + "properties": { + "items": { + "description": "[Output Only] The list of PerInstanceConfig.", + "type": "array", + "items": { + "$ref": "PerInstanceConfig" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", "type": "string", "enumDescriptions": [ - "", - "No changes can be made to the instance.", - "The instance will not restart.", - "The instance will restart." + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." ], - "enum": [ - "INVALID", - "NO_EFFECT", - "REFRESH", - "RESTART" - ] - }, - "mostDisruptiveAllowedAction": { - "description": "Specifies the most disruptive action that can be taken on the instance as part of the update. Compute Engine returns an error if the instance properties require a more disruptive action as part of the instance update. Valid options from lowest to highest are NO_EFFECT, REFRESH, and RESTART.", - "location": "query", - "type": "string", - "enumDescriptions": [ - "", - "No changes can be made to the instance.", - "The instance will not restart.", - "The instance will restart." + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false ], "enum": [ - "INVALID", - "NO_EFFECT", - "REFRESH", - "RESTART" + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "Instance" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates an instance only if the necessary resources are available. This method can update only a specific set of instance properties. See Updating a running instance for a list of updatable instance properties." - }, - "updateShieldedInstanceConfig": { - "id": "compute.instances.updateShieldedInstanceConfig", - "path": "projects/{project}/zones/{zone}/instances/{instance}/updateShieldedInstanceConfig", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateShieldedInstanceConfig", - "httpMethod": "PATCH", - "parameters": { - "instance": { - "description": "Name or id of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "ShieldedInstanceConfig" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the Shielded Instance config for an instance. You can only use this method on a stopped instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + } + } + } + }, + "PerInstanceConfig": { + "id": "PerInstanceConfig", + "type": "object", + "properties": { + "name": { + "description": "The name of a per-instance configuration and its corresponding instance. Serves as a merge key during UpdatePerInstanceConfigs operations, that is, if a per-instance configuration with the same name exists then it will be updated, otherwise a new one will be created for the VM instance with the same name. An attempt to create a per-instance configconfiguration for a VM instance that either doesn't exist or is not part of the group will result in an error.", + "type": "string" }, - "updateDisplayDevice": { - "id": "compute.instances.updateDisplayDevice", - "path": "projects/{project}/zones/{zone}/instances/{instance}/updateDisplayDevice", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/updateDisplayDevice", - "httpMethod": "PATCH", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "DisplayDevice" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the Display config for a VM instance. You can only use this method on a stopped VM instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + "preservedState": { + "description": "The intended preserved state for the given instance. Does not contain preserved state generated from a stateful policy.", + "$ref": "PreservedState" }, - "setShieldedInstanceIntegrityPolicy": { - "id": "compute.instances.setShieldedInstanceIntegrityPolicy", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setShieldedInstanceIntegrityPolicy", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setShieldedInstanceIntegrityPolicy", - "httpMethod": "PATCH", - "parameters": { - "instance": { - "description": "Name or id of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "ShieldedInstanceIntegrityPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "status": { + "description": "The status of applying this per-instance configuration on the corresponding managed instance.", + "type": "string", + "enumDescriptions": [ + "The per-instance configuration is being applied to the instance, but is not yet effective, possibly waiting for the instance to, for example, REFRESH.", + "The per-instance configuration deletion is being applied on the instance, possibly waiting for the instance to, for example, REFRESH.", + "The per-instance configuration is effective on the instance, meaning that all disks, ips and metadata specified in this configuration are attached or set on the instance.", + "*[Default]* The default status, when no per-instance configuration exists.", + "The per-instance configuration is set on an instance but not been applied yet.", + "The per-instance configuration has been deleted, but the deletion is not yet applied." ], - "description": "Sets the Shielded Instance integrity policy for an instance. You can only use this method on a running instance. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + "enum": [ + "APPLYING", + "DELETING", + "EFFECTIVE", + "NONE", + "UNAPPLIED", + "UNAPPLIED_DELETION" + ] }, - "setSecurityPolicy": { - "id": "compute.instances.setSecurityPolicy", - "path": "projects/{project}/zones/{zone}/instances/{instance}/setSecurityPolicy", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/setSecurityPolicy", - "httpMethod": "POST", - "parameters": { - "instance": { - "description": "Name of the Instance resource to which the security policy should be set. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "Name of the zone scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "request": { - "$ref": "InstancesSetSecurityPolicyRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the Google Cloud Armor security policy for the specified instance. For more information, see Google Cloud Armor Overview" + "fingerprint": { + "description": "Fingerprint of this per-instance config. This field can be used in optimistic locking. It is ignored when inserting a per-instance config. An up-to-date fingerprint must be provided in order to update an existing per-instance configuration or the field needs to be unset.", + "type": "string", + "format": "byte" + } + } + }, + "InstanceGroupManagersUpdatePerInstanceConfigsReq": { + "id": "InstanceGroupManagersUpdatePerInstanceConfigsReq", + "description": "InstanceGroupManagers.updatePerInstanceConfigs", + "type": "object", + "properties": { + "perInstanceConfigs": { + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", + "type": "array", + "items": { + "$ref": "PerInstanceConfig" + } + } + } + }, + "InstanceGroupManagersPatchPerInstanceConfigsReq": { + "id": "InstanceGroupManagersPatchPerInstanceConfigsReq", + "description": "InstanceGroupManagers.patchPerInstanceConfigs", + "type": "object", + "properties": { + "perInstanceConfigs": { + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", + "type": "array", + "items": { + "$ref": "PerInstanceConfig" + } + } + } + }, + "InstanceGroupManagersDeletePerInstanceConfigsReq": { + "id": "InstanceGroupManagersDeletePerInstanceConfigsReq", + "description": "InstanceGroupManagers.deletePerInstanceConfigs", + "type": "object", + "properties": { + "names": { + "description": "The list of instance names for which we want to delete per-instance configs on this managed instance group.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "InstanceGroupManagersApplyUpdatesRequest": { + "id": "InstanceGroupManagersApplyUpdatesRequest", + "description": "InstanceGroupManagers.applyUpdatesToInstances", + "type": "object", + "properties": { + "instances": { + "description": "The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "type": "array", + "items": { + "type": "string" + } }, - "getShieldedInstanceIdentity": { - "id": "compute.instances.getShieldedInstanceIdentity", - "path": "projects/{project}/zones/{zone}/instances/{instance}/getShieldedInstanceIdentity", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getShieldedInstanceIdentity", - "httpMethod": "GET", - "parameters": { - "instance": { - "description": "Name or id of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance" - ], - "response": { - "$ref": "ShieldedInstanceIdentity" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "minimalAction": { + "description": "The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update.", + "type": "string", + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method option.", + "Stop the instance and start it again." ], - "description": "Returns the Shielded Instance Identity of an instance" + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" + ] }, - "bulkInsert": { - "id": "compute.instances.bulkInsert", - "path": "projects/{project}/zones/{zone}/instances/bulkInsert", - "flatPath": "projects/{project}/zones/{zone}/instances/bulkInsert", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "BulkInsertInstanceResource" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "mostDisruptiveAllowedAction": { + "description": "The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail.", + "type": "string", + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method option.", + "Stop the instance and start it again." ], - "description": "Creates multiple instances. Count specifies the number of instances to create. For more information, see About bulk creation of VMs." + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" + ] }, - "getEffectiveFirewalls": { - "id": "compute.instances.getEffectiveFirewalls", - "path": "projects/{project}/zones/{zone}/instances/{instance}/getEffectiveFirewalls", - "flatPath": "projects/{project}/zones/{zone}/instances/{instance}/getEffectiveFirewalls", - "httpMethod": "GET", - "parameters": { - "instance": { - "description": "Name of the instance scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "networkInterface": { - "description": "The name of the network interface to get the effective firewalls.", - "location": "query", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instance", - "networkInterface" - ], - "response": { - "$ref": "InstancesGetEffectiveFirewallsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns effective firewalls applied to an interface of the instance." + "allInstances": { + "description": "Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request.", + "type": "boolean" + } + } + }, + "InstanceGroupManagersCreateInstancesRequest": { + "id": "InstanceGroupManagersCreateInstancesRequest", + "description": "InstanceGroupManagers.createInstances", + "type": "object", + "properties": { + "instances": { + "description": "[Required] List of specifications of per-instance configs.", + "type": "array", + "items": { + "$ref": "PerInstanceConfig" + } } } }, - "regionInstances": { - "methods": { - "bulkInsert": { - "id": "compute.regionInstances.bulkInsert", - "path": "projects/{project}/regions/{region}/instances/bulkInsert", - "flatPath": "projects/{project}/regions/{region}/instances/bulkInsert", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "BulkInsertInstanceResource" - }, - "response": { - "$ref": "Operation" + "InstanceGroupManagerResizeRequest": { + "id": "InstanceGroupManagerResizeRequest", + "description": "InstanceGroupManagerResizeRequest represents a request to create a number of VMs: either immediately or by queuing the request for the specified time. This resize request is nested under InstanceGroupManager and the VMs created by this request are added to the owning InstanceGroupManager.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#instanceGroupManagerResizeRequest for resize requests.", + "default": "compute#instanceGroupManagerResizeRequest", + "type": "string" + }, + "id": { + "description": "[Output Only] A unique identifier for this resource type. The server generates this identifier.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] The creation timestamp for this resize request in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "The name of this resize request. The name must be 1-63 characters long, and comply with RFC1035.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "annotations": { + "required": [ + "compute.instanceGroupManagerResizeRequests.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "string" + }, + "description": { + "description": "An optional description of this resource.", + "type": "string" + }, + "zone": { + "description": "[Output Only] The URL of a zone where the resize request is located. Populated only for zonal resize requests.", + "type": "string" + }, + "resizeBy": { + "description": "The number of instances to be created by this resize request. The group's target size will be increased by this number. This field cannot be used together with 'instances'.", + "type": "integer", + "format": "int32" + }, + "requestedRunDuration": { + "description": "Requested run duration for instances that will be created by this request. At the end of the run duration instance will be deleted.", + "$ref": "Duration" + }, + "state": { + "description": "[Output only] Current state of the request.", + "type": "string", + "enumDescriptions": [ + "The request was created successfully and was accepted for provisioning when the capacity becomes available.", + "The request is cancelled.", + "Resize request is being created and may still fail creation.", + "The request failed before or during provisioning. If the request fails during provisioning, any VMs that were created during provisioning are rolled back and removed from the MIG.", + "Default value. This value should never be returned.", + "The request succeeded." ], - "description": "Creates multiple instances in a given region. Count specifies the number of instances to create." + "enum": [ + "ACCEPTED", + "CANCELLED", + "CREATING", + "FAILED", + "STATE_UNSPECIFIED", + "SUCCEEDED" + ] + }, + "status": { + "description": "[Output only] Status of the request.", + "$ref": "InstanceGroupManagerResizeRequestStatus" + }, + "selfLink": { + "description": "[Output Only] The URL for this resize request. The server defines this URL.", + "type": "string" + }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource with the resource id.", + "type": "string" } } }, - "reservations": { - "methods": { - "list": { - "id": "compute.reservations.list", - "path": "projects/{project}/zones/{zone}/reservations", - "flatPath": "projects/{project}/zones/{zone}/reservations", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "InstanceGroupManagerResizeRequestStatus": { + "id": "InstanceGroupManagerResizeRequestStatus", + "type": "object", + "properties": { + "error": { + "description": "[Output only] Fatal errors encountered during the queueing or provisioning phases of the ResizeRequest that caused the transition to the FAILED state. Contrary to the last_attempt errors, this field is final and errors are never removed from here, as the ResizeRequest is not going to retry.", + "type": "object", + "properties": { + "errors": { + "description": "[Output Only] The array of errors encountered while processing this operation.", + "type": "array", + "items": { + "type": "object", + "properties": { + "code": { + "description": "[Output Only] The error type identifier for this error.", + "type": "string" + }, + "location": { + "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", + "type": "string" + }, + "message": { + "description": "[Output Only] An optional, human-readable error message.", + "type": "string" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", + "type": "array", + "items": { + "type": "object", + "properties": { + "errorInfo": { + "$ref": "ErrorInfo" + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo" + }, + "help": { + "$ref": "Help" + }, + "localizedMessage": { + "$ref": "LocalizedMessage" + } + } + } + } + } + } } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "ReservationList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "A list of all the reservations that have been configured for the specified project in specified zone." + } }, - "aggregatedList": { - "id": "compute.reservations.aggregatedList", - "path": "projects/{project}/aggregated/reservations", - "flatPath": "projects/{project}/aggregated/reservations", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "lastAttempt": { + "description": "[Output only] Information about the last attempt to fulfill the request. The value is temporary since the ResizeRequest can retry, as long as it's still active and the last attempt value can either be cleared or replaced with a different error. Since ResizeRequest retries infrequently, the value may be stale and no longer show an active problem. The value is cleared when ResizeRequest transitions to the final state (becomes inactive). If the final state is FAILED the error describing it will be storred in the \"error\" field only.", + "$ref": "InstanceGroupManagerResizeRequestStatusLastAttempt" + } + } + }, + "InstanceGroupManagerResizeRequestStatusLastAttempt": { + "id": "InstanceGroupManagerResizeRequestStatusLastAttempt", + "type": "object", + "properties": { + "error": { + "description": "Errors that prevented the ResizeRequest to be fulfilled.", + "type": "object", + "properties": { + "errors": { + "description": "[Output Only] The array of errors encountered while processing this operation.", + "type": "array", + "items": { + "type": "object", + "properties": { + "code": { + "description": "[Output Only] The error type identifier for this error.", + "type": "string" + }, + "location": { + "description": "[Output Only] Indicates the field in the request that caused the error. This property is optional.", + "type": "string" + }, + "message": { + "description": "[Output Only] An optional, human-readable error message.", + "type": "string" + }, + "errorDetails": { + "description": "[Output Only] An optional list of messages that contain the error details. There is a set of defined message types to use for providing details.The syntax depends on the error code. For example, QuotaExceededInfo will have details when the error code is QUOTA_EXCEEDED.", + "type": "array", + "items": { + "type": "object", + "properties": { + "errorInfo": { + "$ref": "ErrorInfo" + }, + "quotaInfo": { + "$ref": "QuotaExceededInfo" + }, + "help": { + "$ref": "Help" + }, + "localizedMessage": { + "$ref": "LocalizedMessage" + } + } + } + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ReservationAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of reservations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + } + } + } + }, + "InstanceGroupManagerResizeRequestsListResponse": { + "id": "InstanceGroupManagerResizeRequestsListResponse", + "description": "[Output Only] A list of resize requests.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#instanceGroupManagerResizeRequestList for a list of resize requests.", + "default": "compute#instanceGroupManagerResizeRequestList", + "type": "string" }, - "get": { - "id": "compute.reservations.get", - "path": "projects/{project}/zones/{zone}/reservations/{reservation}", - "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "reservation": { - "description": "Name of the reservation to retrieve.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "reservation" - ], - "response": { - "$ref": "Reservation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves information about the specified reservation." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.reservations.insert", - "path": "projects/{project}/zones/{zone}/reservations", - "flatPath": "projects/{project}/zones/{zone}/reservations", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of resize request resources.", + "type": "array", + "items": { + "$ref": "InstanceGroupManagerResizeRequest" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "Reservation" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a new reservation. For more information, read Reserving zonal resources." + } + } + } + }, + "RegionInstanceGroupManagerList": { + "id": "RegionInstanceGroupManagerList", + "description": "Contains a list of managed instance groups.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#instanceGroupManagerList for a list of managed instance groups that exist in th regional scope.", + "default": "compute#regionInstanceGroupManagerList", + "type": "string" }, - "delete": { - "id": "compute.reservations.delete", - "path": "projects/{project}/zones/{zone}/reservations/{reservation}", - "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "reservation": { - "description": "Name of the reservation to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "reservation" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified reservation." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "resize": { - "id": "compute.reservations.resize", - "path": "projects/{project}/zones/{zone}/reservations/{reservation}/resize", - "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}/resize", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "items": { + "description": "A list of InstanceGroupManager resources.", + "type": "array", + "items": { + "$ref": "InstanceGroupManager" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "reservation": { - "description": "Name of the reservation to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "reservation" - ], - "request": { - "$ref": "ReservationsResizeRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Resizes the reservation (applicable to standalone reservations only). For more information, read Modifying reservations." + } + } + } + }, + "RegionInstanceGroupManagersDeleteInstancesRequest": { + "id": "RegionInstanceGroupManagersDeleteInstancesRequest", + "type": "object", + "properties": { + "instances": { + "description": "The URLs of one or more instances to delete. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "type": "array", + "items": { + "type": "string" + } }, - "update": { - "id": "compute.reservations.update", - "path": "projects/{project}/zones/{zone}/reservations/{reservation}", - "flatPath": "projects/{project}/zones/{zone}/reservations/{reservation}", - "httpMethod": "PATCH", - "parameters": { - "paths": { - "location": "query", - "repeated": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "skipInstancesOnValidationError": { + "description": "Specifies whether the request should proceed despite the inclusion of instances that are not members of the group or that are already in the process of being deleted or abandoned. If this field is set to `false` and such an instance is specified in the request, the operation fails. The operation always fails if the request contains a malformed instance URL or a reference to an instance that exists in a zone or region other than the group's zone or region.", + "type": "boolean" + } + } + }, + "RegionInstanceGroupManagersAbandonInstancesRequest": { + "id": "RegionInstanceGroupManagersAbandonInstancesRequest", + "type": "object", + "properties": { + "instances": { + "description": "The URLs of one or more instances to abandon. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "RegionInstanceGroupManagersRecreateRequest": { + "id": "RegionInstanceGroupManagersRecreateRequest", + "type": "object", + "properties": { + "instances": { + "description": "The URLs of one or more instances to recreate. This can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "RegionInstanceGroupManagersSetTemplateRequest": { + "id": "RegionInstanceGroupManagersSetTemplateRequest", + "type": "object", + "properties": { + "instanceTemplate": { + "description": "URL of the InstanceTemplate resource from which all new instances will be created.", + "type": "string" + } + } + }, + "RegionInstanceGroupManagersSetTargetPoolsRequest": { + "id": "RegionInstanceGroupManagersSetTargetPoolsRequest", + "type": "object", + "properties": { + "targetPools": { + "description": "The URL of all TargetPool resources to which instances in the instanceGroup field are added. The target pools automatically apply to all of the instances in the managed instance group.", + "type": "array", + "items": { + "type": "string" + } + }, + "fingerprint": { + "description": "Fingerprint of the target pools information, which is a hash of the contents. This field is used for optimistic locking when you update the target pool entries. This field is optional.", + "type": "string", + "format": "byte" + } + } + }, + "RegionInstanceGroupManagersListInstancesResponse": { + "id": "RegionInstanceGroupManagersListInstancesResponse", + "type": "object", + "properties": { + "managedInstances": { + "description": "A list of managed instances.", + "type": "array", + "items": { + "$ref": "ManagedInstance" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + } + } + }, + "RegionInstanceGroupManagersListErrorsResponse": { + "id": "RegionInstanceGroupManagersListErrorsResponse", + "type": "object", + "properties": { + "items": { + "description": "[Output Only] The list of errors of the managed instance group.", + "type": "array", + "items": { + "$ref": "InstanceManagedByIgmError" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + } + } + }, + "RegionInstanceGroupManagersListInstanceConfigsResp": { + "id": "RegionInstanceGroupManagersListInstanceConfigsResp", + "type": "object", + "properties": { + "items": { + "description": "[Output Only] The list of PerInstanceConfig.", + "type": "array", + "items": { + "$ref": "PerInstanceConfig" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "reservation": { - "description": "Name of the reservation to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "updateMask": { - "description": "Update_mask indicates fields to be updated as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "reservation" + } + } + } + }, + "RegionInstanceGroupManagerUpdateInstanceConfigReq": { + "id": "RegionInstanceGroupManagerUpdateInstanceConfigReq", + "description": "RegionInstanceGroupManagers.updatePerInstanceConfigs", + "type": "object", + "properties": { + "perInstanceConfigs": { + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", + "type": "array", + "items": { + "$ref": "PerInstanceConfig" + } + } + } + }, + "RegionInstanceGroupManagerPatchInstanceConfigReq": { + "id": "RegionInstanceGroupManagerPatchInstanceConfigReq", + "description": "RegionInstanceGroupManagers.patchPerInstanceConfigs", + "type": "object", + "properties": { + "perInstanceConfigs": { + "description": "The list of per-instance configurations to insert or patch on this managed instance group.", + "type": "array", + "items": { + "$ref": "PerInstanceConfig" + } + } + } + }, + "RegionInstanceGroupManagerDeleteInstanceConfigReq": { + "id": "RegionInstanceGroupManagerDeleteInstanceConfigReq", + "description": "RegionInstanceGroupManagers.deletePerInstanceConfigs", + "type": "object", + "properties": { + "names": { + "description": "The list of instance names for which we want to delete per-instance configs on this managed instance group.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "RegionInstanceGroupManagersApplyUpdatesRequest": { + "id": "RegionInstanceGroupManagersApplyUpdatesRequest", + "description": "RegionInstanceGroupManagers.applyUpdatesToInstances", + "type": "object", + "properties": { + "instances": { + "description": "The list of URLs of one or more instances for which you want to apply updates. Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].", + "type": "array", + "items": { + "type": "string" + } + }, + "minimalAction": { + "description": "The minimal action that you want to perform on each instance during the update: - REPLACE: At minimum, delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the minimum action is NONE. If your update requires a more disruptive action than you set with this flag, the necessary action is performed to execute the update.", + "type": "string", + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method option.", + "Stop the instance and start it again." ], - "request": { - "$ref": "Reservation" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" + ] + }, + "mostDisruptiveAllowedAction": { + "description": "The most disruptive action that you want to perform on each instance during the update: - REPLACE: Delete the instance and create it again. - RESTART: Stop the instance and start it again. - REFRESH: Do not stop the instance and limit disruption as much as possible. - NONE: Do not disrupt the instance at all. By default, the most disruptive allowed action is REPLACE. If your update requires a more disruptive action than you set with this flag, the update request will fail.", + "type": "string", + "enumDescriptions": [ + "Do not perform any action.", + "Do not stop the instance.", + "(Default.) Replace the instance according to the replacement method option.", + "Stop the instance and start it again." ], - "description": "Update share settings of the reservation." + "enum": [ + "NONE", + "REFRESH", + "REPLACE", + "RESTART" + ] }, - "getIamPolicy": { - "id": "compute.reservations.getIamPolicy", - "path": "projects/{project}/zones/{zone}/reservations/{resource}/getIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "allInstances": { + "description": "Flag to update all instances instead of specified list of “instances”. If the flag is set to true then the instances may not be specified in the request.", + "type": "boolean" + } + } + }, + "RegionInstanceGroupManagersCreateInstancesRequest": { + "id": "RegionInstanceGroupManagersCreateInstancesRequest", + "description": "RegionInstanceGroupManagers.createInstances", + "type": "object", + "properties": { + "instances": { + "description": "[Required] List of specifications of per-instance configs.", + "type": "array", + "items": { + "$ref": "PerInstanceConfig" + } + } + } + }, + "AutoscalerList": { + "id": "AutoscalerList", + "description": "Contains a list of Autoscaler resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#autoscalerList for lists of autoscalers.", + "default": "compute#autoscalerList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Autoscaler resources.", + "type": "array", + "items": { + "$ref": "Autoscaler" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } + } + } + } + }, + "Autoscaler": { + "id": "Autoscaler", + "description": "Represents an Autoscaler resource. Google Compute Engine has two Autoscaler resources: * [Zonal](/compute/docs/reference/rest/v1/autoscalers) * [Regional](/compute/docs/reference/rest/v1/regionAutoscalers) Use autoscalers to automatically add or delete instances from a managed instance group according to your defined autoscaling policy. For more information, read Autoscaling Groups of Instances. For zonal managed instance groups resource, use the autoscaler resource. For regional managed instance groups, use the regionAutoscalers resource.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#autoscaler for autoscalers.", + "default": "compute#autoscaler", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.autoscalers.insert" + ] }, - "parameterOrder": [ - "project", - "zone", - "resource" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "target": { + "description": "URL of the managed instance group that this autoscaler will scale. This field is required when creating an autoscaler.", + "type": "string" + }, + "autoscalingPolicy": { + "description": "The configuration parameters for the autoscaling algorithm. You can define one or more signals for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization. If none of these are specified, the default will be to autoscale based on cpuUtilization to 0.6 or 60%.", + "$ref": "AutoscalingPolicy" + }, + "zone": { + "description": "[Output Only] URL of the zone where the instance group resides (for autoscalers living in zonal scope).", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the instance group resides (for autoscalers living in regional scope).", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the autoscaler configuration. Current set of possible values: - PENDING: Autoscaler backend hasn't read new/updated configuration. - DELETING: Configuration is being deleted. - ACTIVE: Configuration is acknowledged to be effective. Some warnings might be present in the statusDetails field. - ERROR: Configuration has errors. Actionable for users. Details are present in the statusDetails field. New values might be added in the future.", + "type": "string", + "enumDescriptions": [ + "Configuration is acknowledged to be effective", + "Configuration is being deleted", + "Configuration has errors. Actionable for users.", + "Autoscaler backend hasn't read new/updated configuration" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "ACTIVE", + "DELETING", + "ERROR", + "PENDING" + ] + }, + "statusDetails": { + "description": "[Output Only] Human-readable details about the current state of the autoscaler. Read the documentation for Commonly returned status messages for examples of status messages you might encounter.", + "type": "array", + "items": { + "$ref": "AutoscalerStatusDetails" + } + }, + "recommendedSize": { + "description": "[Output Only] Target recommended MIG size (number of instances) computed by autoscaler. Autoscaler calculates the recommended MIG size even when the autoscaling policy mode is different from ON. This field is empty when autoscaler is not connected to an existing managed instance group or autoscaler did not generate its prediction.", + "type": "integer", + "format": "int32" + }, + "scalingScheduleStatus": { + "description": "[Output Only] Status information of existing scaling schedules.", + "type": "object", + "additionalProperties": { + "$ref": "ScalingScheduleStatus" + } + } + } + }, + "AutoscalingPolicy": { + "id": "AutoscalingPolicy", + "description": "Cloud Autoscaler policy.", + "type": "object", + "properties": { + "minNumReplicas": { + "description": "The minimum number of replicas that the autoscaler can scale in to. This cannot be less than 0. If not provided, autoscaler chooses a default value depending on maximum number of instances allowed.", + "type": "integer", + "format": "int32" + }, + "maxNumReplicas": { + "description": "The maximum number of instances that the autoscaler can scale out to. This is required when creating or updating an autoscaler. The maximum number of replicas must not be lower than minimal number of replicas.", + "type": "integer", + "format": "int32" + }, + "scaleInControl": { + "$ref": "AutoscalingPolicyScaleInControl" + }, + "coolDownPeriodSec": { + "description": "The number of seconds that your application takes to initialize on a VM instance. This is referred to as the [initialization period](/compute/docs/autoscaler#cool_down_period). Specifying an accurate initialization period improves autoscaler decisions. For example, when scaling out, the autoscaler ignores data from VMs that are still initializing because those VMs might not yet represent normal usage of your application. The default initialization period is 60 seconds. Initialization periods might vary because of numerous factors. We recommend that you test how long your application takes to initialize. To do this, create a VM and time your application's startup process.", + "type": "integer", + "format": "int32" + }, + "cpuUtilization": { + "description": "Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.", + "$ref": "AutoscalingPolicyCpuUtilization" + }, + "customMetricUtilizations": { + "description": "Configuration parameters of autoscaling based on a custom metric.", + "type": "array", + "items": { + "$ref": "AutoscalingPolicyCustomMetricUtilization" + } + }, + "loadBalancingUtilization": { + "description": "Configuration parameters of autoscaling based on load balancer.", + "$ref": "AutoscalingPolicyLoadBalancingUtilization" + }, + "mode": { + "description": "Defines the operating mode for this policy. The following modes are available: - OFF: Disables the autoscaler but maintains its configuration. - ONLY_SCALE_OUT: Restricts the autoscaler to add VM instances only. - ON: Enables all autoscaler activities according to its policy. For more information, see \"Turning off or restricting an autoscaler\"", + "type": "string", + "enumDescriptions": [ + "Do not automatically scale the MIG in or out. The recommended_size field contains the size of MIG that would be set if the actuation mode was enabled.", + "Automatically scale the MIG in and out according to the policy.", + "Automatically create VMs according to the policy, but do not scale the MIG in.", + "Automatically create VMs according to the policy, but do not scale the MIG in." ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "enum": [ + "OFF", + "ON", + "ONLY_SCALE_OUT", + "ONLY_UP" + ] }, - "setIamPolicy": { - "id": "compute.reservations.setIamPolicy", - "path": "projects/{project}/zones/{zone}/reservations/{resource}/setIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "request": { - "$ref": "ZoneSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "scalingSchedules": { + "description": "Scaling schedules defined for an autoscaler. Multiple schedules can be set on an autoscaler, and they can overlap. During overlapping periods the greatest min_required_replicas of all scaling schedules is applied. Up to 128 scaling schedules are allowed.", + "type": "object", + "additionalProperties": { + "$ref": "AutoscalingPolicyScalingSchedule" + } + } + } + }, + "AutoscalingPolicyScaleInControl": { + "id": "AutoscalingPolicyScaleInControl", + "description": "Configuration that allows for slower scale in so that even if Autoscaler recommends an abrupt scale in of a MIG, it will be throttled as specified by the parameters below.", + "type": "object", + "properties": { + "maxScaledInReplicas": { + "description": "Maximum allowed number (or %) of VMs that can be deducted from the peak recommendation during the window autoscaler looks at when computing recommendations. Possibly all these VMs can be deleted at once so user service needs to be prepared to lose that many VMs in one step.", + "$ref": "FixedOrPercent" }, - "testIamPermissions": { - "id": "compute.reservations.testIamPermissions", - "path": "projects/{project}/zones/{zone}/reservations/{resource}/testIamPermissions", - "flatPath": "projects/{project}/zones/{zone}/reservations/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" + "timeWindowSec": { + "description": "How far back autoscaling looks when computing recommendations to include directives regarding slower scale in, as described above.", + "type": "integer", + "format": "int32" + } + } + }, + "AutoscalingPolicyCpuUtilization": { + "id": "AutoscalingPolicyCpuUtilization", + "description": "CPU utilization policy.", + "type": "object", + "properties": { + "utilizationTarget": { + "description": "The target CPU utilization that the autoscaler maintains. Must be a float value in the range (0, 1]. If not specified, the default is 0.6. If the CPU level is below the target utilization, the autoscaler scales in the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization. If the average CPU is above the target utilization, the autoscaler scales out until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization.", + "type": "number", + "format": "double" + }, + "predictiveMethod": { + "description": "Indicates whether predictive autoscaling based on CPU metric is enabled. Valid values are: * NONE (default). No predictive method is used. The autoscaler scales the group to meet current demand based on real-time metrics. * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves availability by monitoring daily and weekly load patterns and scaling out ahead of anticipated demand.", + "type": "string", + "enumDescriptions": [ + "No predictive method is used. The autoscaler scales the group to meet current demand based on real-time metrics", + "Predictive autoscaling improves availability by monitoring daily and weekly load patterns and scaling out ahead of anticipated demand." ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "NONE", + "OPTIMIZE_AVAILABILITY" + ] + } + } + }, + "AutoscalingPolicyCustomMetricUtilization": { + "id": "AutoscalingPolicyCustomMetricUtilization", + "description": "Custom utilization metric policy.", + "type": "object", + "properties": { + "metric": { + "description": "The identifier (type) of the Stackdriver Monitoring metric. The metric cannot have negative values. The metric must have a value type of INT64 or DOUBLE.", + "type": "string" + }, + "filter": { + "description": "A filter string, compatible with a Stackdriver Monitoring filter string for TimeSeries.list API call. This filter is used to select a specific TimeSeries for the purpose of autoscaling and to determine whether the metric is exporting per-instance or per-group data. For the filter to be valid for autoscaling purposes, the following rules apply: - You can only use the AND operator for joining selectors. - You can only use direct equality comparison operator (=) without any functions for each selector. - You can specify the metric in both the filter string and in the metric field. However, if specified in both places, the metric must be identical. - The monitored resource type determines what kind of values are expected for the metric. If it is a gce_instance, the autoscaler expects the metric to include a separate TimeSeries for each instance in a group. In such a case, you cannot filter on resource labels. If the resource type is any other value, the autoscaler expects this metric to contain values that apply to the entire autoscaled instance group and resource label filtering can be performed to point autoscaler at the correct TimeSeries to scale upon. This is called a *per-group metric* for the purpose of autoscaling. If not specified, the type defaults to gce_instance. Try to provide a filter that is selective enough to pick just one TimeSeries for the autoscaled group or for each of the instances (if you are using gce_instance resource type). If multiple TimeSeries are returned upon the query execution, the autoscaler will sum their respective values to obtain its scaling value.", + "type": "string" + }, + "utilizationTarget": { + "description": "The target value of the metric that autoscaler maintains. This must be a positive value. A utilization metric scales number of virtual machines handling requests to increase or decrease proportionally to the metric. For example, a good metric to use as a utilization_target is https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. The autoscaler works to keep this value constant for each of the instances.", + "type": "number", + "format": "double" + }, + "singleInstanceAssignment": { + "description": "If scaling is based on a per-group metric value that represents the total amount of work to be done or resource usage, set this value to an amount assigned for a single instance of the scaled group. Autoscaler keeps the number of instances proportional to the value of this metric. The metric itself does not change value due to group resizing. A good metric to use with the target is for example pubsub.googleapis.com/subscription/num_undelivered_messages or a custom metric exporting the total number of requests coming to your instances. A bad example would be a metric exporting an average or median latency, since this value can't include a chunk assignable to a single instance, it could be better used with utilization_target instead.", + "type": "number", + "format": "double" + }, + "utilizationTargetType": { + "description": "Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE.", + "type": "string", + "enumDescriptions": [ + "Sets the utilization target value for a cumulative or delta metric, expressed as the rate of growth per minute.", + "Sets the utilization target value for a cumulative or delta metric, expressed as the rate of growth per second.", + "Sets the utilization target value for a gauge metric. The autoscaler will collect the average utilization of the virtual machines from the last couple of minutes, and compare the value to the utilization target value to perform autoscaling." ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "DELTA_PER_MINUTE", + "DELTA_PER_SECOND", + "GAUGE" + ] } } }, - "instanceGroups": { - "methods": { - "list": { - "id": "compute.instanceGroups.list", - "path": "projects/{project}/zones/{zone}/instanceGroups", - "flatPath": "projects/{project}/zones/{zone}/instanceGroups", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone where the instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" + "AutoscalingPolicyLoadBalancingUtilization": { + "id": "AutoscalingPolicyLoadBalancingUtilization", + "description": "Configuration parameters of autoscaling based on load balancing.", + "type": "object", + "properties": { + "utilizationTarget": { + "description": "Fraction of backend capacity utilization (set in HTTP(S) load balancing configuration) that the autoscaler maintains. Must be a positive float value. If not defined, the default is 0.8.", + "type": "number", + "format": "double" + } + } + }, + "AutoscalingPolicyScalingSchedule": { + "id": "AutoscalingPolicyScalingSchedule", + "description": "Scaling based on user-defined schedule. The message describes a single scaling schedule. A scaling schedule changes the minimum number of VM instances an autoscaler can recommend, which can trigger scaling out.", + "type": "object", + "properties": { + "minRequiredReplicas": { + "description": "The minimum number of VM instances that the autoscaler will recommend in time intervals starting according to schedule. This field is required.", + "type": "integer", + "format": "int32" + }, + "schedule": { + "description": "The start timestamps of time intervals when this scaling schedule is to provide a scaling signal. This field uses the extended cron format (with an optional year field). The expression can describe a single timestamp if the optional year is set, in which case the scaling schedule runs once. The schedule is interpreted with respect to time_zone. This field is required. Note: These timestamps only describe when autoscaler starts providing the scaling signal. The VMs need additional time to become serving.", + "type": "string" + }, + "timeZone": { + "description": "The time zone to use when interpreting the schedule. The value of this field must be a time zone name from the tz database: https://en.wikipedia.org/wiki/Tz_database. This field is assigned a default value of \"UTC\" if left empty.", + "type": "string" + }, + "durationSec": { + "description": "The duration of time intervals, in seconds, for which this scaling schedule is to run. The minimum allowed value is 300. This field is required.", + "type": "integer", + "format": "int32" + }, + "disabled": { + "description": "A boolean value that specifies whether a scaling schedule can influence autoscaler recommendations. If set to true, then a scaling schedule has no effect. This field is optional, and its value is false by default.", + "type": "boolean" + }, + "description": { + "description": "A description of a scaling schedule.", + "type": "string" + } + } + }, + "AutoscalerStatusDetails": { + "id": "AutoscalerStatusDetails", + "type": "object", + "properties": { + "message": { + "description": "The status message.", + "type": "string" + }, + "type": { + "description": "The type of error, warning, or notice returned. Current set of possible values: - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance group are unhealthy (not in RUNNING state). - BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend service attached to the instance group. - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): Autoscaler recommends a size greater than maxNumReplicas. - CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric samples are not exported often enough to be a credible base for autoscaling. - CUSTOM_METRIC_INVALID (ERROR): The custom metric that was specified does not exist or does not have the necessary labels. - MIN_EQUALS_MAX (WARNING): The minNumReplicas is equal to maxNumReplicas. This means the autoscaler cannot add or remove instances from the instance group. - MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not receive any data from the custom metric configured for autoscaling. - MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is configured to scale based on a load balancing signal but the instance group has not received any requests from the load balancer. - MODE_OFF (WARNING): Autoscaling is turned off. The number of instances in the group won't change automatically. The autoscaling configuration is preserved. - MODE_ONLY_UP (WARNING): Autoscaling is in the \"Autoscale only out\" mode. The autoscaler can add instances but not remove any. - MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot be autoscaled because it has more than one backend service attached to it. - NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient quota for the necessary resources, such as CPU or number of instances. - REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional autoscalers: there is a resource stockout in the chosen region. - SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled does not exist. - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): Autoscaling does not work with an HTTP/S load balancer that has been configured for maxRate. - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal autoscalers: there is a resource stockout in the chosen zone. For regional autoscalers: in at least one of the zones you're using there is a resource stockout. New values might be added in the future. Some of the values might not be available in all API versions.", + "type": "string", + "enumDescriptions": [ + "All instances in the instance group are unhealthy (not in RUNNING state).", + "There is no backend service attached to the instance group.", + "Autoscaler recommends a size greater than maxNumReplicas.", + "The custom metric samples are not exported often enough to be a credible base for autoscaling.", + "The custom metric that was specified does not exist or does not have the necessary labels.", + "The minNumReplicas is equal to maxNumReplicas. This means the autoscaler cannot add or remove instances from the instance group.", + "The autoscaler did not receive any data from the custom metric configured for autoscaling.", + "The autoscaler is configured to scale based on a load balancing signal but the instance group has not received any requests from the load balancer.", + "Autoscaling is turned off. The number of instances in the group won't change automatically. The autoscaling configuration is preserved.", + "Autoscaling is in the \"Autoscale only scale out\" mode. Instances in the group will be only added.", + "Autoscaling is in the \"Autoscale only out\" mode. Instances in the group will be only added.", + "The instance group cannot be autoscaled because it has more than one backend service attached to it.", + "There is insufficient quota for the necessary resources, such as CPU or number of instances.", + "Showed only for regional autoscalers: there is a resource stockout in the chosen region.", + "The target to be scaled does not exist.", + "For some scaling schedules minRequiredReplicas is greater than maxNumReplicas. Autoscaler always recommends at most maxNumReplicas instances.", + "For some scaling schedules minRequiredReplicas is less than minNumReplicas. Autoscaler always recommends at least minNumReplicas instances.", + "", + "Autoscaling does not work with an HTTP/S load balancer that has been configured for maxRate.", + "For zonal autoscalers: there is a resource stockout in the chosen zone. For regional autoscalers: in at least one of the zones you're using there is a resource stockout." ], - "response": { - "$ref": "InstanceGroupList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "ALL_INSTANCES_UNHEALTHY", + "BACKEND_SERVICE_DOES_NOT_EXIST", + "CAPPED_AT_MAX_NUM_REPLICAS", + "CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE", + "CUSTOM_METRIC_INVALID", + "MIN_EQUALS_MAX", + "MISSING_CUSTOM_METRIC_DATA_POINTS", + "MISSING_LOAD_BALANCING_DATA_POINTS", + "MODE_OFF", + "MODE_ONLY_SCALE_OUT", + "MODE_ONLY_UP", + "MORE_THAN_ONE_BACKEND_SERVICE", + "NOT_ENOUGH_QUOTA_AVAILABLE", + "REGION_RESOURCE_STOCKOUT", + "SCALING_TARGET_DOES_NOT_EXIST", + "SCHEDULED_INSTANCES_GREATER_THAN_AUTOSCALER_MAX", + "SCHEDULED_INSTANCES_LESS_THAN_AUTOSCALER_MIN", + "UNKNOWN", + "UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION", + "ZONE_RESOURCE_STOCKOUT" + ] + } + } + }, + "ScalingScheduleStatus": { + "id": "ScalingScheduleStatus", + "type": "object", + "properties": { + "nextStartTime": { + "description": "[Output Only] The next time the scaling schedule is to become active. Note: this is a timestamp when a schedule is planned to run, but the actual time might be slightly different. The timestamp is in RFC3339 text format.", + "type": "string" + }, + "lastStartTime": { + "description": "[Output Only] The last time the scaling schedule became active. Note: this is a timestamp when a schedule actually became active, not when it was planned to do so. The timestamp is in RFC3339 text format.", + "type": "string" + }, + "state": { + "description": "[Output Only] The current state of a scaling schedule.", + "type": "string", + "enumDescriptions": [ + "The current autoscaling recommendation is influenced by this scaling schedule.", + "This scaling schedule has been disabled by the user.", + "This scaling schedule will never become active again.", + "The current autoscaling recommendation is not influenced by this scaling schedule." ], - "description": "Retrieves the list of zonal instance group resources contained within the specified zone. For managed instance groups, use the instanceGroupManagers or regionInstanceGroupManagers methods instead." + "enum": [ + "ACTIVE", + "DISABLED", + "OBSOLETE", + "READY" + ] + } + } + }, + "AutoscalerAggregatedList": { + "id": "AutoscalerAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#autoscalerAggregatedList for aggregated lists of autoscalers.", + "default": "compute#autoscalerAggregatedList", + "type": "string" }, - "aggregatedList": { - "id": "compute.instanceGroups.aggregatedList", - "path": "projects/{project}/aggregated/instanceGroups", - "flatPath": "projects/{project}/aggregated/instanceGroups", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of AutoscalersScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of autoscalers.", + "$ref": "AutoscalersScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InstanceGroupAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of instance groups and sorts them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + } }, - "get": { - "id": "compute.instanceGroups.get", - "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", - "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", - "httpMethod": "GET", - "parameters": { - "instanceGroup": { - "description": "The name of the instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone where the instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroup" - ], - "response": { - "$ref": "InstanceGroup" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified zonal instance group. Get a list of available zonal instance groups by making a list() request. For managed instance groups, use the instanceGroupManagers or regionInstanceGroupManagers methods instead." + "unreachables": { + "description": "[Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "AutoscalersScopedList": { + "id": "AutoscalersScopedList", + "type": "object", + "properties": { + "autoscalers": { + "description": "[Output Only] A list of autoscalers contained in this scope.", + "type": "array", + "items": { + "$ref": "Autoscaler" + } }, - "insert": { - "id": "compute.instanceGroups.insert", - "path": "projects/{project}/zones/{zone}/instanceGroups", - "flatPath": "projects/{project}/zones/{zone}/instanceGroups", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] Informational warning which replaces the list of autoscalers when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone where you want to create the instance group.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "InstanceGroup" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates an instance group in the specified project using the parameters that are included in the request." + } + } + } + }, + "RegionAutoscalerList": { + "id": "RegionAutoscalerList", + "description": "Contains a list of autoscalers.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#regionAutoscalerList", + "type": "string" }, - "delete": { - "id": "compute.instanceGroups.delete", - "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", - "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}", - "httpMethod": "DELETE", - "parameters": { - "instanceGroup": { - "description": "The name of the instance group to delete.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroup" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "addInstances": { - "id": "compute.instanceGroups.addInstances", - "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/addInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/addInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroup": { - "description": "The name of the instance group where you are adding instances.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroup" - ], - "request": { - "$ref": "InstanceGroupsAddInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information." + "items": { + "description": "A list of Autoscaler resources.", + "type": "array", + "items": { + "$ref": "Autoscaler" + } }, - "removeInstances": { - "id": "compute.instanceGroups.removeInstances", - "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/removeInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/removeInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroup": { - "description": "The name of the instance group where the specified instances will be removed.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "zone": { - "description": "The name of the zone where the instance group is located.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroup" - ], - "request": { - "$ref": "InstanceGroupsRemoveInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes one or more instances from the specified instance group, but does not delete those instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration before the VM instance is removed or deleted." + } + } + } + }, + "BackendBucketList": { + "id": "BackendBucketList", + "description": "Contains a list of BackendBucket resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#backendBucketList", + "type": "string" }, - "listInstances": { - "id": "compute.instanceGroups.listInstances", - "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances", - "httpMethod": "POST", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "instanceGroup": { - "description": "The name of the instance group from which you want to generate a list of included instances.", - "location": "path", - "required": true, - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of BackendBucket resources.", + "type": "array", + "items": { + "$ref": "BackendBucket" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone where the instance group is located.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroup" + } + } + } + }, + "BackendBucket": { + "id": "BackendBucket", + "description": "Represents a Cloud Storage Bucket resource. This Cloud Storage bucket resource is referenced by a URL map of a load balancer. For more information, read Backend Buckets.", + "type": "object", + "properties": { + "kind": { + "description": "Type of the resource.", + "default": "compute#backendBucket", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional textual description of the resource; provided by the client when the resource is created.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "bucketName": { + "description": "Cloud Storage bucket name.", + "type": "string" + }, + "enableCdn": { + "description": "If true, enable Cloud CDN for this BackendBucket.", + "type": "boolean" + }, + "cdnPolicy": { + "description": "Cloud CDN configuration for this BackendBucket.", + "$ref": "BackendBucketCdnPolicy" + }, + "customResponseHeaders": { + "description": "Headers that the Application Load Balancer should add to proxied responses.", + "type": "array", + "items": { + "type": "string" + } + }, + "edgeSecurityPolicy": { + "description": "[Output Only] The resource URL for the edge security policy associated with this backend bucket.", + "type": "string" + }, + "compressionMode": { + "description": "Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header.", + "type": "string", + "enumDescriptions": [ + "Automatically uses the best compression based on the Accept-Encoding header sent by the client.", + "Disables compression. Existing compressed responses cached by Cloud CDN will not be served to clients." ], - "request": { - "$ref": "InstanceGroupsListInstancesRequest" - }, - "response": { - "$ref": "InstanceGroupsListInstances" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "AUTOMATIC", + "DISABLED" + ] + }, + "usedBy": { + "description": "[Output Only] List of resources referencing that backend bucket.", + "type": "array", + "items": { + "$ref": "BackendBucketUsedBy" + } + } + } + }, + "BackendBucketCdnPolicy": { + "id": "BackendBucketCdnPolicy", + "description": "Message containing Cloud CDN configuration for a backend bucket.", + "type": "object", + "properties": { + "signedUrlKeyNames": { + "description": "[Output Only] Names of the keys for signing request URLs.", + "type": "array", + "items": { + "type": "string" + } + }, + "signedUrlCacheMaxAgeSec": { + "description": "Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a \"Cache-Control: public, max-age=[TTL]\" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.", + "type": "string", + "format": "int64" + }, + "requestCoalescing": { + "description": "If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin.", + "type": "boolean" + }, + "cacheMode": { + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", + "type": "string", + "enumDescriptions": [ + "Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", + "Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content.", + "", + "Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server." ], - "description": "Lists the instances in the specified instance group. The orderBy query parameter is not supported. The filter query parameter is supported, but only for expressions that use `eq` (equal) or `ne` (not equal) operators." + "enum": [ + "CACHE_ALL_STATIC", + "FORCE_CACHE_ALL", + "INVALID_CACHE_MODE", + "USE_ORIGIN_HEADERS" + ] + }, + "defaultTtl": { + "description": "Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-max-age). Setting a TTL of \"0\" means \"always revalidate\". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", + "type": "integer", + "format": "int32" + }, + "maxTtl": { + "description": "Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of \"0\" means \"always revalidate\". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", + "type": "integer", + "format": "int32" + }, + "clientTtl": { + "description": "Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a \"public\" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a \"public\" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year).", + "type": "integer", + "format": "int32" + }, + "negativeCaching": { + "description": "Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 421 (Misdirected Request), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy.", + "type": "boolean" + }, + "negativeCachingPolicy": { + "description": "Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists.", + "type": "array", + "items": { + "$ref": "BackendBucketCdnPolicyNegativeCachingPolicy" + } + }, + "bypassCacheOnRequestHeaders": { + "description": "Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings.", + "type": "array", + "items": { + "$ref": "BackendBucketCdnPolicyBypassCacheOnRequestHeader" + } + }, + "serveWhileStale": { + "description": "Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default \"max-stale\" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-max-age) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale.", + "type": "integer", + "format": "int32" + }, + "cacheKeyPolicy": { + "description": "The CacheKeyPolicy for this CdnPolicy.", + "$ref": "BackendBucketCdnPolicyCacheKeyPolicy" + } + } + }, + "BackendBucketCdnPolicyNegativeCachingPolicy": { + "id": "BackendBucketCdnPolicyNegativeCachingPolicy", + "description": "Specify CDN TTLs for response error codes.", + "type": "object", + "properties": { + "code": { + "description": "The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once.", + "type": "integer", + "format": "int32" + }, + "ttl": { + "description": "The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", + "type": "integer", + "format": "int32" + } + } + }, + "BackendBucketCdnPolicyBypassCacheOnRequestHeader": { + "id": "BackendBucketCdnPolicyBypassCacheOnRequestHeader", + "description": "Bypass the cache when the specified request headers are present, e.g. Pragma or Authorization headers. Values are case insensitive. The presence of such a header overrides the cache_mode setting.", + "type": "object", + "properties": { + "headerName": { + "description": "The header field name to match on when bypassing cache. Values are case-insensitive.", + "type": "string" + } + } + }, + "BackendBucketCdnPolicyCacheKeyPolicy": { + "id": "BackendBucketCdnPolicyCacheKeyPolicy", + "description": "Message containing what to include in the cache key for a request for Cloud CDN.", + "type": "object", + "properties": { + "queryStringWhitelist": { + "description": "Names of query string parameters to include in cache keys. Default parameters are always included. '&' and '=' will be percent encoded and not treated as delimiters.", + "type": "array", + "items": { + "type": "string" + } + }, + "includeHttpHeaders": { + "description": "Allows HTTP request headers (by name) to be used in the cache key.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "BackendBucketUsedBy": { + "id": "BackendBucketUsedBy", + "type": "object", + "properties": { + "reference": { + "description": "[Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.", + "type": "string" + } + } + }, + "SignedUrlKey": { + "id": "SignedUrlKey", + "description": "Represents a customer-supplied Signing Key used by Cloud CDN Signed URLs", + "type": "object", + "properties": { + "keyName": { + "description": "Name of the key. 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" + }, + "keyValue": { + "description": "128-bit key value used for signing the URL. The key value must be a valid RFC 4648 Section 5 base64url encoded string.", + "type": "string" + } + } + }, + "SecurityPolicyReference": { + "id": "SecurityPolicyReference", + "type": "object", + "properties": { + "securityPolicy": { + "type": "string" + } + } + }, + "BackendServiceList": { + "id": "BackendServiceList", + "description": "Contains a list of BackendService resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#backendServiceList for lists of backend services.", + "default": "compute#backendServiceList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of BackendService resources.", + "type": "array", + "items": { + "$ref": "BackendService" + } }, - "setNamedPorts": { - "id": "compute.instanceGroups.setNamedPorts", - "path": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/setNamedPorts", - "flatPath": "projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/setNamedPorts", - "httpMethod": "POST", - "parameters": { - "instanceGroup": { - "description": "The name of the instance group where the named ports are updated.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone where the instance group is located.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroup" - ], - "request": { - "$ref": "InstanceGroupsSetNamedPortsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the named ports for the specified instance group." + } } } }, - "regionInstanceGroups": { - "methods": { - "list": { - "id": "compute.regionInstanceGroups.list", - "path": "projects/{project}/regions/{region}/instanceGroups", - "flatPath": "projects/{project}/regions/{region}/instanceGroups", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "RegionInstanceGroupList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of instance group resources contained within the specified region." + "BackendService": { + "id": "BackendService", + "description": "Represents a Backend Service resource. A backend service defines how Google Cloud load balancers distribute traffic. The backend service configuration contains a set of values, such as the protocol used to connect to backends, various distribution and session settings, health checks, and timeouts. These settings provide fine-grained control over how your load balancer behaves. Most of the settings have default values that allow for easy configuration if you need to get started quickly. Backend services in Google Compute Engine can be either regionally or globally scoped. * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices) For more information, see Backend Services.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#backendService for backend services.", + "default": "compute#backendService", + "type": "string" }, - "get": { - "id": "compute.regionInstanceGroups.get", - "path": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}", - "flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}", - "httpMethod": "GET", - "parameters": { - "instanceGroup": { - "description": "Name of the instance group resource to return.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroup" + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "backends": { + "description": "The list of backends that serve this BackendService.", + "type": "array", + "items": { + "$ref": "Backend" + } + }, + "healthChecks": { + "description": "The list of URLs to the healthChecks, httpHealthChecks (legacy), or httpsHealthChecks (legacy) resource for health checking this backend service. Not all backend services support legacy health checks. See Load balancer guide. Currently, at most one health check can be specified for each backend service. Backend services with instance group or zonal NEG backends must have a health check. Backend services with internet or serverless NEG backends must not have a health check.", + "type": "array", + "items": { + "type": "string" + } + }, + "timeoutSec": { + "description": "The backend service timeout has a different meaning depending on the type of load balancer. For more information see, Backend service settings. The default is 30 seconds. The full range of timeout values allowed goes from 1 through 2,147,483,647 seconds. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. Instead, use maxStreamDuration.", + "type": "integer", + "format": "int32" + }, + "port": { + "description": "Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port.", + "deprecated": true, + "type": "integer", + "format": "int32" + }, + "protocol": { + "description": "The protocol this BackendService uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, TCP, SSL, UDP or GRPC. depending on the chosen load balancer or Traffic Director configuration. Refer to the documentation for the load balancers or for Traffic Director for more information. Must be set to GRPC when the backend service is referenced by a URL map that is bound to target gRPC proxy.", + "type": "string", + "enumDescriptions": [ + "gRPC (available for Traffic Director).", + "", + "HTTP/2 with SSL.", + "", + "TCP proxying with SSL.", + "TCP proxying or TCP pass-through.", + "UDP.", + "If a Backend Service has UNSPECIFIED as its protocol, it can be used with any L3/L4 Forwarding Rules." ], - "response": { - "$ref": "InstanceGroup" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "GRPC", + "HTTP", + "HTTP2", + "HTTPS", + "SSL", + "TCP", + "UDP", + "UNSPECIFIED" + ] + }, + "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 BackendService. An up-to-date fingerprint must be provided in order to update the BackendService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a BackendService.", + "type": "string", + "format": "byte" + }, + "portName": { + "description": "A named port on a backend instance group representing the port for communication to the backend VMs in that group. The named port must be [defined on each backend instance group](https://cloud.google.com/load-balancing/docs/backend-service#named_ports). This parameter has no meaning if the backends are NEGs. For internal passthrough Network Load Balancers and external passthrough Network Load Balancers, omit port_name.", + "type": "string" + }, + "enableCDN": { + "description": "If true, enables Cloud CDN for the backend service of a global external Application Load Balancer.", + "type": "boolean" + }, + "sessionAffinity": { + "description": "Type of session affinity to use. The default is NONE. Only NONE and HEADER_FIELD are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true. For more details, see: [Session Affinity](https://cloud.google.com/load-balancing/docs/backend-service#session_affinity).", + "type": "string", + "enumDescriptions": [ + "2-tuple hash on packet's source and destination IP addresses. Connections from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy.", + "1-tuple hash only on packet's source IP address. Connections from the same source IP address will be served by the same backend VM while that VM remains healthy. This option can only be used for Internal TCP/UDP Load Balancing.", + "5-tuple hash on packet's source and destination IP addresses, IP protocol, and source and destination ports. Connections for the same IP protocol from the same source IP address and port to the same destination IP address and port will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing.", + "3-tuple hash on packet's source and destination IP addresses, and IP protocol. Connections for the same IP protocol from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing.", + "Hash based on a cookie generated by the L7 loadbalancer. Only valid for HTTP(S) load balancing.", + "The hash is based on a user specified header field.", + "The hash is based on a user provided cookie.", + "No session affinity. Connections from the same client IP may go to any instance in the pool.", + "Strong cookie-based affinity. Connections bearing the same cookie will be served by the same backend VM while that VM remains healthy, as long as the cookie has not expired." ], - "description": "Returns the specified instance group resource." + "enum": [ + "CLIENT_IP", + "CLIENT_IP_NO_DESTINATION", + "CLIENT_IP_PORT_PROTO", + "CLIENT_IP_PROTO", + "GENERATED_COOKIE", + "HEADER_FIELD", + "HTTP_COOKIE", + "NONE", + "STRONG_COOKIE_AFFINITY" + ] }, - "listInstances": { - "id": "compute.regionInstanceGroups.listInstances", - "path": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/listInstances", - "flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/listInstances", - "httpMethod": "POST", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "instanceGroup": { - "description": "Name of the regional instance group for which we want to list the instances.", - "location": "path", - "required": true, - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroup" + "affinityCookieTtlSec": { + "description": "Lifetime of cookies in seconds. This setting is applicable to Application Load Balancers and Traffic Director and requires GENERATED_COOKIE or HTTP_COOKIE session affinity. If set to 0, the cookie is non-persistent and lasts only until the end of the browser session (or equivalent). The maximum allowed value is two weeks (1,209,600). Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", + "type": "integer", + "format": "int32" + }, + "region": { + "description": "[Output Only] URL of the region where the regional backend service resides. This field is not applicable to global backend services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "failoverPolicy": { + "description": "Requires at least one backend instance group to be defined as a backup (failover) backend. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).", + "$ref": "BackendServiceFailoverPolicy" + }, + "loadBalancingScheme": { + "description": "Specifies the load balancer type. A backend service created for one type of load balancer cannot be used with another. For more information, refer to Choosing a load balancer.", + "type": "string", + "enumDescriptions": [ + "Signifies that this will be used for classic Application Load Balancers, global external proxy Network Load Balancers, or external passthrough Network Load Balancers.", + "Signifies that this will be used for global external Application Load Balancers, regional external Application Load Balancers, or regional external proxy Network Load Balancers.", + "Signifies that this will be used for internal passthrough Network Load Balancers.", + "Signifies that this will be used for internal Application Load Balancers.", + "Signifies that this will be used by Traffic Director.", + "" ], - "request": { - "$ref": "RegionInstanceGroupsListInstancesRequest" - }, - "response": { - "$ref": "RegionInstanceGroupsListInstances" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "EXTERNAL", + "EXTERNAL_MANAGED", + "INTERNAL", + "INTERNAL_MANAGED", + "INTERNAL_SELF_MANAGED", + "INVALID_LOAD_BALANCING_SCHEME" + ] + }, + "connectionDraining": { + "$ref": "ConnectionDraining" + }, + "iap": { + "description": "The configurations for Identity-Aware Proxy on this resource. Not available for internal passthrough Network Load Balancers and external passthrough Network Load Balancers.", + "$ref": "BackendServiceIAP" + }, + "cdnPolicy": { + "description": "Cloud CDN configuration for this BackendService. Only available for specified load balancer types.", + "$ref": "BackendServiceCdnPolicy" + }, + "customRequestHeaders": { + "description": "Headers that the load balancer adds to proxied requests. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers).", + "type": "array", + "items": { + "type": "string" + } + }, + "customResponseHeaders": { + "description": "Headers that the load balancer adds to proxied responses. See [Creating custom headers](https://cloud.google.com/load-balancing/docs/custom-headers).", + "type": "array", + "items": { + "type": "string" + } + }, + "securityPolicy": { + "description": "[Output Only] The resource URL for the security policy associated with this backend service.", + "type": "string" + }, + "edgeSecurityPolicy": { + "description": "[Output Only] The resource URL for the edge security policy associated with this backend service.", + "type": "string" + }, + "logConfig": { + "description": "This field denotes the logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Stackdriver.", + "$ref": "BackendServiceLogConfig" + }, + "securitySettings": { + "description": "This field specifies the security settings that apply to this backend service. This field is applicable to a global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED.", + "$ref": "SecuritySettings" + }, + "localityLbPolicy": { + "description": "The load balancing algorithm used within the scope of the locality. The possible values are: - ROUND_ROBIN: This is a simple policy in which each healthy backend is selected in round robin order. This is the default. - LEAST_REQUEST: An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests. - RING_HASH: The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests. - RANDOM: The load balancer selects a random healthy host. - ORIGINAL_DESTINATION: Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer. - MAGLEV: used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see https://ai.google/research/pubs/pub44824 This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED, INTERNAL_MANAGED, or EXTERNAL_MANAGED. If sessionAffinity is not configured—that is, if session affinity remains at the default value of NONE—then the default value for localityLbPolicy is ROUND_ROBIN. If session affinity is set to a value other than NONE, then the default value for localityLbPolicy is MAGLEV. Only ROUND_ROBIN and RING_HASH are supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", + "type": "string", + "enumDescriptions": [ + "", + "An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests.", + "This algorithm implements consistent hashing to backends. Maglev can be used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see https://ai.google/research/pubs/pub44824", + "Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer.", + "The load balancer selects a random healthy host.", + "The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests.", + "This is a simple policy in which each healthy backend is selected in round robin order. This is the default.", + "Per-instance weighted Load Balancing via health check reported weights. If set, the Backend Service must configure a non legacy HTTP-based Health Check, and health check replies are expected to contain non-standard HTTP response header field X-Load-Balancing-Endpoint-Weight to specify the per-instance weights. If set, Load Balancing is weighted based on the per-instance weights reported in the last processed health check replies, as long as every instance either reported a valid weight or had UNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight. This option is only supported in Network Load Balancing." ], - "description": "Lists the instances in the specified instance group and displays information about the named ports. Depending on the specified options, this method can list all instances or only the instances that are running. The orderBy query parameter is not supported." + "enum": [ + "INVALID_LB_POLICY", + "LEAST_REQUEST", + "MAGLEV", + "ORIGINAL_DESTINATION", + "RANDOM", + "RING_HASH", + "ROUND_ROBIN", + "WEIGHTED_MAGLEV" + ] }, - "setNamedPorts": { - "id": "compute.regionInstanceGroups.setNamedPorts", - "path": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/setNamedPorts", - "flatPath": "projects/{project}/regions/{region}/instanceGroups/{instanceGroup}/setNamedPorts", - "httpMethod": "POST", - "parameters": { - "instanceGroup": { - "description": "The name of the regional instance group where the named ports are updated.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroup" + "consistentHash": { + "description": "Consistent Hash-based load balancing can be used to provide soft session affinity based on HTTP headers, cookies or other properties. This load balancing policy is applicable only for HTTP connections. The affinity to a particular destination host will be lost when one or more hosts are added/removed from the destination service. This field specifies parameters that control consistent hashing. This field is only applicable when localityLbPolicy is set to MAGLEV or RING_HASH. This field is applicable to either: - A regional backend service with the service_protocol set to HTTP, HTTPS, or HTTP2, and load_balancing_scheme set to INTERNAL_MANAGED. - A global backend service with the load_balancing_scheme set to INTERNAL_SELF_MANAGED. ", + "$ref": "ConsistentHashLoadBalancerSettings" + }, + "circuitBreakers": { + "$ref": "CircuitBreakers" + }, + "outlierDetection": { + "description": "Settings controlling the ejection of unhealthy backend endpoints from the load balancing pool of each individual proxy instance that processes the traffic for the given backend service. If not set, this feature is considered disabled. Results of the outlier detection algorithm (ejection of endpoints from the load balancing pool and returning them back to the pool) are executed independently by each proxy instance of the load balancer. In most cases, more than one proxy instance handles the traffic received by a backend service. Thus, it is possible that an unhealthy endpoint is detected and ejected by only some of the proxies, and while this happens, other proxies may continue to send requests to the same unhealthy endpoint until they detect and eject the unhealthy endpoint. Applicable backend endpoints can be: - VM instances in an Instance Group - Endpoints in a Zonal NEG (GCE_VM_IP, GCE_VM_IP_PORT) - Endpoints in a Hybrid Connectivity NEG (NON_GCP_PRIVATE_IP_PORT) - Serverless NEGs, that resolve to Cloud Run, App Engine, or Cloud Functions Services - Private Service Connect NEGs, that resolve to Google-managed regional API endpoints or managed services published using Private Service Connect Applicable backend service types can be: - A global backend service with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL_MANAGED. - A regional backend service with the serviceProtocol set to HTTP, HTTPS, or HTTP2, and loadBalancingScheme set to INTERNAL_MANAGED or EXTERNAL_MANAGED. Not supported for Serverless NEGs. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", + "$ref": "OutlierDetection" + }, + "network": { + "description": "The URL of the network to which this backend service belongs. This field can only be specified when the load balancing scheme is set to INTERNAL.", + "type": "string" + }, + "subsetting": { + "$ref": "Subsetting" + }, + "connectionTrackingPolicy": { + "description": "Connection Tracking configuration for this BackendService. Connection tracking policy settings are only available for external passthrough Network Load Balancers and internal passthrough Network Load Balancers.", + "$ref": "BackendServiceConnectionTrackingPolicy" + }, + "maxStreamDuration": { + "description": "Specifies the default maximum duration (timeout) for streams to this service. Duration is computed from the beginning of the stream until the response has been completely processed, including all retries. A stream that does not complete in this duration is closed. If not specified, there will be no timeout limit, i.e. the maximum duration is infinite. This value can be overridden in the PathMatcher configuration of the UrlMap that references this backend service. This field is only allowed when the loadBalancingScheme of the backend service is INTERNAL_SELF_MANAGED.", + "$ref": "Duration" + }, + "compressionMode": { + "description": "Compress text responses using Brotli or gzip compression, based on the client's Accept-Encoding header.", + "type": "string", + "enumDescriptions": [ + "Automatically uses the best compression based on the Accept-Encoding header sent by the client.", + "Disables compression. Existing compressed responses cached by Cloud CDN will not be served to clients." ], - "request": { - "$ref": "RegionInstanceGroupsSetNamedPortsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "AUTOMATIC", + "DISABLED" + ] + }, + "serviceLbPolicy": { + "description": "URL to networkservices.ServiceLbPolicy resource. Can only be set if load balancing scheme is EXTERNAL, EXTERNAL_MANAGED, INTERNAL_MANAGED or INTERNAL_SELF_MANAGED and the scope is global.", + "type": "string" + }, + "serviceBindings": { + "description": "URLs of networkservices.ServiceBinding resources. Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED. If set, lists of backends and health checks must be both empty.", + "type": "array", + "items": { + "type": "string" + } + }, + "localityLbPolicies": { + "description": "A list of locality load-balancing policies to be used in order of preference. When you use localityLbPolicies, you must set at least one value for either the localityLbPolicies[].policy or the localityLbPolicies[].customPolicy field. localityLbPolicies overrides any value set in the localityLbPolicy field. For an example of how to use this field, see Define a list of preferred policies. Caution: This field and its children are intended for use in a service mesh that includes gRPC clients only. Envoy proxies can't use backend services that have this configuration.", + "type": "array", + "items": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfig" + } + }, + "ipAddressSelectionPolicy": { + "description": "Specifies a preference for traffic sent from the proxy to the backend (or from the client to the backend for proxyless gRPC). The possible values are: - IPV4_ONLY: Only send IPv4 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv4 health checks are used to check the health of the backends. This is the default setting. - PREFER_IPV6: Prioritize the connection to the endpoint's IPv6 address over its IPv4 address (provided there is a healthy IPv6 address). - IPV6_ONLY: Only send IPv6 traffic to the backends of the backend service (Instance Group, Managed Instance Group, Network Endpoint Group), regardless of traffic from the client to the proxy. Only IPv6 health checks are used to check the health of the backends. This field is applicable to either: - Advanced global external Application Load Balancer (load balancing scheme EXTERNAL_MANAGED), - Regional external Application Load Balancer, - Internal proxy Network Load Balancer (load balancing scheme INTERNAL_MANAGED), - Regional internal Application Load Balancer (load balancing scheme INTERNAL_MANAGED), - Traffic Director with Envoy proxies and proxyless gRPC (load balancing scheme INTERNAL_SELF_MANAGED). ", + "type": "string", + "enumDescriptions": [ + "Only send IPv4 traffic to the backends of the Backend Service (Instance Group, Managed Instance Group, Network Endpoint Group) regardless of traffic from the client to the proxy. Only IPv4 health-checks are used to check the health of the backends. This is the default setting.", + "Only send IPv6 traffic to the backends of the Backend Service (Instance Group, Managed Instance Group, Network Endpoint Group) regardless of traffic from the client to the proxy. Only IPv6 health-checks are used to check the health of the backends.", + "Unspecified IP address selection policy.", + "Prioritize the connection to the endpoints IPv6 address over its IPv4 address (provided there is a healthy IPv6 address)." ], - "description": "Sets the named ports for the specified regional instance group." + "enum": [ + "IPV4_ONLY", + "IPV6_ONLY", + "IP_ADDRESS_SELECTION_POLICY_UNSPECIFIED", + "PREFER_IPV6" + ] + }, + "metadatas": { + "description": "Deployment metadata associated with the resource to be set by a GKE hub controller and read by the backend RCTH", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "usedBy": { + "description": "[Output Only] List of resources referencing given backend service.", + "type": "array", + "items": { + "$ref": "BackendServiceUsedBy" + } + }, + "strongSessionAffinityCookie": { + "description": "Describes the HTTP cookie used for stateful session affinity. This field is applicable and required if the sessionAffinity is set to STRONG_COOKIE_AFFINITY.", + "$ref": "BackendServiceHttpCookie" } } }, - "instanceGroupManagers": { - "methods": { - "list": { - "id": "compute.instanceGroupManagers.list", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "InstanceGroupManagerList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of managed instance groups that are contained within the specified project and zone." + "Backend": { + "id": "Backend", + "description": "Message containing information of one individual backend.", + "type": "object", + "properties": { + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" }, - "aggregatedList": { - "id": "compute.instanceGroupManagers.aggregatedList", - "path": "projects/{project}/aggregated/instanceGroupManagers", - "flatPath": "projects/{project}/aggregated/instanceGroupManagers", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InstanceGroupManagerAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of managed instance groups and groups them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "group": { + "description": "The fully-qualified URL of an instance group or network endpoint group (NEG) resource. To determine what types of backends a load balancer supports, see the [Backend services overview](https://cloud.google.com/load-balancing/docs/backend-service#backends). You must use the *fully-qualified* URL (starting with https://www.googleapis.com/) to specify the instance group or NEG. Partial URLs are not supported.", + "type": "string" }, - "get": { - "id": "compute.instanceGroupManagers.get", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", - "httpMethod": "GET", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "response": { - "$ref": "InstanceGroupManager" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "balancingMode": { + "description": "Specifies how to determine whether the backend of a load balancer can handle additional traffic or is fully loaded. For usage guidelines, see Connection balancing mode. Backends must use compatible balancing modes. For more information, see Supported balancing modes and target capacity settings and Restrictions and guidance for instance groups. Note: Currently, if you use the API to configure incompatible balancing modes, the configuration might be accepted even though it has no impact and is ignored. Specifically, Backend.maxUtilization is ignored when Backend.balancingMode is RATE. In the future, this incompatible combination will be rejected.", + "type": "string", + "enumDescriptions": [ + "Balance based on the number of simultaneous connections.", + "Balance based on requests per second (RPS).", + "Balance based on the backend utilization." ], - "description": "Returns all of the details about the specified managed instance group." + "enum": [ + "CONNECTION", + "RATE", + "UTILIZATION" + ] }, - "insert": { - "id": "compute.instanceGroupManagers.insert", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where you want to create the managed instance group.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "InstanceGroupManager" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "maxUtilization": { + "description": "Optional parameter to define a target capacity for the UTILIZATION balancing mode. The valid range is [0.0, 1.0]. For usage guidelines, see Utilization balancing mode.", + "type": "number", + "format": "float" + }, + "maxRate": { + "description": "Defines a maximum number of HTTP requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.", + "type": "integer", + "format": "int32" + }, + "maxRatePerInstance": { + "description": "Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.", + "type": "number", + "format": "float" + }, + "maxRatePerEndpoint": { + "description": "Defines a maximum target for requests per second (RPS). For usage guidelines, see Rate balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is CONNECTION.", + "type": "number", + "format": "float" + }, + "maxConnections": { + "description": "Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.", + "type": "integer", + "format": "int32" + }, + "maxConnectionsPerInstance": { + "description": "Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.", + "type": "integer", + "format": "int32" + }, + "maxConnectionsPerEndpoint": { + "description": "Defines a target maximum number of simultaneous connections. For usage guidelines, see Connection balancing mode and Utilization balancing mode. Not available if the backend's balancingMode is RATE.", + "type": "integer", + "format": "int32" + }, + "capacityScaler": { + "description": "A multiplier applied to the backend's target capacity of its balancing mode. The default value is 1, which means the group serves up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. The valid ranges are 0.0 and [0.1,1.0]. You cannot configure a setting larger than 0 and smaller than 0.1. You cannot configure a setting of 0 when there is only one backend attached to the backend service. Not available with backends that don't support using a balancingMode. This includes backends such as global internet NEGs, regional serverless NEGs, and PSC NEGs.", + "type": "number", + "format": "float" + }, + "failover": { + "description": "This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.", + "type": "boolean" + }, + "preference": { + "description": "This field indicates whether this backend should be fully utilized before sending traffic to backends with default preference. The possible values are: - PREFERRED: Backends with this preference level will be filled up to their capacity limits first, based on RTT. - DEFAULT: If preferred backends don't have enough capacity, backends in this layer would be used and traffic would be assigned based on the load balancing algorithm you use. This is the default ", + "type": "string", + "enumDescriptions": [ + "No preference.", + "If preference is unspecified, we set it to the DEFAULT value", + "Traffic will be sent to this backend first." ], - "description": "Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method. A managed instance group can have up to 1000 VM instances per group. Please contact Cloud Support if you need an increase in this limit." + "enum": [ + "DEFAULT", + "PREFERENCE_UNSPECIFIED", + "PREFERRED" + ] + } + } + }, + "BackendServiceFailoverPolicy": { + "id": "BackendServiceFailoverPolicy", + "description": "For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). On failover or failback, this field indicates whether connection draining will be honored. Google Cloud has a fixed connection draining timeout of 10 minutes. A setting of true terminates existing TCP connections to the active pool during failover and failback, immediately draining traffic. A setting of false allows existing TCP connections to persist, even on VMs no longer in the active pool, for up to the duration of the connection draining timeout (10 minutes).", + "type": "object", + "properties": { + "disableConnectionDrainOnFailover": { + "description": "This can be set to true only if the protocol is TCP. The default is false.", + "type": "boolean" + }, + "dropTrafficIfUnhealthy": { + "description": "If set to true, connections to the load balancer are dropped when all primary and all backup backend VMs are unhealthy.If set to false, connections are distributed among all primary VMs when all primary and all backup backend VMs are unhealthy. For load balancers that have configurable failover: [Internal passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external passthrough Network Load Balancers](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview). The default is false.", + "type": "boolean" + }, + "failoverRatio": { + "description": "The value of the field must be in the range [0, 1]. If the value is 0, the load balancer performs a failover when the number of healthy primary VMs equals zero. For all other values, the load balancer performs a failover when the total number of healthy primary VMs is less than this ratio. For load balancers that have configurable failover: [Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal/failover-overview) and [external TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-failover-overview).", + "type": "number", + "format": "float" + } + } + }, + "ConnectionDraining": { + "id": "ConnectionDraining", + "description": "Message containing connection draining configuration.", + "type": "object", + "properties": { + "drainingTimeoutSec": { + "description": "Configures a duration timeout for existing requests on a removed backend instance. For supported load balancers and protocols, as described in Enabling connection draining.", + "type": "integer", + "format": "int32" + } + } + }, + "BackendServiceIAP": { + "id": "BackendServiceIAP", + "description": "Identity-Aware Proxy", + "type": "object", + "properties": { + "enabled": { + "description": "Whether the serving infrastructure will authenticate and authorize all incoming requests.", + "type": "boolean" + }, + "oauth2ClientId": { + "description": "OAuth2 client ID to use for the authentication flow.", + "type": "string" + }, + "oauth2ClientSecret": { + "description": "OAuth2 client secret to use for the authentication flow. For security reasons, this value cannot be retrieved via the API. Instead, the SHA-256 hash of the value is returned in the oauth2ClientSecretSha256 field. @InputOnly", + "type": "string" + }, + "oauth2ClientSecretSha256": { + "description": "[Output Only] SHA256 hash value for the field oauth2_client_secret above.", + "type": "string" + } + } + }, + "BackendServiceCdnPolicy": { + "id": "BackendServiceCdnPolicy", + "description": "Message containing Cloud CDN configuration for a backend service.", + "type": "object", + "properties": { + "cacheKeyPolicy": { + "description": "The CacheKeyPolicy for this CdnPolicy.", + "$ref": "CacheKeyPolicy" + }, + "signedUrlKeyNames": { + "description": "[Output Only] Names of the keys for signing request URLs.", + "type": "array", + "items": { + "type": "string" + } }, - "patch": { - "id": "compute.instanceGroupManagers.patch", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", - "httpMethod": "PATCH", - "parameters": { - "instanceGroupManager": { - "description": "The name of the instance group manager.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where you want to create the managed instance group.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManager" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listManagedInstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. If you update your group to specify a new template or instance configuration, it's possible that your intended specification for each VM in the group is different from the current state of that VM. To learn how to apply an updated configuration to the VMs in a MIG, see Updating instances in a MIG." + "signedUrlCacheMaxAgeSec": { + "description": "Maximum number of seconds the response to a signed URL request will be considered fresh. After this time period, the response will be revalidated before being served. Defaults to 1hr (3600s). When serving responses to signed URL requests, Cloud CDN will internally behave as though all responses from this backend had a \"Cache-Control: public, max-age=[TTL]\" header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.", + "type": "string", + "format": "int64" }, - "delete": { - "id": "compute.instanceGroupManagers.delete", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}", - "httpMethod": "DELETE", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group to delete.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified managed instance group and all of the instances in that group. Note that the instance group must not belong to a backend service. Read Deleting an instance group for more information." + "requestCoalescing": { + "description": "If true then Cloud CDN will combine multiple concurrent cache fill requests into a small number of requests to the origin.", + "type": "boolean" }, - "deleteInstances": { - "id": "compute.instanceGroupManagers.deleteInstances", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersDeleteInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "cacheMode": { + "description": "Specifies the cache setting for all responses from this backend. The possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server. FORCE_CACHE_ALL Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content. CACHE_ALL_STATIC Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", + "type": "string", + "enumDescriptions": [ + "Automatically cache static content, including common image formats, media (video and audio), and web assets (JavaScript and CSS). Requests and responses that are marked as uncacheable, as well as dynamic content (including HTML), will not be cached.", + "Cache all content, ignoring any \"private\", \"no-store\" or \"no-cache\" directives in Cache-Control response headers. Warning: this may result in Cloud CDN caching private, per-user (user identifiable) content.", + "", + "Requires the origin to set valid caching headers to cache content. Responses without these headers will not be cached at Google's edge, and will require a full trip to the origin on every request, potentially impacting performance and increasing load on the origin server." ], - "description": "Flags the specified instances in the managed instance group for immediate deletion. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." + "enum": [ + "CACHE_ALL_STATIC", + "FORCE_CACHE_ALL", + "INVALID_CACHE_MODE", + "USE_ORIGIN_HEADERS" + ] }, - "abandonInstances": { - "id": "compute.instanceGroupManagers.abandonInstances", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersAbandonInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Flags the specified instances to be removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." + "defaultTtl": { + "description": "Specifies the default TTL for cached content served by this origin for responses that do not have an existing valid TTL (max-age or s-max-age). Setting a TTL of \"0\" means \"always revalidate\". The value of defaultTTL cannot be set to a value greater than that of maxTTL, but can be equal. When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses. The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", + "type": "integer", + "format": "int32" }, - "recreateInstances": { - "id": "compute.instanceGroupManagers.recreateInstances", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersRecreateInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Flags the specified VM instances in the managed instance group to be immediately recreated. Each instance is recreated using the group's current configuration. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." + "maxTtl": { + "description": "Specifies the maximum allowed TTL for cached content served by this origin. Cache directives that attempt to set a max-age or s-maxage higher than this, or an Expires header more than maxTTL seconds in the future will be capped at the value of maxTTL, as if it were the value of an s-maxage Cache-Control directive. Headers sent to the client will not be modified. Setting a TTL of \"0\" means \"always revalidate\". The maximum allowed value is 31,622,400s (1 year), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", + "type": "integer", + "format": "int32" }, - "resize": { - "id": "compute.instanceGroupManagers.resize", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resize", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resize", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "size": { - "description": "The number of running instances that the managed instance group should maintain at any given time. The group automatically adds or removes instances to maintain the number of instances specified by this parameter.", - "location": "query", - "required": true, - "type": "integer", - "format": "int32" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager", - "size" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method. When resizing down, the instance group arbitrarily chooses the order in which VMs are deleted. The group takes into account some VM attributes when making the selection including: + The status of the VM instance. + The health of the VM instance. + The instance template version the VM is based on. + For regional managed instance groups, the location of the VM instance. This list is subject to change. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted." + "clientTtl": { + "description": "Specifies a separate client (e.g. browser client) maximum TTL. This is used to clamp the max-age (or Expires) value sent to the client. With FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the response max-age directive, along with a \"public\" directive. For cacheable content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the origin (if specified), or else sets the response max-age directive to the lesser of the client_ttl and default_ttl, and also ensures a \"public\" cache-control directive is present. If a client TTL is not specified, a default value (1 hour) will be used. The maximum allowed value is 31,622,400s (1 year).", + "type": "integer", + "format": "int32" }, - "setInstanceTemplate": { - "id": "compute.instanceGroupManagers.setInstanceTemplate", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersSetInstanceTemplateRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE." + "negativeCaching": { + "description": "Negative caching allows per-status code TTLs to be set, in order to apply fine-grained caching for common errors or redirects. This can reduce the load on your origin and improve end-user experience by reducing response latency. When the cache mode is set to CACHE_ALL_STATIC or USE_ORIGIN_HEADERS, negative caching applies to responses with the specified response code that lack any Cache-Control, Expires, or Pragma: no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, negative caching applies to all responses with the specified response code, and override any caching headers. By default, Cloud CDN will apply the following default TTLs to these status codes: HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 421 (Misdirected Request), 501 (Not Implemented): 60s. These defaults can be overridden in negative_caching_policy.", + "type": "boolean" }, - "setTargetPools": { - "id": "compute.instanceGroupManagers.setTargetPools", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersSetTargetPoolsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Modifies the target pools to which all instances in this managed instance group are assigned. The target pools automatically apply to all of the instances in the managed instance group. This operation is marked DONE when you make the request even if the instances have not yet been added to their target pools. The change might take some time to apply to all of the instances in the group depending on the size of the group." + "negativeCachingPolicy": { + "description": "Sets a cache TTL for the specified HTTP status code. negative_caching must be enabled to configure negative_caching_policy. Omitting the policy and leaving negative_caching enabled will use Cloud CDN's default cache TTLs. Note that when specifying an explicit negative_caching_policy, you should take care to specify a cache TTL for all response codes that you wish to cache. Cloud CDN will not apply any default negative caching when a policy exists.", + "type": "array", + "items": { + "$ref": "BackendServiceCdnPolicyNegativeCachingPolicy" + } + }, + "bypassCacheOnRequestHeaders": { + "description": "Bypass the cache when the specified request headers are matched - e.g. Pragma or Authorization headers. Up to 5 headers can be specified. The cache is bypassed for all cdnPolicy.cacheMode settings.", + "type": "array", + "items": { + "$ref": "BackendServiceCdnPolicyBypassCacheOnRequestHeader" + } + }, + "serveWhileStale": { + "description": "Serve existing content from the cache (if available) when revalidating content with the origin, or when an error is encountered when refreshing the cache. This setting defines the default \"max-stale\" duration for any cached responses that do not specify a max-stale directive. Stale responses that exceed the TTL configured here will not be served. The default limit (max-stale) is 86400s (1 day), which will allow stale content to be served up to this limit beyond the max-age (or s-max-age) of a cached response. The maximum allowed value is 604800 (1 week). Set this to zero (0) to disable serve-while-stale.", + "type": "integer", + "format": "int32" + } + } + }, + "CacheKeyPolicy": { + "id": "CacheKeyPolicy", + "description": "Message containing what to include in the cache key for a request for Cloud CDN.", + "type": "object", + "properties": { + "includeProtocol": { + "description": "If true, http and https requests will be cached separately.", + "type": "boolean" + }, + "includeHost": { + "description": "If true, requests to different hosts will be cached separately.", + "type": "boolean" + }, + "includeQueryString": { + "description": "If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.", + "type": "boolean" + }, + "queryStringWhitelist": { + "description": "Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.", + "type": "array", + "items": { + "type": "string" + } + }, + "queryStringBlacklist": { + "description": "Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.", + "type": "array", + "items": { + "type": "string" + } + }, + "includeHttpHeaders": { + "description": "Allows HTTP request headers (by name) to be used in the cache key.", + "type": "array", + "items": { + "type": "string" + } + }, + "includeNamedCookies": { + "description": "Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "BackendServiceCdnPolicyNegativeCachingPolicy": { + "id": "BackendServiceCdnPolicyNegativeCachingPolicy", + "description": "Specify CDN TTLs for response error codes.", + "type": "object", + "properties": { + "code": { + "description": "The HTTP status code to define a TTL against. Only HTTP status codes 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as values, and you cannot specify a status code more than once.", + "type": "integer", + "format": "int32" + }, + "ttl": { + "description": "The TTL (in seconds) for which to cache responses with the corresponding status code. The maximum allowed value is 1800s (30 minutes), noting that infrequently accessed objects may be evicted from the cache before the defined TTL.", + "type": "integer", + "format": "int32" + } + } + }, + "BackendServiceCdnPolicyBypassCacheOnRequestHeader": { + "id": "BackendServiceCdnPolicyBypassCacheOnRequestHeader", + "description": "Bypass the cache when the specified request headers are present, e.g. Pragma or Authorization headers. Values are case insensitive. The presence of such a header overrides the cache_mode setting.", + "type": "object", + "properties": { + "headerName": { + "description": "The header field name to match on when bypassing cache. Values are case-insensitive.", + "type": "string" + } + } + }, + "BackendServiceLogConfig": { + "id": "BackendServiceLogConfig", + "description": "The available logging options for the load balancer traffic served by this backend service.", + "type": "object", + "properties": { + "enable": { + "description": "Denotes whether to enable logging for the load balancer traffic served by this backend service. The default value is false.", + "type": "boolean" }, - "listManagedInstances": { - "id": "compute.instanceGroupManagers.listManagedInstances", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", - "httpMethod": "POST", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "instanceGroupManager": { - "description": "The name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "response": { - "$ref": "InstanceGroupManagersListManagedInstancesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`." + "sampleRate": { + "description": "This field can only be specified if logging is enabled for this backend service. The value of the field must be in [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no logged requests are reported. The default value is 1.0.", + "type": "number", + "format": "float" }, - "listErrors": { - "id": "compute.instanceGroupManagers.listErrors", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listErrors", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listErrors", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "instanceGroupManager": { - "description": "The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}.", - "location": "path", - "required": true, - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "response": { - "$ref": "InstanceGroupManagersListErrorsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "optionalMode": { + "description": "This field can only be specified if logging is enabled for this backend service. Configures whether all, none or a subset of optional fields should be added to the reported logs. One of [INCLUDE_ALL_OPTIONAL, EXCLUDE_ALL_OPTIONAL, CUSTOM]. Default is EXCLUDE_ALL_OPTIONAL.", + "type": "string", + "enumDescriptions": [ + "A subset of optional fields.", + "None optional fields.", + "All optional fields." ], - "description": "Lists all errors thrown by actions on instances for a given managed instance group. The filter and orderBy query parameters are not supported." + "enum": [ + "CUSTOM", + "EXCLUDE_ALL_OPTIONAL", + "INCLUDE_ALL_OPTIONAL" + ] }, - "listPerInstanceConfigs": { - "id": "compute.instanceGroupManagers.listPerInstanceConfigs", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", - "httpMethod": "POST", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "instanceGroupManager": { - "description": "The name of the managed instance group. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "response": { - "$ref": "InstanceGroupManagersListPerInstanceConfigsResp" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported." + "optionalFields": { + "description": "This field can only be specified if logging is enabled for this backend service and \"logConfig.optionalMode\" was set to CUSTOM. Contains a list of optional fields you want to include in the logs. For example: serverInstance, serverGkeDetails.cluster, serverGkeDetails.pod.podNamespace", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SecuritySettings": { + "id": "SecuritySettings", + "description": "The authentication and authorization settings for a BackendService.", + "type": "object", + "properties": { + "clientTlsPolicy": { + "description": "Optional. A URL referring to a networksecurity.ClientTlsPolicy resource that describes how clients should authenticate with this service's backends. clientTlsPolicy only applies to a global BackendService with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. If left blank, communications are not encrypted.", + "type": "string" }, - "updatePerInstanceConfigs": { - "id": "compute.instanceGroupManagers.updatePerInstanceConfigs", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersUpdatePerInstanceConfigsReq" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch." + "subjectAltNames": { + "description": "Optional. A list of Subject Alternative Names (SANs) that the client verifies during a mutual TLS handshake with an server/endpoint for this BackendService. When the server presents its X.509 certificate to the client, the client inspects the certificate's subjectAltName field. If the field contains one of the specified values, the communication continues. Otherwise, it fails. This additional check enables the client to verify that the server is authorized to run the requested service. Note that the contents of the server certificate's subjectAltName field are configured by the Public Key Infrastructure which provisions server identities. Only applies to a global BackendService with loadBalancingScheme set to INTERNAL_SELF_MANAGED. Only applies when BackendService has an attached clientTlsPolicy with clientCertificate (mTLS mode).", + "type": "array", + "items": { + "type": "string" + } }, - "patchPerInstanceConfigs": { - "id": "compute.instanceGroupManagers.patchPerInstanceConfigs", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersPatchPerInstanceConfigsReq" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch." + "awsV4Authentication": { + "description": "The configuration needed to generate a signature for access to private storage buckets that support AWS's Signature Version 4 for authentication. Allowed only for INTERNET_IP_PORT and INTERNET_FQDN_PORT NEG backends.", + "$ref": "AWSV4Signature" + } + } + }, + "AWSV4Signature": { + "id": "AWSV4Signature", + "description": "Contains the configurations necessary to generate a signature for access to private storage buckets that support Signature Version 4 for authentication. The service name for generating the authentication header will always default to 's3'.", + "type": "object", + "properties": { + "accessKeyId": { + "description": "The identifier of an access key used for s3 bucket authentication.", + "type": "string" }, - "deletePerInstanceConfigs": { - "id": "compute.instanceGroupManagers.deletePerInstanceConfigs", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersDeletePerInstanceConfigsReq" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes selected per-instance configurations for the managed instance group." + "accessKey": { + "description": "The access key used for s3 bucket authentication. Required for updating or creating a backend that uses AWS v4 signature authentication, but will not be returned as part of the configuration when queried with a REST API GET request. @InputOnly", + "type": "string" }, - "applyUpdatesToInstances": { - "id": "compute.instanceGroupManagers.applyUpdatesToInstances", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group, should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located. Should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersApplyUpdatesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Applies changes to selected instances on the managed instance group. This method can be used to apply new overrides and/or new versions." + "accessKeyVersion": { + "description": "The optional version identifier for the access key. You can use this to keep track of different iterations of your access key.", + "type": "string" }, - "createInstances": { - "id": "compute.instanceGroupManagers.createInstances", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/createInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagersCreateInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates instances with per-instance configurations in this managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method." + "originRegion": { + "description": "The name of the cloud region of your origin. This is a free-form field with the name of the region your cloud uses to host your origin. For example, \"us-east-1\" for AWS or \"us-ashburn-1\" for OCI.", + "type": "string" + } + } + }, + "ConsistentHashLoadBalancerSettings": { + "id": "ConsistentHashLoadBalancerSettings", + "description": "This message defines settings for a consistent hash style load balancer.", + "type": "object", + "properties": { + "httpCookie": { + "description": "Hash is based on HTTP Cookie. This field describes a HTTP cookie that will be used as the hash key for the consistent hash load balancer. If the cookie is not present, it will be generated. This field is applicable if the sessionAffinity is set to HTTP_COOKIE. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", + "$ref": "ConsistentHashLoadBalancerSettingsHttpCookie" + }, + "httpHeaderName": { + "description": "The hash based on the value of the specified header field. This field is applicable if the sessionAffinity is set to HEADER_FIELD.", + "type": "string" + }, + "minimumRingSize": { + "description": "The minimum number of virtual nodes to use for the hash ring. Defaults to 1024. Larger ring sizes result in more granular load distributions. If the number of hosts in the load balancing pool is larger than the ring size, each host will be assigned a single virtual node.", + "type": "string", + "format": "int64" } } }, - "instanceGroupManagerResizeRequests": { - "methods": { - "get": { - "id": "compute.instanceGroupManagerResizeRequests.get", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", - "httpMethod": "GET", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group. Name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resizeRequest": { - "description": "The name of the resize request. Name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the href=\"/compute/docs/regions-zones/#available\"\u003ezone scoping this request. Name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager", - "resizeRequest" - ], - "response": { - "$ref": "InstanceGroupManagerResizeRequest" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns all of the details about the specified resize request." - }, - "insert": { - "id": "compute.instanceGroupManagerResizeRequests.insert", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group to which the resize request will be added. Name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located and where the resize request will be created. Name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManagerResizeRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a new resize request that starts provisioning VMs immediately or queues VM creation." - }, - "list": { - "id": "compute.instanceGroupManagerResizeRequests.list", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "instanceGroupManager": { - "description": "The name of the managed instance group. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager" - ], - "response": { - "$ref": "InstanceGroupManagerResizeRequestsListResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of resize requests that are contained in the managed instance group." + "ConsistentHashLoadBalancerSettingsHttpCookie": { + "id": "ConsistentHashLoadBalancerSettingsHttpCookie", + "description": "The information about the HTTP Cookie on which the hash function is based for load balancing policies that use a consistent hash.", + "type": "object", + "properties": { + "name": { + "description": "Name of the cookie.", + "type": "string" }, - "cancel": { - "id": "compute.instanceGroupManagerResizeRequests.cancel", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}/cancel", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group. The name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "resizeRequest": { - "description": "The name of the resize request to cancel. The name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager", - "resizeRequest" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Cancels the specified resize request and removes it from the queue. Cancelled resize request does no longer wait for the resources to be provisioned. Cancel is only possible for requests that are accepted in the queue." + "path": { + "description": "Path to set for the cookie.", + "type": "string" }, - "delete": { - "id": "compute.instanceGroupManagerResizeRequests.delete", - "path": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", - "flatPath": "projects/{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/resizeRequests/{resizeRequest}", - "httpMethod": "DELETE", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group. The name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "resizeRequest": { - "description": "The name of the resize request to delete. The name should conform to RFC1035 or be a resource ID.", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone where the managed instance group is located. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instanceGroupManager", - "resizeRequest" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified, inactive resize request. Requests that are still active cannot be deleted. Deleting request does not delete instances that were provisioned previously." + "ttl": { + "description": "Lifetime of the cookie.", + "$ref": "Duration" } } }, - "regionInstanceGroupManagers": { - "methods": { - "list": { - "id": "compute.regionInstanceGroupManagers.list", - "path": "projects/{project}/regions/{region}/instanceGroupManagers", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "RegionInstanceGroupManagerList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of managed instance groups that are contained within the specified region." + "CircuitBreakers": { + "id": "CircuitBreakers", + "description": "Settings controlling the volume of requests, connections and retries to this backend service.", + "type": "object", + "properties": { + "maxRequestsPerConnection": { + "description": "Maximum requests for a single connection to the backend service. This parameter is respected by both the HTTP/1.1 and HTTP/2 implementations. If not specified, there is no limit. Setting this parameter to 1 will effectively disable keep alive. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", + "type": "integer", + "format": "int32" }, - "get": { - "id": "compute.regionInstanceGroupManagers.get", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", - "httpMethod": "GET", - "parameters": { - "instanceGroupManager": { - "description": "Name of the managed instance group to return.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "response": { - "$ref": "InstanceGroupManager" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns all of the details about the specified managed instance group." + "maxConnections": { + "description": "The maximum number of connections to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", + "type": "integer", + "format": "int32" }, - "insert": { - "id": "compute.regionInstanceGroupManagers.insert", - "path": "projects/{project}/regions/{region}/instanceGroupManagers", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "InstanceGroupManager" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a managed instance group using the information that you specify in the request. After the group is created, instances in the group are created using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method. A regional managed instance group can contain up to 2000 instances." + "maxPendingRequests": { + "description": "The maximum number of pending requests allowed to the backend service. If not specified, there is no limit. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", + "type": "integer", + "format": "int32" }, - "patch": { - "id": "compute.regionInstanceGroupManagers.patch", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", - "httpMethod": "PATCH", - "parameters": { - "instanceGroupManager": { - "description": "The name of the instance group manager.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "InstanceGroupManager" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates a managed instance group using the information that you specify in the request. This operation is marked as DONE when the group is patched even if the instances in the group are still in the process of being patched. You must separately verify the status of the individual instances with the listmanagedinstances method. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. If you update your group to specify a new template or instance configuration, it's possible that your intended specification for each VM in the group is different from the current state of that VM. To learn how to apply an updated configuration to the VMs in a MIG, see Updating instances in a MIG." + "maxRequests": { + "description": "The maximum number of parallel requests that allowed to the backend service. If not specified, there is no limit.", + "type": "integer", + "format": "int32" + }, + "maxRetries": { + "description": "The maximum number of parallel retries allowed to the backend cluster. If not specified, the default is 1. Not supported when the backend service is referenced by a URL map that is bound to target gRPC proxy that has validateForProxyless field set to true.", + "type": "integer", + "format": "int32" + } + } + }, + "OutlierDetection": { + "id": "OutlierDetection", + "description": "Settings controlling the eviction of unhealthy hosts from the load balancing pool for the backend service.", + "type": "object", + "properties": { + "consecutiveErrors": { + "description": "Number of consecutive errors before a backend endpoint is ejected from the load balancing pool. When the backend endpoint is accessed over HTTP, a 5xx return code qualifies as an error. Defaults to 5.", + "type": "integer", + "format": "int32" }, - "delete": { - "id": "compute.regionInstanceGroupManagers.delete", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}", - "httpMethod": "DELETE", - "parameters": { - "instanceGroupManager": { - "description": "Name of the managed instance group to delete.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified managed instance group and all of the instances in that group." + "interval": { + "description": "Time interval between ejection analysis sweeps. This can result in both new ejections and backend endpoints being returned to service. The interval is equal to the number of seconds as defined in outlierDetection.interval.seconds plus the number of nanoseconds as defined in outlierDetection.interval.nanos. Defaults to 1 second.", + "$ref": "Duration" }, - "deleteInstances": { - "id": "compute.regionInstanceGroupManagers.deleteInstances", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deleteInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "Name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagersDeleteInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Flags the specified instances in the managed instance group to be immediately deleted. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. The deleteInstances operation is marked DONE if the deleteInstances request is successful. The underlying actions take additional time. You must separately verify the status of the deleting action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." + "baseEjectionTime": { + "description": "The base time that a backend endpoint is ejected for. Defaults to 30000ms or 30s. After a backend endpoint is returned back to the load balancing pool, it can be ejected again in another ejection analysis. Thus, the total ejection time is equal to the base ejection time multiplied by the number of times the backend endpoint has been ejected. Defaults to 30000ms or 30s.", + "$ref": "Duration" }, - "abandonInstances": { - "id": "compute.regionInstanceGroupManagers.abandonInstances", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/abandonInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "Name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagersAbandonInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Flags the specified instances to be immediately removed from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." + "maxEjectionPercent": { + "description": "Maximum percentage of backend endpoints in the load balancing pool for the backend service that can be ejected if the ejection conditions are met. Defaults to 50%.", + "type": "integer", + "format": "int32" }, - "recreateInstances": { - "id": "compute.regionInstanceGroupManagers.recreateInstances", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/recreateInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "Name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagersRecreateRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Flags the specified VM instances in the managed instance group to be immediately recreated. Each instance is recreated using the group's current configuration. This operation is marked as DONE when the flag is set even if the instances have not yet been recreated. You must separately verify the status of each instance by checking its currentAction field; for more information, see Checking the status of managed instances. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted. You can specify a maximum of 1000 instances with this method per request." + "enforcingConsecutiveErrors": { + "description": "The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive 5xx. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 0.", + "type": "integer", + "format": "int32" }, - "resize": { - "id": "compute.regionInstanceGroupManagers.resize", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resize", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/resize", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "Name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "size": { - "description": "Number of instances that should exist in this instance group manager.", - "minimum": "0", - "location": "query", - "required": true, - "type": "integer", - "format": "int32" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager", - "size" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the intended size of the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes one or more instances. The resize operation is marked DONE if the resize request is successful. The underlying actions take additional time. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method. If the group is part of a backend service that has enabled connection draining, it can take up to 60 seconds after the connection draining duration has elapsed before the VM instance is removed or deleted." + "enforcingSuccessRate": { + "description": "The percentage chance that a backend endpoint will be ejected when an outlier status is detected through success rate statistics. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100. Not supported when the backend service uses Serverless NEG.", + "type": "integer", + "format": "int32" }, - "setInstanceTemplate": { - "id": "compute.regionInstanceGroupManagers.setInstanceTemplate", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setInstanceTemplate", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagersSetTemplateRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the instance template to use when creating new instances or recreating instances in this group. Existing instances are not affected." + "successRateMinimumHosts": { + "description": "The number of backend endpoints in the load balancing pool that must have enough request volume to detect success rate outliers. If the number of backend endpoints is fewer than this setting, outlier detection via success rate statistics is not performed for any backend endpoint in the load balancing pool. Defaults to 5. Not supported when the backend service uses Serverless NEG.", + "type": "integer", + "format": "int32" }, - "setTargetPools": { - "id": "compute.regionInstanceGroupManagers.setTargetPools", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/setTargetPools", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "Name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagersSetTargetPoolsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Modifies the target pools to which all new instances in this group are assigned. Existing instances in the group are not affected." + "successRateRequestVolume": { + "description": "The minimum number of total requests that must be collected in one interval (as defined by the interval duration above) to include this backend endpoint in success rate based outlier detection. If the volume is lower than this setting, outlier detection via success rate statistics is not performed for that backend endpoint. Defaults to 100. Not supported when the backend service uses Serverless NEG.", + "type": "integer", + "format": "int32" }, - "listManagedInstances": { - "id": "compute.regionInstanceGroupManagers.listManagedInstances", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listManagedInstances", - "httpMethod": "POST", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "instanceGroupManager": { - "description": "The name of the managed instance group.", - "location": "path", - "required": true, - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "response": { - "$ref": "RegionInstanceGroupManagersListInstancesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances. The orderBy query parameter is not supported. The `pageToken` query parameter is supported only if the group's `listManagedInstancesResults` field is set to `PAGINATED`." + "successRateStdevFactor": { + "description": "This factor is used to determine the ejection threshold for success rate outlier ejection. The ejection threshold is the difference between the mean success rate, and the product of this factor and the standard deviation of the mean success rate: mean - (stdev * successRateStdevFactor). This factor is divided by a thousand to get a double. That is, if the desired factor is 1.9, the runtime value should be 1900. Defaults to 1900. Not supported when the backend service uses Serverless NEG.", + "type": "integer", + "format": "int32" }, - "listErrors": { - "id": "compute.regionInstanceGroupManagers.listErrors", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listErrors", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listErrors", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "instanceGroupManager": { - "description": "The name of the managed instance group. It must be a string that meets the requirements in RFC1035, or an unsigned long integer: must match regexp pattern: (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}.", - "location": "path", - "required": true, - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request. This should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" + "consecutiveGatewayFailure": { + "description": "The number of consecutive gateway failures (502, 503, 504 status or connection errors that are mapped to one of those status codes) before a consecutive gateway failure ejection occurs. Defaults to 3.", + "type": "integer", + "format": "int32" + }, + "enforcingConsecutiveGatewayFailure": { + "description": "The percentage chance that a backend endpoint will be ejected when an outlier status is detected through consecutive gateway failures. This setting can be used to disable ejection or to ramp it up slowly. Defaults to 100.", + "type": "integer", + "format": "int32" + } + } + }, + "Subsetting": { + "id": "Subsetting", + "description": "Subsetting configuration for this BackendService. Currently this is applicable only for Internal TCP/UDP load balancing, Internal HTTP(S) load balancing and Traffic Director.", + "type": "object", + "properties": { + "policy": { + "type": "string", + "enumDescriptions": [ + "Subsetting based on consistent hashing. For Traffic Director, the number of backends per backend group (the subset size) is based on the `subset_size` parameter. For Internal HTTP(S) load balancing, the number of backends per backend group (the subset size) is dynamically adjusted in two cases: - As the number of proxy instances participating in Internal HTTP(S) load balancing increases, the subset size decreases. - When the total number of backends in a network exceeds the capacity of a single proxy instance, subset sizes are reduced automatically for each service that has backend subsetting enabled.", + "No Subsetting. Clients may open connections and send traffic to all backends of this backend service. This can lead to performance issues if there is substantial imbalance in the count of clients and backends." ], - "response": { - "$ref": "RegionInstanceGroupManagersListErrorsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "CONSISTENT_HASH_SUBSETTING", + "NONE" + ] + } + } + }, + "BackendServiceConnectionTrackingPolicy": { + "id": "BackendServiceConnectionTrackingPolicy", + "description": "Connection Tracking configuration for this BackendService.", + "type": "object", + "properties": { + "trackingMode": { + "description": "Specifies the key used for connection tracking. There are two options: - PER_CONNECTION: This is the default mode. The Connection Tracking is performed as per the Connection Key (default Hash Method) for the specific protocol. - PER_SESSION: The Connection Tracking is performed as per the configured Session Affinity. It matches the configured Session Affinity. For more details, see [Tracking Mode for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#tracking-mode) and [Tracking Mode for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#tracking-mode).", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "description": "Lists all errors thrown by actions on instances for a given regional managed instance group. The filter and orderBy query parameters are not supported." + "enum": [ + "INVALID_TRACKING_MODE", + "PER_CONNECTION", + "PER_SESSION" + ] }, - "listPerInstanceConfigs": { - "id": "compute.regionInstanceGroupManagers.listPerInstanceConfigs", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs", - "httpMethod": "POST", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "instanceGroupManager": { - "description": "The name of the managed instance group. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request, should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "response": { - "$ref": "RegionInstanceGroupManagersListInstanceConfigsResp" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "connectionPersistenceOnUnhealthyBackends": { + "description": "Specifies connection persistence when backends are unhealthy. The default value is DEFAULT_FOR_PROTOCOL. If set to DEFAULT_FOR_PROTOCOL, the existing connections persist on unhealthy backends only for connection-oriented protocols (TCP and SCTP) and only if the Tracking Mode is PER_CONNECTION (default tracking mode) or the Session Affinity is configured for 5-tuple. They do not persist for UDP. If set to NEVER_PERSIST, after a backend becomes unhealthy, the existing connections on the unhealthy backend are never persisted on the unhealthy backend. They are always diverted to newly selected healthy backends (unless all backends are unhealthy). If set to ALWAYS_PERSIST, existing connections always persist on unhealthy backends regardless of protocol and session affinity. It is generally not recommended to use this mode overriding the default. For more details, see [Connection Persistence for Network Load Balancing](https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence) and [Connection Persistence for Internal TCP/UDP Load Balancing](https://cloud.google.com/load-balancing/docs/internal#connection-persistence).", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "description": "Lists all of the per-instance configurations defined for the managed instance group. The orderBy query parameter is not supported." + "enum": [ + "ALWAYS_PERSIST", + "DEFAULT_FOR_PROTOCOL", + "NEVER_PERSIST" + ] }, - "updatePerInstanceConfigs": { - "id": "compute.regionInstanceGroupManagers.updatePerInstanceConfigs", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request, should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagerUpdateInstanceConfigReq" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Inserts or updates per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch." + "idleTimeoutSec": { + "description": "Specifies how long to keep a Connection Tracking entry while there is no matching traffic (in seconds). For internal passthrough Network Load Balancers: - The minimum (default) is 10 minutes and the maximum is 16 hours. - It can be set only if Connection Tracking is less than 5-tuple (i.e. Session Affinity is CLIENT_IP_NO_DESTINATION, CLIENT_IP or CLIENT_IP_PROTO, and Tracking Mode is PER_SESSION). For external passthrough Network Load Balancers the default is 60 seconds. This option is not available publicly.", + "type": "integer", + "format": "int32" }, - "patchPerInstanceConfigs": { - "id": "compute.regionInstanceGroupManagers.patchPerInstanceConfigs", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request, should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagerPatchInstanceConfigReq" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Inserts or patches per-instance configurations for the managed instance group. perInstanceConfig.name serves as a key used to distinguish whether to perform insert or patch." + "enableStrongAffinity": { + "description": "Enable Strong Session Affinity for external passthrough Network Load Balancers. This option is not available publicly.", + "type": "boolean" + } + } + }, + "BackendServiceLocalityLoadBalancingPolicyConfig": { + "id": "BackendServiceLocalityLoadBalancingPolicyConfig", + "description": "Container for either a built-in LB policy supported by gRPC or Envoy or a custom one implemented by the end user.", + "type": "object", + "properties": { + "policy": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy" }, - "deletePerInstanceConfigs": { - "id": "compute.regionInstanceGroupManagers.deletePerInstanceConfigs", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request, should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagerDeleteInstanceConfigReq" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "customPolicy": { + "$ref": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy" + } + } + }, + "BackendServiceLocalityLoadBalancingPolicyConfigPolicy": { + "id": "BackendServiceLocalityLoadBalancingPolicyConfigPolicy", + "description": "The configuration for a built-in load balancing policy.", + "type": "object", + "properties": { + "name": { + "description": "The name of a locality load-balancing policy. Valid values include ROUND_ROBIN and, for Java clients, LEAST_REQUEST. For information about these values, see the description of localityLbPolicy. Do not specify the same policy more than once for a backend. If you do, the configuration is rejected.", + "type": "string", + "enumDescriptions": [ + "", + "An O(1) algorithm which selects two random healthy hosts and picks the host which has fewer active requests.", + "This algorithm implements consistent hashing to backends. Maglev can be used as a drop in replacement for the ring hash load balancer. Maglev is not as stable as ring hash but has faster table lookup build times and host selection times. For more information about Maglev, see https://ai.google/research/pubs/pub44824", + "Backend host is selected based on the client connection metadata, i.e., connections are opened to the same address as the destination address of the incoming connection before the connection was redirected to the load balancer.", + "The load balancer selects a random healthy host.", + "The ring/modulo hash load balancer implements consistent hashing to backends. The algorithm has the property that the addition/removal of a host from a set of N hosts only affects 1/N of the requests.", + "This is a simple policy in which each healthy backend is selected in round robin order. This is the default.", + "Per-instance weighted Load Balancing via health check reported weights. If set, the Backend Service must configure a non legacy HTTP-based Health Check, and health check replies are expected to contain non-standard HTTP response header field X-Load-Balancing-Endpoint-Weight to specify the per-instance weights. If set, Load Balancing is weighted based on the per-instance weights reported in the last processed health check replies, as long as every instance either reported a valid weight or had UNAVAILABLE_WEIGHT. Otherwise, Load Balancing remains equal-weight. This option is only supported in Network Load Balancing." ], - "description": "Deletes selected per-instance configurations for the managed instance group." + "enum": [ + "INVALID_LB_POLICY", + "LEAST_REQUEST", + "MAGLEV", + "ORIGINAL_DESTINATION", + "RANDOM", + "RING_HASH", + "ROUND_ROBIN", + "WEIGHTED_MAGLEV" + ] + } + } + }, + "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy": { + "id": "BackendServiceLocalityLoadBalancingPolicyConfigCustomPolicy", + "description": "The configuration for a custom policy implemented by the user and deployed with the client.", + "type": "object", + "properties": { + "name": { + "description": "Identifies the custom policy. The value should match the name of a custom implementation registered on the gRPC clients. It should follow protocol buffer message naming conventions and include the full path (for example, myorg.CustomLbPolicy). The maximum length is 256 characters. Do not specify the same custom policy more than once for a backend. If you do, the configuration is rejected. For an example of how to use this field, see Use a custom policy.", + "type": "string" }, - "applyUpdatesToInstances": { - "id": "compute.regionInstanceGroupManagers.applyUpdatesToInstances", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/applyUpdatesToInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group, should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request, should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagersApplyUpdatesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Apply updates to selected instances the managed instance group." + "data": { + "description": "An optional, arbitrary JSON object with configuration data, understood by a locally installed custom policy implementation.", + "type": "string" + } + } + }, + "BackendServiceUsedBy": { + "id": "BackendServiceUsedBy", + "type": "object", + "properties": { + "reference": { + "description": "[Output Only] Server-defined URL for resources referencing given BackendService like UrlMaps, TargetTcpProxies, TargetSslProxies and ForwardingRule.", + "type": "string" + } + } + }, + "BackendServiceHttpCookie": { + "id": "BackendServiceHttpCookie", + "description": "The HTTP cookie used for stateful session affinity.", + "type": "object", + "properties": { + "name": { + "description": "Name of the cookie.", + "type": "string" }, - "createInstances": { - "id": "compute.regionInstanceGroupManagers.createInstances", - "path": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", - "flatPath": "projects/{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/createInstances", - "httpMethod": "POST", - "parameters": { - "instanceGroupManager": { - "description": "The name of the managed instance group. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "path": { + "description": "Path to set for the cookie.", + "type": "string" + }, + "ttl": { + "description": "Lifetime of the cookie.", + "$ref": "Duration" + } + } + }, + "BackendServiceAggregatedList": { + "id": "BackendServiceAggregatedList", + "description": "Contains a list of BackendServicesScopedList.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#backendServiceAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of BackendServicesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of BackendServices.", + "$ref": "BackendServicesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region where the managed instance group is located. It should conform to RFC1035.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "instanceGroupManager" - ], - "request": { - "$ref": "RegionInstanceGroupManagersCreateInstancesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates instances with per-instance configurations in this regional managed instance group. Instances are created using the current instance template. The create instances operation is marked DONE if the createInstances request is successful. The underlying actions take additional time. You must separately verify the status of the creating or actions with the listmanagedinstances method." + } + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } } } }, - "autoscalers": { - "methods": { - "list": { - "id": "compute.autoscalers.list", - "path": "projects/{project}/zones/{zone}/autoscalers", - "flatPath": "projects/{project}/zones/{zone}/autoscalers", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "AutoscalerList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of autoscalers contained within the specified zone." + "BackendServicesScopedList": { + "id": "BackendServicesScopedList", + "type": "object", + "properties": { + "backendServices": { + "description": "A list of BackendServices contained in this scope.", + "type": "array", + "items": { + "$ref": "BackendService" + } }, - "aggregatedList": { - "id": "compute.autoscalers.aggregatedList", - "path": "projects/{project}/aggregated/autoscalers", - "flatPath": "projects/{project}/aggregated/autoscalers", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", + "warning": { + "description": "Informational warning which replaces the list of backend services when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "AutoscalerAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of autoscalers. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." - }, - "get": { - "id": "compute.autoscalers.get", - "path": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", - "flatPath": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", - "httpMethod": "GET", - "parameters": { - "autoscaler": { - "description": "Name of the autoscaler to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "autoscaler" - ], - "response": { - "$ref": "Autoscaler" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified autoscaler resource." + } + } + } + }, + "BackendServiceListUsable": { + "id": "BackendServiceListUsable", + "description": "Contains a list of usable BackendService resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#usableBackendServiceList for lists of usable backend services.", + "default": "compute#usableBackendServiceList", + "type": "string" }, - "insert": { - "id": "compute.autoscalers.insert", - "path": "projects/{project}/zones/{zone}/autoscalers", - "flatPath": "projects/{project}/zones/{zone}/autoscalers", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "Autoscaler" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates an autoscaler in the specified project using the data included in the request." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "update": { - "id": "compute.autoscalers.update", - "path": "projects/{project}/zones/{zone}/autoscalers", - "flatPath": "projects/{project}/zones/{zone}/autoscalers", - "httpMethod": "PUT", - "parameters": { - "autoscaler": { - "description": "Name of the autoscaler to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of BackendService resources.", + "type": "array", + "items": { + "$ref": "BackendService" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "Autoscaler" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates an autoscaler in the specified project using the data included in the request." + } + } + } + }, + "ResourceGroupReference": { + "id": "ResourceGroupReference", + "type": "object", + "properties": { + "group": { + "description": "A URI referencing one of the instance groups or network endpoint groups listed in the backend service.", + "type": "string" + } + } + }, + "BackendServiceGroupHealth": { + "id": "BackendServiceGroupHealth", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#backendServiceGroupHealth for the health of backend services.", + "default": "compute#backendServiceGroupHealth", + "type": "string" }, - "patch": { - "id": "compute.autoscalers.patch", - "path": "projects/{project}/zones/{zone}/autoscalers", - "flatPath": "projects/{project}/zones/{zone}/autoscalers", - "httpMethod": "PATCH", - "parameters": { - "autoscaler": { - "description": "Name of the autoscaler to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "Autoscaler" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + "healthStatus": { + "description": "Health state of the backend instances or endpoints in requested instance or network endpoint group, determined based on configured health checks.", + "type": "array", + "items": { + "$ref": "HealthStatus" + } }, - "delete": { - "id": "compute.autoscalers.delete", - "path": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", - "flatPath": "projects/{project}/zones/{zone}/autoscalers/{autoscaler}", - "httpMethod": "DELETE", - "parameters": { - "autoscaler": { - "description": "Name of the autoscaler to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "autoscaler" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified autoscaler." + "annotations": { + "description": "Metadata defined as annotations on the network endpoint group.", + "type": "object", + "additionalProperties": { + "type": "string" + } } } }, - "regionAutoscalers": { - "methods": { - "list": { - "id": "compute.regionAutoscalers.list", - "path": "projects/{project}/regions/{region}/autoscalers", - "flatPath": "projects/{project}/regions/{region}/autoscalers", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "RegionAutoscalerList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "HealthStatus": { + "id": "HealthStatus", + "type": "object", + "properties": { + "ipAddress": { + "description": "For target pool based Network Load Balancing, it indicates the forwarding rule's IP address assigned to this instance. For other types of load balancing, the field indicates VM internal ip.", + "type": "string" + }, + "ipv6Address": { + "type": "string" + }, + "port": { + "description": "The named port of the instance group, not necessarily the port that is health-checked.", + "type": "integer", + "format": "int32" + }, + "instance": { + "description": "URL of the instance resource.", + "type": "string" + }, + "healthState": { + "description": "Health state of the IPv4 address of the instance.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves a list of autoscalers contained within the specified region." + "enum": [ + "HEALTHY", + "UNHEALTHY" + ] }, - "get": { - "id": "compute.regionAutoscalers.get", - "path": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", - "flatPath": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", - "httpMethod": "GET", - "parameters": { - "autoscaler": { - "description": "Name of the autoscaler to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "autoscaler" + "ipv6HealthState": { + "description": "Health state of the IPv6 address of the instance.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "response": { - "$ref": "Autoscaler" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "HEALTHY", + "UNHEALTHY" + ] + }, + "annotations": { + "description": "Metadata defined as annotations for network endpoint.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "weight": { + "type": "string" + }, + "weightError": { + "type": "string", + "enumDescriptions": [ + "The response to a Health Check probe had the HTTP response header field X-Load-Balancing-Endpoint-Weight, but its content was invalid (i.e., not a non-negative single-precision floating-point number in decimal string representation).", + "The response to a Health Check probe did not have the HTTP response header field X-Load-Balancing-Endpoint-Weight.", + "This is the value when the accompanied health status is either TIMEOUT (i.e.,the Health Check probe was not able to get a response in time) or UNKNOWN. For the latter, it should be typically because there has not been sufficient time to parse and report the weight for a new backend (which is with 0.0.0.0 ip address). However, it can be also due to an outage case for which the health status is explicitly reset to UNKNOWN.", + "This is the default value when WeightReportMode is DISABLE, and is also the initial value when WeightReportMode has just updated to ENABLE or DRY_RUN and there has not been sufficient time to parse and report the backend weight." ], - "description": "Returns the specified autoscaler." + "enum": [ + "INVALID_WEIGHT", + "MISSING_WEIGHT", + "UNAVAILABLE_WEIGHT", + "WEIGHT_NONE" + ] }, - "insert": { - "id": "compute.regionAutoscalers.insert", - "path": "projects/{project}/regions/{region}/autoscalers", - "flatPath": "projects/{project}/regions/{region}/autoscalers", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "forwardingRuleIp": { + "description": "A forwarding rule IP address assigned to this instance.", + "type": "string" + }, + "forwardingRule": { + "description": "URL of the forwarding rule associated with the health status of the instance.", + "type": "string" + } + } + }, + "CommitmentList": { + "id": "CommitmentList", + "description": "Contains a list of Commitment resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#commitmentList for lists of commitments.", + "default": "compute#commitmentList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Commitment resources.", + "type": "array", + "items": { + "$ref": "Commitment" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "Autoscaler" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + } + } + } + }, + "Commitment": { + "id": "Commitment", + "description": "Represents a regional Commitment resource. Creating a commitment resource means that you are purchasing a committed use contract with an explicit start and end time. You can create commitments based on vCPUs and memory usage and receive discounted rates. For full details, read Signing Up for Committed Use Discounts.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#commitment for commitments.", + "default": "compute#commitment", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where this commitment may be used.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "status": { + "description": "[Output Only] Status of the commitment with regards to eventual expiration (each commitment has an end date defined). One of the following values: NOT_YET_ACTIVE, ACTIVE, EXPIRED.", + "type": "string", + "enumDescriptions": [ + "", + "Deprecate CANCELED status. Will use separate status to differentiate cancel by mergeCud or manual cancellation.", + "", + "", + "" ], - "description": "Creates an autoscaler in the specified project using the data included in the request." + "enum": [ + "ACTIVE", + "CANCELLED", + "CREATING", + "EXPIRED", + "NOT_YET_ACTIVE" + ] }, - "update": { - "id": "compute.regionAutoscalers.update", - "path": "projects/{project}/regions/{region}/autoscalers", - "flatPath": "projects/{project}/regions/{region}/autoscalers", - "httpMethod": "PUT", - "parameters": { - "autoscaler": { - "description": "Name of the autoscaler to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" + "statusMessage": { + "description": "[Output Only] An optional, human-readable explanation of the status.", + "type": "string" + }, + "plan": { + "description": "The plan for this commitment, which determines duration and discount rate. The currently supported plans are TWELVE_MONTH (1 year), and THIRTY_SIX_MONTH (3 years).", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "request": { - "$ref": "Autoscaler" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "INVALID", + "THIRTY_SIX_MONTH", + "TWELVE_MONTH" + ] + }, + "startTimestamp": { + "description": "[Output Only] Commitment start time in RFC3339 text format.", + "type": "string" + }, + "endTimestamp": { + "description": "[Output Only] Commitment end time in RFC3339 text format.", + "type": "string" + }, + "resources": { + "description": "A list of commitment amounts for particular resources. Note that VCPU and MEMORY resource commitments must occur together.", + "type": "array", + "items": { + "$ref": "ResourceCommitment" + } + }, + "type": { + "description": "The type of commitment, which affects the discount rate and the eligible resources. Type MEMORY_OPTIMIZED specifies a commitment that will only apply to memory optimized machines. Type ACCELERATOR_OPTIMIZED specifies a commitment that will only apply to accelerator optimized machines.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Updates an autoscaler in the specified project using the data included in the request." + "enum": [ + "ACCELERATOR_OPTIMIZED", + "ACCELERATOR_OPTIMIZED_A3", + "ACCELERATOR_OPTIMIZED_A3_MEGA", + "COMPUTE_OPTIMIZED", + "COMPUTE_OPTIMIZED_C2D", + "COMPUTE_OPTIMIZED_C3", + "COMPUTE_OPTIMIZED_C3D", + "COMPUTE_OPTIMIZED_H3", + "GENERAL_PURPOSE", + "GENERAL_PURPOSE_C4", + "GENERAL_PURPOSE_E2", + "GENERAL_PURPOSE_N2", + "GENERAL_PURPOSE_N2D", + "GENERAL_PURPOSE_N4", + "GENERAL_PURPOSE_T2D", + "GRAPHICS_OPTIMIZED", + "MEMORY_OPTIMIZED", + "MEMORY_OPTIMIZED_M3", + "STORAGE_OPTIMIZED_Z3", + "TYPE_UNSPECIFIED" + ] }, - "patch": { - "id": "compute.regionAutoscalers.patch", - "path": "projects/{project}/regions/{region}/autoscalers", - "flatPath": "projects/{project}/regions/{region}/autoscalers", - "httpMethod": "PATCH", - "parameters": { - "autoscaler": { - "description": "Name of the autoscaler to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" + "reservations": { + "description": "List of create-on-create reservations for this commitment.", + "type": "array", + "items": { + "$ref": "Reservation" + } + }, + "category": { + "description": "The category of the commitment. Category MACHINE specifies commitments composed of machine resources such as VCPU or MEMORY, listed in resources. Category LICENSE specifies commitments composed of software licenses, listed in licenseResources. Note that only MACHINE commitments should have a Type specified.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "request": { - "$ref": "Autoscaler" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "CATEGORY_UNSPECIFIED", + "LICENSE", + "MACHINE" + ] + }, + "licenseResource": { + "description": "The license specification required as part of a license commitment.", + "$ref": "LicenseResourceCommitment" + }, + "autoRenew": { + "description": "Specifies whether to enable automatic renewal for the commitment. The default value is false if not specified. The field can be updated until the day of the commitment expiration at 12:00am PST. If the field is set to true, the commitment will be automatically renewed for either one or three years according to the terms of the existing commitment.", + "type": "boolean" + }, + "mergeSourceCommitments": { + "description": "List of source commitments to be merged into a new commitment.", + "type": "array", + "items": { + "type": "string" + } + }, + "splitSourceCommitment": { + "description": "Source commitment to be split into a new commitment.", + "type": "string" + }, + "resourceStatus": { + "description": "[Output Only] Status information for Commitment resource.", + "$ref": "CommitmentResourceStatus" + }, + "existingReservations": { + "description": "Specifies the already existing reservations to attach to the Commitment. This field is optional, and it can be a full or partial URL. For example, the following are valid URLs to an reservation: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /reservations/reservation - projects/project/zones/zone/reservations/reservation ", + "type": "array", + "items": { + "type": "string" + } + }, + "customEndTimestamp": { + "description": "[Input Only] Optional, specifies the CUD end time requested by the customer in RFC3339 text format. Needed when the customer wants CUD's end date is later than the start date + term duration.", + "type": "string" + } + } + }, + "ResourceCommitment": { + "id": "ResourceCommitment", + "description": "Commitment for a particular resource (a Commitment is composed of one or more of these).", + "type": "object", + "properties": { + "type": { + "description": "Type of resource for which this commitment applies. Possible values are VCPU, MEMORY, LOCAL_SSD, and ACCELERATOR.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "description": "Updates an autoscaler in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + "enum": [ + "ACCELERATOR", + "LOCAL_SSD", + "MEMORY", + "UNSPECIFIED", + "VCPU" + ] }, - "delete": { - "id": "compute.regionAutoscalers.delete", - "path": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", - "flatPath": "projects/{project}/regions/{region}/autoscalers/{autoscaler}", - "httpMethod": "DELETE", - "parameters": { - "autoscaler": { - "description": "Name of the autoscaler to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "amount": { + "description": "The amount of the resource purchased (in a type-dependent unit, such as bytes). For vCPUs, this can just be an integer. For memory, this must be provided in MB. Memory must be a multiple of 256 MB, with up to 6.5GB of memory per every vCPU.", + "type": "string", + "format": "int64" + }, + "acceleratorType": { + "description": "Name of the accelerator type resource. Applicable only when the type is ACCELERATOR.", + "type": "string" + } + } + }, + "LicenseResourceCommitment": { + "id": "LicenseResourceCommitment", + "description": "Commitment for a particular license resource.", + "type": "object", + "properties": { + "license": { + "description": "Any applicable license URI.", + "type": "string" + }, + "amount": { + "description": "The number of licenses purchased.", + "type": "string", + "format": "int64" + }, + "coresPerLicense": { + "description": "Specifies the core range of the instance for which this license applies.", + "type": "string" + } + } + }, + "CommitmentResourceStatus": { + "id": "CommitmentResourceStatus", + "description": "[Output Only] Contains output only fields.", + "type": "object", + "properties": { + "customTermEligibilityEndTimestamp": { + "description": "[Output Only] Indicates the end time of customer's eligibility to send custom term requests in RFC3339 text format. Term extension requests that (not the end time in the request) after this time will be rejected.", + "type": "string" + } + } + }, + "CommitmentAggregatedList": { + "id": "CommitmentAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#commitmentAggregatedList for aggregated lists of commitments.", + "default": "compute#commitmentAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of CommitmentsScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of commitments.", + "$ref": "CommitmentsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "autoscaler" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified autoscaler." + } + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } } } }, - "backendBuckets": { - "methods": { - "list": { - "id": "compute.backendBuckets.list", - "path": "projects/{project}/global/backendBuckets", - "flatPath": "projects/{project}/global/backendBuckets", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "CommitmentsScopedList": { + "id": "CommitmentsScopedList", + "type": "object", + "properties": { + "commitments": { + "description": "[Output Only] A list of commitments contained in this scope.", + "type": "array", + "items": { + "$ref": "Commitment" + } + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of commitments when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "BackendBucketList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of BackendBucket resources available to the specified project." + } + } + } + }, + "DiskTypeList": { + "id": "DiskTypeList", + "description": "Contains a list of disk types.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#diskTypeList for disk types.", + "default": "compute#diskTypeList", + "type": "string" }, - "get": { - "id": "compute.backendBuckets.get", - "path": "projects/{project}/global/backendBuckets/{backendBucket}", - "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", - "httpMethod": "GET", - "parameters": { - "backendBucket": { - "description": "Name of the BackendBucket resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendBucket" - ], - "response": { - "$ref": "BackendBucket" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified BackendBucket resource." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.backendBuckets.insert", - "path": "projects/{project}/global/backendBuckets", - "flatPath": "projects/{project}/global/backendBuckets", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "BackendBucket" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a BackendBucket resource in the specified project using the data included in the request." + "items": { + "description": "A list of DiskType resources.", + "type": "array", + "items": { + "$ref": "DiskType" + } }, - "delete": { - "id": "compute.backendBuckets.delete", - "path": "projects/{project}/global/backendBuckets/{backendBucket}", - "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", - "httpMethod": "DELETE", - "parameters": { - "backendBucket": { - "description": "Name of the BackendBucket resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendBucket" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified BackendBucket resource." + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "update": { - "id": "compute.backendBuckets.update", - "path": "projects/{project}/global/backendBuckets/{backendBucket}", - "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", - "httpMethod": "PUT", - "parameters": { - "backendBucket": { - "description": "Name of the BackendBucket resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendBucket" - ], - "request": { - "$ref": "BackendBucket" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified BackendBucket resource with the data included in the request." + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" }, - "patch": { - "id": "compute.backendBuckets.patch", - "path": "projects/{project}/global/backendBuckets/{backendBucket}", - "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}", - "httpMethod": "PATCH", - "parameters": { - "backendBucket": { - "description": "Name of the BackendBucket resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "backendBucket" - ], - "request": { - "$ref": "BackendBucket" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified BackendBucket resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + } + } + } + }, + "DiskType": { + "id": "DiskType", + "description": "Represents a Disk Type resource. Google Compute Engine has two Disk Type resources: * [Regional](/compute/docs/reference/rest/v1/regionDiskTypes) * [Zonal](/compute/docs/reference/rest/v1/diskTypes) You can choose from a variety of disk types based on your needs. For more information, read Storage options. The diskTypes resource represents disk types for a zonal persistent disk. For more information, read Zonal persistent disks. The regionDiskTypes resource represents disk types for a regional persistent disk. For more information, read Regional persistent disks.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#diskType for disk types.", + "default": "compute#diskType", + "type": "string" }, - "addSignedUrlKey": { - "id": "compute.backendBuckets.addSignedUrlKey", - "path": "projects/{project}/global/backendBuckets/{backendBucket}/addSignedUrlKey", - "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/addSignedUrlKey", - "httpMethod": "POST", - "parameters": { - "backendBucket": { - "description": "Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendBucket" - ], - "request": { - "$ref": "SignedUrlKey" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Adds a key for validating requests with signed URLs for this backend bucket." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "deleteSignedUrlKey": { - "id": "compute.backendBuckets.deleteSignedUrlKey", - "path": "projects/{project}/global/backendBuckets/{backendBucket}/deleteSignedUrlKey", - "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/deleteSignedUrlKey", - "httpMethod": "POST", - "parameters": { - "backendBucket": { - "description": "Name of the BackendBucket resource to which the Signed URL Key should be added. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "keyName": { - "description": "The name of the Signed URL Key to delete.", - "location": "query", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendBucket", - "keyName" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes a key for validating requests with signed URLs for this backend bucket." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "setEdgeSecurityPolicy": { - "id": "compute.backendBuckets.setEdgeSecurityPolicy", - "path": "projects/{project}/global/backendBuckets/{backendBucket}/setEdgeSecurityPolicy", - "flatPath": "projects/{project}/global/backendBuckets/{backendBucket}/setEdgeSecurityPolicy", - "httpMethod": "POST", - "parameters": { - "backendBucket": { - "description": "Name of the BackendBucket resource to which the security policy should be set. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendBucket" - ], - "request": { - "$ref": "SecurityPolicyReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the edge security policy for the specified backend bucket." + "name": { + "description": "[Output Only] Name of the resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" }, - "getIamPolicy": { - "id": "compute.backendBuckets.getIamPolicy", - "path": "projects/{project}/global/backendBuckets/{resource}/getIamPolicy", - "flatPath": "projects/{project}/global/backendBuckets/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "description": { + "description": "[Output Only] An optional description of this resource.", + "type": "string" }, - "setIamPolicy": { - "id": "compute.backendBuckets.setIamPolicy", - "path": "projects/{project}/global/backendBuckets/{resource}/setIamPolicy", - "flatPath": "projects/{project}/global/backendBuckets/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "validDiskSize": { + "description": "[Output Only] An optional textual description of the valid disk size, such as \"10GB-10TB\".", + "type": "string" }, - "testIamPermissions": { - "id": "compute.backendBuckets.testIamPermissions", - "path": "projects/{project}/global/backendBuckets/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/backendBuckets/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + "deprecated": { + "description": "[Output Only] The deprecation status associated with this disk type.", + "$ref": "DeprecationStatus" + }, + "zone": { + "description": "[Output Only] URL of the zone where the disk type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "defaultDiskSizeGb": { + "description": "[Output Only] Server-defined default disk size in GB.", + "type": "string", + "format": "int64" + }, + "region": { + "description": "[Output Only] URL of the region where the disk type resides. Only applicable for regional resources. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" } } }, - "backendServices": { - "methods": { - "list": { - "id": "compute.backendServices.list", - "path": "projects/{project}/global/backendServices", - "flatPath": "projects/{project}/global/backendServices", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "BackendServiceList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of BackendService resources available to the specified project." + "DiskTypeAggregatedList": { + "id": "DiskTypeAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#diskTypeAggregatedList.", + "default": "compute#diskTypeAggregatedList", + "type": "string" }, - "aggregatedList": { - "id": "compute.backendServices.aggregatedList", - "path": "projects/{project}/aggregated/backendServices", - "flatPath": "projects/{project}/aggregated/backendServices", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of DiskTypesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of disk types.", + "$ref": "DiskTypesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "BackendServiceAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of all BackendService resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + } }, - "listUsable": { - "id": "compute.backendServices.listUsable", - "path": "projects/{project}/global/backendServices/listUsable", - "flatPath": "projects/{project}/global/backendServices/listUsable", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "DiskTypesScopedList": { + "id": "DiskTypesScopedList", + "type": "object", + "properties": { + "diskTypes": { + "description": "[Output Only] A list of disk types contained in this scope.", + "type": "array", + "items": { + "$ref": "DiskType" + } + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of disk types when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "BackendServiceListUsable" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of all usable backend services in the specified project." + } + } + } + }, + "RegionDiskTypeList": { + "id": "RegionDiskTypeList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#regionDiskTypeList for region disk types.", + "default": "compute#regionDiskTypeList", + "type": "string" }, - "get": { - "id": "compute.backendServices.get", - "path": "projects/{project}/global/backendServices/{backendService}", - "flatPath": "projects/{project}/global/backendServices/{backendService}", - "httpMethod": "GET", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendService" - ], - "response": { - "$ref": "BackendService" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified BackendService resource." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.backendServices.insert", - "path": "projects/{project}/global/backendServices", - "flatPath": "projects/{project}/global/backendServices", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "BackendService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview ." + "items": { + "description": "A list of DiskType resources.", + "type": "array", + "items": { + "$ref": "DiskType" + } }, - "delete": { - "id": "compute.backendServices.delete", - "path": "projects/{project}/global/backendServices/{backendService}", - "flatPath": "projects/{project}/global/backendServices/{backendService}", - "httpMethod": "DELETE", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendService" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified BackendService resource." + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "update": { - "id": "compute.backendServices.update", - "path": "projects/{project}/global/backendServices/{backendService}", - "flatPath": "projects/{project}/global/backendServices/{backendService}", - "httpMethod": "PUT", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "backendService" - ], - "request": { - "$ref": "BackendService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified BackendService resource with the data included in the request. For more information, see Backend services overview." + } + } + } + }, + "ExternalVpnGateway": { + "id": "ExternalVpnGateway", + "description": "Represents an external VPN gateway. External VPN gateway is the on-premises VPN gateway(s) or another cloud provider's VPN gateway that connects to your Google Cloud VPN gateway. To create a highly available VPN from Google Cloud Platform to your VPN gateway or another cloud provider's VPN gateway, you must create a external VPN gateway resource with information about the other gateway. For more information about using external VPN gateways, see Creating an HA VPN gateway and tunnel pair to a peer VPN.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#externalVpnGateway for externalVpnGateways.", + "default": "compute#externalVpnGateway", + "type": "string" }, - "patch": { - "id": "compute.backendServices.patch", - "path": "projects/{project}/global/backendServices/{backendService}", - "flatPath": "projects/{project}/global/backendServices/{backendService}", - "httpMethod": "PATCH", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendService" - ], - "request": { - "$ref": "BackendService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified BackendService resource with the data included in the request. For more information, see Backend services overview. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" }, - "addSignedUrlKey": { - "id": "compute.backendServices.addSignedUrlKey", - "path": "projects/{project}/global/backendServices/{backendService}/addSignedUrlKey", - "flatPath": "projects/{project}/global/backendServices/{backendService}/addSignedUrlKey", - "httpMethod": "POST", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendService" - ], - "request": { - "$ref": "SignedUrlKey" - }, - "response": { - "$ref": "Operation" + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.externalVpnGateways.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "string" + }, + "redundancyType": { + "description": "Indicates the user-supplied redundancy type of this external VPN gateway.", + "type": "string", + "enumDescriptions": [ + "The external VPN gateway has four public IP addresses; at the time of writing this API, the AWS virtual private gateway is an example which has four public IP addresses for high availability connections; there should be two VPN connections in the AWS virtual private gateway , each AWS VPN connection has two public IP addresses; please make sure to put two public IP addresses from one AWS VPN connection into interfaces 0 and 1 of this external VPN gateway, and put the other two public IP addresses from another AWS VPN connection into interfaces 2 and 3 of this external VPN gateway. When displaying highly available configuration status for the VPN tunnels connected to FOUR_IPS_REDUNDANCY external VPN gateway, Google will always detect whether interfaces 0 and 1 are connected on one interface of HA Cloud VPN gateway, and detect whether interfaces 2 and 3 are connected to another interface of the HA Cloud VPN gateway.", + "The external VPN gateway has only one public IP address which internally provide redundancy or failover.", + "The external VPN gateway has two public IP addresses which are redundant with each other, the following two types of setup on your on-premises side would have this type of redundancy: (1) Two separate on-premises gateways, each with one public IP address, the two on-premises gateways are redundant with each other. (2) A single on-premise gateway with two public IP addresses that are redundant with eatch other." ], - "description": "Adds a key for validating requests with signed URLs for this backend service." + "enum": [ + "FOUR_IPS_REDUNDANCY", + "SINGLE_IP_INTERNALLY_REDUNDANT", + "TWO_IPS_REDUNDANCY" + ] }, - "deleteSignedUrlKey": { - "id": "compute.backendServices.deleteSignedUrlKey", - "path": "projects/{project}/global/backendServices/{backendService}/deleteSignedUrlKey", - "flatPath": "projects/{project}/global/backendServices/{backendService}/deleteSignedUrlKey", - "httpMethod": "POST", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to which the Signed URL Key should be added. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "keyName": { - "description": "The name of the Signed URL Key to delete.", - "location": "query", - "required": true, - "type": "string" + "interfaces": { + "description": "A list of interfaces for this external VPN gateway. If your peer-side gateway is an on-premises gateway and non-AWS cloud providers' gateway, at most two interfaces can be provided for an external VPN gateway. If your peer side is an AWS virtual private gateway, four interfaces should be provided for an external VPN gateway.", + "type": "array", + "items": { + "$ref": "ExternalVpnGatewayInterface" + } + }, + "labels": { + "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this ExternalVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an ExternalVpnGateway.", + "type": "string", + "format": "byte" + } + } + }, + "ExternalVpnGatewayInterface": { + "id": "ExternalVpnGatewayInterface", + "description": "The interface for the external VPN gateway.", + "type": "object", + "properties": { + "id": { + "description": "The numeric ID of this interface. The allowed input values for this id for different redundancy types of external VPN gateway: - SINGLE_IP_INTERNALLY_REDUNDANT - 0 - TWO_IPS_REDUNDANCY - 0, 1 - FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 ", + "type": "integer", + "format": "uint32" + }, + "ipAddress": { + "description": "IP address of the interface in the external VPN gateway. Only IPv4 is supported. This IP address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine.", + "type": "string" + }, + "ipv6Address": { + "description": "IPv6 address of the interface in the external VPN gateway. This IPv6 address can be either from your on-premise gateway or another Cloud provider's VPN gateway, it cannot be an IP address from Google Compute Engine. Must specify an IPv6 address (not IPV4-mapped) using any format described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).", + "type": "string" + } + } + }, + "ExternalVpnGatewayList": { + "id": "ExternalVpnGatewayList", + "description": "Response to the list request, and contains a list of externalVpnGateways.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#externalVpnGatewayList for lists of externalVpnGateways.", + "default": "compute#externalVpnGatewayList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of ExternalVpnGateway resources.", + "type": "array", + "items": { + "$ref": "ExternalVpnGateway" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "backendService", - "keyName" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes a key for validating requests with signed URLs for this backend service." + } }, - "setSecurityPolicy": { - "id": "compute.backendServices.setSecurityPolicy", - "path": "projects/{project}/global/backendServices/{backendService}/setSecurityPolicy", - "flatPath": "projects/{project}/global/backendServices/{backendService}/setSecurityPolicy", - "httpMethod": "POST", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" + "etag": { + "type": "string" + } + } + }, + "ForwardingRuleList": { + "id": "ForwardingRuleList", + "description": "Contains a list of ForwardingRule resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#forwardingRuleList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of ForwardingRule resources.", + "type": "array", + "items": { + "$ref": "ForwardingRule" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "backendService" - ], - "request": { - "$ref": "SecurityPolicyReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview" + } + } + } + }, + "ForwardingRule": { + "id": "ForwardingRule", + "description": "Represents a Forwarding Rule resource. Forwarding rule resources in Google Cloud can be either regional or global in scope: * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules) * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules) A forwarding rule and its corresponding IP address represent the frontend configuration of a Google Cloud load balancer. Forwarding rules can also reference target instances and Cloud VPN Classic gateways (targetVpnGateway). For more information, read Forwarding rule concepts and Using protocol forwarding.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#forwardingRule for forwarding rule resources.", + "default": "compute#forwardingRule", + "type": "string" }, - "setEdgeSecurityPolicy": { - "id": "compute.backendServices.setEdgeSecurityPolicy", - "path": "projects/{project}/global/backendServices/{backendService}/setEdgeSecurityPolicy", - "flatPath": "projects/{project}/global/backendServices/{backendService}/setEdgeSecurityPolicy", - "httpMethod": "POST", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to which the edge security policy should be set. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendService" - ], - "request": { - "$ref": "SecurityPolicyReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the edge security policy for the specified backend service." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "getHealth": { - "id": "compute.backendServices.getHealth", - "path": "projects/{project}/global/backendServices/{backendService}/getHealth", - "flatPath": "projects/{project}/global/backendServices/{backendService}/getHealth", - "httpMethod": "POST", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to which the queried instance belongs.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "backendService" - ], - "request": { - "$ref": "ResourceGroupReference" - }, - "response": { - "$ref": "BackendServiceGroupHealth" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the most recent health check results for this BackendService. Example request body: { \"group\": \"/zones/us-east1-b/instanceGroups/lb-backend-example\" }" + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "getIamPolicy": { - "id": "compute.backendServices.getIamPolicy", - "path": "projects/{project}/global/backendServices/{resource}/getIamPolicy", - "flatPath": "projects/{project}/global/backendServices/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" + "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. For Private Service Connect forwarding rules that forward traffic to Google APIs, the forwarding rule name must be a 1-20 characters string with lowercase letters and numbers and must start with a letter.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the regional forwarding rule resides. This field is not applicable to global forwarding rules. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "IPAddress": { + "description": "IP address for which this forwarding rule accepts traffic. When a client sends traffic to this IP address, the forwarding rule directs the traffic to the referenced target or backendService. While creating a forwarding rule, specifying an IPAddress is required under the following circumstances: - When the target is set to targetGrpcProxy and validateForProxyless is set to true, the IPAddress should be set to 0.0.0.0. - When the target is a Private Service Connect Google APIs bundle, you must specify an IPAddress. Otherwise, you can optionally specify an IP address that references an existing static (reserved) IP address resource. When omitted, Google Cloud assigns an ephemeral IP address. Use one of the following formats to specify an IP address while creating a forwarding rule: * IP address number, as in `100.1.2.3` * IPv6 address range, as in `2600:1234::/96` * Full resource URL, as in https://www.googleapis.com/compute/v1/projects/ project_id/regions/region/addresses/address-name * Partial URL or by name, as in: - projects/project_id/regions/region/addresses/address-name - regions/region/addresses/address-name - global/addresses/address-name - address-name The forwarding rule's target or backendService, and in most cases, also the loadBalancingScheme, determine the type of IP address that you can use. For detailed information, see [IP address specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). When reading an IPAddress, the API always returns the IP address number.", + "type": "string" + }, + "IPProtocol": { + "description": "The IP protocol to which this rule applies. For protocol forwarding, valid options are TCP, UDP, ESP, AH, SCTP, ICMP and L3_DEFAULT. The valid IP protocols are different for different load balancing products as described in [Load balancing features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends).", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "AH", + "ESP", + "ICMP", + "L3_DEFAULT", + "SCTP", + "TCP", + "UDP" + ] + }, + "portRange": { + "description": "The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The portRange field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: external passthrough Network Load Balancers, internal and external proxy Network Load Balancers, internal and external Application Load Balancers, external protocol forwarding, and Classic VPN. - Some products have restrictions on what ports can be used. See port specifications for details. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot have overlapping portRanges. @pattern: \\\\d+(?:-\\\\d+)?", + "type": "string" + }, + "ports": { + "description": "The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The ports field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, or SCTP, and - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal protocol forwarding. - You can specify a list of up to five ports by number, separated by commas. The ports can be contiguous or discontiguous. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair if they share at least one port number. @pattern: \\\\d+(?:-\\\\d+)?", + "type": "array", + "items": { + "type": "string" + } + }, + "target": { + "description": "The URL of the target resource to receive the matched traffic. For regional forwarding rules, this target must be in the same region as the forwarding rule. For global forwarding rules, this target must be a global load balancing resource. The forwarded traffic must be of a type appropriate to the target object. - For load balancers, see the \"Target\" column in [Port specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). - For Private Service Connect forwarding rules that forward traffic to Google APIs, provide the name of a supported Google API bundle: - vpc-sc - APIs that support VPC Service Controls. - all-apis - All supported Google APIs. - For Private Service Connect forwarding rules that forward traffic to managed services, the target must be a service attachment. The target is not mutable once set as a service attachment. ", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "loadBalancingScheme": { + "description": "Specifies the forwarding rule type. For more information about forwarding rules, refer to Forwarding rule concepts.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "" ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "enum": [ + "EXTERNAL", + "EXTERNAL_MANAGED", + "INTERNAL", + "INTERNAL_MANAGED", + "INTERNAL_SELF_MANAGED", + "INVALID" + ] }, - "setIamPolicy": { - "id": "compute.backendServices.setIamPolicy", - "path": "projects/{project}/global/backendServices/{resource}/setIamPolicy", - "flatPath": "projects/{project}/global/backendServices/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" + "subnetwork": { + "description": "This field identifies the subnetwork that the load balanced IP should belong to for this forwarding rule, used with internal load balancers and external passthrough Network Load Balancers with IPv6. If the network specified is in auto subnet mode, this field is optional. However, a subnetwork must be specified if the network is in custom subnet mode or when creating external forwarding rule with IPv6.", + "type": "string" + }, + "network": { + "description": "This field is not used for global external load balancing. For internal passthrough Network Load Balancers, this field identifies the network that the load balanced IP should belong to for this forwarding rule. If the subnetwork is specified, the network of the subnetwork will be used. If neither subnetwork nor this field is specified, the default network will be used. For Private Service Connect forwarding rules that forward traffic to Google APIs, a network must be provided.", + "type": "string" + }, + "backendService": { + "description": "Identifies the backend service to which the forwarding rule sends traffic. Required for internal and external passthrough Network Load Balancers; must be omitted for all other load balancer types.", + "type": "string" + }, + "serviceDirectoryRegistrations": { + "description": "Service Directory resources to register this forwarding rule with. Currently, only supports a single Service Directory resource.", + "type": "array", + "items": { + "$ref": "ForwardingRuleServiceDirectoryRegistration" + } + }, + "serviceLabel": { + "description": "An optional prefix to the service name for this forwarding rule. If specified, the prefix is the first label of the fully qualified service name. The label must be 1-63 characters long, and comply with RFC1035. Specifically, the label 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. This field is only used for internal load balancing.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "serviceName": { + "description": "[Output Only] The internal fully qualified service name for this forwarding rule. This field is only used for internal load balancing.", + "type": "string" + }, + "networkTier": { + "description": "This signifies the networking tier used for configuring this load balancer and can only take the following values: PREMIUM, STANDARD. For regional ForwardingRule, the valid values are PREMIUM and STANDARD. For GlobalForwardingRule, the valid value is PREMIUM. If this field is not specified, it is assumed to be PREMIUM. If IPAddress is specified, this value must be equal to the networkTier of the Address.", + "type": "string", + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking products.", + "Public internet quality, only limited support for other networking products.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" + ] + }, + "labels": { + "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this resource, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule.", + "type": "string", + "format": "byte" + }, + "ipVersion": { + "description": "The IP Version that will be used by this forwarding rule. Valid options are IPV4 or IPV6.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "enum": [ + "IPV4", + "IPV6", + "UNSPECIFIED_VERSION" + ] }, - "testIamPermissions": { - "id": "compute.backendServices.testIamPermissions", - "path": "projects/{project}/global/backendServices/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/backendServices/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" + "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 ForwardingRule. Include the fingerprint in patch request to ensure that you do not overwrite changes that were applied from another concurrent request. To see the latest fingerprint, make a get() request to retrieve a ForwardingRule.", + "type": "string", + "format": "byte" + }, + "allPorts": { + "description": "The ports, portRange, and allPorts fields are mutually exclusive. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The allPorts field has the following limitations: - It requires that the forwarding rule IPProtocol be TCP, UDP, SCTP, or L3_DEFAULT. - It's applicable only to the following products: internal passthrough Network Load Balancers, backend service-based external passthrough Network Load Balancers, and internal and external protocol forwarding. - Set this field to true to allow packets addressed to any port or packets lacking destination port information (for example, UDP fragments after the first fragment) to be forwarded to the backends configured with this forwarding rule. The L3_DEFAULT protocol requires allPorts be set to true. ", + "type": "boolean" + }, + "allowGlobalAccess": { + "description": "If set to true, clients can access the internal passthrough Network Load Balancers, the regional internal Application Load Balancer, and the regional internal proxy Network Load Balancer from all regions. If false, only allows access from the local region the load balancer is located at. Note that for INTERNAL_MANAGED forwarding rules, this field cannot be changed after the forwarding rule is created.", + "type": "boolean" + }, + "metadataFilters": { + "description": "Opaque filter criteria used by load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to load balancer, xDS clients present node metadata. When there is a match, the relevant configuration is made available to those proxies. Otherwise, all the resources (e.g. TargetHttpProxy, UrlMap) referenced by the ForwardingRule are not visible to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadataFilters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here will be applifed before those specified in the UrlMap that this ForwardingRule references. metadataFilters only applies to Loadbalancers that have their loadBalancingScheme set to INTERNAL_SELF_MANAGED.", + "type": "array", + "items": { + "$ref": "MetadataFilter" + } + }, + "isMirroringCollector": { + "description": "Indicates whether or not this load balancer can be used as a collector for packet mirroring. To prevent mirroring loops, instances behind this load balancer will not have their traffic mirrored even if a PacketMirroring rule applies to them. This can only be set to true for load balancers that have their loadBalancingScheme set to INTERNAL.", + "type": "boolean" + }, + "sourceIpRanges": { + "description": "If not empty, this forwarding rule will only forward the traffic when the source IP address matches one of the IP addresses or CIDR ranges set here. Note that a forwarding rule can only have up to 64 source IP ranges, and this field can only be used with a regional forwarding rule whose scheme is EXTERNAL. Each source_ip_range entry should be either an IP address (for example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24).", + "type": "array", + "items": { + "type": "string" + } + }, + "pscConnectionId": { + "description": "[Output Only] The PSC connection id of the PSC forwarding rule.", + "type": "string", + "format": "uint64" + }, + "pscConnectionStatus": { + "type": "string", + "enumDescriptions": [ + "The connection has been accepted by the producer.", + "The connection has been closed by the producer and will not serve traffic going forward.", + "The connection has been accepted by the producer, but the producer needs to take further action before the forwarding rule can serve traffic.", + "The connection is pending acceptance by the producer.", + "The connection has been rejected by the producer.", + "" ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "ACCEPTED", + "CLOSED", + "NEEDS_ATTENTION", + "PENDING", + "REJECTED", + "STATUS_UNSPECIFIED" + ] + }, + "baseForwardingRule": { + "description": "[Output Only] The URL for the corresponding base forwarding rule. By base forwarding rule, we mean the forwarding rule that has the same IP address, protocol, and port settings with the current forwarding rule, but without sourceIPRanges specified. Always empty if the current forwarding rule does not have sourceIPRanges specified.", + "type": "string" + }, + "allowPscGlobalAccess": { + "description": "This is used in PSC consumer ForwardingRule to control whether the PSC endpoint can be accessed from another region.", + "type": "boolean" + }, + "noAutomateDnsZone": { + "description": "This is used in PSC consumer ForwardingRule to control whether it should try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use this field. Once set, this field is not mutable.", + "type": "boolean" + }, + "ipCollection": { + "description": "Resource reference of a PublicDelegatedPrefix. The PDP must be a sub-PDP in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. Use one of the following formats to specify a sub-PDP when creating an IPv6 NetLB forwarding rule using BYOIP: Full resource URL, as in https://www.googleapis.com/compute/v1/projects/project_id/regions/region /publicDelegatedPrefixes/sub-pdp-name Partial URL, as in: - projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name - regions/region/publicDelegatedPrefixes/sub-pdp-name ", + "type": "string" + } + } + }, + "ForwardingRuleServiceDirectoryRegistration": { + "id": "ForwardingRuleServiceDirectoryRegistration", + "description": "Describes the auto-registration of the forwarding rule to Service Directory. The region and project of the Service Directory resource generated from this registration will be the same as this forwarding rule.", + "type": "object", + "properties": { + "namespace": { + "description": "Service Directory namespace to register the forwarding rule under.", + "type": "string" + }, + "service": { + "description": "Service Directory service to register the forwarding rule under.", + "type": "string" + }, + "serviceDirectoryRegion": { + "description": "[Optional] Service Directory region to register this global forwarding rule under. Default to \"us-central1\". Only used for PSC for Google APIs. All PSC for Google APIs forwarding rules on the same network should use the same Service Directory region.", + "type": "string" + } + } + }, + "MetadataFilter": { + "id": "MetadataFilter", + "description": "Opaque filter criteria used by load balancers to restrict routing configuration to a limited set of load balancing proxies. Proxies and sidecars involved in load balancing would typically present metadata to the load balancers that need to match criteria specified here. If a match takes place, the relevant configuration is made available to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. An example for using metadataFilters would be: if load balancing involves Envoys, they receive routing configuration when values in metadataFilters match values supplied in of their XDS requests to loadbalancers.", + "type": "object", + "properties": { + "filterMatchCriteria": { + "description": "Specifies how individual filter label matches within the list of filterLabels and contributes toward the overall metadataFilter match. Supported values are: - MATCH_ANY: at least one of the filterLabels must have a matching label in the provided metadata. - MATCH_ALL: all filterLabels must have matching labels in the provided metadata. ", + "type": "string", + "enumDescriptions": [ + "Specifies that all filterLabels must match for the metadataFilter to be considered a match.", + "Specifies that any filterLabel must match for the metadataFilter to be considered a match.", + "Indicates that the match criteria was not set. A metadataFilter must never be created with this value." ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "MATCH_ALL", + "MATCH_ANY", + "NOT_SET" + ] + }, + "filterLabels": { + "description": "The list of label value pairs that must match labels in the provided metadata based on filterMatchCriteria This list must not be empty and can have at the most 64 entries.", + "type": "array", + "items": { + "$ref": "MetadataFilterLabelMatch" + } } } }, - "regionBackendServices": { - "methods": { - "list": { - "id": "compute.regionBackendServices.list", - "path": "projects/{project}/regions/{region}/backendServices", - "flatPath": "projects/{project}/regions/{region}/backendServices", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "BackendServiceList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of regional BackendService resources available to the specified project in the given region." + "MetadataFilterLabelMatch": { + "id": "MetadataFilterLabelMatch", + "description": "MetadataFilter label name value pairs that are expected to match corresponding labels presented as metadata to the load balancer.", + "type": "object", + "properties": { + "name": { + "description": "Name of metadata label. The name can have a maximum length of 1024 characters and must be at least 1 character long.", + "type": "string" }, - "listUsable": { - "id": "compute.regionBackendServices.listUsable", - "path": "projects/{project}/regions/{region}/backendServices/listUsable", - "flatPath": "projects/{project}/regions/{region}/backendServices/listUsable", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request. It must be a string that meets the requirements in RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "BackendServiceListUsable" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of all usable backend services in the specified project in the given region." + "value": { + "description": "The value of the label must match the specified value. value can have a maximum length of 1024 characters.", + "type": "string" + } + } + }, + "TargetReference": { + "id": "TargetReference", + "type": "object", + "properties": { + "target": { + "type": "string" + } + } + }, + "ForwardingRuleAggregatedList": { + "id": "ForwardingRuleAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#forwardingRuleAggregatedList for lists of forwarding rules.", + "default": "compute#forwardingRuleAggregatedList", + "type": "string" }, - "get": { - "id": "compute.regionBackendServices.get", - "path": "projects/{project}/regions/{region}/backendServices/{backendService}", - "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", - "httpMethod": "GET", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "backendService" - ], - "response": { - "$ref": "BackendService" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified regional BackendService resource." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.regionBackendServices.insert", - "path": "projects/{project}/regions/{region}/backendServices", - "flatPath": "projects/{project}/regions/{region}/backendServices", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of ForwardingRulesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of addresses.", + "$ref": "ForwardingRulesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "BackendService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a regional BackendService resource in the specified project using the data included in the request. For more information, see Backend services overview." + } }, - "delete": { - "id": "compute.regionBackendServices.delete", - "path": "projects/{project}/regions/{region}/backendServices/{backendService}", - "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", - "httpMethod": "DELETE", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "ForwardingRulesScopedList": { + "id": "ForwardingRulesScopedList", + "type": "object", + "properties": { + "forwardingRules": { + "description": "A list of forwarding rules contained in this scope.", + "type": "array", + "items": { + "$ref": "ForwardingRule" + } + }, + "warning": { + "description": "Informational warning which replaces the list of forwarding rules when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "backendService" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified regional BackendService resource." + } + } + } + }, + "HealthCheckServicesList": { + "id": "HealthCheckServicesList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#healthCheckServicesList for lists of HealthCheckServices.", + "default": "compute#healthCheckServicesList", + "type": "string" }, - "update": { - "id": "compute.regionBackendServices.update", - "path": "projects/{project}/regions/{region}/backendServices/{backendService}", - "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", - "httpMethod": "PUT", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "backendService" - ], - "request": { - "$ref": "BackendService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified regional BackendService resource with the data included in the request. For more information, see Backend services overview ." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "patch": { - "id": "compute.regionBackendServices.patch", - "path": "projects/{project}/regions/{region}/backendServices/{backendService}", - "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}", - "httpMethod": "PATCH", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of HealthCheckService resources.", + "type": "array", + "items": { + "$ref": "HealthCheckService" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "backendService" - ], - "request": { - "$ref": "BackendService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + } + } + } + }, + "HealthCheckService": { + "id": "HealthCheckService", + "description": "Represents a Health-Check as a Service resource.", + "type": "object", + "properties": { + "kind": { + "description": "[Output only] Type of the resource. Always compute#healthCheckServicefor health check services.", + "default": "compute#healthCheckService", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "name": { + "description": "Name of the resource. 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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the health check service resides. This field is not applicable to global health check services. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "healthStatusAggregationPolicy": { + "description": "Optional. Policy for how the results from multiple health checks for the same endpoint are aggregated. Defaults to NO_AGGREGATION if unspecified. - NO_AGGREGATION. An EndpointHealth message is returned for each pair in the health check service. - AND. If any health check of an endpoint reports UNHEALTHY, then UNHEALTHY is the HealthState of the endpoint. If all health checks report HEALTHY, the HealthState of the endpoint is HEALTHY. . This is only allowed with regional HealthCheckService.", + "type": "string", + "enumDescriptions": [ + "If any backend's health check reports UNHEALTHY, then UNHEALTHY is the HealthState of the entire health check service. If all backend's are healthy, the HealthState of the health check service is HEALTHY.", + "An EndpointHealth message is returned for each backend in the health check service." ], - "description": "Updates the specified regional BackendService resource with the data included in the request. For more information, see Understanding backend services This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + "enum": [ + "AND", + "NO_AGGREGATION" + ] }, - "setSecurityPolicy": { - "id": "compute.regionBackendServices.setSecurityPolicy", - "path": "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy", - "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}/setSecurityPolicy", - "httpMethod": "POST", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource to which the security policy should be set. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "healthChecks": { + "description": "A list of URLs to the HealthCheck resources. Must have at least one HealthCheck, and not more than 10 for regional HealthCheckService, and not more than 1 for global HealthCheckService. HealthCheck resources must have portSpecification=USE_SERVING_PORT or portSpecification=USE_FIXED_PORT. For regional HealthCheckService, the HealthCheck must be regional and in the same region. For global HealthCheckService, HealthCheck must be global. Mix of regional and global HealthChecks is not supported. Multiple regional HealthChecks must belong to the same region. Regional HealthChecks must belong to the same region as zones of NetworkEndpointGroups. For global HealthCheckService using global INTERNET_IP_PORT NetworkEndpointGroups, the global HealthChecks must specify sourceRegions, and HealthChecks that specify sourceRegions can only be used with global INTERNET_IP_PORT NetworkEndpointGroups.", + "type": "array", + "items": { + "type": "string" + } + }, + "networkEndpointGroups": { + "description": "A list of URLs to the NetworkEndpointGroup resources. Must not have more than 100. For regional HealthCheckService, NEGs must be in zones in the region of the HealthCheckService. For global HealthCheckServices, the NetworkEndpointGroups must be global INTERNET_IP_PORT.", + "type": "array", + "items": { + "type": "string" + } + }, + "notificationEndpoints": { + "description": "A list of URLs to the NotificationEndpoint resources. Must not have more than 10. A list of endpoints for receiving notifications of change in health status. For regional HealthCheckService, NotificationEndpoint must be regional and in the same region. For global HealthCheckService, NotificationEndpoint must be global.", + "type": "array", + "items": { + "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 HealthCheckService. An up-to-date fingerprint must be provided in order to patch/update the HealthCheckService; Otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the HealthCheckService.", + "type": "string", + "format": "byte" + } + } + }, + "HealthCheckList": { + "id": "HealthCheckList", + "description": "Contains a list of HealthCheck resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#healthCheckList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of HealthCheck resources.", + "type": "array", + "items": { + "$ref": "HealthCheck" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "backendService" - ], - "request": { - "$ref": "SecurityPolicyReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the Google Cloud Armor security policy for the specified backend service. For more information, see Google Cloud Armor Overview" + } + } + } + }, + "HealthCheck": { + "id": "HealthCheck", + "description": "Represents a health check resource. Google Compute Engine has two health check resources: * [Regional](/compute/docs/reference/rest/v1/regionHealthChecks) * [Global](/compute/docs/reference/rest/v1/healthChecks) These health check resources can be used for load balancing and for autohealing VMs in a managed instance group (MIG). **Load balancing** Health check requirements vary depending on the type of load balancer. For details about the type of health check supported for each load balancer and corresponding backend type, see Health checks overview: Load balancer guide. **Autohealing in MIGs** The health checks that you use for autohealing VMs in a MIG can be either regional or global. For more information, see Set up an application health check and autohealing. For more information, see Health checks overview.", + "type": "object", + "properties": { + "kind": { + "description": "Type of the resource.", + "default": "compute#healthCheck", + "type": "string" }, - "getHealth": { - "id": "compute.regionBackendServices.getHealth", - "path": "projects/{project}/regions/{region}/backendServices/{backendService}/getHealth", - "flatPath": "projects/{project}/regions/{region}/backendServices/{backendService}/getHealth", - "httpMethod": "POST", - "parameters": { - "backendService": { - "description": "Name of the BackendService resource for which to get health.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "backendService" - ], - "request": { - "$ref": "ResourceGroupReference" - }, - "response": { - "$ref": "BackendServiceGroupHealth" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the most recent health check results for this regional BackendService." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "getIamPolicy": { - "id": "compute.regionBackendServices.getIamPolicy", - "path": "projects/{project}/regions/{region}/backendServices/{resource}/getIamPolicy", - "flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in 3339 text format.", + "type": "string" }, - "setIamPolicy": { - "id": "compute.regionBackendServices.setIamPolicy", - "path": "projects/{project}/regions/{region}/backendServices/{resource}/setIamPolicy", - "flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "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. For example, a name that is 1-63 characters long, matches the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with RFC1035. This regular expression describes a name where the first character is a lowercase letter, and all following characters are a dash, lowercase letter, or digit, except the last character, which isn't a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" }, - "testIamPermissions": { - "id": "compute.regionBackendServices.testIamPermissions", - "path": "projects/{project}/regions/{region}/backendServices/{resource}/testIamPermissions", - "flatPath": "projects/{project}/regions/{region}/backendServices/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "checkIntervalSec": { + "description": "How often (in seconds) to send a health check. The default value is 5 seconds.", + "type": "integer", + "format": "int32" + }, + "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.", + "type": "integer", + "format": "int32" + }, + "unhealthyThreshold": { + "description": "A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.", + "type": "integer", + "format": "int32" + }, + "healthyThreshold": { + "description": "A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.", + "type": "integer", + "format": "int32" + }, + "type": { + "description": "Specifies the type of the healthCheck, either TCP, SSL, HTTP, HTTPS, HTTP2 or GRPC. Exactly one of the protocol-specific health check fields must be specified, which must match type field.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "" ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "GRPC", + "HTTP", + "HTTP2", + "HTTPS", + "INVALID", + "SSL", + "TCP" + ] + }, + "tcpHealthCheck": { + "$ref": "TCPHealthCheck" + }, + "sslHealthCheck": { + "$ref": "SSLHealthCheck" + }, + "httpHealthCheck": { + "$ref": "HTTPHealthCheck" + }, + "httpsHealthCheck": { + "$ref": "HTTPSHealthCheck" + }, + "http2HealthCheck": { + "$ref": "HTTP2HealthCheck" + }, + "grpcHealthCheck": { + "$ref": "GRPCHealthCheck" + }, + "sourceRegions": { + "description": "The list of cloud regions from which health checks are performed. If any regions are specified, then exactly 3 regions should be specified. The region names must be valid names of Google Cloud regions. This can only be set for global health check. If this list is non-empty, then there are restrictions on what other health check fields are supported and what other resources can use this health check: - SSL, HTTP2, and GRPC protocols are not supported. - The TCP request field is not supported. - The proxyHeader field for HTTP, HTTPS, and TCP is not supported. - The checkIntervalSec field must be at least 30. - The health check cannot be used with BackendService nor with managed instance group auto-healing. ", + "type": "array", + "items": { + "type": "string" + } + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] Region where the health check resides. Not applicable to global health checks.", + "type": "string" + }, + "logConfig": { + "description": "Configure logging on this health check.", + "$ref": "HealthCheckLogConfig" } } }, - "regionCommitments": { - "methods": { - "list": { - "id": "compute.regionCommitments.list", - "path": "projects/{project}/regions/{region}/commitments", - "flatPath": "projects/{project}/regions/{region}/commitments", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" + "TCPHealthCheck": { + "id": "TCPHealthCheck", + "type": "object", + "properties": { + "port": { + "description": "The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535.", + "type": "integer", + "format": "int32" + }, + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", + "type": "string", + "enumDescriptions": [ + "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." ], - "response": { - "$ref": "CommitmentList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" + ] + }, + "request": { + "description": "Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection.", + "type": "string" + }, + "response": { + "description": "Creates a content-based TCP health check. In addition to establishing a TCP connection, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp", + "type": "string" + }, + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves a list of commitments contained within the specified region." + "enum": [ + "NONE", + "PROXY_V1" + ] + } + } + }, + "SSLHealthCheck": { + "id": "SSLHealthCheck", + "type": "object", + "properties": { + "port": { + "description": "The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535.", + "type": "integer", + "format": "int32" }, - "aggregatedList": { - "id": "compute.regionCommitments.aggregatedList", - "path": "projects/{project}/aggregated/commitments", - "flatPath": "projects/{project}/aggregated/commitments", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", + "type": "string", + "enumDescriptions": [ + "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." ], - "response": { - "$ref": "CommitmentAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" + ] + }, + "request": { + "description": "Instructs the health check prober to send this exact ASCII string, up to 1024 bytes in length, after establishing the TCP connection and SSL handshake.", + "type": "string" + }, + "response": { + "description": "Creates a content-based SSL health check. In addition to establishing a TCP connection and the TLS handshake, you can configure the health check to pass only when the backend sends this exact response ASCII string, up to 1024 bytes in length. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp", + "type": "string" + }, + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves an aggregated list of commitments by region. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "NONE", + "PROXY_V1" + ] + } + } + }, + "HTTPHealthCheck": { + "id": "HTTPHealthCheck", + "type": "object", + "properties": { + "port": { + "description": "The TCP port number to which the health check prober sends packets. The default value is 80. Valid values are 1 through 65535.", + "type": "integer", + "format": "int32" }, - "get": { - "id": "compute.regionCommitments.get", - "path": "projects/{project}/regions/{region}/commitments/{commitment}", - "flatPath": "projects/{project}/regions/{region}/commitments/{commitment}", - "httpMethod": "GET", - "parameters": { - "commitment": { - "description": "Name of the commitment to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "commitment" + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Also supported in legacy HTTP health checks for target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for pass-through load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", + "type": "string", + "enumDescriptions": [ + "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." ], - "response": { - "$ref": "Commitment" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" + ] + }, + "host": { + "description": "The value of the host header in the HTTP health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", + "type": "string" + }, + "requestPath": { + "description": "The request path of the HTTP health check request. The default value is /. Must comply with RFC3986.", + "type": "string" + }, + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified commitment resource." + "enum": [ + "NONE", + "PROXY_V1" + ] }, - "insert": { - "id": "compute.regionCommitments.insert", - "path": "projects/{project}/regions/{region}/commitments", - "flatPath": "projects/{project}/regions/{region}/commitments", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" + "response": { + "description": "Creates a content-based HTTP health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", + "type": "string" + } + } + }, + "HTTPSHealthCheck": { + "id": "HTTPSHealthCheck", + "type": "object", + "properties": { + "port": { + "description": "The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535.", + "type": "integer", + "format": "int32" + }, + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", + "type": "string", + "enumDescriptions": [ + "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." ], - "request": { - "$ref": "Commitment" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" + ] + }, + "host": { + "description": "The value of the host header in the HTTPS health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", + "type": "string" + }, + "requestPath": { + "description": "The request path of the HTTPS health check request. The default value is /. Must comply with RFC3986.", + "type": "string" + }, + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Creates a commitment in the specified project using the data included in the request." + "enum": [ + "NONE", + "PROXY_V1" + ] }, - "update": { - "id": "compute.regionCommitments.update", - "path": "projects/{project}/regions/{region}/commitments/{commitment}", - "flatPath": "projects/{project}/regions/{region}/commitments/{commitment}", - "httpMethod": "PATCH", - "parameters": { - "commitment": { - "description": "Name of the commitment for which auto renew is being updated.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "paths": { - "location": "query", - "repeated": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "updateMask": { - "description": "update_mask indicates fields to be updated as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - } - }, - "parameterOrder": [ - "project", - "region", - "commitment" + "response": { + "description": "Creates a content-based HTTPS health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", + "type": "string" + } + } + }, + "HTTP2HealthCheck": { + "id": "HTTP2HealthCheck", + "type": "object", + "properties": { + "port": { + "description": "The TCP port number to which the health check prober sends packets. The default value is 443. Valid values are 1 through 65535.", + "type": "integer", + "format": "int32" + }, + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", + "type": "string", + "enumDescriptions": [ + "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." ], - "request": { - "$ref": "Commitment" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" + ] + }, + "host": { + "description": "The value of the host header in the HTTP/2 health check request. If left empty (default value), the host header is set to the destination IP address to which health check packets are sent. The destination IP address depends on the type of load balancer. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest", + "type": "string" + }, + "requestPath": { + "description": "The request path of the HTTP/2 health check request. The default value is /. Must comply with RFC3986.", + "type": "string" + }, + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Updates the specified commitment with the data included in the request. Update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: auto_renew." + "enum": [ + "NONE", + "PROXY_V1" + ] + }, + "response": { + "description": "Creates a content-based HTTP/2 health check. In addition to the required HTTP 200 (OK) status code, you can configure the health check to pass only when the backend sends this specific ASCII response string within the first 1024 bytes of the HTTP response body. For details, see: https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http", + "type": "string" } } }, - "diskTypes": { - "methods": { - "list": { - "id": "compute.diskTypes.list", - "path": "projects/{project}/zones/{zone}/diskTypes", - "flatPath": "projects/{project}/zones/{zone}/diskTypes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "GRPCHealthCheck": { + "id": "GRPCHealthCheck", + "type": "object", + "properties": { + "port": { + "description": "The TCP port number to which the health check prober sends packets. Valid values are 1 through 65535.", + "type": "integer", + "format": "int32" + }, + "portName": { + "description": "Not supported.", + "type": "string" + }, + "portSpecification": { + "description": "Specifies how a port is selected for health checking. Can be one of the following values: USE_FIXED_PORT: Specifies a port number explicitly using the port field in the health check. Supported by backend services for passthrough load balancers and backend services for proxy load balancers. Not supported by target pools. The health check supports all backends supported by the backend service provided the backend can be health checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT network endpoint groups, and instance group backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an indirect method of specifying the health check port by referring to the backend service. Only supported by backend services for proxy load balancers. Not supported by target pools. Not supported by backend services for passthrough load balancers. Supports all backends that can be health checked; for example, GCE_VM_IP_PORT network endpoint groups and instance group backends. For GCE_VM_IP_PORT network endpoint group backends, the health check uses the port number specified for each endpoint in the network endpoint group. For instance group backends, the health check uses the port number determined by looking up the backend service's named port in the instance group's list of named ports.", + "type": "string", + "enumDescriptions": [ + "The port number in the health check's port is used for health checking. Applies to network endpoint group and instance group backends.", + "Not supported.", + "For network endpoint group backends, the health check uses the port number specified on each endpoint in the network endpoint group. For instance group backends, the health check uses the port number specified for the backend service's named port defined in the instance group's named ports." + ], + "enum": [ + "USE_FIXED_PORT", + "USE_NAMED_PORT", + "USE_SERVING_PORT" + ] + }, + "grpcServiceName": { + "description": "The gRPC service name for the health check. This field is optional. The value of grpc_service_name has the following meanings by convention: - Empty service_name means the overall status of all services at the backend. - Non-empty service_name means the health of that gRPC service, as defined by the owner of the service. The grpc_service_name can only be ASCII.", + "type": "string" + } + } + }, + "HealthCheckLogConfig": { + "id": "HealthCheckLogConfig", + "description": "Configuration of logging on a health check. If logging is enabled, logs will be exported to Stackdriver.", + "type": "object", + "properties": { + "enable": { + "description": "Indicates whether or not to export logs. This is false by default, which means no health check logging will be done.", + "type": "boolean" + } + } + }, + "HealthChecksAggregatedList": { + "id": "HealthChecksAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#healthChecksAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of HealthChecksScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of HealthChecks.", + "$ref": "HealthChecksScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "DiskTypeList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of disk types available to the specified project." + } }, - "aggregatedList": { - "id": "compute.diskTypes.aggregatedList", - "path": "projects/{project}/aggregated/diskTypes", - "flatPath": "projects/{project}/aggregated/diskTypes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "DiskTypeAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of disk types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "HealthChecksScopedList": { + "id": "HealthChecksScopedList", + "type": "object", + "properties": { + "healthChecks": { + "description": "A list of HealthChecks contained in this scope.", + "type": "array", + "items": { + "$ref": "HealthCheck" + } }, - "get": { - "id": "compute.diskTypes.get", - "path": "projects/{project}/zones/{zone}/diskTypes/{diskType}", - "flatPath": "projects/{project}/zones/{zone}/diskTypes/{diskType}", - "httpMethod": "GET", - "parameters": { - "diskType": { - "description": "Name of the disk type to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "Informational warning which replaces the list of backend services when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "diskType" - ], - "response": { - "$ref": "DiskType" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified disk type." + } } } }, - "regionDiskTypes": { - "methods": { - "list": { - "id": "compute.regionDiskTypes.list", - "path": "projects/{project}/regions/{region}/diskTypes", - "flatPath": "projects/{project}/regions/{region}/diskTypes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "RegionDiskTypeList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of regional disk types available to the specified project." + "HttpHealthCheckList": { + "id": "HttpHealthCheckList", + "description": "Contains a list of HttpHealthCheck resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#httpHealthCheckList", + "type": "string" }, - "get": { - "id": "compute.regionDiskTypes.get", - "path": "projects/{project}/regions/{region}/diskTypes/{diskType}", - "flatPath": "projects/{project}/regions/{region}/diskTypes/{diskType}", - "httpMethod": "GET", - "parameters": { - "diskType": { - "description": "Name of the disk type to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of HttpHealthCheck resources.", + "type": "array", + "items": { + "$ref": "HttpHealthCheck" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "diskType" - ], - "response": { - "$ref": "DiskType" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified regional disk type." + } } } }, - "externalVpnGateways": { - "methods": { - "insert": { - "id": "compute.externalVpnGateways.insert", - "path": "projects/{project}/global/externalVpnGateways", - "flatPath": "projects/{project}/global/externalVpnGateways", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "ExternalVpnGateway" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a ExternalVpnGateway in the specified project using the data included in the request." + "HttpHealthCheck": { + "id": "HttpHealthCheck", + "description": "Represents a legacy HTTP Health Check resource. Legacy HTTP health checks are now only required by target pool-based network load balancers. For all other load balancers, including backend service-based network load balancers, and for managed instance group auto-healing, you must use modern (non-legacy) health checks. For more information, see Health checks overview .", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#httpHealthCheck for HTTP health checks.", + "default": "compute#httpHealthCheck", + "type": "string" }, - "list": { - "id": "compute.externalVpnGateways.list", - "path": "projects/{project}/global/externalVpnGateways", - "flatPath": "projects/{project}/global/externalVpnGateways", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ExternalVpnGatewayList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of ExternalVpnGateway available to the specified project." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "get": { - "id": "compute.externalVpnGateways.get", - "path": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", - "flatPath": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", - "httpMethod": "GET", - "parameters": { - "externalVpnGateway": { - "description": "Name of the externalVpnGateway to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "externalVpnGateway" - ], - "response": { - "$ref": "ExternalVpnGateway" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified externalVpnGateway. Get a list of available externalVpnGateways by making a list() request." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "delete": { - "id": "compute.externalVpnGateways.delete", - "path": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", - "flatPath": "projects/{project}/global/externalVpnGateways/{externalVpnGateway}", - "httpMethod": "DELETE", - "parameters": { - "externalVpnGateway": { - "description": "Name of the externalVpnGateways to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "externalVpnGateway" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified externalVpnGateway." + "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" }, - "testIamPermissions": { - "id": "compute.externalVpnGateways.testIamPermissions", - "path": "projects/{project}/global/externalVpnGateways/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/externalVpnGateways/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" }, - "setLabels": { - "id": "compute.externalVpnGateways.setLabels", - "path": "projects/{project}/global/externalVpnGateways/{resource}/setLabels", - "flatPath": "projects/{project}/global/externalVpnGateways/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on an ExternalVpnGateway. To learn more about labels, read the Labeling Resources documentation." + "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" + }, + "requestPath": { + "description": "The request path of the HTTP health check request. The default value is /. This field does not support query parameters. Must comply with RFC3986.", + "type": "string" + }, + "port": { + "description": "The TCP port number for the HTTP health check request. The default value is 80.", + "type": "integer", + "format": "int32" + }, + "checkIntervalSec": { + "description": "How often (in seconds) to send a health check. The default value is 5 seconds.", + "type": "integer", + "format": "int32" + }, + "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.", + "type": "integer", + "format": "int32" + }, + "unhealthyThreshold": { + "description": "A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.", + "type": "integer", + "format": "int32" + }, + "healthyThreshold": { + "description": "A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.", + "type": "integer", + "format": "int32" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" } } }, - "globalForwardingRules": { - "methods": { - "list": { - "id": "compute.globalForwardingRules.list", - "path": "projects/{project}/global/forwardingRules", - "flatPath": "projects/{project}/global/forwardingRules", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ForwardingRuleList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of GlobalForwardingRule resources available to the specified project." + "HttpsHealthCheckList": { + "id": "HttpsHealthCheckList", + "description": "Contains a list of HttpsHealthCheck resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#httpsHealthCheckList", + "type": "string" }, - "get": { - "id": "compute.globalForwardingRules.get", - "path": "projects/{project}/global/forwardingRules/{forwardingRule}", - "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", - "httpMethod": "GET", - "parameters": { - "forwardingRule": { - "description": "Name of the ForwardingRule resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of HttpsHealthCheck resources.", + "type": "array", + "items": { + "$ref": "HttpsHealthCheck" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "forwardingRule" - ], - "response": { - "$ref": "ForwardingRule" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified GlobalForwardingRule resource. Gets a list of available forwarding rules by making a list() request." - }, - "insert": { - "id": "compute.globalForwardingRules.insert", - "path": "projects/{project}/global/forwardingRules", - "flatPath": "projects/{project}/global/forwardingRules", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "ForwardingRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a GlobalForwardingRule resource in the specified project using the data included in the request." + } + } + } + }, + "HttpsHealthCheck": { + "id": "HttpsHealthCheck", + "description": "Represents a legacy HTTPS Health Check resource. Legacy HTTPS health checks have been deprecated. If you are using a target pool-based network load balancer, you must use a legacy HTTP (not HTTPS) health check. For all other load balancers, including backend service-based network load balancers, and for managed instance group auto-healing, you must use modern (non-legacy) health checks. For more information, see Health checks overview .", + "type": "object", + "properties": { + "kind": { + "description": "Type of the resource.", + "default": "compute#httpsHealthCheck", + "type": "string" }, - "delete": { - "id": "compute.globalForwardingRules.delete", - "path": "projects/{project}/global/forwardingRules/{forwardingRule}", - "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", - "httpMethod": "DELETE", - "parameters": { - "forwardingRule": { - "description": "Name of the ForwardingRule resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "forwardingRule" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified GlobalForwardingRule resource." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "setTarget": { - "id": "compute.globalForwardingRules.setTarget", - "path": "projects/{project}/global/forwardingRules/{forwardingRule}/setTarget", - "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}/setTarget", - "httpMethod": "POST", - "parameters": { - "forwardingRule": { - "description": "Name of the ForwardingRule resource in which target is to be set.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "forwardingRule" - ], - "request": { - "$ref": "TargetReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes target URL for the GlobalForwardingRule resource. The new target should be of the same type as the old target." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "patch": { - "id": "compute.globalForwardingRules.patch", - "path": "projects/{project}/global/forwardingRules/{forwardingRule}", - "flatPath": "projects/{project}/global/forwardingRules/{forwardingRule}", - "httpMethod": "PATCH", - "parameters": { - "forwardingRule": { - "description": "Name of the ForwardingRule resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "forwardingRule" - ], - "request": { - "$ref": "ForwardingRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified forwarding rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. Currently, you can only patch the network_tier field." + "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" }, - "setLabels": { - "id": "compute.globalForwardingRules.setLabels", - "path": "projects/{project}/global/forwardingRules/{resource}/setLabels", - "flatPath": "projects/{project}/global/forwardingRules/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on the specified resource. To learn more about labels, read the Labeling resources documentation." + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "host": { + "description": "The value of the host header in the HTTPS 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" + }, + "requestPath": { + "description": "The request path of the HTTPS health check request. The default value is \"/\". Must comply with RFC3986.", + "type": "string" + }, + "port": { + "description": "The TCP port number for the HTTPS health check request. The default value is 443.", + "type": "integer", + "format": "int32" + }, + "checkIntervalSec": { + "description": "How often (in seconds) to send a health check. The default value is 5 seconds.", + "type": "integer", + "format": "int32" + }, + "timeoutSec": { + "description": "How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have a greater value than checkIntervalSec.", + "type": "integer", + "format": "int32" + }, + "unhealthyThreshold": { + "description": "A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.", + "type": "integer", + "format": "int32" + }, + "healthyThreshold": { + "description": "A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.", + "type": "integer", + "format": "int32" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" } } }, - "forwardingRules": { - "methods": { - "list": { - "id": "compute.forwardingRules.list", - "path": "projects/{project}/regions/{region}/forwardingRules", - "flatPath": "projects/{project}/regions/{region}/forwardingRules", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "ForwardingRuleList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of ForwardingRule resources available to the specified project and region." + "InstanceTemplateList": { + "id": "InstanceTemplateList", + "description": "A list of instance templates.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#instanceTemplatesListResponse for instance template lists.", + "default": "compute#instanceTemplateList", + "type": "string" }, - "aggregatedList": { - "id": "compute.forwardingRules.aggregatedList", - "path": "projects/{project}/aggregated/forwardingRules", - "flatPath": "projects/{project}/aggregated/forwardingRules", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InstanceTemplate resources.", + "type": "array", + "items": { + "$ref": "InstanceTemplate" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ForwardingRuleAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of forwarding rules. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + } + } + } + }, + "InstanceTemplate": { + "id": "InstanceTemplate", + "description": "Represents an Instance Template resource. Google Compute Engine has two Instance Template resources: * [Global](/compute/docs/reference/rest/v1/instanceTemplates) * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates) You can reuse a global instance template in different regions whereas you can use a regional instance template in a specified region only. If you want to reduce cross-region dependency or achieve data residency, use a regional instance template. To create VMs, managed instance groups, and reservations, you can use either global or regional instance templates. For more information, read Instance Templates.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#instanceTemplate for instance templates.", + "default": "compute#instanceTemplate", + "type": "string" }, - "get": { - "id": "compute.forwardingRules.get", - "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", - "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", - "httpMethod": "GET", - "parameters": { - "forwardingRule": { - "description": "Name of the ForwardingRule resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "forwardingRule" - ], - "response": { - "$ref": "ForwardingRule" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified ForwardingRule resource." + "id": { + "description": "[Output Only] A unique identifier for this instance template. The server defines this identifier.", + "type": "string", + "format": "uint64" }, - "insert": { - "id": "compute.forwardingRules.insert", - "path": "projects/{project}/regions/{region}/forwardingRules", - "flatPath": "projects/{project}/regions/{region}/forwardingRules", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "ForwardingRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a ForwardingRule resource in the specified project and region using the data included in the request." + "creationTimestamp": { + "description": "[Output Only] The creation timestamp for this instance template in RFC3339 text format.", + "type": "string" }, - "delete": { - "id": "compute.forwardingRules.delete", - "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", - "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", - "httpMethod": "DELETE", - "parameters": { - "forwardingRule": { - "description": "Name of the ForwardingRule resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "forwardingRule" - ], - "response": { - "$ref": "Operation" + "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])?", + "annotations": { + "required": [ + "compute.instanceTemplates.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified ForwardingRule resource." + "type": "string" }, - "setTarget": { - "id": "compute.forwardingRules.setTarget", - "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}/setTarget", - "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}/setTarget", - "httpMethod": "POST", - "parameters": { - "forwardingRule": { - "description": "Name of the ForwardingRule resource in which target is to be set.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "forwardingRule" - ], - "request": { - "$ref": "TargetReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes target URL for forwarding rule. The new target should be of the same type as the old target." + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" }, - "patch": { - "id": "compute.forwardingRules.patch", - "path": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", - "flatPath": "projects/{project}/regions/{region}/forwardingRules/{forwardingRule}", - "httpMethod": "PATCH", - "parameters": { - "forwardingRule": { - "description": "Name of the ForwardingRule resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "forwardingRule" - ], - "request": { - "$ref": "ForwardingRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "properties": { + "description": "The instance properties for this instance template.", + "$ref": "InstanceProperties" + }, + "selfLink": { + "description": "[Output Only] The URL for this instance template. The server defines this URL.", + "type": "string" + }, + "sourceInstance": { + "description": "The source instance used to create the template. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance ", + "type": "string" + }, + "sourceInstanceParams": { + "description": "The source instance params to use to create this instance template.", + "$ref": "SourceInstanceParams" + }, + "region": { + "description": "[Output Only] URL of the region where the instance template resides. Only applicable for regional resources.", + "type": "string" + } + } + }, + "SourceInstanceParams": { + "id": "SourceInstanceParams", + "description": "A specification of the parameters to use when creating the instance template from a source instance.", + "type": "object", + "properties": { + "diskConfigs": { + "description": "Attached disks configuration. If not provided, defaults are applied: For boot disk and any other R/W disks, the source images for each disk will be used. For read-only disks, they will be attached in read-only mode. Local SSD disks will be created as blank volumes.", + "type": "array", + "items": { + "$ref": "DiskInstantiationConfig" + } + } + } + }, + "DiskInstantiationConfig": { + "id": "DiskInstantiationConfig", + "description": "A specification of the desired way to instantiate a disk in the instance template when its created from a source instance.", + "type": "object", + "properties": { + "deviceName": { + "description": "Specifies the device name of the disk to which the configurations apply to.", + "type": "string" + }, + "instantiateFrom": { + "description": "Specifies whether to include the disk and what image to use. Possible values are: - source-image: to use the same image that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - source-image-family: to use the same image family that was used to create the source instance's corresponding disk. Applicable to the boot disk and additional read-write disks. - custom-image: to use a user-provided image url for disk creation. Applicable to the boot disk and additional read-write disks. - attach-read-only: to attach a read-only disk. Applicable to read-only disks. - do-not-include: to exclude a disk from the template. Applicable to additional read-write disks, local SSDs, and read-only disks. ", + "type": "string", + "enumDescriptions": [ + "Attach the existing disk in read-only mode. The request will fail if the disk was attached in read-write mode on the source instance. Applicable to: read-only disks.", + "Create a blank disk. The disk will be created unformatted. Applicable to: additional read-write disks, local SSDs.", + "Use the custom image specified in the custom_image field. Applicable to: boot disk, additional read-write disks.", + "Use the default instantiation option for the corresponding type of disk. For boot disk and any other R/W disks, new custom images will be created from each disk. For read-only disks, they will be attached in read-only mode. Local SSD disks will be created as blank volumes.", + "Do not include the disk in the instance template. Applicable to: additional read-write disks, local SSDs, read-only disks.", + "Use the same source image used for creation of the source instance's corresponding disk. The request will fail if the source VM's disk was created from a snapshot. Applicable to: boot disk, additional read-write disks.", + "Use the same source image family used for creation of the source instance's corresponding disk. The request will fail if the source image of the source disk does not belong to any image family. Applicable to: boot disk, additional read-write disks." ], - "description": "Updates the specified forwarding rule with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules. Currently, you can only patch the network_tier field." + "enum": [ + "ATTACH_READ_ONLY", + "BLANK", + "CUSTOM_IMAGE", + "DEFAULT", + "DO_NOT_INCLUDE", + "SOURCE_IMAGE", + "SOURCE_IMAGE_FAMILY" + ] }, - "setLabels": { - "id": "compute.forwardingRules.setLabels", - "path": "projects/{project}/regions/{region}/forwardingRules/{resource}/setLabels", - "flatPath": "projects/{project}/regions/{region}/forwardingRules/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "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" + }, + "customImage": { + "description": "The custom source image to be used to restore this disk when instantiating this instance template.", + "type": "string" + } + } + }, + "InstanceTemplateAggregatedList": { + "id": "InstanceTemplateAggregatedList", + "description": "Contains a list of InstanceTemplatesScopedList.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#instanceTemplateAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InstanceTemplatesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "The name of the scope that contains this set of instance templates.", + "$ref": "InstanceTemplatesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on the specified resource. To learn more about labels, read the Labeling Resources documentation." + } } } }, - "futureReservations": { - "methods": { - "insert": { - "id": "compute.futureReservations.insert", - "path": "projects/{project}/zones/{zone}/futureReservations", - "flatPath": "projects/{project}/zones/{zone}/futureReservations", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request. Name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "FutureReservation" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a new Future Reservation." + "InstanceTemplatesScopedList": { + "id": "InstanceTemplatesScopedList", + "type": "object", + "properties": { + "instanceTemplates": { + "description": "[Output Only] A list of instance templates that are contained within the specified project and zone.", + "type": "array", + "items": { + "$ref": "InstanceTemplate" + } }, - "get": { - "id": "compute.futureReservations.get", - "path": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", - "flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", - "httpMethod": "GET", - "parameters": { - "futureReservation": { - "description": "Name of the future reservation to retrieve. Name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] An informational warning that replaces the list of instance templates when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "Name of the zone for this request. Name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "futureReservation" - ], - "response": { - "$ref": "FutureReservation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves information about the specified future reservation." + } + } + } + }, + "InstanceSettings": { + "id": "InstanceSettings", + "description": "Represents a Instance Settings resource. You can use instance settings to configure default settings for Compute Engine VM instances. For example, you can use it to configure default machine type of Compute Engine VM instances.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#instance_settings for instance settings.", + "default": "compute#instanceSettings", + "type": "string" }, - "delete": { - "id": "compute.futureReservations.delete", - "path": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", - "flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", - "httpMethod": "DELETE", - "parameters": { - "futureReservation": { - "description": "Name of the future reservation to retrieve. Name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request. Name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "futureReservation" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified future reservation." + "fingerprint": { + "description": "Specifies a fingerprint for instance settings, which is essentially a hash of the instance settings resource's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update the instance settings resource. You must always provide an up-to-date fingerprint hash in order to update or change the resource, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the resource.", + "type": "string", + "format": "byte" }, - "list": { - "id": "compute.futureReservations.list", - "path": "projects/{project}/zones/{zone}/futureReservations", - "flatPath": "projects/{project}/zones/{zone}/futureReservations", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "Name of the zone for this request. Name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "FutureReservationsListResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "A list of all the future reservations that have been configured for the specified project in specified zone." + "metadata": { + "description": "The metadata key/value pairs assigned to all the instances in the corresponding scope.", + "$ref": "InstanceSettingsMetadata" }, - "aggregatedList": { - "id": "compute.futureReservations.aggregatedList", - "path": "projects/{project}/aggregated/futureReservations", - "flatPath": "projects/{project}/aggregated/futureReservations", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "zone": { + "description": "[Output Only] URL of the zone where the resource resides You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + } + } + }, + "InstanceSettingsMetadata": { + "id": "InstanceSettingsMetadata", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#metadata for metadata.", + "default": "compute#metadata", + "type": "string" + }, + "items": { + "description": "A metadata key/value items map. The total size of all keys and values must be less than 512KB.", + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } + }, + "InstantSnapshotList": { + "id": "InstantSnapshotList", + "description": "Contains a list of InstantSnapshot resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#instantSnapshotList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InstantSnapshot resources.", + "type": "array", + "items": { + "$ref": "InstantSnapshot" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" + } + } + } + }, + "InstantSnapshot": { + "id": "InstantSnapshot", + "description": "Represents a InstantSnapshot resource. You can use instant snapshots to create disk rollback points quickly..", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#instantSnapshot for InstantSnapshot resources.", + "default": "compute#instantSnapshot", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the instantSnapshot. This can be CREATING, DELETING, FAILED, or READY.", + "type": "string", + "enumDescriptions": [ + "InstantSnapshot creation is in progress.", + "InstantSnapshot is currently being deleted.", + "InstantSnapshot creation failed.", + "InstantSnapshot has been created successfully.", + "InstantSnapshot is currently unavailable and cannot be used for Disk restoration" ], - "response": { - "$ref": "FutureReservationsAggregatedListResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY", + "UNAVAILABLE" + ] + }, + "sourceDisk": { + "description": "URL of the source disk used to create this instant snapshot. Note that the source disk must be in the same zone/region as the instant snapshot to be created. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk ", + "type": "string" + }, + "sourceDiskId": { + "description": "[Output Only] The ID value of the disk used to create this InstantSnapshot. This value may be used to determine whether the InstantSnapshot was taken from the current or a previous instance of a given disk name.", + "type": "string" + }, + "diskSizeGb": { + "description": "[Output Only] Size of the source disk, specified in GB.", + "type": "string", + "format": "int64" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource's resource id.", + "type": "string" + }, + "labels": { + "description": "Labels to apply to this InstantSnapshot. These can be later modified by the setLabels method. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this InstantSnapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a InstantSnapshot.", + "type": "string", + "format": "byte" + }, + "zone": { + "description": "[Output Only] URL of the zone where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "satisfiesPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "architecture": { + "description": "[Output Only] The architecture of the instant snapshot. Valid values are ARM64 or X86_64.", + "type": "string", + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "description": "Retrieves an aggregated list of future reservations. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" + ] }, - "update": { - "id": "compute.futureReservations.update", - "path": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", - "flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}", - "httpMethod": "PATCH", - "parameters": { - "futureReservation": { - "description": "Name of the reservation to update. Name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "updateMask": { - "description": "update_mask indicates fields to be updated as part of this request.", - "location": "query", + "resourceStatus": { + "description": "[Output Only] Status information for the instant snapshot resource.", + "$ref": "InstantSnapshotResourceStatus" + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + } + } + }, + "InstantSnapshotResourceStatus": { + "id": "InstantSnapshotResourceStatus", + "type": "object", + "properties": { + "storageSizeBytes": { + "description": "[Output Only] The storage size of this instant snapshot.", + "type": "string", + "format": "int64" + } + } + }, + "InstantSnapshotAggregatedList": { + "id": "InstantSnapshotAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#instantSnapshotAggregatedList for aggregated lists of instantSnapshots.", + "default": "compute#instantSnapshotAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InstantSnapshotsScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of instantSnapshots.", + "$ref": "InstantSnapshotsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", "type": "string", - "format": "google-fieldmask" + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "zone": { - "description": "Name of the zone for this request. Name should conform to RFC1035.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "futureReservation" - ], - "request": { - "$ref": "FutureReservation" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified future reservation." + } }, - "cancel": { - "id": "compute.futureReservations.cancel", - "path": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}/cancel", - "flatPath": "projects/{project}/zones/{zone}/futureReservations/{futureReservation}/cancel", - "httpMethod": "POST", - "parameters": { - "futureReservation": { - "description": "Name of the future reservation to retrieve. Name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "InstantSnapshotsScopedList": { + "id": "InstantSnapshotsScopedList", + "type": "object", + "properties": { + "instantSnapshots": { + "description": "[Output Only] A list of instantSnapshots contained in this scope.", + "type": "array", + "items": { + "$ref": "InstantSnapshot" + } + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of instantSnapshots when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "Name of the zone for this request. Name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "futureReservation" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Cancel the specified future reservation." + } } } }, - "regionHealthCheckServices": { - "methods": { - "list": { - "id": "compute.regionHealthCheckServices.list", - "path": "projects/{project}/regions/{region}/healthCheckServices", - "flatPath": "projects/{project}/regions/{region}/healthCheckServices", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "HealthCheckServicesList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all the HealthCheckService resources that have been configured for the specified project in the given region." + "InterconnectAttachmentList": { + "id": "InterconnectAttachmentList", + "description": "Response to the list request, and contains a list of interconnect attachments.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#interconnectAttachmentList for lists of interconnect attachments.", + "default": "compute#interconnectAttachmentList", + "type": "string" }, - "get": { - "id": "compute.regionHealthCheckServices.get", - "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", - "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", - "httpMethod": "GET", - "parameters": { - "healthCheckService": { - "description": "Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "healthCheckService" - ], - "response": { - "$ref": "HealthCheckService" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified regional HealthCheckService resource." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.regionHealthCheckServices.insert", - "path": "projects/{project}/regions/{region}/healthCheckServices", - "flatPath": "projects/{project}/regions/{region}/healthCheckServices", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "HealthCheckService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a regional HealthCheckService resource in the specified project and region using the data included in the request." + "items": { + "description": "A list of InterconnectAttachment resources.", + "type": "array", + "items": { + "$ref": "InterconnectAttachment" + } }, - "delete": { - "id": "compute.regionHealthCheckServices.delete", - "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", - "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", - "httpMethod": "DELETE", - "parameters": { - "healthCheckService": { - "description": "Name of the HealthCheckService to delete. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "healthCheckService" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified regional HealthCheckService." + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "patch": { - "id": "compute.regionHealthCheckServices.patch", - "path": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", - "flatPath": "projects/{project}/regions/{region}/healthCheckServices/{healthCheckService}", - "httpMethod": "PATCH", - "parameters": { - "healthCheckService": { - "description": "Name of the HealthCheckService to update. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "healthCheckService" - ], - "request": { - "$ref": "HealthCheckService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified regional HealthCheckService resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + } } } }, - "healthChecks": { - "methods": { - "list": { - "id": "compute.healthChecks.list", - "path": "projects/{project}/global/healthChecks", - "flatPath": "projects/{project}/global/healthChecks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" + "InterconnectAttachment": { + "id": "InterconnectAttachment", + "description": "Represents an Interconnect Attachment (VLAN) resource. You can use Interconnect attachments (VLANS) to connect your Virtual Private Cloud networks to your on-premises networks through an Interconnect. For more information, read Creating VLAN Attachments.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#interconnectAttachment for interconnect attachments.", + "default": "compute#interconnectAttachment", + "type": "string" + }, + "description": { + "description": "An optional description of this resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "interconnect": { + "description": "URL of the underlying Interconnect object that this attachment's traffic will traverse through.", + "type": "string" + }, + "router": { + "description": "URL of the Cloud Router to be used for dynamic routing. This router must be in the same region as this InterconnectAttachment. The InterconnectAttachment will automatically connect the Interconnect to the network & region within which the Cloud Router is configured.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the regional interconnect attachment resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "googleReferenceId": { + "description": "[Output Only] Google reference ID, to be used when raising support tickets with Google or otherwise to debug backend connectivity issues. [Deprecated] This field is not used.", + "deprecated": true, + "type": "string" + }, + "mtu": { + "description": "Maximum Transmission Unit (MTU), in bytes, of packets passing through this interconnect attachment. Only 1440 and 1500 are allowed. If not specified, the value will default to 1440.", + "type": "integer", + "format": "int32" + }, + "privateInterconnectInfo": { + "description": "[Output Only] Information specific to an InterconnectAttachment. This property is populated if the interconnect that this is attached to is of type DEDICATED.", + "$ref": "InterconnectAttachmentPrivateInfo" + }, + "operationalStatus": { + "description": "[Output Only] The current status of whether or not this interconnect attachment is functional, which can take one of the following values: - OS_ACTIVE: The attachment has been turned up and is ready to use. - OS_UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. ", + "type": "string", + "enumDescriptions": [ + "Indicates that attachment has been turned up and is ready to use.", + "Indicates that attachment is not ready to use yet, because turnup is not complete." ], - "response": { - "$ref": "HealthCheckList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "OS_ACTIVE", + "OS_UNPROVISIONED" + ] + }, + "cloudRouterIpAddress": { + "description": "[Output Only] IPv4 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment.", + "type": "string" + }, + "customerRouterIpAddress": { + "description": "[Output Only] IPv4 address + prefix length to be configured on the customer router subinterface for this interconnect attachment.", + "type": "string" + }, + "type": { + "description": "The type of interconnect attachment this is, which can take one of the following values: - DEDICATED: an attachment to a Dedicated Interconnect. - PARTNER: an attachment to a Partner Interconnect, created by the customer. - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by the partner. ", + "type": "string", + "enumDescriptions": [ + "Attachment to a dedicated interconnect.", + "Attachment to a partner interconnect, created by the customer.", + "Attachment to a partner interconnect, created by the partner." ], - "description": "Retrieves the list of HealthCheck resources available to the specified project." + "enum": [ + "DEDICATED", + "PARTNER", + "PARTNER_PROVIDER" + ] }, - "aggregatedList": { - "id": "compute.healthChecks.aggregatedList", - "path": "projects/{project}/aggregated/healthChecks", - "flatPath": "projects/{project}/aggregated/healthChecks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" + "pairingKey": { + "description": "[Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not present for DEDICATED]. The opaque identifier of a PARTNER attachment used to initiate provisioning with a selected partner. Of the form \"XXXXX/region/domain\"", + "type": "string" + }, + "adminEnabled": { + "description": "Determines whether this Attachment will carry packets. Not present for PARTNER_PROVIDER.", + "type": "boolean" + }, + "vlanTag8021q": { + "description": "The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. Only specified at creation time.", + "type": "integer", + "format": "int32" + }, + "edgeAvailabilityDomain": { + "description": "Desired availability domain for the attachment. Only available for type PARTNER, at creation time, and can take one of the following values: - AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For improved reliability, customers should configure a pair of attachments, one per availability domain. The selected availability domain will be provided to the Partner via the pairing key, so that the provisioned circuit will lie in the specified domain. If not specified, the value will default to AVAILABILITY_DOMAIN_ANY.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "response": { - "$ref": "HealthChecksAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "AVAILABILITY_DOMAIN_1", + "AVAILABILITY_DOMAIN_2", + "AVAILABILITY_DOMAIN_ANY" + ] + }, + "candidateSubnets": { + "description": "Up to 16 candidate prefixes that can be used to restrict the allocation of cloudRouterIpAddress and customerRouterIpAddress for this attachment. All prefixes must be within link-local address space (169.254.0.0/16) and must be /29 or shorter (/28, /27, etc). Google will attempt to select an unused /29 from the supplied candidate prefix(es). The request will fail if all possible /29s are in use on Google's edge. If not supplied, Google will randomly select an unused /29 from all of link-local space.", + "type": "array", + "items": { + "type": "string" + } + }, + "bandwidth": { + "description": "Provisioned bandwidth capacity for the interconnect attachment. For attachments of type DEDICATED, the user can set the bandwidth. For attachments of type PARTNER, the Google Partner that is operating the interconnect must set the bandwidth. Output only for PARTNER type, mutable for PARTNER_PROVIDER and DEDICATED, and can take one of the following values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s ", + "type": "string", + "enumDescriptions": [ + "100 Mbit/s", + "10 Gbit/s", + "1 Gbit/s", + "200 Mbit/s", + "20 Gbit/s", + "2 Gbit/s", + "300 Mbit/s", + "400 Mbit/s", + "500 Mbit/s", + "50 Gbit/s", + "50 Mbit/s", + "5 Gbit/s" ], - "description": "Retrieves the list of all HealthCheck resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "BPS_100M", + "BPS_10G", + "BPS_1G", + "BPS_200M", + "BPS_20G", + "BPS_2G", + "BPS_300M", + "BPS_400M", + "BPS_500M", + "BPS_50G", + "BPS_50M", + "BPS_5G" + ] }, - "get": { - "id": "compute.healthChecks.get", - "path": "projects/{project}/global/healthChecks/{healthCheck}", - "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", - "httpMethod": "GET", - "parameters": { - "healthCheck": { - "description": "Name of the HealthCheck resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "healthCheck" + "partnerMetadata": { + "description": "Informational metadata about Partner attachments from Partners to display to customers. Output only for PARTNER type, mutable for PARTNER_PROVIDER, not available for DEDICATED.", + "$ref": "InterconnectAttachmentPartnerMetadata" + }, + "labels": { + "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this InterconnectAttachment, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an InterconnectAttachment.", + "type": "string", + "format": "byte" + }, + "state": { + "description": "[Output Only] The current state of this attachment's functionality. Enum values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, PARTNER, and PARTNER_PROVIDER interconnect attachments, while enum values PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used for only PARTNER and PARTNER_PROVIDER interconnect attachments. This state can take one of the following values: - ACTIVE: The attachment has been turned up and is ready to use. - UNPROVISIONED: The attachment is not ready to use yet, because turnup is not complete. - PENDING_PARTNER: A newly-created PARTNER attachment that has not yet been configured on the Partner side. - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of provisioning after a PARTNER_PROVIDER attachment was created that references it. - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER attachment that is waiting for a customer to activate it. - DEFUNCT: The attachment was deleted externally and is no longer functional. This could be because the associated Interconnect was removed, or because the other side of a Partner attachment was deleted. ", + "type": "string", + "enumDescriptions": [ + "Indicates that attachment has been turned up and is ready to use.", + "The attachment was deleted externally and is no longer functional. This could be because the associated Interconnect was wiped out, or because the other side of a Partner attachment was deleted.", + "A PARTNER attachment is in the process of provisioning after a PARTNER_PROVIDER attachment was created that references it.", + "PARTNER or PARTNER_PROVIDER attachment that is waiting for the customer to activate.", + "A newly created PARTNER attachment that has not yet been configured on the Partner side.", + "", + "Indicates that attachment is not ready to use yet, because turnup is not complete." ], - "response": { - "$ref": "HealthCheck" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "ACTIVE", + "DEFUNCT", + "PARTNER_REQUEST_RECEIVED", + "PENDING_CUSTOMER", + "PENDING_PARTNER", + "STATE_UNSPECIFIED", + "UNPROVISIONED" + ] + }, + "partnerAsn": { + "description": "Optional BGP ASN for the router supplied by a Layer 3 Partner if they configured BGP on behalf of the customer. Output only for PARTNER type, input only for PARTNER_PROVIDER, not available for DEDICATED.", + "type": "string", + "format": "int64" + }, + "encryption": { + "description": "Indicates the user-supplied encryption option of this VLAN attachment (interconnectAttachment). Can only be specified at attachment creation for PARTNER or DEDICATED attachments. Possible values are: - NONE - This is the default value, which means that the VLAN attachment carries unencrypted traffic. VMs are able to send traffic to, or receive traffic from, such a VLAN attachment. - IPSEC - The VLAN attachment carries only encrypted traffic that is encrypted by an IPsec device, such as an HA VPN gateway or third-party IPsec VPN. VMs cannot directly send traffic to, or receive traffic from, such a VLAN attachment. To use *HA VPN over Cloud Interconnect*, the VLAN attachment must be created with this option. ", + "type": "string", + "enumDescriptions": [ + "The interconnect attachment will carry only encrypted traffic that is encrypted by an IPsec device such as HA VPN gateway; VMs cannot directly send traffic to or receive traffic from such an interconnect attachment. To use HA VPN over Cloud Interconnect, the interconnect attachment must be created with this option.", + "This is the default value, which means the Interconnect Attachment will carry unencrypted traffic. VMs will be able to send traffic to or receive traffic from such interconnect attachment." ], - "description": "Returns the specified HealthCheck resource." + "enum": [ + "IPSEC", + "NONE" + ] }, - "insert": { - "id": "compute.healthChecks.insert", - "path": "projects/{project}/global/healthChecks", - "flatPath": "projects/{project}/global/healthChecks", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" + "ipsecInternalAddresses": { + "description": "A list of URLs of addresses that have been reserved for the VLAN attachment. Used only for the VLAN attachment that has the encryption option as IPSEC. The addresses must be regional internal IP address ranges. When creating an HA VPN gateway over the VLAN attachment, if the attachment is configured to use a regional internal IP address, then the VPN gateway's IP address is allocated from the IP address range specified here. For example, if the HA VPN gateway's interface 0 is paired to this VLAN attachment, then a regional internal IP address for the VPN gateway interface 0 will be allocated from the IP address specified for this VLAN attachment. If this field is not specified when creating the VLAN attachment, then later on when creating an HA VPN gateway on this VLAN attachment, the HA VPN gateway's IP address is allocated from the regional external IP address pool.", + "type": "array", + "items": { + "type": "string" + } + }, + "dataplaneVersion": { + "description": "[Output Only] Dataplane version for this InterconnectAttachment. This field is only present for Dataplane version 2 and higher. Absence of this field in the API output indicates that the Dataplane is version 1.", + "type": "integer", + "format": "int32" + }, + "satisfiesPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "stackType": { + "description": "The stack type for this interconnect attachment to identify whether the IPv6 feature is enabled or not. If not specified, IPV4_ONLY will be used. This field can be both set at interconnect attachments creation and update interconnect attachment operations.", + "type": "string", + "enumDescriptions": [ + "The interconnect attachment can have both IPv4 and IPv6 addresses.", + "The interconnect attachment will only be assigned IPv4 addresses." ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY" + ] + }, + "cloudRouterIpv6Address": { + "description": "[Output Only] IPv6 address + prefix length to be configured on Cloud Router Interface for this interconnect attachment.", + "type": "string" + }, + "customerRouterIpv6Address": { + "description": "[Output Only] IPv6 address + prefix length to be configured on the customer router subinterface for this interconnect attachment.", + "type": "string" + }, + "candidateIpv6Subnets": { + "description": "This field is not available.", + "type": "array", + "items": { + "type": "string" + } + }, + "cloudRouterIpv6InterfaceId": { + "description": "This field is not available.", + "type": "string" + }, + "customerRouterIpv6InterfaceId": { + "description": "This field is not available.", + "type": "string" + }, + "subnetLength": { + "description": "Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The default value is 29, except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure remote location fall into this category. In these cases, the default value is 30, and requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it gives Google Cloud Support more debugging visibility. ", + "type": "integer", + "format": "int32" + }, + "remoteService": { + "description": "[Output Only] If the attachment is on a Cross-Cloud Interconnect connection, this field contains the interconnect's remote location service provider. Example values: \"Amazon Web Services\" \"Microsoft Azure\". The field is set only for attachments on Cross-Cloud Interconnect connections. Its value is copied from the InterconnectRemoteLocation remoteService field.", + "type": "string" + }, + "configurationConstraints": { + "description": "[Output Only] Constraints for this attachment, if any. The attachment does not work if these constraints are not met.", + "$ref": "InterconnectAttachmentConfigurationConstraints" + } + } + }, + "InterconnectAttachmentPrivateInfo": { + "id": "InterconnectAttachmentPrivateInfo", + "description": "Information for an interconnect attachment when this belongs to an interconnect of type DEDICATED.", + "type": "object", + "properties": { + "tag8021q": { + "description": "[Output Only] 802.1q encapsulation tag to be used for traffic between Google and the customer, going to and from this network and region.", + "type": "integer", + "format": "uint32" + } + } + }, + "InterconnectAttachmentPartnerMetadata": { + "id": "InterconnectAttachmentPartnerMetadata", + "description": "Informational metadata about Partner attachments from Partners to display to customers. These fields are propagated from PARTNER_PROVIDER attachments to their corresponding PARTNER attachments.", + "type": "object", + "properties": { + "partnerName": { + "description": "Plain text name of the Partner providing this attachment. This value may be validated to match approved Partner values.", + "type": "string" + }, + "interconnectName": { + "description": "Plain text name of the Interconnect this attachment is connected to, as displayed in the Partner's portal. For instance \"Chicago 1\". This value may be validated to match approved Partner values.", + "type": "string" + }, + "portalUrl": { + "description": "URL of the Partner's portal for this Attachment. Partners may customise this to be a deep link to the specific resource on the Partner portal. This value may be validated to match approved Partner values.", + "type": "string" + } + } + }, + "InterconnectAttachmentConfigurationConstraints": { + "id": "InterconnectAttachmentConfigurationConstraints", + "type": "object", + "properties": { + "bgpMd5": { + "description": "[Output Only] Whether the attachment's BGP session requires/allows/disallows BGP MD5 authentication. This can take one of the following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. For example, a Cross-Cloud Interconnect connection to a remote cloud provider that requires BGP MD5 authentication has the interconnectRemoteLocation attachment_configuration_constraints.bgp_md5 field set to MD5_REQUIRED, and that property is propagated to the attachment. Similarly, if BGP MD5 is MD5_UNSUPPORTED, an error is returned if MD5 is requested.", + "type": "string", + "enumDescriptions": [ + "MD5_OPTIONAL: BGP MD5 authentication is supported and can optionally be configured.", + "MD5_REQUIRED: BGP MD5 authentication must be configured.", + "MD5_UNSUPPORTED: BGP MD5 authentication must not be configured" ], - "description": "Creates a HealthCheck resource in the specified project using the data included in the request." + "enum": [ + "MD5_OPTIONAL", + "MD5_REQUIRED", + "MD5_UNSUPPORTED" + ] }, - "delete": { - "id": "compute.healthChecks.delete", - "path": "projects/{project}/global/healthChecks/{healthCheck}", - "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", - "httpMethod": "DELETE", - "parameters": { - "healthCheck": { - "description": "Name of the HealthCheck resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "bgpPeerAsnRanges": { + "description": "[Output Only] List of ASN ranges that the remote location is known to support. Formatted as an array of inclusive ranges {min: min-value, max: max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] allows the peer ASN to be 123 or anything in the range 64512-65534. This field is only advisory. Although the API accepts other ranges, these are the ranges that we recommend.", + "type": "array", + "items": { + "$ref": "InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange" + } + } + } + }, + "InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange": { + "id": "InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange", + "type": "object", + "properties": { + "min": { + "type": "integer", + "format": "uint32" + }, + "max": { + "type": "integer", + "format": "uint32" + } + } + }, + "InterconnectAttachmentAggregatedList": { + "id": "InterconnectAttachmentAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#interconnectAttachmentAggregatedList for aggregated lists of interconnect attachments.", + "default": "compute#interconnectAttachmentAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InterconnectAttachmentsScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of interconnect attachments.", + "$ref": "InterconnectAttachmentsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "healthCheck" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified HealthCheck resource." + } }, - "update": { - "id": "compute.healthChecks.update", - "path": "projects/{project}/global/healthChecks/{healthCheck}", - "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", - "httpMethod": "PUT", - "parameters": { - "healthCheck": { - "description": "Name of the HealthCheck resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "healthCheck" - ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates a HealthCheck resource in the specified project using the data included in the request." + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "InterconnectAttachmentsScopedList": { + "id": "InterconnectAttachmentsScopedList", + "type": "object", + "properties": { + "interconnectAttachments": { + "description": "A list of interconnect attachments contained in this scope.", + "type": "array", + "items": { + "$ref": "InterconnectAttachment" + } }, - "patch": { - "id": "compute.healthChecks.patch", - "path": "projects/{project}/global/healthChecks/{healthCheck}", - "flatPath": "projects/{project}/global/healthChecks/{healthCheck}", - "httpMethod": "PATCH", - "parameters": { - "healthCheck": { - "description": "Name of the HealthCheck resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "Informational warning which replaces the list of addresses when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "healthCheck" - ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + } } } }, - "regionHealthChecks": { - "methods": { - "list": { - "id": "compute.regionHealthChecks.list", - "path": "projects/{project}/regions/{region}/healthChecks", - "flatPath": "projects/{project}/regions/{region}/healthChecks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "HealthCheckList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of HealthCheck resources available to the specified project." + "Interconnect": { + "id": "Interconnect", + "description": "Represents an Interconnect resource. An Interconnect resource is a dedicated connection between the Google Cloud network and your on-premises network. For more information, read the Dedicated Interconnect Overview.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#interconnect for interconnects.", + "default": "compute#interconnect", + "type": "string" }, - "get": { - "id": "compute.regionHealthChecks.get", - "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", - "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", - "httpMethod": "GET", - "parameters": { - "healthCheck": { - "description": "Name of the HealthCheck resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "healthCheck" - ], - "response": { - "$ref": "HealthCheck" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified HealthCheck resource." + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" }, - "insert": { - "id": "compute.regionHealthChecks.insert", - "path": "projects/{project}/regions/{region}/healthChecks", - "flatPath": "projects/{project}/regions/{region}/healthChecks", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a HealthCheck resource in the specified project using the data included in the request." + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" }, - "delete": { - "id": "compute.regionHealthChecks.delete", - "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", - "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", - "httpMethod": "DELETE", - "parameters": { - "healthCheck": { - "description": "Name of the HealthCheck resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.interconnects.insert" + ] }, - "parameterOrder": [ - "project", - "region", - "healthCheck" + "type": "string" + }, + "location": { + "description": "URL of the InterconnectLocation object that represents where this connection is to be provisioned.", + "type": "string" + }, + "linkType": { + "description": "Type of link requested, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. Note that this field indicates the speed of each of the links in the bundle, not the speed of the entire bundle.", + "type": "string", + "enumDescriptions": [ + "100G Ethernet, LR Optics.", + "10G Ethernet, LR Optics. [(rate_bps) = 10000000000];" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "LINK_TYPE_ETHERNET_100G_LR", + "LINK_TYPE_ETHERNET_10G_LR" + ] + }, + "requestedLinkCount": { + "description": "Target number of physical links in the link bundle, as requested by the customer.", + "type": "integer", + "format": "int32" + }, + "interconnectType": { + "description": "Type of interconnect, which can take one of the following values: - PARTNER: A partner-managed interconnection shared between customers though a partner. - DEDICATED: A dedicated physical interconnection with the customer. Note that a value IT_PRIVATE has been deprecated in favor of DEDICATED.", + "type": "string", + "enumDescriptions": [ + "A dedicated physical interconnection with the customer.", + "[Deprecated] A private, physical interconnection with the customer.", + "A partner-managed interconnection shared between customers via partner." ], - "description": "Deletes the specified HealthCheck resource." + "enum": [ + "DEDICATED", + "IT_PRIVATE", + "PARTNER" + ] }, - "update": { - "id": "compute.regionHealthChecks.update", - "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", - "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", - "httpMethod": "PUT", - "parameters": { - "healthCheck": { - "description": "Name of the HealthCheck resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "healthCheck" + "adminEnabled": { + "description": "Administrative status of the interconnect. When this is set to true, the Interconnect is functional and can carry traffic. When set to false, no packets can be carried over the interconnect and no BGP routes are exchanged over it. By default, the status is set to true.", + "type": "boolean" + }, + "nocContactEmail": { + "description": "Email address to contact the customer NOC for operations and maintenance notifications regarding this Interconnect. If specified, this will be used for notifications in addition to all other forms described, such as Cloud Monitoring logs alerting and Cloud Notifications. This field is required for users who sign up for Cloud Interconnect using workforce identity federation.", + "type": "string" + }, + "customerName": { + "description": "Customer name, to put in the Letter of Authorization as the party authorized to request a crossconnect.", + "type": "string" + }, + "operationalStatus": { + "description": "[Output Only] The current status of this Interconnect's functionality, which can take one of the following values: - OS_ACTIVE: A valid Interconnect, which is turned up and is ready to use. Attachments may be provisioned on this Interconnect. - OS_UNPROVISIONED: An Interconnect that has not completed turnup. No attachments may be provisioned on this Interconnect. - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. ", + "type": "string", + "enumDescriptions": [ + "The interconnect is valid, turned up, and ready to use. Attachments may be provisioned on this interconnect.", + "The interconnect has not completed turnup. No attachments may be provisioned on this interconnect." ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "OS_ACTIVE", + "OS_UNPROVISIONED" + ] + }, + "provisionedLinkCount": { + "description": "[Output Only] Number of links actually provisioned in this interconnect.", + "type": "integer", + "format": "int32" + }, + "interconnectAttachments": { + "description": "[Output Only] A list of the URLs of all InterconnectAttachments configured to use this Interconnect.", + "type": "array", + "items": { + "type": "string" + } + }, + "peerIpAddress": { + "description": "[Output Only] IP address configured on the customer side of the Interconnect link. The customer should configure this IP address during turnup when prompted by Google NOC. This can be used only for ping tests.", + "type": "string" + }, + "googleIpAddress": { + "description": "[Output Only] IP address configured on the Google side of the Interconnect link. This can be used only for ping tests.", + "type": "string" + }, + "googleReferenceId": { + "description": "[Output Only] Google reference ID to be used when raising support tickets with Google or otherwise to debug backend connectivity issues.", + "type": "string" + }, + "expectedOutages": { + "description": "[Output Only] A list of outages expected for this Interconnect.", + "type": "array", + "items": { + "$ref": "InterconnectOutageNotification" + } + }, + "circuitInfos": { + "description": "[Output Only] A list of CircuitInfo objects, that describe the individual circuits in this LAG.", + "type": "array", + "items": { + "$ref": "InterconnectCircuitInfo" + } + }, + "labels": { + "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this Interconnect, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an Interconnect.", + "type": "string", + "format": "byte" + }, + "state": { + "description": "[Output Only] The current state of Interconnect functionality, which can take one of the following values: - ACTIVE: The Interconnect is valid, turned up and ready to use. Attachments may be provisioned on this Interconnect. - UNPROVISIONED: The Interconnect has not completed turnup. No attachments may be provisioned on this Interconnect. - UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. No attachments may be provisioned or updated on this Interconnect. ", + "type": "string", + "enumDescriptions": [ + "The interconnect is valid, turned up, and ready to use. Attachments may be provisioned on this interconnect.", + "The interconnect has not completed turnup. No attachments may be provisioned on this interconnect." ], - "description": "Updates a HealthCheck resource in the specified project using the data included in the request." + "enum": [ + "ACTIVE", + "UNPROVISIONED" + ] }, - "patch": { - "id": "compute.regionHealthChecks.patch", - "path": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", - "flatPath": "projects/{project}/regions/{region}/healthChecks/{healthCheck}", - "httpMethod": "PATCH", - "parameters": { - "healthCheck": { - "description": "Name of the HealthCheck resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "healthCheck" + "satisfiesPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "macsec": { + "description": "Configuration that enables Media Access Control security (MACsec) on the Cloud Interconnect connection between Google and your on-premises router.", + "$ref": "InterconnectMacsec" + }, + "macsecEnabled": { + "description": "Enable or disable MACsec on this Interconnect connection. MACsec enablement fails if the MACsec object is not specified.", + "type": "boolean" + }, + "remoteLocation": { + "description": "Indicates that this is a Cross-Cloud Interconnect. This field specifies the location outside of Google's network that the interconnect is connected to.", + "type": "string" + }, + "requestedFeatures": { + "description": "Optional. List of features requested for this Interconnect connection, which can take one of the following values: - IF_MACSEC If specified then the connection is created on MACsec capable hardware ports. If not specified, the default value is false, which allocates non-MACsec capable ports first if available. This parameter can be provided only with Interconnect INSERT. It isn't valid for Interconnect PATCH.", + "type": "array", + "items": { + "type": "string", + "enumDescriptions": [ + "Media Access Control security (MACsec)" + ], + "enum": [ + "IF_MACSEC" + ] + } + }, + "availableFeatures": { + "description": "[Output only] List of features available for this Interconnect connection, which can take one of the following values: - IF_MACSEC If present then the Interconnect connection is provisioned on MACsec capable hardware ports. If not present then the Interconnect connection is provisioned on non-MACsec capable ports and MACsec isn't supported and enabling MACsec fails.", + "type": "array", + "items": { + "type": "string", + "enumDescriptions": [ + "Media Access Control security (MACsec)" + ], + "enum": [ + "IF_MACSEC" + ] + } + } + } + }, + "InterconnectOutageNotification": { + "id": "InterconnectOutageNotification", + "description": "Description of a planned outage on this Interconnect.", + "type": "object", + "properties": { + "name": { + "description": "Unique identifier for this outage notification.", + "type": "string" + }, + "description": { + "description": "A description about the purpose of the outage.", + "type": "string" + }, + "source": { + "description": "The party that generated this notification, which can take the following value: - GOOGLE: this notification as generated by Google. Note that the value of NSRC_GOOGLE has been deprecated in favor of GOOGLE.", + "type": "string", + "enumDescriptions": [ + "This notification was generated by Google.", + "[Deprecated] This notification was generated by Google." ], - "request": { - "$ref": "HealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "GOOGLE", + "NSRC_GOOGLE" + ] + }, + "state": { + "description": "State of this notification, which can take one of the following values: - ACTIVE: This outage notification is active. The event could be in the past, present, or future. See start_time and end_time for scheduling. - CANCELLED: The outage associated with this notification was cancelled before the outage was due to start. - COMPLETED: The outage associated with this notification is complete. Note that the versions of this enum prefixed with \"NS_\" have been deprecated in favor of the unprefixed values.", + "type": "string", + "enumDescriptions": [ + "This outage notification is active. The event could be in the future, present, or past. See start_time and end_time for scheduling.", + "The outage associated with this notification was cancelled before the outage was due to start.", + "The outage associated with this notification is complete.", + "[Deprecated] This outage notification is active. The event could be in the future, present, or past. See start_time and end_time for scheduling.", + "[Deprecated] The outage associated with this notification was canceled before the outage was due to start." ], - "description": "Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + "enum": [ + "ACTIVE", + "CANCELLED", + "COMPLETED", + "NS_ACTIVE", + "NS_CANCELED" + ] + }, + "issueType": { + "description": "Form this outage is expected to take, which can take one of the following values: - OUTAGE: The Interconnect may be completely out of service for some or all of the specified window. - PARTIAL_OUTAGE: Some circuits comprising the Interconnect as a whole should remain up, but with reduced bandwidth. Note that the versions of this enum prefixed with \"IT_\" have been deprecated in favor of the unprefixed values.", + "type": "string", + "enumDescriptions": [ + "[Deprecated] The Interconnect may be completely out of service for some or all of the specified window.", + "[Deprecated] Some circuits comprising the Interconnect will be out of service during the expected window. The interconnect as a whole should remain up, albeit with reduced bandwidth.", + "The Interconnect may be completely out of service for some or all of the specified window.", + "Some circuits comprising the Interconnect will be out of service during the expected window. The interconnect as a whole should remain up, albeit with reduced bandwidth." + ], + "enum": [ + "IT_OUTAGE", + "IT_PARTIAL_OUTAGE", + "OUTAGE", + "PARTIAL_OUTAGE" + ] + }, + "affectedCircuits": { + "description": "If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit IDs that will be affected.", + "type": "array", + "items": { + "type": "string" + } + }, + "startTime": { + "description": "Scheduled start time for the outage (milliseconds since Unix epoch).", + "type": "string", + "format": "int64" + }, + "endTime": { + "description": "Scheduled end time for the outage (milliseconds since Unix epoch).", + "type": "string", + "format": "int64" } } }, - "httpHealthChecks": { - "methods": { - "list": { - "id": "compute.httpHealthChecks.list", - "path": "projects/{project}/global/httpHealthChecks", - "flatPath": "projects/{project}/global/httpHealthChecks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "InterconnectCircuitInfo": { + "id": "InterconnectCircuitInfo", + "description": "Describes a single physical circuit between the Customer and Google. CircuitInfo objects are created by Google, so all fields are output only.", + "type": "object", + "properties": { + "googleCircuitId": { + "description": "Google-assigned unique ID for this circuit. Assigned at circuit turn-up.", + "type": "string" + }, + "googleDemarcId": { + "description": "Google-side demarc ID for this circuit. Assigned at circuit turn-up and provided by Google to the customer in the LOA.", + "type": "string" + }, + "customerDemarcId": { + "description": "Customer-side demarc ID for this circuit.", + "type": "string" + } + } + }, + "InterconnectMacsec": { + "id": "InterconnectMacsec", + "description": "Configuration information for enabling Media Access Control security (MACsec) on this Cloud Interconnect connection between Google and your on-premises router.", + "type": "object", + "properties": { + "preSharedKeys": { + "description": "Required. A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link.", + "type": "array", + "items": { + "$ref": "InterconnectMacsecPreSharedKey" + } + }, + "failOpen": { + "description": "If set to true, the Interconnect connection is configured with a should-secure MACsec security policy, that allows the Google router to fallback to cleartext traffic if the MKA session cannot be established. By default, the Interconnect connection is configured with a must-secure security policy that drops all traffic if the MKA session cannot be established with your router.", + "type": "boolean" + } + } + }, + "InterconnectMacsecPreSharedKey": { + "id": "InterconnectMacsecPreSharedKey", + "description": "Describes a pre-shared key used to setup MACsec in static connectivity association key (CAK) mode.", + "type": "object", + "properties": { + "name": { + "description": "Required. A name for this pre-shared key. 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.", + "type": "string" + }, + "startTime": { + "description": "A RFC3339 timestamp on or after which the key is valid. startTime can be in the future. If the keychain has a single key, startTime can be omitted. If the keychain has multiple keys, startTime is mandatory for each key. The start times of keys must be in increasing order. The start times of two consecutive keys must be at least 6 hours apart.", + "type": "string" + } + } + }, + "InterconnectList": { + "id": "InterconnectList", + "description": "Response to the list request, and contains a list of interconnects.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#interconnectList for lists of interconnects.", + "default": "compute#interconnectList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Interconnect resources.", + "type": "array", + "items": { + "$ref": "Interconnect" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "HttpHealthCheckList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of HttpHealthCheck resources available to the specified project." + } + } + } + }, + "InterconnectsGetDiagnosticsResponse": { + "id": "InterconnectsGetDiagnosticsResponse", + "description": "Response for the InterconnectsGetDiagnosticsRequest.", + "type": "object", + "properties": { + "result": { + "$ref": "InterconnectDiagnostics" + } + } + }, + "InterconnectDiagnostics": { + "id": "InterconnectDiagnostics", + "description": "Diagnostics information about the Interconnect connection, which contains detailed and current technical information about Google's side of the connection.", + "type": "object", + "properties": { + "macAddress": { + "description": "The MAC address of the Interconnect's bundle interface.", + "type": "string" }, - "get": { - "id": "compute.httpHealthChecks.get", - "path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", - "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", - "httpMethod": "GET", - "parameters": { - "httpHealthCheck": { - "description": "Name of the HttpHealthCheck resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "httpHealthCheck" - ], - "response": { - "$ref": "HttpHealthCheck" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified HttpHealthCheck resource." + "arpCaches": { + "description": "A list of InterconnectDiagnostics.ARPEntry objects, describing individual neighbors currently seen by the Google router in the ARP cache for the Interconnect. This will be empty when the Interconnect is not bundled.", + "type": "array", + "items": { + "$ref": "InterconnectDiagnosticsARPEntry" + } }, - "insert": { - "id": "compute.httpHealthChecks.insert", - "path": "projects/{project}/global/httpHealthChecks", - "flatPath": "projects/{project}/global/httpHealthChecks", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "HttpHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "links": { + "description": "A list of InterconnectDiagnostics.LinkStatus objects, describing the status for each link on the Interconnect.", + "type": "array", + "items": { + "$ref": "InterconnectDiagnosticsLinkStatus" + } + }, + "bundleOperationalStatus": { + "description": "The operational status of the bundle interface.", + "type": "string", + "enumDescriptions": [ + "If bundleAggregationType is LACP: LACP is not established and/or all links in the bundle have DOWN operational status. If bundleAggregationType is STATIC: one or more links in the bundle has DOWN operational status.", + "If bundleAggregationType is LACP: LACP is established and at least one link in the bundle has UP operational status. If bundleAggregationType is STATIC: all links in the bundle (typically just one) have UP operational status." ], - "description": "Creates a HttpHealthCheck resource in the specified project using the data included in the request." + "enum": [ + "BUNDLE_OPERATIONAL_STATUS_DOWN", + "BUNDLE_OPERATIONAL_STATUS_UP" + ] }, - "delete": { - "id": "compute.httpHealthChecks.delete", - "path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", - "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", - "httpMethod": "DELETE", - "parameters": { - "httpHealthCheck": { - "description": "Name of the HttpHealthCheck resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "httpHealthCheck" + "bundleAggregationType": { + "description": "The aggregation type of the bundle interface.", + "type": "string", + "enumDescriptions": [ + "LACP is enabled.", + "LACP is disabled." ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "BUNDLE_AGGREGATION_TYPE_LACP", + "BUNDLE_AGGREGATION_TYPE_STATIC" + ] + } + } + }, + "InterconnectDiagnosticsARPEntry": { + "id": "InterconnectDiagnosticsARPEntry", + "description": "Describing the ARP neighbor entries seen on this link", + "type": "object", + "properties": { + "macAddress": { + "description": "The MAC address of this ARP neighbor.", + "type": "string" + }, + "ipAddress": { + "description": "The IP address of this ARP neighbor.", + "type": "string" + } + } + }, + "InterconnectDiagnosticsLinkStatus": { + "id": "InterconnectDiagnosticsLinkStatus", + "type": "object", + "properties": { + "circuitId": { + "description": "The unique ID for this link assigned during turn up by Google.", + "type": "string" + }, + "googleDemarc": { + "description": "The Demarc address assigned by Google and provided in the LoA.", + "type": "string" + }, + "receivingOpticalPower": { + "description": "An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the received light level.", + "$ref": "InterconnectDiagnosticsLinkOpticalPower" + }, + "transmittingOpticalPower": { + "description": "An InterconnectDiagnostics.LinkOpticalPower object, describing the current value and status of the transmitted light level.", + "$ref": "InterconnectDiagnosticsLinkOpticalPower" + }, + "lacpStatus": { + "$ref": "InterconnectDiagnosticsLinkLACPStatus" + }, + "operationalStatus": { + "description": "The operational status of the link.", + "type": "string", + "enumDescriptions": [ + "The interface is unable to communicate with the remote end.", + "The interface has low level communication with the remote end." ], - "description": "Deletes the specified HttpHealthCheck resource." + "enum": [ + "LINK_OPERATIONAL_STATUS_DOWN", + "LINK_OPERATIONAL_STATUS_UP" + ] }, - "update": { - "id": "compute.httpHealthChecks.update", - "path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", - "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", - "httpMethod": "PUT", - "parameters": { - "httpHealthCheck": { - "description": "Name of the HttpHealthCheck resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "httpHealthCheck" + "arpCaches": { + "description": "A list of InterconnectDiagnostics.ARPEntry objects, describing the ARP neighbor entries seen on this link. This will be empty if the link is bundled", + "type": "array", + "items": { + "$ref": "InterconnectDiagnosticsARPEntry" + } + }, + "macsec": { + "description": "Describes the status of MACsec encryption on this link.", + "$ref": "InterconnectDiagnosticsMacsecStatus" + } + } + }, + "InterconnectDiagnosticsLinkOpticalPower": { + "id": "InterconnectDiagnosticsLinkOpticalPower", + "type": "object", + "properties": { + "value": { + "description": "Value of the current receiving or transmitting optical power, read in dBm. Take a known good optical value, give it a 10% margin and trigger warnings relative to that value. In general, a -7dBm warning and a -11dBm alarm are good optical value estimates for most links.", + "type": "number", + "format": "float" + }, + "state": { + "description": "The status of the current value when compared to the warning and alarm levels for the receiving or transmitting transceiver. Possible states include: - OK: The value has not crossed a warning threshold. - LOW_WARNING: The value has crossed below the low warning threshold. - HIGH_WARNING: The value has crossed above the high warning threshold. - LOW_ALARM: The value has crossed below the low alarm threshold. - HIGH_ALARM: The value has crossed above the high alarm threshold. ", + "type": "string", + "enumDescriptions": [ + "The value has crossed above the high alarm threshold.", + "The value of the current optical power has crossed above the high warning threshold.", + "The value of the current optical power has crossed below the low alarm threshold.", + "The value of the current optical power has crossed below the low warning threshold.", + "The value of the current optical power has not crossed a warning threshold." ], - "request": { - "$ref": "HttpHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "HIGH_ALARM", + "HIGH_WARNING", + "LOW_ALARM", + "LOW_WARNING", + "OK" + ] + } + } + }, + "InterconnectDiagnosticsLinkLACPStatus": { + "id": "InterconnectDiagnosticsLinkLACPStatus", + "type": "object", + "properties": { + "state": { + "description": "The state of a LACP link, which can take one of the following values: - ACTIVE: The link is configured and active within the bundle. - DETACHED: The link is not configured within the bundle. This means that the rest of the object should be empty. ", + "type": "string", + "enumDescriptions": [ + "The link is configured and active within the bundle.", + "The link is not configured within the bundle, this means the rest of the object should be empty." ], - "description": "Updates a HttpHealthCheck resource in the specified project using the data included in the request." + "enum": [ + "ACTIVE", + "DETACHED" + ] }, - "patch": { - "id": "compute.httpHealthChecks.patch", - "path": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", - "flatPath": "projects/{project}/global/httpHealthChecks/{httpHealthCheck}", - "httpMethod": "PATCH", - "parameters": { - "httpHealthCheck": { - "description": "Name of the HttpHealthCheck resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "googleSystemId": { + "description": "System ID of the port on Google's side of the LACP exchange.", + "type": "string" + }, + "neighborSystemId": { + "description": "System ID of the port on the neighbor's side of the LACP exchange.", + "type": "string" + } + } + }, + "InterconnectDiagnosticsMacsecStatus": { + "id": "InterconnectDiagnosticsMacsecStatus", + "description": "Describes the status of MACsec encryption on the link.", + "type": "object", + "properties": { + "operational": { + "description": "Indicates whether or not MACsec is operational on this link.", + "type": "boolean" + }, + "ckn": { + "description": "Indicates the Connectivity Association Key Name (CKN) currently being used if MACsec is operational.", + "type": "string" + } + } + }, + "InterconnectsGetMacsecConfigResponse": { + "id": "InterconnectsGetMacsecConfigResponse", + "description": "Response for the InterconnectsGetMacsecConfigRequest.", + "type": "object", + "properties": { + "result": { + "$ref": "InterconnectMacsecConfig" + }, + "etag": { + "description": "end_interface: MixerGetResponseWithEtagBuilder", + "type": "string" + } + } + }, + "InterconnectMacsecConfig": { + "id": "InterconnectMacsecConfig", + "description": "MACsec configuration information for the Interconnect connection. Contains the generated Connectivity Association Key Name (CKN) and the key (CAK) for this Interconnect connection.", + "type": "object", + "properties": { + "preSharedKeys": { + "description": "A keychain placeholder describing a set of named key objects along with their start times. A MACsec CKN/CAK is generated for each key in the key chain. Google router automatically picks the key with the most recent startTime when establishing or re-establishing a MACsec secure link.", + "type": "array", + "items": { + "$ref": "InterconnectMacsecConfigPreSharedKey" + } + } + } + }, + "InterconnectMacsecConfigPreSharedKey": { + "id": "InterconnectMacsecConfigPreSharedKey", + "description": "Describes a pre-shared key used to setup MACsec in static connectivity association key (CAK) mode.", + "type": "object", + "properties": { + "name": { + "description": "User provided name for this pre-shared key.", + "type": "string" + }, + "ckn": { + "description": "An auto-generated Connectivity Association Key Name (CKN) for this key.", + "type": "string" + }, + "cak": { + "description": "An auto-generated Connectivity Association Key (CAK) for this key.", + "type": "string" + }, + "startTime": { + "description": "User provided timestamp on or after which this key is valid.", + "type": "string" + } + } + }, + "InterconnectLocationList": { + "id": "InterconnectLocationList", + "description": "Response to the list request, and contains a list of interconnect locations.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#interconnectLocationList for lists of interconnect locations.", + "default": "compute#interconnectLocationList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of InterconnectLocation resources.", + "type": "array", + "items": { + "$ref": "InterconnectLocation" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "httpHealthCheck" - ], - "request": { - "$ref": "HttpHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates a HttpHealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + } } } }, - "httpsHealthChecks": { - "methods": { - "list": { - "id": "compute.httpsHealthChecks.list", - "path": "projects/{project}/global/httpsHealthChecks", - "flatPath": "projects/{project}/global/httpsHealthChecks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "HttpsHealthCheckList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of HttpsHealthCheck resources available to the specified project." + "InterconnectLocation": { + "id": "InterconnectLocation", + "description": "Represents an Interconnect Attachment (VLAN) Location resource. You can use this resource to find location details about an Interconnect attachment (VLAN). For more information about interconnect attachments, read Creating VLAN Attachments.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#interconnectLocation for interconnect locations.", + "default": "compute#interconnectLocation", + "type": "string" }, - "get": { - "id": "compute.httpsHealthChecks.get", - "path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", - "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", - "httpMethod": "GET", - "parameters": { - "httpsHealthCheck": { - "description": "Name of the HttpsHealthCheck resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "httpsHealthCheck" - ], - "response": { - "$ref": "HttpsHealthCheck" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified HttpsHealthCheck resource." + "description": { + "description": "[Output Only] An optional description of the resource.", + "type": "string" }, - "insert": { - "id": "compute.httpsHealthChecks.insert", - "path": "projects/{project}/global/httpsHealthChecks", - "flatPath": "projects/{project}/global/httpsHealthChecks", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "HttpsHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a HttpsHealthCheck resource in the specified project using the data included in the request." + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" }, - "delete": { - "id": "compute.httpsHealthChecks.delete", - "path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", - "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", - "httpMethod": "DELETE", - "parameters": { - "httpsHealthCheck": { - "description": "Name of the HttpsHealthCheck resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "httpsHealthCheck" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified HttpsHealthCheck resource." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "update": { - "id": "compute.httpsHealthChecks.update", - "path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", - "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", - "httpMethod": "PUT", - "parameters": { - "httpsHealthCheck": { - "description": "Name of the HttpsHealthCheck resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "httpsHealthCheck" - ], - "request": { - "$ref": "HttpsHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "type": "string" + }, + "peeringdbFacilityId": { + "description": "[Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb).", + "type": "string" + }, + "address": { + "description": "[Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character.", + "type": "string" + }, + "facilityProvider": { + "description": "[Output Only] The name of the provider for this facility (e.g., EQUINIX).", + "type": "string" + }, + "facilityProviderFacilityId": { + "description": "[Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1).", + "type": "string" + }, + "regionInfos": { + "description": "[Output Only] A list of InterconnectLocation.RegionInfo objects, that describe parameters pertaining to the relation between this InterconnectLocation and various Google Cloud regions.", + "type": "array", + "items": { + "$ref": "InterconnectLocationRegionInfo" + } + }, + "continent": { + "description": "[Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA ", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Updates a HttpsHealthCheck resource in the specified project using the data included in the request." + "enum": [ + "AFRICA", + "ASIA_PAC", + "C_AFRICA", + "C_ASIA_PAC", + "C_EUROPE", + "C_NORTH_AMERICA", + "C_SOUTH_AMERICA", + "EUROPE", + "NORTH_AMERICA", + "SOUTH_AMERICA" + ] }, - "patch": { - "id": "compute.httpsHealthChecks.patch", - "path": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", - "flatPath": "projects/{project}/global/httpsHealthChecks/{httpsHealthCheck}", - "httpMethod": "PATCH", - "parameters": { - "httpsHealthCheck": { - "description": "Name of the HttpsHealthCheck resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "httpsHealthCheck" + "city": { + "description": "[Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: \"Chicago, IL\", \"Amsterdam, Netherlands\".", + "type": "string" + }, + "availabilityZone": { + "description": "[Output Only] Availability zone for this InterconnectLocation. Within a metropolitan area (metro), maintenance will not be simultaneously scheduled in more than one availability zone. Example: \"zone1\" or \"zone2\".", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of this InterconnectLocation, which can take one of the following values: - CLOSED: The InterconnectLocation is closed and is unavailable for provisioning new Interconnects. - AVAILABLE: The InterconnectLocation is available for provisioning new Interconnects. ", + "type": "string", + "enumDescriptions": [ + "The InterconnectLocation is available for provisioning new Interconnects.", + "The InterconnectLocation is closed for provisioning new Interconnects." ], - "request": { - "$ref": "HttpsHealthCheck" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "AVAILABLE", + "CLOSED" + ] + }, + "supportsPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "availableFeatures": { + "description": "[Output only] List of features available at this InterconnectLocation, which can take one of the following values: - MACSEC ", + "type": "array", + "items": { + "type": "string", + "enumDescriptions": [ + "Media Access Control security (MACsec)" + ], + "enum": [ + "IF_MACSEC" + ] + } + }, + "availableLinkTypes": { + "description": "[Output only] List of link types available at this InterconnectLocation, which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR - LINK_TYPE_ETHERNET_100G_LR ", + "type": "array", + "items": { + "type": "string", + "enumDescriptions": [ + "100G Ethernet, LR Optics.", + "10G Ethernet, LR Optics. [(rate_bps) = 10000000000];" + ], + "enum": [ + "LINK_TYPE_ETHERNET_100G_LR", + "LINK_TYPE_ETHERNET_10G_LR" + ] + } + } + } + }, + "InterconnectLocationRegionInfo": { + "id": "InterconnectLocationRegionInfo", + "description": "Information about any potential InterconnectAttachments between an Interconnect at a specific InterconnectLocation, and a specific Cloud Region.", + "type": "object", + "properties": { + "region": { + "description": "URL for the region of this location.", + "type": "string" + }, + "expectedRttMs": { + "description": "Expected round-trip time in milliseconds, from this InterconnectLocation to a VM in this region.", + "type": "string", + "format": "int64" + }, + "locationPresence": { + "description": "Identifies the network presence of this location.", + "type": "string", + "enumDescriptions": [ + "This region is not in any common network presence with this InterconnectLocation.", + "This region shares the same regional network presence as this InterconnectLocation.", + "[Deprecated] This region is not in any common network presence with this InterconnectLocation.", + "[Deprecated] This region shares the same regional network presence as this InterconnectLocation." ], - "description": "Updates a HttpsHealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + "enum": [ + "GLOBAL", + "LOCAL_REGION", + "LP_GLOBAL", + "LP_LOCAL_REGION" + ] } } }, - "instanceTemplates": { - "methods": { - "list": { - "id": "compute.instanceTemplates.list", - "path": "projects/{project}/global/instanceTemplates", - "flatPath": "projects/{project}/global/instanceTemplates", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InstanceTemplateList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of instance templates that are contained within the specified project." + "InterconnectRemoteLocationList": { + "id": "InterconnectRemoteLocationList", + "description": "Response to the list request, and contains a list of interconnect remote locations.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#interconnectRemoteLocationList for lists of interconnect remote locations.", + "default": "compute#interconnectRemoteLocationList", + "type": "string" }, - "get": { - "id": "compute.instanceTemplates.get", - "path": "projects/{project}/global/instanceTemplates/{instanceTemplate}", - "flatPath": "projects/{project}/global/instanceTemplates/{instanceTemplate}", - "httpMethod": "GET", - "parameters": { - "instanceTemplate": { - "description": "The name of the instance template.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "instanceTemplate" - ], - "response": { - "$ref": "InstanceTemplate" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified instance template." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.instanceTemplates.insert", - "path": "projects/{project}/global/instanceTemplates", - "flatPath": "projects/{project}/global/instanceTemplates", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "InstanceTemplate" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates an instance template in the specified project using the data that is included in the request. If you are creating a new template to update an existing instance group, your new instance template must use the same network or, if applicable, the same subnetwork as the original template." + "items": { + "description": "A list of InterconnectRemoteLocation resources.", + "type": "array", + "items": { + "$ref": "InterconnectRemoteLocation" + } }, - "delete": { - "id": "compute.instanceTemplates.delete", - "path": "projects/{project}/global/instanceTemplates/{instanceTemplate}", - "flatPath": "projects/{project}/global/instanceTemplates/{instanceTemplate}", - "httpMethod": "DELETE", - "parameters": { - "instanceTemplate": { - "description": "The name of the instance template to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "instanceTemplate" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified instance template. Deleting an instance template is permanent and cannot be undone. It is not possible to delete templates that are already in use by a managed instance group." + "nextPageToken": { + "description": "[Output Only] This token lets you get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "aggregatedList": { - "id": "compute.instanceTemplates.aggregatedList", - "path": "projects/{project}/aggregated/instanceTemplates", - "flatPath": "projects/{project}/aggregated/instanceTemplates", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InstanceTemplateAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of all InstanceTemplates resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" }, - "getIamPolicy": { - "id": "compute.instanceTemplates.getIamPolicy", - "path": "projects/{project}/global/instanceTemplates/{resource}/getIamPolicy", - "flatPath": "projects/{project}/global/instanceTemplates/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + } + } + } + }, + "InterconnectRemoteLocation": { + "id": "InterconnectRemoteLocation", + "description": "Represents a Cross-Cloud Interconnect Remote Location resource. You can use this resource to find remote location details about an Interconnect attachment (VLAN).", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#interconnectRemoteLocation for interconnect remote locations.", + "default": "compute#interconnectRemoteLocation", + "type": "string" }, - "setIamPolicy": { - "id": "compute.instanceTemplates.setIamPolicy", - "path": "projects/{project}/global/instanceTemplates/{resource}/setIamPolicy", - "flatPath": "projects/{project}/global/instanceTemplates/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "description": { + "description": "[Output Only] An optional description of the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "type": "string" + }, + "peeringdbFacilityId": { + "description": "[Output Only] The peeringdb identifier for this facility (corresponding with a netfac type in peeringdb).", + "type": "string" + }, + "address": { + "description": "[Output Only] The postal address of the Point of Presence, each line in the address is separated by a newline character.", + "type": "string" + }, + "facilityProvider": { + "description": "[Output Only] The name of the provider for this facility (e.g., EQUINIX).", + "type": "string" + }, + "facilityProviderFacilityId": { + "description": "[Output Only] A provider-assigned Identifier for this facility (e.g., Ashburn-DC1).", + "type": "string" + }, + "continent": { + "description": "[Output Only] Continent for this location, which can take one of the following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - SOUTH_AMERICA ", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "enum": [ + "AFRICA", + "ASIA_PAC", + "EUROPE", + "NORTH_AMERICA", + "SOUTH_AMERICA" + ] + }, + "city": { + "description": "[Output Only] Metropolitan area designator that indicates which city an interconnect is located. For example: \"Chicago, IL\", \"Amsterdam, Netherlands\".", + "type": "string" }, - "testIamPermissions": { - "id": "compute.instanceTemplates.testIamPermissions", - "path": "projects/{project}/global/instanceTemplates/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/instanceTemplates/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" + "status": { + "description": "[Output Only] The status of this InterconnectRemoteLocation, which can take one of the following values: - CLOSED: The InterconnectRemoteLocation is closed and is unavailable for provisioning new Cross-Cloud Interconnects. - AVAILABLE: The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects. ", + "type": "string", + "enumDescriptions": [ + "The InterconnectRemoteLocation is available for provisioning new Cross-Cloud Interconnects.", + "The InterconnectRemoteLocation is closed for provisioning new Cross-Cloud Interconnects." ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "AVAILABLE", + "CLOSED" + ] + }, + "remoteService": { + "description": "[Output Only] Indicates the service provider present at the remote location. Example values: \"Amazon Web Services\", \"Microsoft Azure\".", + "type": "string" + }, + "permittedConnections": { + "description": "[Output Only] Permitted connections.", + "type": "array", + "items": { + "$ref": "InterconnectRemoteLocationPermittedConnections" + } + }, + "constraints": { + "description": "[Output Only] Constraints on the parameters for creating Cross-Cloud Interconnect and associated InterconnectAttachments.", + "$ref": "InterconnectRemoteLocationConstraints" + }, + "attachmentConfigurationConstraints": { + "description": "[Output Only] Subset of fields from InterconnectAttachment's |configurationConstraints| field that apply to all attachments for this remote location.", + "$ref": "InterconnectAttachmentConfigurationConstraints" + }, + "lacp": { + "description": "[Output Only] Link Aggregation Control Protocol (LACP) constraints, which can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED", + "type": "string", + "enumDescriptions": [ + "LACP_SUPPORTED: LACP is supported, and enabled by default on the Cross-Cloud Interconnect.", + "LACP_UNSUPPORTED: LACP is not supported and is not be enabled on this port. GetDiagnostics shows bundleAggregationType as \"static\". GCP does not support LAGs without LACP, so requestedLinkCount must be 1." ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "LACP_SUPPORTED", + "LACP_UNSUPPORTED" + ] + }, + "maxLagSize100Gbps": { + "description": "[Output Only] The maximum number of 100 Gbps ports supported in a link aggregation group (LAG). When linkType is 100 Gbps, requestedLinkCount cannot exceed max_lag_size_100_gbps.", + "type": "integer", + "format": "int32" + }, + "maxLagSize10Gbps": { + "description": "[Output Only] The maximum number of 10 Gbps ports supported in a link aggregation group (LAG). When linkType is 10 Gbps, requestedLinkCount cannot exceed max_lag_size_10_gbps.", + "type": "integer", + "format": "int32" } } }, - "regionInstanceTemplates": { - "methods": { - "list": { - "id": "compute.regionInstanceTemplates.list", - "path": "projects/{project}/regions/{region}/instanceTemplates", - "flatPath": "projects/{project}/regions/{region}/instanceTemplates", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the regions for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" + "InterconnectRemoteLocationPermittedConnections": { + "id": "InterconnectRemoteLocationPermittedConnections", + "type": "object", + "properties": { + "interconnectLocation": { + "description": "[Output Only] URL of an Interconnect location that is permitted to connect to this Interconnect remote location.", + "type": "string" + } + } + }, + "InterconnectRemoteLocationConstraints": { + "id": "InterconnectRemoteLocationConstraints", + "type": "object", + "properties": { + "subnetLengthRange": { + "description": "[Output Only] [min-length, max-length] The minimum and maximum value (inclusive) for the IPv4 subnet length. For example, an interconnectRemoteLocation for Azure has {min: 30, max: 30} because Azure requires /30 subnets. This range specifies the values supported by both cloud providers. Interconnect currently supports /29 and /30 IPv4 subnet lengths. If a remote cloud has no constraint on IPv4 subnet length, the range would thus be {min: 29, max: 30}. ", + "$ref": "InterconnectRemoteLocationConstraintsSubnetLengthRange" + }, + "portPairVlan": { + "description": "[Output Only] Port pair VLAN constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN", + "type": "string", + "enumDescriptions": [ + "If PORT_PAIR_MATCHING_VLAN, the Interconnect for this attachment is part of a pair of ports that should have matching VLAN allocations. This occurs with Cross-Cloud Interconnect to Azure remote locations. While GCP's API does not explicitly group pairs of ports, the UI uses this field to ensure matching VLAN ids when configuring a redundant VLAN pair.", + "PORT_PAIR_UNCONSTRAINED_VLAN means there is no constraint." ], - "response": { - "$ref": "InstanceTemplateList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "PORT_PAIR_MATCHING_VLAN", + "PORT_PAIR_UNCONSTRAINED_VLAN" + ] + }, + "portPairRemoteLocation": { + "description": "[Output Only] Port pair remote location constraints, which can take one of the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, PORT_PAIR_MATCHING_REMOTE_LOCATION. Google Cloud API refers only to individual ports, but the UI uses this field when ordering a pair of ports, to prevent users from accidentally ordering something that is incompatible with their cloud provider. Specifically, when ordering a redundant pair of Cross-Cloud Interconnect ports, and one of them uses a remote location with portPairMatchingRemoteLocation set to matching, the UI requires that both ports use the same remote location.", + "type": "string", + "enumDescriptions": [ + "If PORT_PAIR_MATCHING_REMOTE_LOCATION, the remote cloud provider allocates ports in pairs, and the user should choose the same remote location for both ports.", + "If PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, a user may opt to provision a redundant pair of Cross-Cloud Interconnects using two different remote locations in the same city." ], - "description": "Retrieves a list of instance templates that are contained within the specified project and region." + "enum": [ + "PORT_PAIR_MATCHING_REMOTE_LOCATION", + "PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION" + ] + } + } + }, + "InterconnectRemoteLocationConstraintsSubnetLengthRange": { + "id": "InterconnectRemoteLocationConstraintsSubnetLengthRange", + "type": "object", + "properties": { + "min": { + "type": "integer", + "format": "int32" }, - "get": { - "id": "compute.regionInstanceTemplates.get", - "path": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", - "flatPath": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", - "httpMethod": "GET", - "parameters": { - "instanceTemplate": { - "description": "The name of the instance template.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } + "max": { + "type": "integer", + "format": "int32" + } + } + }, + "LicenseCode": { + "id": "LicenseCode", + "description": "Represents a License Code resource. A License Code is a unique identifier used to represent a license resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. ", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#licenseCode for licenses.", + "default": "compute#licenseCode", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "name": { + "description": "[Output Only] Name of the resource. The name is 1-20 characters long and must be a valid 64 bit integer.", + "pattern": "[0-9]{0,20}?", + "annotations": { + "required": [ + "compute.licenses.insert" + ] }, - "parameterOrder": [ - "project", - "region", - "instanceTemplate" + "type": "string" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "description": { + "description": "[Output Only] Description of this License Code.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "transferable": { + "description": "[Output Only] If true, the license will remain attached when creating images or snapshots from disks. Otherwise, the license is not transferred.", + "type": "boolean" + }, + "state": { + "description": "[Output Only] Current state of this License Code.", + "type": "string", + "enumDescriptions": [ + "Machines are not allowed to attach boot disks with this License Code. Requests to create new resources with this license will be rejected.", + "Use is allowed for anyone with USE_READ_ONLY access to this License Code.", + "Use of this license is limited to a project whitelist.", + "", + "Reserved state." ], - "response": { - "$ref": "InstanceTemplate" + "enum": [ + "DISABLED", + "ENABLED", + "RESTRICTED", + "STATE_UNSPECIFIED", + "TERMINATED" + ] + }, + "licenseAlias": { + "description": "[Output Only] URL and description aliases of Licenses with the same License Code.", + "type": "array", + "items": { + "$ref": "LicenseCodeLicenseAlias" + } + } + } + }, + "LicenseCodeLicenseAlias": { + "id": "LicenseCodeLicenseAlias", + "type": "object", + "properties": { + "selfLink": { + "description": "[Output Only] URL of license corresponding to this License Code.", + "type": "string" + }, + "description": { + "description": "[Output Only] Description of this License Code.", + "type": "string" + } + } + }, + "License": { + "id": "License", + "description": "Represents a License resource. A License represents billing and aggregate usage data for public and marketplace images. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. ", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#license for licenses.", + "default": "compute#license", + "type": "string" + }, + "name": { + "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])?", + "annotations": { + "required": [ + "compute.images.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified instance template." + "type": "string" }, - "insert": { - "id": "compute.regionInstanceTemplates.insert", - "path": "projects/{project}/regions/{region}/instanceTemplates", - "flatPath": "projects/{project}/regions/{region}/instanceTemplates", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "chargesUseFee": { + "description": "[Output Only] Deprecated. This field no longer reflects whether a license charges a usage fee.", + "type": "boolean" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "licenseCode": { + "description": "[Output Only] The unique code used to attach this license to images, snapshots, and disks.", + "type": "string", + "format": "uint64" + }, + "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" + }, + "transferable": { + "description": "If false, licenses will not be copied from the source resource when creating an image from a disk, disk from snapshot, or snapshot from disk.", + "type": "boolean" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "resourceRequirements": { + "$ref": "LicenseResourceRequirements" + } + } + }, + "LicenseResourceRequirements": { + "id": "LicenseResourceRequirements", + "type": "object", + "properties": { + "minGuestCpuCount": { + "description": "Minimum number of guest cpus required to use the Instance. Enforced at Instance creation and Instance start.", + "type": "integer", + "format": "int32" + }, + "minMemoryMb": { + "description": "Minimum memory required to use the Instance. Enforced at Instance creation and Instance start.", + "type": "integer", + "format": "int32" + } + } + }, + "LicensesListResponse": { + "id": "LicensesListResponse", + "type": "object", + "properties": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of License resources.", + "type": "array", + "items": { + "$ref": "License" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "InstanceTemplate" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates an instance template in the specified project and region using the global instance template whose URL is included in the request." + } + } + } + }, + "MachineImageList": { + "id": "MachineImageList", + "description": "A list of machine images.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#machineImagesListResponse for machine image lists.", + "default": "compute#machineImageList", + "type": "string" }, - "delete": { - "id": "compute.regionInstanceTemplates.delete", - "path": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", - "flatPath": "projects/{project}/regions/{region}/instanceTemplates/{instanceTemplate}", - "httpMethod": "DELETE", - "parameters": { - "instanceTemplate": { - "description": "The name of the instance template to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of MachineImage resources.", + "type": "array", + "items": { + "$ref": "MachineImage" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "instanceTemplate" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified instance template. Deleting an instance template is permanent and cannot be undone." + } } } }, - "instanceSettings": { - "methods": { - "get": { - "id": "compute.instanceSettings.get", - "path": "projects/{project}/zones/{zone}/instanceSettings", - "flatPath": "projects/{project}/zones/{zone}/instanceSettings", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "InstanceSettings" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Get Instance settings." + "MachineImage": { + "id": "MachineImage", + "description": "Represents a machine image resource. A machine image is a Compute Engine resource that stores all the configuration, metadata, permissions, and data from one or more disks required to create a Virtual machine (VM) instance. For more information, see Machine images.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#machineImage for machine image.", + "default": "compute#machineImage", + "type": "string" }, - "patch": { - "id": "compute.instanceSettings.patch", - "path": "projects/{project}/zones/{zone}/instanceSettings", - "flatPath": "projects/{project}/zones/{zone}/instanceSettings", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "updateMask": { - "description": "update_mask indicates fields to be updated as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - }, - "zone": { - "description": "The zone scoping this request. It should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } + "id": { + "description": "[Output Only] A unique identifier for this machine image. The server defines this identifier.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] The creation timestamp for this machine image in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.machineImages.insert" + ] }, - "parameterOrder": [ - "project", - "zone" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] The URL for this machine image. The server defines this URL.", + "type": "string" + }, + "sourceInstance": { + "description": "The source instance used to create the machine image. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance ", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the machine image. One of the following values: INVALID, CREATING, READY, DELETING, and UPLOADING.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "request": { - "$ref": "InstanceSettings" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY", + "UPLOADING" + ] + }, + "sourceInstanceProperties": { + "description": "[Output Only] DEPRECATED: Please use instance_properties instead for source instance related properties. New properties will not be added to this field.", + "$ref": "SourceInstanceProperties" + }, + "instanceProperties": { + "description": "[Output Only] Properties of source instance", + "$ref": "InstanceProperties" + }, + "savedDisks": { + "description": "An array of Machine Image specific properties for disks attached to the source instance", + "type": "array", + "items": { + "$ref": "SavedDisk" + } + }, + "storageLocations": { + "description": "The regional or multi-regional Cloud Storage bucket location where the machine image is stored.", + "type": "array", + "items": { + "type": "string" + } + }, + "machineImageEncryptionKey": { + "description": "Encrypts the machine image using a customer-supplied encryption key. After you encrypt a machine image using a customer-supplied key, you must provide the same key if you use the machine image later. For example, you must provide the encryption key when you create an instance from the encrypted machine image in a future request. Customer-supplied encryption keys do not protect access to metadata of the machine image. If you do not provide an encryption key when creating the machine image, then the machine image will be encrypted using an automatically generated key and you do not need to provide a key to use the machine image later.", + "$ref": "CustomerEncryptionKey" + }, + "guestFlush": { + "description": "[Input Only] Whether to attempt an application consistent machine image by informing the OS to prepare for the snapshot process.", + "type": "boolean" + }, + "sourceDiskEncryptionKeys": { + "description": "[Input Only] The customer-supplied encryption key of the disks attached to the source instance. Required if the source disk is protected by a customer-supplied encryption key.", + "type": "array", + "items": { + "$ref": "SourceDiskEncryptionKey" + } + }, + "totalStorageBytes": { + "description": "[Output Only] Total size of the storage used by the machine image.", + "type": "string", + "format": "int64" + }, + "satisfiesPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "satisfiesPzi": { + "description": "Output only. Reserved for future use.", + "readOnly": true, + "type": "boolean" + } + } + }, + "SourceInstanceProperties": { + "id": "SourceInstanceProperties", + "description": "DEPRECATED: Please use compute#instanceProperties instead. New properties will not be added to this field.", + "type": "object", + "properties": { + "description": { + "description": "An optional text description for the instances that are created from this machine image.", + "type": "string" + }, + "tags": { + "description": "A list of tags to apply to the instances that are created from this machine image. The tags identify valid sources or targets for network firewalls. The setTags method can modify this list of tags. Each tag within the list must comply with RFC1035.", + "$ref": "Tags" + }, + "machineType": { + "description": "The machine type to use for instances that are created from this machine image.", + "type": "string" + }, + "canIpForward": { + "description": "Enables instances created based on this machine image to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, specify true. If unsure, leave this set to false. See the Enable IP forwarding documentation for more information.", + "type": "boolean" + }, + "networkInterfaces": { + "description": "An array of network access configurations for this interface.", + "type": "array", + "items": { + "$ref": "NetworkInterface" + } + }, + "disks": { + "description": "An array of disks that are associated with the instances that are created from this machine image.", + "type": "array", + "items": { + "$ref": "SavedAttachedDisk" + } + }, + "metadata": { + "description": "The metadata key/value pairs to assign to instances that are created from this machine image. These pairs can consist of custom metadata or predefined keys. See Project and instance metadata for more information.", + "$ref": "Metadata" + }, + "serviceAccounts": { + "description": "A list of service accounts with specified scopes. Access tokens for these service accounts are available to the instances that are created from this machine image. Use metadata queries to obtain the access tokens for these instances.", + "type": "array", + "items": { + "$ref": "ServiceAccount" + } + }, + "scheduling": { + "description": "Specifies the scheduling options for the instances that are created from this machine image.", + "$ref": "Scheduling" + }, + "labels": { + "description": "Labels to apply to instances that are created from this machine image.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "guestAccelerators": { + "description": "A list of guest accelerator cards' type and count to use for instances created from this machine image.", + "type": "array", + "items": { + "$ref": "AcceleratorConfig" + } + }, + "minCpuPlatform": { + "description": "Minimum cpu/platform to be used by instances created from this machine image. The instance may be scheduled on the specified or newer cpu/platform. Applicable values are the friendly names of CPU platforms, such as minCpuPlatform: \"Intel Haswell\" or minCpuPlatform: \"Intel Sandy Bridge\". For more information, read Specifying a Minimum CPU Platform.", + "type": "string" + }, + "deletionProtection": { + "description": "Whether the instance created from this machine image should be protected against deletion.", + "type": "boolean" + }, + "keyRevocationActionType": { + "description": "KeyRevocationActionType of the instance. Supported options are \"STOP\" and \"NONE\". The default value is \"NONE\" if it is not specified.", + "type": "string", + "enumDescriptions": [ + "Default value. This value is unused.", + "Indicates user chose no operation.", + "Indicates user chose to opt for VM shutdown on key revocation." ], - "description": "Patch Instance settings" + "enum": [ + "KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED", + "NONE", + "STOP" + ] } } }, - "instantSnapshots": { - "methods": { - "list": { - "id": "compute.instantSnapshots.list", - "path": "projects/{project}/zones/{zone}/instantSnapshots", - "flatPath": "projects/{project}/zones/{zone}/instantSnapshots", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "InstantSnapshotList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of InstantSnapshot resources contained within the specified zone." + "SavedAttachedDisk": { + "id": "SavedAttachedDisk", + "description": "DEPRECATED: Please use compute#savedDisk instead. An instance-attached disk resource.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#attachedDisk for attached disks.", + "default": "compute#savedAttachedDisk", + "type": "string" }, - "get": { - "id": "compute.instantSnapshots.get", - "path": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", - "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", - "httpMethod": "GET", - "parameters": { - "instantSnapshot": { - "description": "Name of the InstantSnapshot resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instantSnapshot" - ], - "response": { - "$ref": "InstantSnapshot" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": { + "description": "Specifies the type of the attached disk, either SCRATCH or PERSISTENT.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified InstantSnapshot resource in the specified zone." + "enum": [ + "PERSISTENT", + "SCRATCH" + ] }, - "insert": { - "id": "compute.instantSnapshots.insert", - "path": "projects/{project}/zones/{zone}/instantSnapshots", - "flatPath": "projects/{project}/zones/{zone}/instantSnapshots", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "Name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "InstantSnapshot" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "mode": { + "description": "The mode in which this disk is attached to the source instance, either READ_WRITE or READ_ONLY.", + "type": "string", + "enumDescriptions": [ + "Attaches this disk in read-only mode. Multiple virtual machines can use a disk in read-only mode at a time.", + "*[Default]* Attaches this disk in read-write mode. Only one virtual machine at a time can be attached to a disk in read-write mode." ], - "description": "Creates an instant snapshot in the specified zone." + "enum": [ + "READ_ONLY", + "READ_WRITE" + ] }, - "setLabels": { - "id": "compute.instantSnapshots.setLabels", - "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setLabels", - "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" + "source": { + "description": "Specifies a URL of the disk attached to the source instance.", + "type": "string" + }, + "deviceName": { + "description": "Specifies the name of the disk attached to the source instance.", + "type": "string" + }, + "index": { + "description": "Specifies zero-based index of the disk that is attached to the source instance.", + "type": "integer", + "format": "int32" + }, + "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" + }, + "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" + }, + "licenses": { + "description": "[Output Only] Any valid publicly visible licenses.", + "type": "array", + "items": { + "type": "string" + } + }, + "interface": { + "description": "Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "request": { - "$ref": "ZoneSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "NVME", + "SCSI" + ] + }, + "guestOsFeatures": { + "description": "A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options.", + "type": "array", + "items": { + "$ref": "GuestOsFeature" + } + }, + "diskEncryptionKey": { + "description": "The encryption key for the disk.", + "$ref": "CustomerEncryptionKey" + }, + "diskSizeGb": { + "description": "The size of the disk in base-2 GB.", + "type": "string", + "format": "int64" + }, + "storageBytes": { + "description": "[Output Only] A size of the storage used by the disk's snapshot by this machine image.", + "type": "string", + "format": "int64" + }, + "storageBytesStatus": { + "description": "[Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Sets the labels on a instantSnapshot in the given zone. To learn more about labels, read the Labeling Resources documentation." + "enum": [ + "UPDATING", + "UP_TO_DATE" + ] }, - "delete": { - "id": "compute.instantSnapshots.delete", - "path": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", - "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{instantSnapshot}", - "httpMethod": "DELETE", - "parameters": { - "instantSnapshot": { - "description": "Name of the InstantSnapshot resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "instantSnapshot" + "diskType": { + "description": "[Output Only] URL of the disk type resource. For example: projects/project /zones/zone/diskTypes/pd-standard or pd-ssd", + "type": "string" + } + } + }, + "SavedDisk": { + "id": "SavedDisk", + "description": "An instance-attached disk resource.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#savedDisk for attached disks.", + "default": "compute#savedDisk", + "type": "string" + }, + "sourceDisk": { + "description": "Specifies a URL of the disk attached to the source instance.", + "type": "string" + }, + "storageBytes": { + "description": "[Output Only] Size of the individual disk snapshot used by this machine image.", + "type": "string", + "format": "int64" + }, + "storageBytesStatus": { + "description": "[Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "UPDATING", + "UP_TO_DATE" + ] + }, + "architecture": { + "description": "[Output Only] The architecture of the attached disk.", + "type": "string", + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "description": "Deletes the specified InstantSnapshot resource. Keep in mind that deleting a single instantSnapshot might not necessarily delete all the data on that instantSnapshot. If any data on the instantSnapshot that is marked for deletion is needed for subsequent instantSnapshots, the data will be moved to the next corresponding instantSnapshot. For more information, see Deleting instantSnapshots." + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" + ] + } + } + }, + "SourceDiskEncryptionKey": { + "id": "SourceDiskEncryptionKey", + "type": "object", + "properties": { + "sourceDisk": { + "description": "URL of the disk attached to the source instance. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk ", + "type": "string" }, - "getIamPolicy": { - "id": "compute.instantSnapshots.getIamPolicy", - "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/getIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "diskEncryptionKey": { + "description": "The customer-supplied encryption key of the source disk. Required if the source disk is protected by a customer-supplied encryption key.", + "$ref": "CustomerEncryptionKey" + } + } + }, + "MachineTypeList": { + "id": "MachineTypeList", + "description": "Contains a list of machine types.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#machineTypeList for lists of machine types.", + "default": "compute#machineTypeList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of MachineType resources.", + "type": "array", + "items": { + "$ref": "MachineType" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + } + } + } + }, + "MachineType": { + "id": "MachineType", + "description": "Represents a Machine Type resource. You can use specific machine types for your VM instances based on performance and pricing requirements. For more information, read Machine Types.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The type of the resource. Always compute#machineType for machine types.", + "default": "compute#machineType", + "type": "string" }, - "setIamPolicy": { - "id": "compute.instantSnapshots.setIamPolicy", - "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "request": { - "$ref": "ZoneSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "testIamPermissions": { - "id": "compute.instantSnapshots.testIamPermissions", - "path": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/testIamPermissions", - "flatPath": "projects/{project}/zones/{zone}/instantSnapshots/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "description": { + "description": "[Output Only] An optional textual description of the resource.", + "type": "string" + }, + "guestCpus": { + "description": "[Output Only] The number of virtual CPUs that are available to the instance.", + "type": "integer", + "format": "int32" + }, + "memoryMb": { + "description": "[Output Only] The amount of physical memory available to the instance, defined in MB.", + "type": "integer", + "format": "int32" + }, + "imageSpaceGb": { + "description": "[Deprecated] This property is deprecated and will never be populated with any relevant values.", + "type": "integer", + "format": "int32" + }, + "scratchDisks": { + "description": "[Output Only] A list of extended scratch disks assigned to the instance.", + "type": "array", + "items": { + "type": "object", + "properties": { + "diskGb": { + "description": "Size of the scratch disk, defined in GB.", + "type": "integer", + "format": "int32" + } } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + } }, - "aggregatedList": { - "id": "compute.instantSnapshots.aggregatedList", - "path": "projects/{project}/aggregated/instantSnapshots", - "flatPath": "projects/{project}/aggregated/instantSnapshots", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "maximumPersistentDisks": { + "description": "[Output Only] Maximum persistent disks allowed.", + "type": "integer", + "format": "int32" + }, + "maximumPersistentDisksSizeGb": { + "description": "[Output Only] Maximum total persistent disks size (GB) allowed.", + "type": "string", + "format": "int64" + }, + "deprecated": { + "description": "[Output Only] The deprecation status associated with this machine type. Only applicable if the machine type is unavailable.", + "$ref": "DeprecationStatus" + }, + "zone": { + "description": "[Output Only] The name of the zone where the machine type resides, such as us-central1-a.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "isSharedCpu": { + "description": "[Output Only] Whether this machine type has a shared CPU. See Shared-core machine types for more information.", + "type": "boolean" + }, + "accelerators": { + "description": "[Output Only] A list of accelerator configurations assigned to this machine type.", + "type": "array", + "items": { + "type": "object", + "properties": { + "guestAcceleratorType": { + "description": "The accelerator type resource name, not a full URL, e.g. nvidia-tesla-t4.", + "type": "string" + }, + "guestAcceleratorCount": { + "description": "Number of accelerator cards exposed to the guest.", + "type": "integer", + "format": "int32" + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InstantSnapshotAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + } + }, + "architecture": { + "description": "[Output Only] The architecture of the machine type.", + "type": "string", + "enumDescriptions": [ + "Default value indicating Architecture is not set.", + "Machines with architecture ARM64", + "Machines with architecture X86_64" ], - "description": "Retrieves an aggregated list of instantSnapshots. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "ARCHITECTURE_UNSPECIFIED", + "ARM64", + "X86_64" + ] } } }, - "regionInstantSnapshots": { - "methods": { - "list": { - "id": "compute.regionInstantSnapshots.list", - "path": "projects/{project}/regions/{region}/instantSnapshots", - "flatPath": "projects/{project}/regions/{region}/instantSnapshots", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "InstantSnapshotList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of InstantSnapshot resources contained within the specified region." + "MachineTypeAggregatedList": { + "id": "MachineTypeAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#machineTypeAggregatedList for aggregated lists of machine types.", + "default": "compute#machineTypeAggregatedList", + "type": "string" }, - "get": { - "id": "compute.regionInstantSnapshots.get", - "path": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", - "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", - "httpMethod": "GET", - "parameters": { - "instantSnapshot": { - "description": "Name of the InstantSnapshot resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of MachineTypesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of machine types.", + "$ref": "MachineTypesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "instantSnapshot" - ], - "response": { - "$ref": "InstantSnapshot" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified InstantSnapshot resource in the specified region." + } }, - "insert": { - "id": "compute.regionInstantSnapshots.insert", - "path": "projects/{project}/regions/{region}/instantSnapshots", - "flatPath": "projects/{project}/regions/{region}/instantSnapshots", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "InstantSnapshot" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates an instant snapshot in the specified region." + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "MachineTypesScopedList": { + "id": "MachineTypesScopedList", + "type": "object", + "properties": { + "machineTypes": { + "description": "[Output Only] A list of machine types contained in this scope.", + "type": "array", + "items": { + "$ref": "MachineType" + } }, - "setLabels": { - "id": "compute.regionInstantSnapshots.setLabels", - "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setLabels", - "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] An informational warning that appears when the machine types list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on a instantSnapshot in the given region. To learn more about labels, read the Labeling Resources documentation." + } + } + } + }, + "NetworkAttachmentAggregatedList": { + "id": "NetworkAttachmentAggregatedList", + "description": "Contains a list of NetworkAttachmentsScopedList.", + "type": "object", + "properties": { + "kind": { + "default": "compute#networkAttachmentAggregatedList", + "type": "string" }, - "delete": { - "id": "compute.regionInstantSnapshots.delete", - "path": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", - "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{instantSnapshot}", - "httpMethod": "DELETE", - "parameters": { - "instantSnapshot": { - "description": "Name of the InstantSnapshot resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "instantSnapshot" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified InstantSnapshot resource. Keep in mind that deleting a single instantSnapshot might not necessarily delete all the data on that instantSnapshot. If any data on the instantSnapshot that is marked for deletion is needed for subsequent instantSnapshots, the data will be moved to the next corresponding instantSnapshot. For more information, see Deleting instantSnapshots." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "getIamPolicy": { - "id": "compute.regionInstantSnapshots.getIamPolicy", - "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/getIamPolicy", - "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "items": { + "description": "A list of NetworkAttachmentsScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of NetworkAttachments.", + "$ref": "NetworkAttachmentsScopedList" + } }, - "setIamPolicy": { - "id": "compute.regionInstantSnapshots.setIamPolicy", - "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setIamPolicy", - "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + } + } + } + }, + "NetworkAttachmentsScopedList": { + "id": "NetworkAttachmentsScopedList", + "type": "object", + "properties": { + "networkAttachments": { + "description": "A list of NetworkAttachments contained in this scope.", + "type": "array", + "items": { + "$ref": "NetworkAttachment" + } }, - "testIamPermissions": { - "id": "compute.regionInstantSnapshots.testIamPermissions", - "path": "projects/{project}/regions/{region}/instantSnapshots/{resource}/testIamPermissions", - "flatPath": "projects/{project}/regions/{region}/instantSnapshots/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "Informational warning which replaces the list of network attachments when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } + } + } + } + }, + "NetworkAttachment": { + "id": "NetworkAttachment", + "description": "NetworkAttachments A network attachment resource ...", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource.", + "default": "compute#networkAttachment", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.networkAttachments.insert" + ] }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource's resource id.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the network attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "connectionPreference": { + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "ACCEPT_AUTOMATIC", + "ACCEPT_MANUAL", + "INVALID" + ] + }, + "connectionEndpoints": { + "description": "[Output Only] An array of connections for all the producers connected to this network attachment.", + "type": "array", + "items": { + "$ref": "NetworkAttachmentConnectedEndpoint" + } + }, + "subnetworks": { + "description": "An array of URLs where each entry is the URL of a subnet provided by the service consumer to use for endpoints in the producers that connect to this network attachment.", + "type": "array", + "items": { + "type": "string" + } + }, + "producerRejectLists": { + "description": "Projects that are not allowed to connect to this network attachment. The project can be specified using its id or number.", + "type": "array", + "items": { + "type": "string" + } + }, + "producerAcceptLists": { + "description": "Projects that are allowed to connect to this network attachment. The project can be specified using its id or number.", + "type": "array", + "items": { + "type": "string" + } + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. An up-to-date fingerprint must be provided in order to patch.", + "type": "string", + "format": "byte" + }, + "network": { + "description": "[Output Only] The URL of the network which the Network Attachment belongs to. Practically it is inferred by fetching the network of the first subnetwork associated. Because it is required that all the subnetworks must be from the same network, it is assured that the Network Attachment belongs to the same network as all the subnetworks.", + "type": "string" + } + } + }, + "NetworkAttachmentConnectedEndpoint": { + "id": "NetworkAttachmentConnectedEndpoint", + "description": "[Output Only] A connection connected to this network attachment.", + "type": "object", + "properties": { + "status": { + "description": "The status of a connected endpoint to this network attachment.", + "type": "string", + "enumDescriptions": [ + "The consumer allows traffic from the producer to reach its VPC.", + "The consumer network attachment no longer exists.", + "The consumer needs to take further action before traffic can be served.", + "The consumer neither allows nor prohibits traffic from the producer to reach its VPC.", + "The consumer prohibits traffic from the producer to reach its VPC.", + "" ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "ACCEPTED", + "CLOSED", + "NEEDS_ATTENTION", + "PENDING", + "REJECTED", + "STATUS_UNSPECIFIED" + ] + }, + "projectIdOrNum": { + "description": "The project id or number of the interface to which the IP was assigned.", + "type": "string" + }, + "subnetwork": { + "description": "The subnetwork used to assign the IP to the producer instance network interface.", + "type": "string" + }, + "ipAddress": { + "description": "The IPv4 address assigned to the producer instance network interface. This value will be a range in case of Serverless.", + "type": "string" + }, + "ipv6Address": { + "description": "The IPv6 address assigned to the producer instance network interface. This is only assigned when the stack types of both the instance network interface and the consumer subnet are IPv4_IPv6.", + "type": "string" + }, + "secondaryIpCidrRanges": { + "description": "Alias IP ranges from the same subnetwork.", + "type": "array", + "items": { + "type": "string" + } + }, + "subnetworkCidrRange": { + "description": "[Output Only] The CIDR range of the subnet from which the IPv4 internal IP was allocated from.", + "type": "string" } } }, - "interconnectAttachments": { - "methods": { - "list": { - "id": "compute.interconnectAttachments.list", - "path": "projects/{project}/regions/{region}/interconnectAttachments", - "flatPath": "projects/{project}/regions/{region}/interconnectAttachments", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "NetworkAttachmentList": { + "id": "NetworkAttachmentList", + "type": "object", + "properties": { + "kind": { + "default": "compute#networkAttachmentList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NetworkAttachment resources.", + "type": "array", + "items": { + "$ref": "NetworkAttachment" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "InterconnectAttachmentList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of interconnect attachments contained within the specified region." + } + } + } + }, + "NetworkEdgeSecurityService": { + "id": "NetworkEdgeSecurityService", + "description": "Represents a Google Cloud Armor network edge security service resource.", + "type": "object", + "properties": { + "kind": { + "description": "[Output only] Type of the resource. Always compute#networkEdgeSecurityService for NetworkEdgeSecurityServices", + "default": "compute#networkEdgeSecurityService", + "type": "string" }, - "aggregatedList": { - "id": "compute.interconnectAttachments.aggregatedList", - "path": "projects/{project}/aggregated/interconnectAttachments", - "flatPath": "projects/{project}/aggregated/interconnectAttachments", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InterconnectAttachmentAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of interconnect attachments. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "get": { - "id": "compute.interconnectAttachments.get", - "path": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", - "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", - "httpMethod": "GET", - "parameters": { - "interconnectAttachment": { - "description": "Name of the interconnect attachment to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "interconnectAttachment" - ], - "response": { - "$ref": "InterconnectAttachment" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified interconnect attachment." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "insert": { - "id": "compute.interconnectAttachments.insert", - "path": "projects/{project}/regions/{region}/interconnectAttachments", - "flatPath": "projects/{project}/regions/{region}/interconnectAttachments", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource with the resource id.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the resource resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "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 NetworkEdgeSecurityService. An up-to-date fingerprint must be provided in order to update the NetworkEdgeSecurityService, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a NetworkEdgeSecurityService.", + "type": "string", + "format": "byte" + }, + "securityPolicy": { + "description": "The resource URL for the network edge security service associated with this network edge security service.", + "type": "string" + } + } + }, + "NetworkEdgeSecurityServiceAggregatedList": { + "id": "NetworkEdgeSecurityServiceAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#networkEdgeSecurityServiceAggregatedList for lists of Network Edge Security Services.", + "default": "compute#networkEdgeSecurityServiceAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NetworkEdgeSecurityServicesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of security policies.", + "$ref": "NetworkEdgeSecurityServicesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "validateOnly": { - "description": "If true, the request will not be committed.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "InterconnectAttachment" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates an InterconnectAttachment in the specified project using the data included in the request." + } }, - "patch": { - "id": "compute.interconnectAttachments.patch", - "path": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", - "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", - "httpMethod": "PATCH", - "parameters": { - "interconnectAttachment": { - "description": "Name of the interconnect attachment to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "etag": { + "type": "string" + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "NetworkEdgeSecurityServicesScopedList": { + "id": "NetworkEdgeSecurityServicesScopedList", + "type": "object", + "properties": { + "networkEdgeSecurityServices": { + "description": "A list of NetworkEdgeSecurityServices contained in this scope.", + "type": "array", + "items": { + "$ref": "NetworkEdgeSecurityService" + } + }, + "warning": { + "description": "Informational warning which replaces the list of security policies when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "interconnectAttachment" - ], - "request": { - "$ref": "InterconnectAttachment" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified interconnect attachment with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + } + } + } + }, + "NetworkEndpointGroupList": { + "id": "NetworkEndpointGroupList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#networkEndpointGroupList for network endpoint group lists.", + "default": "compute#networkEndpointGroupList", + "type": "string" }, - "delete": { - "id": "compute.interconnectAttachments.delete", - "path": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", - "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{interconnectAttachment}", - "httpMethod": "DELETE", - "parameters": { - "interconnectAttachment": { - "description": "Name of the interconnect attachment to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "interconnectAttachment" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified interconnect attachment." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "setLabels": { - "id": "compute.interconnectAttachments.setLabels", - "path": "projects/{project}/regions/{region}/interconnectAttachments/{resource}/setLabels", - "flatPath": "projects/{project}/regions/{region}/interconnectAttachments/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of NetworkEndpointGroup resources.", + "type": "array", + "items": { + "$ref": "NetworkEndpointGroup" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" + } + } + } + }, + "NetworkEndpointGroup": { + "id": "NetworkEndpointGroup", + "description": "Represents a collection of network endpoints. A network endpoint group (NEG) defines how a set of endpoints should be reached, whether they are reachable, and where they are located. For more information about using NEGs for different use cases, see Network endpoint groups overview.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#networkEndpointGroup for network endpoint group.", + "default": "compute#networkEndpointGroup", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for 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. 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.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "networkEndpointType": { + "description": "Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.", + "type": "string", + "enumDescriptions": [ + "The network endpoint is represented by an IP address.", + "The network endpoint is represented by IP address and port pair.", + "The network endpoint is represented by an IP, Port and Client Destination Port.", + "The network endpoint is represented by fully qualified domain name and port.", + "The network endpoint is represented by an internet IP address and port.", + "The network endpoint is represented by an IP address and port. The endpoint belongs to a VM or pod running in a customer's on-premises.", + "The network endpoint is either public Google APIs or services exposed by other GCP Project with a Service Attachment. The connection is set up by private service connect", + "The network endpoint is handled by specified serverless infrastructure." ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "GCE_VM_IP", + "GCE_VM_IP_PORT", + "GCE_VM_IP_PORTMAP", + "INTERNET_FQDN_PORT", + "INTERNET_IP_PORT", + "NON_GCP_PRIVATE_IP_PORT", + "PRIVATE_SERVICE_CONNECT", + "SERVERLESS" + ] + }, + "size": { + "description": "[Output only] Number of network endpoints in the network endpoint group.", + "type": "integer", + "format": "int32" + }, + "region": { + "description": "[Output Only] The URL of the region where the network endpoint group is located.", + "type": "string" + }, + "zone": { + "description": "[Output Only] The URL of the zone where the network endpoint group is located.", + "type": "string" + }, + "network": { + "description": "The URL of the network to which all network endpoints in the NEG belong. Uses default project network if unspecified.", + "type": "string" + }, + "subnetwork": { + "description": "Optional URL of the subnetwork to which all network endpoints in the NEG belong.", + "type": "string" + }, + "defaultPort": { + "description": "The default port used if the port number is not specified in the network endpoint. If the network endpoint type is either GCE_VM_IP, SERVERLESS or PRIVATE_SERVICE_CONNECT, this field must not be specified.", + "type": "integer", + "format": "int32" + }, + "annotations": { + "description": "Metadata defined as annotations on the network endpoint group.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "cloudRun": { + "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set.", + "$ref": "NetworkEndpointGroupCloudRun" + }, + "appEngine": { + "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set.", + "$ref": "NetworkEndpointGroupAppEngine" + }, + "cloudFunction": { + "description": "Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, appEngine or cloudFunction may be set.", + "$ref": "NetworkEndpointGroupCloudFunction" + }, + "pscTargetService": { + "description": "The target service url used to set up private service connection to a Google API or a PSC Producer Service Attachment. An example value is: asia-northeast3-cloudkms.googleapis.com", + "type": "string" + }, + "pscData": { + "$ref": "NetworkEndpointGroupPscData" + } + } + }, + "NetworkEndpointGroupCloudRun": { + "id": "NetworkEndpointGroupCloudRun", + "description": "Configuration for a Cloud Run network endpoint group (NEG). The service must be provided explicitly or in the URL mask. The tag is optional, may be provided explicitly or in the URL mask. Note: Cloud Run service must be in the same project and located in the same region as the Serverless NEG.", + "type": "object", + "properties": { + "service": { + "description": "Cloud Run service is the main resource of Cloud Run. The service must be 1-63 characters long, and comply with RFC1035. Example value: \"run-service\".", + "type": "string" + }, + "tag": { + "description": "Optional Cloud Run tag represents the \"named-revision\" to provide additional fine-grained traffic routing information. The tag must be 1-63 characters long, and comply with RFC1035. Example value: \"revision-0010\".", + "type": "string" + }, + "urlMask": { + "description": "An URL mask is one of the main components of the Cloud Function. A template to parse \u003cservice\u003e and \u003ctag\u003e fields from a request URL. URL mask allows for routing to multiple Run services without having to create multiple network endpoint groups and backend services. For example, request URLs foo1.domain.com/bar1 and foo1.domain.com/bar2 can be backed by the same Serverless Network Endpoint Group (NEG) with URL mask \u003ctag\u003e.domain.com/\u003cservice\u003e. The URL mask will parse them to { service=\"bar1\", tag=\"foo1\" } and { service=\"bar2\", tag=\"foo2\" } respectively.", + "type": "string" + } + } + }, + "NetworkEndpointGroupAppEngine": { + "id": "NetworkEndpointGroupAppEngine", + "description": "Configuration for an App Engine network endpoint group (NEG). The service is optional, may be provided explicitly or in the URL mask. The version is optional and can only be provided explicitly or in the URL mask when service is present. Note: App Engine service must be in the same project and located in the same region as the Serverless NEG.", + "type": "object", + "properties": { + "service": { + "description": "Optional serving service. The service name is case-sensitive and must be 1-63 characters long. Example value: default, my-service.", + "type": "string" + }, + "version": { + "description": "Optional serving version. The version name is case-sensitive and must be 1-100 characters long. Example value: v1, v2.", + "type": "string" + }, + "urlMask": { + "description": "An URL mask is one of the main components of the Cloud Function. 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. For 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 \u003cservice\u003e-dot-appname.appspot.com/\u003cversion\u003e. The URL mask will parse them to { service = \"foo1\", version = \"v1\" } and { service = \"foo1\", version = \"v2\" } respectively.", + "type": "string" + } + } + }, + "NetworkEndpointGroupCloudFunction": { + "id": "NetworkEndpointGroupCloudFunction", + "description": "Configuration for a Cloud Function network endpoint group (NEG). The function must be provided explicitly or in the URL mask. Note: Cloud Function must be in the same project and located in the same region as the Serverless NEG.", + "type": "object", + "properties": { + "function": { + "description": "A user-defined name of the Cloud Function. The function name is case-sensitive and must be 1-63 characters long. Example value: func1.", + "type": "string" + }, + "urlMask": { + "description": "An URL mask is one of the main components of the Cloud Function. A template to parse function field from a request URL. URL mask allows for routing to multiple Cloud Functions without having to create multiple Network Endpoint Groups and backend services. For example, request URLs mydomain.com/function1 and mydomain.com/function2 can be backed by the same Serverless NEG with URL mask /\u003cfunction\u003e. The URL mask will parse them to { function = \"function1\" } and { function = \"function2\" } respectively.", + "type": "string" + } + } + }, + "NetworkEndpointGroupPscData": { + "id": "NetworkEndpointGroupPscData", + "description": "All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.", + "type": "object", + "properties": { + "consumerPscAddress": { + "description": "[Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.", + "type": "string" + }, + "pscConnectionId": { + "description": "[Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.", + "type": "string", + "format": "uint64" + }, + "pscConnectionStatus": { + "description": "[Output Only] The connection status of the PSC Forwarding Rule.", + "type": "string", + "enumDescriptions": [ + "The connection has been accepted by the producer.", + "The connection has been closed by the producer and will not serve traffic going forward.", + "The connection has been accepted by the producer, but the producer needs to take further action before the forwarding rule can serve traffic.", + "The connection is pending acceptance by the producer.", + "The connection has been rejected by the producer.", + "" ], - "description": "Sets the labels on an InterconnectAttachment. To learn more about labels, read the Labeling Resources documentation." + "enum": [ + "ACCEPTED", + "CLOSED", + "NEEDS_ATTENTION", + "PENDING", + "REJECTED", + "STATUS_UNSPECIFIED" + ] + }, + "producerPort": { + "description": "The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type", + "type": "integer", + "format": "int32" } } }, - "interconnects": { - "methods": { - "insert": { - "id": "compute.interconnects.insert", - "path": "projects/{project}/global/interconnects", - "flatPath": "projects/{project}/global/interconnects", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "Interconnect" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates an Interconnect in the specified project using the data included in the request." + "NetworkEndpointGroupAggregatedList": { + "id": "NetworkEndpointGroupAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#networkEndpointGroupAggregatedList for aggregated lists of network endpoint groups.", + "default": "compute#networkEndpointGroupAggregatedList", + "type": "string" }, - "list": { - "id": "compute.interconnects.list", - "path": "projects/{project}/global/interconnects", - "flatPath": "projects/{project}/global/interconnects", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InterconnectList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of Interconnects available to the specified project." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "getDiagnostics": { - "id": "compute.interconnects.getDiagnostics", - "path": "projects/{project}/global/interconnects/{interconnect}/getDiagnostics", - "flatPath": "projects/{project}/global/interconnects/{interconnect}/getDiagnostics", - "httpMethod": "GET", - "parameters": { - "interconnect": { - "description": "Name of the interconnect resource to query.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "interconnect" - ], - "response": { - "$ref": "InterconnectsGetDiagnosticsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the interconnectDiagnostics for the specified Interconnect. In the event of a global outage, do not use this API to make decisions about where to redirect your network traffic. Unlike a VLAN attachment, which is regional, a Cloud Interconnect connection is a global resource. A global outage can prevent this API from functioning properly." + "items": { + "description": "A list of NetworkEndpointGroupsScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "The name of the scope that contains this set of network endpoint groups.", + "$ref": "NetworkEndpointGroupsScopedList" + } }, - "getMacsecConfig": { - "id": "compute.interconnects.getMacsecConfig", - "path": "projects/{project}/global/interconnects/{interconnect}/getMacsecConfig", - "flatPath": "projects/{project}/global/interconnects/{interconnect}/getMacsecConfig", - "httpMethod": "GET", - "parameters": { - "interconnect": { - "description": "Name of the interconnect resource to query.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "interconnect" - ], - "response": { - "$ref": "InterconnectsGetMacsecConfigResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the interconnectMacsecConfig for the specified Interconnect." + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "get": { - "id": "compute.interconnects.get", - "path": "projects/{project}/global/interconnects/{interconnect}", - "flatPath": "projects/{project}/global/interconnects/{interconnect}", - "httpMethod": "GET", - "parameters": { - "interconnect": { - "description": "Name of the interconnect to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "interconnect" - ], - "response": { - "$ref": "Interconnect" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified Interconnect. Get a list of available Interconnects by making a list() request." + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" }, - "delete": { - "id": "compute.interconnects.delete", - "path": "projects/{project}/global/interconnects/{interconnect}", - "flatPath": "projects/{project}/global/interconnects/{interconnect}", - "httpMethod": "DELETE", - "parameters": { - "interconnect": { - "description": "Name of the interconnect to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "interconnect" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified Interconnect." + } }, - "patch": { - "id": "compute.interconnects.patch", - "path": "projects/{project}/global/interconnects/{interconnect}", - "flatPath": "projects/{project}/global/interconnects/{interconnect}", - "httpMethod": "PATCH", - "parameters": { - "interconnect": { - "description": "Name of the interconnect to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "NetworkEndpointGroupsScopedList": { + "id": "NetworkEndpointGroupsScopedList", + "type": "object", + "properties": { + "networkEndpointGroups": { + "description": "[Output Only] The list of network endpoint groups that are contained in this scope.", + "type": "array", + "items": { + "$ref": "NetworkEndpointGroup" + } + }, + "warning": { + "description": "[Output Only] An informational warning that replaces the list of network endpoint groups when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "interconnect" - ], - "request": { - "$ref": "Interconnect" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified Interconnect with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + } + } + } + }, + "NetworkEndpointGroupsAttachEndpointsRequest": { + "id": "NetworkEndpointGroupsAttachEndpointsRequest", + "type": "object", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be attached.", + "type": "array", + "items": { + "$ref": "NetworkEndpoint" + } + } + } + }, + "NetworkEndpoint": { + "id": "NetworkEndpoint", + "description": "The network endpoint.", + "type": "object", + "properties": { + "ipAddress": { + "description": "Optional IPv4 address of network endpoint. The IP address must belong to a VM in Compute Engine (either the primary IP or as part of an aliased IP range). If the IP address is not specified, then the primary IP address for the VM instance in the network that the network endpoint group belongs to will be used. This field is redundant and need not be set for network endpoints of type GCE_VM_IP. If set, it must be set to the primary internal IP address of the attached VM instance that matches the subnetwork of the NEG. The primary internal IP address from any NIC of a multi-NIC VM instance can be added to a NEG as long as it matches the NEG subnetwork.", + "type": "string" }, - "setLabels": { - "id": "compute.interconnects.setLabels", - "path": "projects/{project}/global/interconnects/{resource}/setLabels", - "flatPath": "projects/{project}/global/interconnects/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "ipv6Address": { + "description": "Optional IPv6 address of network endpoint.", + "type": "string" + }, + "fqdn": { + "description": "Optional fully qualified domain name of network endpoint. This can only be specified when NetworkEndpointGroup.network_endpoint_type is NON_GCP_FQDN_PORT.", + "type": "string" + }, + "port": { + "description": "Optional port number of network endpoint. If not specified, the defaultPort for the network endpoint group will be used. This field can not be set for network endpoints of type GCE_VM_IP.", + "type": "integer", + "format": "int32" + }, + "clientDestinationPort": { + "description": "Represents the port number to which PSC consumer sends packets. Only valid for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type.", + "type": "integer", + "format": "int32" + }, + "instance": { + "description": "The name or a URL of VM instance of this network endpoint. This field is required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The instance must be in the same zone of network endpoint group (for zonal NEGs) or in the zone within the region of the NEG (for regional NEGs). If the ipAddress is specified, it must belongs to the VM instance. The name must be 1-63 characters long, and comply with RFC1035 or be a valid URL pointing to an existing instance.", + "type": "string" + }, + "annotations": { + "description": "Metadata defined as annotations on the network endpoint.", + "type": "object", + "additionalProperties": { + "type": "string" + } + } + } + }, + "NetworkEndpointGroupsDetachEndpointsRequest": { + "id": "NetworkEndpointGroupsDetachEndpointsRequest", + "type": "object", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be detached.", + "type": "array", + "items": { + "$ref": "NetworkEndpoint" + } + } + } + }, + "NetworkEndpointGroupsListEndpointsRequest": { + "id": "NetworkEndpointGroupsListEndpointsRequest", + "type": "object", + "properties": { + "healthStatus": { + "description": "Optional query parameter for showing the health status of each network endpoint. Valid options are SKIP or SHOW. If you don't specify this parameter, the health status of network endpoints will not be provided.", + "type": "string", + "enumDescriptions": [ + "Show the health status for each network endpoint. Impacts latency of the call.", + "Health status for network endpoints will not be provided." ], - "description": "Sets the labels on an Interconnect. To learn more about labels, read the Labeling Resources documentation." + "enum": [ + "SHOW", + "SKIP" + ] } } }, - "interconnectLocations": { - "methods": { - "list": { - "id": "compute.interconnectLocations.list", - "path": "projects/{project}/global/interconnectLocations", - "flatPath": "projects/{project}/global/interconnectLocations", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "NetworkEndpointGroupsListNetworkEndpoints": { + "id": "NetworkEndpointGroupsListNetworkEndpoints", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute#networkEndpointGroupsListNetworkEndpoints for the list of network endpoints in the specified network endpoint group.", + "default": "compute#networkEndpointGroupsListNetworkEndpoints", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NetworkEndpointWithHealthStatus resources.", + "type": "array", + "items": { + "$ref": "NetworkEndpointWithHealthStatus" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InterconnectLocationList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of interconnect locations available to the specified project." + } + } + } + }, + "NetworkEndpointWithHealthStatus": { + "id": "NetworkEndpointWithHealthStatus", + "type": "object", + "properties": { + "networkEndpoint": { + "description": "[Output only] The network endpoint;", + "$ref": "NetworkEndpoint" }, - "get": { - "id": "compute.interconnectLocations.get", - "path": "projects/{project}/global/interconnectLocations/{interconnectLocation}", - "flatPath": "projects/{project}/global/interconnectLocations/{interconnectLocation}", - "httpMethod": "GET", - "parameters": { - "interconnectLocation": { - "description": "Name of the interconnect location to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "interconnectLocation" - ], - "response": { - "$ref": "InterconnectLocation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the details for the specified interconnect location. Gets a list of available interconnect locations by making a list() request." + "healths": { + "description": "[Output only] The health status of network endpoint;", + "type": "array", + "items": { + "$ref": "HealthStatusForNetworkEndpoint" + } } } }, - "interconnectRemoteLocations": { - "methods": { - "list": { - "id": "compute.interconnectRemoteLocations.list", - "path": "projects/{project}/global/interconnectRemoteLocations", - "flatPath": "projects/{project}/global/interconnectRemoteLocations", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "InterconnectRemoteLocationList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of interconnect remote locations available to the specified project." + "HealthStatusForNetworkEndpoint": { + "id": "HealthStatusForNetworkEndpoint", + "type": "object", + "properties": { + "forwardingRule": { + "description": "URL of the forwarding rule associated with the health state of the network endpoint.", + "$ref": "ForwardingRuleReference" }, - "get": { - "id": "compute.interconnectRemoteLocations.get", - "path": "projects/{project}/global/interconnectRemoteLocations/{interconnectRemoteLocation}", - "flatPath": "projects/{project}/global/interconnectRemoteLocations/{interconnectRemoteLocation}", - "httpMethod": "GET", - "parameters": { - "interconnectRemoteLocation": { - "description": "Name of the interconnect remote location to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "interconnectRemoteLocation" + "backendService": { + "description": "URL of the backend service associated with the health state of the network endpoint.", + "$ref": "BackendServiceReference" + }, + "healthCheck": { + "description": "URL of the health check associated with the health state of the network endpoint.", + "$ref": "HealthCheckReference" + }, + "healthCheckService": { + "description": "URL of the health check service associated with the health state of the network endpoint.", + "$ref": "HealthCheckServiceReference" + }, + "healthState": { + "description": "Health state of the network endpoint determined based on the health checks configured.", + "type": "string", + "enumDescriptions": [ + "Endpoint is being drained.", + "Endpoint is healthy.", + "Endpoint is unhealthy.", + "Health status of the endpoint is unknown." ], - "response": { - "$ref": "InterconnectRemoteLocation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "DRAINING", + "HEALTHY", + "UNHEALTHY", + "UNKNOWN" + ] + }, + "ipv6HealthState": { + "description": "Health state of the ipv6 network endpoint determined based on the health checks configured.", + "type": "string", + "enumDescriptions": [ + "Endpoint is being drained.", + "Endpoint is healthy.", + "Endpoint is unhealthy.", + "Health status of the endpoint is unknown." ], - "description": "Returns the details for the specified interconnect remote location. Gets a list of available interconnect remote locations by making a list() request." + "enum": [ + "DRAINING", + "HEALTHY", + "UNHEALTHY", + "UNKNOWN" + ] } } }, - "licenseCodes": { - "methods": { - "get": { - "id": "compute.licenseCodes.get", - "path": "projects/{project}/global/licenseCodes/{licenseCode}", - "flatPath": "projects/{project}/global/licenseCodes/{licenseCode}", - "httpMethod": "GET", - "parameters": { - "licenseCode": { - "description": "Number corresponding to the License code resource to return.", - "pattern": "[0-9]{0,61}?", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "licenseCode" - ], - "response": { - "$ref": "LicenseCode" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Return a specified license code. License codes are mirrored across all projects that have permissions to read the License Code. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " - }, - "testIamPermissions": { - "id": "compute.licenseCodes.testIamPermissions", - "path": "projects/{project}/global/licenseCodes/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/licenseCodes/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + "ForwardingRuleReference": { + "id": "ForwardingRuleReference", + "type": "object", + "properties": { + "forwardingRule": { + "type": "string" } } }, - "licenses": { - "methods": { - "get": { - "id": "compute.licenses.get", - "path": "projects/{project}/global/licenses/{license}", - "flatPath": "projects/{project}/global/licenses/{license}", - "httpMethod": "GET", - "parameters": { - "license": { - "description": "Name of the License resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "license" - ], - "response": { - "$ref": "License" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified License resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + "BackendServiceReference": { + "id": "BackendServiceReference", + "type": "object", + "properties": { + "backendService": { + "type": "string" + } + } + }, + "HealthCheckReference": { + "id": "HealthCheckReference", + "description": "A full or valid partial URL to a health check. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check - projects/project-id/global/httpHealthChecks/health-check - global/httpHealthChecks/health-check ", + "type": "object", + "properties": { + "healthCheck": { + "type": "string" + } + } + }, + "HealthCheckServiceReference": { + "id": "HealthCheckServiceReference", + "description": "A full or valid partial URL to a health check service. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service - projects/project-id/regions/us-west1/healthCheckServices/health-check-service - regions/us-west1/healthCheckServices/health-check-service ", + "type": "object", + "properties": { + "healthCheckService": { + "type": "string" + } + } + }, + "GlobalNetworkEndpointGroupsAttachEndpointsRequest": { + "id": "GlobalNetworkEndpointGroupsAttachEndpointsRequest", + "type": "object", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be attached.", + "type": "array", + "items": { + "$ref": "NetworkEndpoint" + } + } + } + }, + "GlobalNetworkEndpointGroupsDetachEndpointsRequest": { + "id": "GlobalNetworkEndpointGroupsDetachEndpointsRequest", + "type": "object", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be detached.", + "type": "array", + "items": { + "$ref": "NetworkEndpoint" + } + } + } + }, + "RegionNetworkEndpointGroupsAttachEndpointsRequest": { + "id": "RegionNetworkEndpointGroupsAttachEndpointsRequest", + "type": "object", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be attached.", + "type": "array", + "items": { + "$ref": "NetworkEndpoint" + } + } + } + }, + "RegionNetworkEndpointGroupsDetachEndpointsRequest": { + "id": "RegionNetworkEndpointGroupsDetachEndpointsRequest", + "type": "object", + "properties": { + "networkEndpoints": { + "description": "The list of network endpoints to be detached.", + "type": "array", + "items": { + "$ref": "NetworkEndpoint" + } + } + } + }, + "NetworkList": { + "id": "NetworkList", + "description": "Contains a list of networks.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#networkList for lists of networks.", + "default": "compute#networkList", + "type": "string" }, - "list": { - "id": "compute.licenses.list", - "path": "projects/{project}/global/licenses", - "flatPath": "projects/{project}/global/licenses", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "LicensesListResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of licenses available in the specified project. This method does not get any licenses that belong to other projects, including licenses attached to publicly-available images, like Debian 9. If you want to get a list of publicly-available licenses, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "delete": { - "id": "compute.licenses.delete", - "path": "projects/{project}/global/licenses/{license}", - "flatPath": "projects/{project}/global/licenses/{license}", - "httpMethod": "DELETE", - "parameters": { - "license": { - "description": "Name of the license resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "license" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified license. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + "items": { + "description": "A list of Network resources.", + "type": "array", + "items": { + "$ref": "Network" + } }, - "insert": { - "id": "compute.licenses.insert", - "path": "projects/{project}/global/licenses", - "flatPath": "projects/{project}/global/licenses", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "License" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/devstorage.full_control", - "https://www.googleapis.com/auth/devstorage.read_only", - "https://www.googleapis.com/auth/devstorage.read_write" - ], - "description": "Create a License resource in the specified project. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "getIamPolicy": { - "id": "compute.licenses.getIamPolicy", - "path": "projects/{project}/global/licenses/{resource}/getIamPolicy", - "flatPath": "projects/{project}/global/licenses/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" }, - "setIamPolicy": { - "id": "compute.licenses.setIamPolicy", - "path": "projects/{project}/global/licenses/{resource}/setIamPolicy", - "flatPath": "projects/{project}/global/licenses/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } + } + } + } + }, + "Network": { + "id": "Network", + "description": "Represents a VPC Network resource. Networks connect resources to each other and to the internet. For more information, read Virtual Private Cloud (VPC) Network.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#network for networks.", + "default": "compute#network", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "annotations": { + "required": [ + "compute.networks.insert" + ] }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this field when you create the resource.", + "type": "string" + }, + "IPv4Range": { + "description": "Deprecated in favor of subnet mode networks. The range of internal addresses that are legal on this network. This range is a CIDR specification, for example: 192.168.0.0/16. Provided by the client when the network is created.", + "pattern": "[0-9]{1,3}(?:\\.[0-9]{1,3}){3}/[0-9]{1,2}", + "deprecated": true, + "type": "string" + }, + "gatewayIPv4": { + "description": "[Output Only] The gateway address for default routing out of the network, selected by Google Cloud.", + "pattern": "[0-9]{1,3}(?:\\.[0-9]{1,3}){3}", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource with the resource id.", + "type": "string" + }, + "autoCreateSubnetworks": { + "description": "Must be set to create a VPC network. If not set, a legacy network is created. When set to true, the VPC network is created in auto mode. When set to false, the VPC network is created in custom mode. An auto mode VPC network starts with one subnet per region. Each subnet has a predetermined range as described in Auto mode VPC network IP ranges. For custom mode VPC networks, you can add subnets using the subnetworks insert method.", + "type": "boolean" + }, + "subnetworks": { + "description": "[Output Only] Server-defined fully-qualified URLs for all subnetworks in this VPC network.", + "type": "array", + "items": { + "type": "string" + } + }, + "peerings": { + "description": "[Output Only] A list of network peerings for the resource.", + "type": "array", + "items": { + "$ref": "NetworkPeering" + } + }, + "routingConfig": { + "description": "The network-level routing configuration for this network. Used by Cloud Router to determine what type of network-wide routing behavior to enforce.", + "$ref": "NetworkRoutingConfig" + }, + "mtu": { + "description": "Maximum Transmission Unit in bytes. The minimum value for this field is 1300 and the maximum value is 8896. The suggested value is 1500, which is the default MTU used on the Internet, or 8896 if you want to use Jumbo frames. If unspecified, the value defaults to 1460.", + "type": "integer", + "format": "int32" + }, + "firewallPolicy": { + "description": "[Output Only] URL of the firewall policy the network is associated with.", + "type": "string" + }, + "networkFirewallPolicyEnforcementOrder": { + "description": "The network firewall policy enforcement order. Can be either AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to AFTER_CLASSIC_FIREWALL if the field is not specified.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + "enum": [ + "AFTER_CLASSIC_FIREWALL", + "BEFORE_CLASSIC_FIREWALL" + ] }, - "testIamPermissions": { - "id": "compute.licenses.testIamPermissions", - "path": "projects/{project}/global/licenses/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/licenses/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" + "enableUlaInternalIpv6": { + "description": "Enable ULA internal ipv6 on this network. Enabling this feature will assign a /48 from google defined ULA prefix fd20::/20. .", + "type": "boolean" + }, + "internalIpv6Range": { + "description": "When enabling ula internal ipv6, caller optionally can specify the /48 range they want from the google defined ULA prefix fd20::/20. The input must be a valid /48 ULA IPv6 address and must be within the fd20::/20. Operation will fail if the speficied /48 is already in used by another resource. If the field is not speficied, then a /48 range will be randomly allocated from fd20::/20 and returned via this field. .", + "type": "string" + } + } + }, + "NetworkPeering": { + "id": "NetworkPeering", + "description": "A network peering attached to a network resource. The message includes the peering name, peer network, peering state, and a flag indicating whether Google Compute Engine should automatically create routes for the peering.", + "type": "object", + "properties": { + "name": { + "description": "Name of this peering. Provided by the client when the peering is created. The name must comply with RFC1035. Specifically, the name must be 1-63 characters long and match regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all the following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", + "type": "string" + }, + "network": { + "description": "The URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network.", + "type": "string" + }, + "state": { + "description": "[Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The peering is `ACTIVE` when there's a matching configuration in the peer network.", + "type": "string", + "enumDescriptions": [ + "Matching configuration exists on the peer.", + "There is no matching configuration on the peer, including the case when peer does not exist." ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "ACTIVE", + "INACTIVE" + ] + }, + "stateDetails": { + "description": "[Output Only] Details about the current state of the peering.", + "type": "string" + }, + "autoCreateRoutes": { + "description": "This field will be deprecated soon. Use the exchange_subnet_routes field instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE.", + "type": "boolean" + }, + "exportCustomRoutes": { + "description": "Whether to export the custom routes to peer network. The default value is false.", + "type": "boolean" + }, + "importCustomRoutes": { + "description": "Whether to import the custom routes from peer network. The default value is false.", + "type": "boolean" + }, + "exchangeSubnetRoutes": { + "description": "Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE.", + "type": "boolean" + }, + "exportSubnetRoutesWithPublicIp": { + "description": "Whether subnet routes with public IP range are exported. The default value is true, all subnet routes are exported. IPv4 special-use ranges are always exported to peers and are not controlled by this field.", + "type": "boolean" + }, + "importSubnetRoutesWithPublicIp": { + "description": "Whether subnet routes with public IP range are imported. The default value is false. IPv4 special-use ranges are always imported from peers and are not controlled by this field.", + "type": "boolean" + }, + "peerMtu": { + "description": "Maximum Transmission Unit in bytes.", + "type": "integer", + "format": "int32" + }, + "stackType": { + "description": "Which IP version(s) of traffic and routes are allowed to be imported or exported between peer networks. The default value is IPV4_ONLY.", + "type": "string", + "enumDescriptions": [ + "This Peering will allow IPv4 traffic and routes to be exchanged. Additionally if the matching peering is IPV4_IPV6, IPv6 traffic and routes will be exchanged as well.", + "This Peering will only allow IPv4 traffic and routes to be exchanged, even if the matching peering is IPV4_IPV6." ], - "description": "Returns permissions that a caller has on the specified resource. *Caution* This resource is intended for use only by third-party partners who are creating Cloud Marketplace images. " + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY" + ] } } }, - "machineImages": { - "methods": { - "list": { - "id": "compute.machineImages.list", - "path": "projects/{project}/global/machineImages", - "flatPath": "projects/{project}/global/machineImages", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" + "NetworkRoutingConfig": { + "id": "NetworkRoutingConfig", + "description": "A routing configuration attached to a network resource. The message includes the list of routers associated with the network, and a flag indicating the type of routing behavior to enforce network-wide.", + "type": "object", + "properties": { + "routingMode": { + "description": "The network-wide routing mode to use. If set to REGIONAL, this network's Cloud Routers will only advertise routes with subnets of this network in the same region as the router. If set to GLOBAL, this network's Cloud Routers will advertise routes with all subnets of this network, across regions.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "response": { - "$ref": "MachineImageList" + "enum": [ + "GLOBAL", + "REGIONAL" + ] + } + } + }, + "NetworksUpdatePeeringRequest": { + "id": "NetworksUpdatePeeringRequest", + "type": "object", + "properties": { + "networkPeering": { + "$ref": "NetworkPeering" + } + } + }, + "NetworksAddPeeringRequest": { + "id": "NetworksAddPeeringRequest", + "type": "object", + "properties": { + "name": { + "description": "Name of the peering, which should conform to RFC1035.", + "annotations": { + "required": [ + "compute.networks.addPeering" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of machine images that are contained within the specified project." + "type": "string" }, - "get": { - "id": "compute.machineImages.get", - "path": "projects/{project}/global/machineImages/{machineImage}", - "flatPath": "projects/{project}/global/machineImages/{machineImage}", - "httpMethod": "GET", - "parameters": { - "machineImage": { - "description": "The name of the machine image.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "machineImage" - ], - "response": { - "$ref": "MachineImage" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified machine image." + "peerNetwork": { + "description": "URL of the peer network. It can be either full URL or partial URL. The peer network may belong to a different project. If the partial URL does not contain project, it is assumed that the peer network is in the same project as the current network.", + "type": "string" }, - "insert": { - "id": "compute.machineImages.insert", - "path": "projects/{project}/global/machineImages", - "flatPath": "projects/{project}/global/machineImages", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "sourceInstance": { - "description": "Required. Source instance that is used to create the machine image from.", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "MachineImage" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "autoCreateRoutes": { + "description": "This field will be deprecated soon. Use exchange_subnet_routes in network_peering instead. Indicates whether full mesh connectivity is created and managed automatically between peered networks. Currently this field should always be true since Google Compute Engine will automatically create and manage subnetwork routes between two networks when peering state is ACTIVE.", + "type": "boolean" + }, + "networkPeering": { + "description": "Network peering parameters. In order to specify route policies for peering using import and export custom routes, you must specify all peering related parameters (name, peer network, exchange_subnet_routes) in the network_peering field. The corresponding fields in NetworksAddPeeringRequest will be deprecated soon.", + "$ref": "NetworkPeering" + } + } + }, + "NetworksRemovePeeringRequest": { + "id": "NetworksRemovePeeringRequest", + "type": "object", + "properties": { + "name": { + "description": "Name of the peering, which should conform to RFC1035.", + "type": "string" + } + } + }, + "NetworksGetEffectiveFirewallsResponse": { + "id": "NetworksGetEffectiveFirewallsResponse", + "type": "object", + "properties": { + "firewalls": { + "description": "Effective firewalls on the network.", + "type": "array", + "items": { + "$ref": "Firewall" + } + }, + "firewallPolicys": { + "description": "[Output Only] Effective firewalls from firewall policy. It returns Global Network Firewall Policies and Hierarchical Firewall Policies. Use regionNetworkFirewallPolicies.getEffectiveFirewalls to get Regional Network Firewall Policies as well.", + "type": "array", + "items": { + "$ref": "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy" + } + } + } + }, + "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy": { + "id": "NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy", + "type": "object", + "properties": { + "name": { + "description": "[Output Only] The name of the firewall policy.", + "type": "string" + }, + "type": { + "description": "[Output Only] The type of the firewall policy.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Creates a machine image in the specified project using the data that is included in the request. If you are creating a new machine image to update an existing instance, your new machine image should use the same network or, if applicable, the same subnetwork as the original instance." + "enum": [ + "HIERARCHY", + "NETWORK", + "SYSTEM", + "UNSPECIFIED" + ] + }, + "shortName": { + "description": "[Output Only] The short name of the firewall policy.", + "type": "string" + }, + "displayName": { + "description": "[Output Only] Deprecated, please use short name instead. The display name of the firewall policy.", + "deprecated": true, + "type": "string" + }, + "rules": { + "description": "[Output Only] The rules that apply to the network.", + "type": "array", + "items": { + "$ref": "FirewallPolicyRule" + } + }, + "priority": { + "description": "[Output only] Priority of firewall policy association. Not applicable for type=HIERARCHY.", + "type": "integer", + "format": "int32" + } + } + }, + "ExchangedPeeringRoutesList": { + "id": "ExchangedPeeringRoutesList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#exchangedPeeringRoutesList for exchanged peering routes lists.", + "default": "compute#exchangedPeeringRoutesList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "delete": { - "id": "compute.machineImages.delete", - "path": "projects/{project}/global/machineImages/{machineImage}", - "flatPath": "projects/{project}/global/machineImages/{machineImage}", - "httpMethod": "DELETE", - "parameters": { - "machineImage": { - "description": "The name of the machine image to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "machineImage" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified machine image. Deleting a machine image is permanent and cannot be undone." + "items": { + "description": "A list of ExchangedPeeringRoute resources.", + "type": "array", + "items": { + "$ref": "ExchangedPeeringRoute" + } }, - "getIamPolicy": { - "id": "compute.machineImages.getIamPolicy", - "path": "projects/{project}/global/machineImages/{resource}/getIamPolicy", - "flatPath": "projects/{project}/global/machineImages/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + } + } + } + }, + "ExchangedPeeringRoute": { + "id": "ExchangedPeeringRoute", + "type": "object", + "properties": { + "destRange": { + "description": "The destination range of the route.", + "type": "string" }, - "setIamPolicy": { - "id": "compute.machineImages.setIamPolicy", - "path": "projects/{project}/global/machineImages/{resource}/setIamPolicy", - "flatPath": "projects/{project}/global/machineImages/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "GlobalSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": { + "description": "The type of the peering route.", + "type": "string", + "enumDescriptions": [ + "For routes exported from local network.", + "The peering route.", + "The peering route corresponding to subnetwork range." ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "enum": [ + "DYNAMIC_PEERING_ROUTE", + "STATIC_PEERING_ROUTE", + "SUBNET_PEERING_ROUTE" + ] }, - "testIamPermissions": { - "id": "compute.machineImages.testIamPermissions", - "path": "projects/{project}/global/machineImages/{resource}/testIamPermissions", - "flatPath": "projects/{project}/global/machineImages/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9_]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + "nextHopRegion": { + "description": "The region of peering route next hop, only applies to dynamic routes.", + "type": "string" + }, + "priority": { + "description": "The priority of the peering route.", + "type": "integer", + "format": "uint32" + }, + "imported": { + "description": "True if the peering route has been imported from a peer. The actual import happens if the field networkPeering.importCustomRoutes is true for this network, and networkPeering.exportCustomRoutes is true for the peer network, and the import does not result in a route conflict.", + "type": "boolean" } } }, - "machineTypes": { - "methods": { - "list": { - "id": "compute.machineTypes.list", - "path": "projects/{project}/zones/{zone}/machineTypes", - "flatPath": "projects/{project}/zones/{zone}/machineTypes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "MachineTypeList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of machine types available to the specified project." + "NodeGroupList": { + "id": "NodeGroupList", + "description": "Contains a list of nodeGroups.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource.Always compute#nodeGroupList for lists of node groups.", + "default": "compute#nodeGroupList", + "type": "string" }, - "aggregatedList": { - "id": "compute.machineTypes.aggregatedList", - "path": "projects/{project}/aggregated/machineTypes", - "flatPath": "projects/{project}/aggregated/machineTypes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NodeGroup resources.", + "type": "array", + "items": { + "$ref": "NodeGroup" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "MachineTypeAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + } + } + } + }, + "NodeGroup": { + "id": "NodeGroup", + "description": "Represents a sole-tenant Node Group resource. A sole-tenant node is a physical server that is dedicated to hosting VM instances only for your specific project. Use sole-tenant nodes to keep your instances physically separated from instances in other projects, or to group your instances together on the same host hardware. For more information, read Sole-tenant nodes.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The type of the resource. Always compute#nodeGroup for node group.", + "default": "compute#nodeGroup", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "nodeTemplate": { + "description": "URL of the node template to create the node group from.", + "type": "string" + }, + "zone": { + "description": "[Output Only] The name of the zone where the node group resides, such as us-central1-a.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "status": { + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Retrieves an aggregated list of machine types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY" + ] }, - "get": { - "id": "compute.machineTypes.get", - "path": "projects/{project}/zones/{zone}/machineTypes/{machineType}", - "flatPath": "projects/{project}/zones/{zone}/machineTypes/{machineType}", - "httpMethod": "GET", - "parameters": { - "machineType": { - "description": "Name of the machine type to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "machineType" + "size": { + "description": "[Output Only] The total number of nodes in the node group.", + "type": "integer", + "format": "int32" + }, + "autoscalingPolicy": { + "description": "Specifies how autoscaling should behave.", + "$ref": "NodeGroupAutoscalingPolicy" + }, + "maintenancePolicy": { + "description": "Specifies how to handle instances when a node in the group undergoes maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more information, see Maintenance policies.", + "type": "string", + "enumDescriptions": [ + "Allow the node and corresponding instances to retain default maintenance behavior.", + "", + "When maintenance must be done on a node, the instances on that node will be moved to other nodes in the group. Instances with onHostMaintenance = MIGRATE will live migrate to their destinations while instances with onHostMaintenance = TERMINATE will terminate and then restart on their destination nodes if automaticRestart = true.", + "Instances in this group will restart on the same node when maintenance has completed. Instances must have onHostMaintenance = TERMINATE, and they will only restart if automaticRestart = true." ], - "response": { - "$ref": "MachineType" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "DEFAULT", + "MAINTENANCE_POLICY_UNSPECIFIED", + "MIGRATE_WITHIN_NODE_GROUP", + "RESTART_IN_PLACE" + ] + }, + "locationHint": { + "description": "An opaque location hint used to place the Node close to other resources. This field is for use by internal tools that use the public API. The location hint here on the NodeGroup overrides any location_hint present in the NodeTemplate.", + "type": "string" + }, + "fingerprint": { + "type": "string", + "format": "byte" + }, + "maintenanceWindow": { + "$ref": "NodeGroupMaintenanceWindow" + }, + "shareSettings": { + "description": "Share-settings for the node group", + "$ref": "ShareSettings" + }, + "maintenanceInterval": { + "description": "Specifies the frequency of planned maintenance events. The accepted values are: `AS_NEEDED` and `RECURRENT`.", + "type": "string", + "enumDescriptions": [ + "VMs are eligible to receive infrastructure and hypervisor updates as they become available. This may result in more maintenance operations (live migrations or terminations) for the VM than the PERIODIC and RECURRENT options.", + "VMs receive infrastructure and hypervisor updates on a periodic basis, minimizing the number of maintenance operations (live migrations or terminations) on an individual VM. This may mean a VM will take longer to receive an update than if it was configured for AS_NEEDED. Security updates will still be applied as soon as they are available. RECURRENT is used for GEN3 and Slice of Hardware VMs." ], - "description": "Returns the specified machine type." + "enum": [ + "AS_NEEDED", + "RECURRENT" + ] } } }, - "networkAttachments": { - "methods": { - "aggregatedList": { - "id": "compute.networkAttachments.aggregatedList", - "path": "projects/{project}/aggregated/networkAttachments", - "flatPath": "projects/{project}/aggregated/networkAttachments", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "NetworkAttachmentAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "NodeGroupAutoscalingPolicy": { + "id": "NodeGroupAutoscalingPolicy", + "type": "object", + "properties": { + "mode": { + "description": "The autoscaling mode. Set to one of: ON, OFF, or ONLY_SCALE_OUT. For more information, see Autoscaler modes.", + "type": "string", + "enumDescriptions": [ + "", + "Autoscaling is disabled.", + "Autocaling is fully enabled.", + "Autoscaling will only scale out and will not remove nodes." ], - "description": "Retrieves the list of all NetworkAttachment resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "MODE_UNSPECIFIED", + "OFF", + "ON", + "ONLY_SCALE_OUT" + ] }, - "list": { - "id": "compute.networkAttachments.list", - "path": "projects/{project}/regions/{region}/networkAttachments", - "flatPath": "projects/{project}/regions/{region}/networkAttachments", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "NetworkAttachmentList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the NetworkAttachments for a project in the given scope." + "minNodes": { + "description": "The minimum number of nodes that the group should have.", + "type": "integer", + "format": "int32" }, - "get": { - "id": "compute.networkAttachments.get", - "path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", - "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", - "httpMethod": "GET", - "parameters": { - "networkAttachment": { - "description": "Name of the NetworkAttachment resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "maxNodes": { + "description": "The maximum number of nodes that the group should have. Must be set if autoscaling is enabled. Maximum value allowed is 100.", + "type": "integer", + "format": "int32" + } + } + }, + "NodeGroupMaintenanceWindow": { + "id": "NodeGroupMaintenanceWindow", + "description": "Time window specified for daily maintenance operations. GCE's internal maintenance will be performed within this window.", + "type": "object", + "properties": { + "startTime": { + "description": "Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid.", + "type": "string" + }, + "maintenanceDuration": { + "description": "[Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario.", + "$ref": "Duration" + } + } + }, + "NodeGroupAggregatedList": { + "id": "NodeGroupAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource.Always compute#nodeGroupAggregatedList for aggregated lists of node groups.", + "default": "compute#nodeGroupAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NodeGroupsScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of node groups.", + "$ref": "NodeGroupsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "networkAttachment" - ], - "response": { - "$ref": "NetworkAttachment" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified NetworkAttachment resource in the given scope." + } }, - "insert": { - "id": "compute.networkAttachments.insert", - "path": "projects/{project}/regions/{region}/networkAttachments", - "flatPath": "projects/{project}/regions/{region}/networkAttachments", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "NetworkAttachment" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a NetworkAttachment in the specified project in the given scope using the parameters that are included in the request." + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "NodeGroupsScopedList": { + "id": "NodeGroupsScopedList", + "type": "object", + "properties": { + "nodeGroups": { + "description": "[Output Only] A list of node groups contained in this scope.", + "type": "array", + "items": { + "$ref": "NodeGroup" + } }, - "delete": { - "id": "compute.networkAttachments.delete", - "path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", - "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", - "httpMethod": "DELETE", - "parameters": { - "networkAttachment": { - "description": "Name of the NetworkAttachment resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] An informational warning that appears when the nodeGroup list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "networkAttachment" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified NetworkAttachment in the given scope" + } + } + } + }, + "NodeGroupsAddNodesRequest": { + "id": "NodeGroupsAddNodesRequest", + "type": "object", + "properties": { + "additionalNodeCount": { + "description": "Count of additional nodes to be added to the node group.", + "type": "integer", + "format": "int32" + } + } + }, + "NodeGroupsDeleteNodesRequest": { + "id": "NodeGroupsDeleteNodesRequest", + "type": "object", + "properties": { + "nodes": { + "description": "Names of the nodes to delete.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "NodeGroupsListNodes": { + "id": "NodeGroupsListNodes", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The resource type, which is always compute.nodeGroupsListNodes for the list of nodes in the specified node group.", + "default": "compute#nodeGroupsListNodes", + "type": "string" }, - "patch": { - "id": "compute.networkAttachments.patch", - "path": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", - "flatPath": "projects/{project}/regions/{region}/networkAttachments/{networkAttachment}", - "httpMethod": "PATCH", - "parameters": { - "networkAttachment": { - "description": "Name of the NetworkAttachment resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "networkAttachment" - ], - "request": { - "$ref": "NetworkAttachment" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified NetworkAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "getIamPolicy": { - "id": "compute.networkAttachments.getIamPolicy", - "path": "projects/{project}/regions/{region}/networkAttachments/{resource}/getIamPolicy", - "flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "items": { + "description": "A list of Node resources.", + "type": "array", + "items": { + "$ref": "NodeGroupNode" + } }, - "setIamPolicy": { - "id": "compute.networkAttachments.setIamPolicy", - "path": "projects/{project}/regions/{region}/networkAttachments/{resource}/setIamPolicy", - "flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + } + } + } + }, + "NodeGroupNode": { + "id": "NodeGroupNode", + "type": "object", + "properties": { + "name": { + "description": "The name of the node.", + "type": "string" }, - "testIamPermissions": { - "id": "compute.networkAttachments.testIamPermissions", - "path": "projects/{project}/regions/{region}/networkAttachments/{resource}/testIamPermissions", - "flatPath": "projects/{project}/regions/{region}/networkAttachments/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" + "status": { + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY", + "REPAIRING" + ] + }, + "nodeType": { + "description": "The type of this node.", + "type": "string" + }, + "serverBinding": { + "description": "Binding properties for the physical server.", + "$ref": "ServerBinding" + }, + "serverId": { + "description": "Server ID associated with this node.", + "type": "string" + }, + "disks": { + "description": "Local disk configurations.", + "type": "array", + "items": { + "$ref": "LocalDisk" + } + }, + "accelerators": { + "description": "Accelerators for this node.", + "type": "array", + "items": { + "$ref": "AcceleratorConfig" + } + }, + "instances": { + "description": "Instances scheduled on this node.", + "type": "array", + "items": { + "type": "string" + } + }, + "instanceConsumptionData": { + "description": "Instance data that shows consumed resources on the node.", + "type": "array", + "items": { + "$ref": "InstanceConsumptionData" + } + }, + "consumedResources": { + "description": "Node resources that are reserved by all instances.", + "$ref": "InstanceConsumptionInfo" + }, + "totalResources": { + "description": "Total amount of available resources on the node.", + "$ref": "InstanceConsumptionInfo" + }, + "cpuOvercommitType": { + "description": "CPU overcommit.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "CPU_OVERCOMMIT_TYPE_UNSPECIFIED", + "ENABLED", + "NONE" + ] + }, + "satisfiesPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "upcomingMaintenance": { + "description": "[Output Only] The information about an upcoming maintenance event.", + "$ref": "UpcomingMaintenance" } } }, - "networkEdgeSecurityServices": { - "methods": { - "get": { - "id": "compute.networkEdgeSecurityServices.get", - "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", - "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", - "httpMethod": "GET", - "parameters": { - "networkEdgeSecurityService": { - "description": "Name of the network edge security service to get.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "networkEdgeSecurityService" - ], - "response": { - "$ref": "NetworkEdgeSecurityService" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "ServerBinding": { + "id": "ServerBinding", + "type": "object", + "properties": { + "type": { + "type": "string", + "enumDescriptions": [ + "Node may associate with any physical server over its lifetime.", + "Node may associate with minimal physical servers over its lifetime.", + "" ], - "description": "Gets a specified NetworkEdgeSecurityService." + "enum": [ + "RESTART_NODE_ON_ANY_SERVER", + "RESTART_NODE_ON_MINIMAL_SERVERS", + "SERVER_BINDING_TYPE_UNSPECIFIED" + ] + } + } + }, + "LocalDisk": { + "id": "LocalDisk", + "type": "object", + "properties": { + "diskType": { + "description": "Specifies the desired disk type on the node. This disk type must be a local storage type (e.g.: local-ssd). Note that for nodeTemplates, this should be the name of the disk type and not its URL.", + "type": "string" }, - "insert": { - "id": "compute.networkEdgeSecurityServices.insert", - "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices", - "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "validateOnly": { - "description": "If true, the request will not be committed.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "NetworkEdgeSecurityService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a new service in the specified project using the data included in the request." + "diskSizeGb": { + "description": "Specifies the size of the disk in base-2 GB.", + "type": "integer", + "format": "int32" }, - "delete": { - "id": "compute.networkEdgeSecurityServices.delete", - "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", - "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", - "httpMethod": "DELETE", - "parameters": { - "networkEdgeSecurityService": { - "description": "Name of the network edge security service to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "diskCount": { + "description": "Specifies the number of such disks.", + "type": "integer", + "format": "int32" + } + } + }, + "InstanceConsumptionData": { + "id": "InstanceConsumptionData", + "type": "object", + "properties": { + "instance": { + "description": "Server-defined URL for the instance.", + "type": "string" + }, + "consumptionInfo": { + "description": "Resources consumed by the instance.", + "$ref": "InstanceConsumptionInfo" + } + } + }, + "InstanceConsumptionInfo": { + "id": "InstanceConsumptionInfo", + "type": "object", + "properties": { + "minNodeCpus": { + "description": "The minimal guaranteed number of virtual CPUs that are reserved.", + "type": "integer", + "format": "int32" + }, + "guestCpus": { + "description": "The number of virtual CPUs that are available to the instance.", + "type": "integer", + "format": "int32" + }, + "memoryMb": { + "description": "The amount of physical memory available to the instance, defined in MiB.", + "type": "integer", + "format": "int32" + }, + "localSsdGb": { + "description": "The amount of local SSD storage available to the instance, defined in GiB.", + "type": "integer", + "format": "int32" + } + } + }, + "NodeGroupsSetNodeTemplateRequest": { + "id": "NodeGroupsSetNodeTemplateRequest", + "type": "object", + "properties": { + "nodeTemplate": { + "description": "Full or partial URL of the node template resource to be updated for this node group.", + "type": "string" + } + } + }, + "NodeGroupsSimulateMaintenanceEventRequest": { + "id": "NodeGroupsSimulateMaintenanceEventRequest", + "type": "object", + "properties": { + "nodes": { + "description": "Names of the nodes to go under maintenance simulation.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "NodeGroupsPerformMaintenanceRequest": { + "id": "NodeGroupsPerformMaintenanceRequest", + "type": "object", + "properties": { + "nodes": { + "description": "[Required] List of nodes affected by the call.", + "type": "array", + "items": { + "type": "string" + } + }, + "startTime": { + "description": "The start time of the schedule. The timestamp is an RFC3339 string.", + "type": "string" + } + } + }, + "NodeTemplateList": { + "id": "NodeTemplateList", + "description": "Contains a list of node templates.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource.Always compute#nodeTemplateList for lists of node templates.", + "default": "compute#nodeTemplateList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NodeTemplate resources.", + "type": "array", + "items": { + "$ref": "NodeTemplate" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "networkEdgeSecurityService" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified service." + } + } + } + }, + "NodeTemplate": { + "id": "NodeTemplate", + "description": "Represent a sole-tenant Node Template resource. You can use a template to define properties for nodes in a node group. For more information, read Creating node groups and instances.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The type of the resource. Always compute#nodeTemplate for node templates.", + "default": "compute#nodeTemplate", + "type": "string" }, - "patch": { - "id": "compute.networkEdgeSecurityServices.patch", - "path": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", - "flatPath": "projects/{project}/regions/{region}/networkEdgeSecurityServices/{networkEdgeSecurityService}", - "httpMethod": "PATCH", - "parameters": { - "networkEdgeSecurityService": { - "description": "Name of the network edge security service to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "paths": { - "location": "query", - "repeated": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "updateMask": { - "description": "Indicates fields to be updated as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - } - }, - "parameterOrder": [ - "project", - "region", - "networkEdgeSecurityService" - ], - "request": { - "$ref": "NetworkEdgeSecurityService" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified policy with the data included in the request." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "aggregatedList": { - "id": "compute.networkEdgeSecurityServices.aggregatedList", - "path": "projects/{project}/aggregated/networkEdgeSecurityServices", - "flatPath": "projects/{project}/aggregated/networkEdgeSecurityServices", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "nodeType": { + "description": "The node type to use for nodes group that are created from this template.", + "type": "string" + }, + "nodeAffinityLabels": { + "description": "Labels to use for node affinity, which will be used in instance scheduling.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "status": { + "description": "[Output Only] The status of the node template. One of the following values: CREATING, READY, and DELETING.", + "type": "string", + "enumDescriptions": [ + "Resources are being allocated.", + "The node template is currently being deleted.", + "Invalid status.", + "The node template is ready." ], - "response": { - "$ref": "NetworkEdgeSecurityServiceAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "CREATING", + "DELETING", + "INVALID", + "READY" + ] + }, + "statusMessage": { + "description": "[Output Only] An optional, human-readable explanation of the status.", + "type": "string" + }, + "region": { + "description": "[Output Only] The name of the region where the node template resides, such as us-central1.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "nodeTypeFlexibility": { + "description": "Do not use. Instead, use the node_type property.", + "$ref": "NodeTemplateNodeTypeFlexibility" + }, + "serverBinding": { + "description": "Sets the binding properties for the physical server. Valid values include: - *[Default]* RESTART_NODE_ON_ANY_SERVER: Restarts VMs on any available physical server - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same physical server whenever possible See Sole-tenant node options for more information.", + "$ref": "ServerBinding" + }, + "disks": { + "type": "array", + "items": { + "$ref": "LocalDisk" + } + }, + "accelerators": { + "type": "array", + "items": { + "$ref": "AcceleratorConfig" + } + }, + "cpuOvercommitType": { + "description": "CPU overcommit.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "description": "Retrieves the list of all NetworkEdgeSecurityService resources available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "CPU_OVERCOMMIT_TYPE_UNSPECIFIED", + "ENABLED", + "NONE" + ] } } }, - "networkEndpointGroups": { - "methods": { - "list": { - "id": "compute.networkEndpointGroups.list", - "path": "projects/{project}/zones/{zone}/networkEndpointGroups", - "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "NetworkEndpointGroupList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of network endpoint groups that are located in the specified project and zone." + "NodeTemplateNodeTypeFlexibility": { + "id": "NodeTemplateNodeTypeFlexibility", + "type": "object", + "properties": { + "cpus": { + "type": "string" }, - "aggregatedList": { - "id": "compute.networkEndpointGroups.aggregatedList", - "path": "projects/{project}/aggregated/networkEndpointGroups", - "flatPath": "projects/{project}/aggregated/networkEndpointGroups", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "memory": { + "type": "string" + }, + "localSsd": { + "type": "string" + } + } + }, + "NodeTemplateAggregatedList": { + "id": "NodeTemplateAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource.Always compute#nodeTemplateAggregatedList for aggregated lists of node templates.", + "default": "compute#nodeTemplateAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NodeTemplatesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of node templates.", + "$ref": "NodeTemplatesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "NetworkEndpointGroupAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of network endpoint groups and sorts them by zone. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + } }, - "get": { - "id": "compute.networkEndpointGroups.get", - "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", - "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", - "httpMethod": "GET", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "networkEndpointGroup" - ], - "response": { - "$ref": "NetworkEndpointGroup" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified network endpoint group." + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "NodeTemplatesScopedList": { + "id": "NodeTemplatesScopedList", + "type": "object", + "properties": { + "nodeTemplates": { + "description": "[Output Only] A list of node templates contained in this scope.", + "type": "array", + "items": { + "$ref": "NodeTemplate" + } }, - "insert": { - "id": "compute.networkEndpointGroups.insert", - "path": "projects/{project}/zones/{zone}/networkEndpointGroups", - "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] An informational warning that appears when the node templates list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone where you want to create the network endpoint group. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "NetworkEndpointGroup" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a network endpoint group in the specified project using the parameters that are included in the request." + } + } + } + }, + "NodeTypeList": { + "id": "NodeTypeList", + "description": "Contains a list of node types.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource.Always compute#nodeTypeList for lists of node types.", + "default": "compute#nodeTypeList", + "type": "string" }, - "delete": { - "id": "compute.networkEndpointGroups.delete", - "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", - "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}", - "httpMethod": "DELETE", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group to delete. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "networkEndpointGroup" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified network endpoint group. The network endpoints in the NEG and the VM instances they belong to are not terminated when the NEG is deleted. Note that the NEG cannot be deleted if there are backend services referencing it." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "attachNetworkEndpoints": { - "id": "compute.networkEndpointGroups.attachNetworkEndpoints", - "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", - "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", - "httpMethod": "POST", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "networkEndpointGroup" - ], - "request": { - "$ref": "NetworkEndpointGroupsAttachEndpointsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Attach a list of network endpoints to the specified network endpoint group." + "items": { + "description": "A list of NodeType resources.", + "type": "array", + "items": { + "$ref": "NodeType" + } }, - "detachNetworkEndpoints": { - "id": "compute.networkEndpointGroups.detachNetworkEndpoints", - "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", - "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", - "httpMethod": "POST", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "networkEndpointGroup" - ], - "request": { - "$ref": "NetworkEndpointGroupsDetachEndpointsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Detach a list of network endpoints from the specified network endpoint group." + } + } + } + }, + "NodeType": { + "id": "NodeType", + "description": "Represent a sole-tenant Node Type resource. Each node within a node group must have a node type. A node type specifies the total amount of cores and memory for that node. Currently, the only available node type is n1-node-96-624 node type that has 96 vCPUs and 624 GB of memory, available in multiple zones. For more information read Node types.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The type of the resource. Always compute#nodeType for node types.", + "default": "compute#nodeType", + "type": "string" }, - "listNetworkEndpoints": { - "id": "compute.networkEndpointGroups.listNetworkEndpoints", - "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", - "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", - "httpMethod": "POST", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "networkEndpointGroup": { - "description": "The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone where the network endpoint group is located. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "networkEndpointGroup" - ], - "request": { - "$ref": "NetworkEndpointGroupsListEndpointsRequest" - }, - "response": { - "$ref": "NetworkEndpointGroupsListNetworkEndpoints" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the network endpoints in the specified network endpoint group." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "testIamPermissions": { - "id": "compute.networkEndpointGroups.testIamPermissions", - "path": "projects/{project}/zones/{zone}/networkEndpointGroups/{resource}/testIamPermissions", - "flatPath": "projects/{project}/zones/{zone}/networkEndpointGroups/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "description": { + "description": "[Output Only] An optional textual description of the resource.", + "type": "string" + }, + "cpuPlatform": { + "description": "[Output Only] The CPU platform used by this node type.", + "type": "string" + }, + "guestCpus": { + "description": "[Output Only] The number of virtual CPUs that are available to the node type.", + "type": "integer", + "format": "int32" + }, + "memoryMb": { + "description": "[Output Only] The amount of physical memory available to the node type, defined in MB.", + "type": "integer", + "format": "int32" + }, + "localSsdGb": { + "description": "[Output Only] Local SSD available to the node type, defined in GB.", + "type": "integer", + "format": "int32" + }, + "deprecated": { + "description": "[Output Only] The deprecation status associated with this node type.", + "$ref": "DeprecationStatus" + }, + "zone": { + "description": "[Output Only] The name of the zone where the node type resides, such as us-central1-a.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" } } }, - "globalNetworkEndpointGroups": { - "methods": { - "list": { - "id": "compute.globalNetworkEndpointGroups.list", - "path": "projects/{project}/global/networkEndpointGroups", - "flatPath": "projects/{project}/global/networkEndpointGroups", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "NetworkEndpointGroupList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of network endpoint groups that are located in the specified project." + "NodeTypeAggregatedList": { + "id": "NodeTypeAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource.Always compute#nodeTypeAggregatedList for aggregated lists of node types.", + "default": "compute#nodeTypeAggregatedList", + "type": "string" }, - "get": { - "id": "compute.globalNetworkEndpointGroups.get", - "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", - "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", - "httpMethod": "GET", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "networkEndpointGroup" - ], - "response": { - "$ref": "NetworkEndpointGroup" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified network endpoint group." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.globalNetworkEndpointGroups.insert", - "path": "projects/{project}/global/networkEndpointGroups", - "flatPath": "projects/{project}/global/networkEndpointGroups", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "NetworkEndpointGroup" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a network endpoint group in the specified project using the parameters that are included in the request." + "items": { + "description": "A list of NodeTypesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of node types.", + "$ref": "NodeTypesScopedList" + } }, - "delete": { - "id": "compute.globalNetworkEndpointGroups.delete", - "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", - "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}", - "httpMethod": "DELETE", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group to delete. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "networkEndpointGroup" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified network endpoint group.Note that the NEG cannot be deleted if there are backend services referencing it." + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "attachNetworkEndpoints": { - "id": "compute.globalNetworkEndpointGroups.attachNetworkEndpoints", - "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", - "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", - "httpMethod": "POST", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "networkEndpointGroup" - ], - "request": { - "$ref": "GlobalNetworkEndpointGroupsAttachEndpointsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Attach a network endpoint to the specified network endpoint group." + } }, - "detachNetworkEndpoints": { - "id": "compute.globalNetworkEndpointGroups.detachNetworkEndpoints", - "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", - "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", - "httpMethod": "POST", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group where you are removing network endpoints. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "NodeTypesScopedList": { + "id": "NodeTypesScopedList", + "type": "object", + "properties": { + "nodeTypes": { + "description": "[Output Only] A list of node types contained in this scope.", + "type": "array", + "items": { + "$ref": "NodeType" + } + }, + "warning": { + "description": "[Output Only] An informational warning that appears when the node types list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "networkEndpointGroup" - ], - "request": { - "$ref": "GlobalNetworkEndpointGroupsDetachEndpointsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Detach the network endpoint from the specified network endpoint group." + } + } + } + }, + "NotificationEndpointList": { + "id": "NotificationEndpointList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints.", + "default": "compute#notificationEndpointList", + "type": "string" }, - "listNetworkEndpoints": { - "id": "compute.globalNetworkEndpointGroups.listNetworkEndpoints", - "path": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", - "flatPath": "projects/{project}/global/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", - "httpMethod": "POST", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "networkEndpointGroup": { - "description": "The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of NotificationEndpoint resources.", + "type": "array", + "items": { + "$ref": "NotificationEndpoint" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } + } + } + } + }, + "NotificationEndpoint": { + "id": "NotificationEndpoint", + "description": "Represents a notification endpoint. A notification endpoint resource defines an endpoint to receive notifications when there are status changes detected by the associated health check service. For more information, see Health checks overview.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#notificationEndpoint for notification endpoints.", + "default": "compute#notificationEndpoint", + "type": "string" + }, + "id": { + "description": "[Output Only] A unique identifier for this resource type. The server generates this identifier.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the notification endpoint resides. This field applies only to the regional resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "grpcSettings": { + "description": "Settings of the gRPC notification endpoint including the endpoint URL and the retry duration.", + "$ref": "NotificationEndpointGrpcSettings" + } + } + }, + "NotificationEndpointGrpcSettings": { + "id": "NotificationEndpointGrpcSettings", + "description": "Represents a gRPC setting that describes one gRPC notification endpoint and the retry duration attempting to send notification to this endpoint.", + "type": "object", + "properties": { + "endpoint": { + "description": "Endpoint to which gRPC notifications are sent. This must be a valid gRPCLB DNS name.", + "type": "string" + }, + "retryDurationSec": { + "description": "How much time (in seconds) is spent attempting notification retries until a successful response is received. Default is 30s. Limit is 20m (1200s). Must be a positive number.", + "type": "integer", + "format": "uint32" + }, + "payloadName": { + "description": "Optional. If specified, this field is used to populate the \"name\" field in gRPC requests.", + "type": "string" + }, + "authority": { + "description": "Optional. If specified, this field is used to set the authority header by the sender of notifications. See https://tools.ietf.org/html/rfc7540#section-8.1.2.3", + "type": "string" + }, + "resendInterval": { + "description": "Optional. This field is used to configure how often to send a full update of all non-healthy backends. If unspecified, full updates are not sent. If specified, must be in the range between 600 seconds to 3600 seconds. Nanos are disallowed. Can only be set for regional notification endpoints.", + "$ref": "Duration" + } + } + }, + "PacketMirroring": { + "id": "PacketMirroring", + "description": "Represents a Packet Mirroring resource. Packet Mirroring clones the traffic of specified instances in your Virtual Private Cloud (VPC) network and forwards it to a collector destination, such as an instance group of an internal TCP/UDP load balancer, for analysis or examination. For more information about setting up Packet Mirroring, see Using Packet Mirroring.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#packetMirroring for packet mirrorings.", + "default": "compute#packetMirroring", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for 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. 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])?", + "annotations": { + "required": [ + "compute.packetMirrorings.insert" + ] }, - "parameterOrder": [ - "project", - "networkEndpointGroup" - ], - "response": { - "$ref": "NetworkEndpointGroupsListNetworkEndpoints" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] URI of the region where the packetMirroring resides.", + "type": "string" + }, + "network": { + "description": "Specifies the mirrored VPC network. Only packets in this network will be mirrored. All mirrored VMs should have a NIC in the given network. All mirrored subnetworks should belong to the given network.", + "annotations": { + "required": [ + "compute.packetMirrorings.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "$ref": "PacketMirroringNetworkInfo" + }, + "priority": { + "description": "The priority of applying this configuration. Priority is used to break ties in cases where there is more than one matching rule. In the case of two rules that apply for a given Instance, the one with the lowest-numbered priority value wins. Default value is 1000. Valid range is 0 through 65535.", + "type": "integer", + "format": "uint32" + }, + "collectorIlb": { + "description": "The Forwarding Rule resource of type loadBalancingScheme=INTERNAL that will be used as collector for mirrored traffic. The specified forwarding rule must have isMirroringCollector set to true.", + "$ref": "PacketMirroringForwardingRuleInfo" + }, + "mirroredResources": { + "description": "PacketMirroring mirroredResourceInfos. MirroredResourceInfo specifies a set of mirrored VM instances, subnetworks and/or tags for which traffic from/to all VM instances will be mirrored.", + "$ref": "PacketMirroringMirroredResourceInfo" + }, + "filter": { + "description": "Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored.", + "$ref": "PacketMirroringFilter" + }, + "enable": { + "description": "Indicates whether or not this packet mirroring takes effect. If set to FALSE, this packet mirroring policy will not be enforced on the network. The default is TRUE.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Lists the network endpoints in the specified network endpoint group." + "enum": [ + "FALSE", + "TRUE" + ] } } }, - "regionNetworkEndpointGroups": { - "methods": { - "list": { - "id": "compute.regionNetworkEndpointGroups.list", - "path": "projects/{project}/regions/{region}/networkEndpointGroups", - "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region where the network endpoint group is located. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "NetworkEndpointGroupList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of regional network endpoint groups available to the specified project in the given region." + "PacketMirroringNetworkInfo": { + "id": "PacketMirroringNetworkInfo", + "type": "object", + "properties": { + "url": { + "description": "URL of the network resource.", + "type": "string" }, - "get": { - "id": "compute.regionNetworkEndpointGroups.get", - "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", - "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", - "httpMethod": "GET", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region where the network endpoint group is located. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "networkEndpointGroup" - ], - "response": { - "$ref": "NetworkEndpointGroup" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified network endpoint group." + "canonicalUrl": { + "description": "[Output Only] Unique identifier for the network; defined by the server.", + "type": "string" + } + } + }, + "PacketMirroringForwardingRuleInfo": { + "id": "PacketMirroringForwardingRuleInfo", + "type": "object", + "properties": { + "url": { + "description": "Resource URL to the forwarding rule representing the ILB configured as destination of the mirrored traffic.", + "type": "string" }, - "insert": { - "id": "compute.regionNetworkEndpointGroups.insert", - "path": "projects/{project}/regions/{region}/networkEndpointGroups", - "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region where you want to create the network endpoint group. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "NetworkEndpointGroup" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a network endpoint group in the specified project using the parameters that are included in the request." + "canonicalUrl": { + "description": "[Output Only] Unique identifier for the forwarding rule; defined by the server.", + "type": "string" + } + } + }, + "PacketMirroringMirroredResourceInfo": { + "id": "PacketMirroringMirroredResourceInfo", + "type": "object", + "properties": { + "subnetworks": { + "description": "A set of subnetworks for which traffic from/to all VM instances will be mirrored. They must live in the same region as this packetMirroring. You may specify a maximum of 5 subnetworks.", + "type": "array", + "items": { + "$ref": "PacketMirroringMirroredResourceInfoSubnetInfo" + } }, - "delete": { - "id": "compute.regionNetworkEndpointGroups.delete", - "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", - "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}", - "httpMethod": "DELETE", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group to delete. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region where the network endpoint group is located. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "networkEndpointGroup" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified network endpoint group. Note that the NEG cannot be deleted if it is configured as a backend of a backend service." + "instances": { + "description": "A set of virtual machine instances that are being mirrored. They must live in zones contained in the same region as this packetMirroring. Note that this config will apply only to those network interfaces of the Instances that belong to the network specified in this packetMirroring. You may specify a maximum of 50 Instances.", + "type": "array", + "items": { + "$ref": "PacketMirroringMirroredResourceInfoInstanceInfo" + } }, - "attachNetworkEndpoints": { - "id": "compute.regionNetworkEndpointGroups.attachNetworkEndpoints", - "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", - "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/attachNetworkEndpoints", - "httpMethod": "POST", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group where you are attaching network endpoints to. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region where you want to create the network endpoint group. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "networkEndpointGroup" - ], - "request": { - "$ref": "RegionNetworkEndpointGroupsAttachEndpointsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "tags": { + "description": "A set of mirrored tags. Traffic from/to all VM instances that have one or more of these tags will be mirrored.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "PacketMirroringMirroredResourceInfoSubnetInfo": { + "id": "PacketMirroringMirroredResourceInfoSubnetInfo", + "type": "object", + "properties": { + "url": { + "description": "Resource URL to the subnetwork for which traffic from/to all VM instances will be mirrored.", + "type": "string" + }, + "canonicalUrl": { + "description": "[Output Only] Unique identifier for the subnetwork; defined by the server.", + "type": "string" + } + } + }, + "PacketMirroringMirroredResourceInfoInstanceInfo": { + "id": "PacketMirroringMirroredResourceInfoInstanceInfo", + "type": "object", + "properties": { + "url": { + "description": "Resource URL to the virtual machine instance which is being mirrored.", + "type": "string" + }, + "canonicalUrl": { + "description": "[Output Only] Unique identifier for the instance; defined by the server.", + "type": "string" + } + } + }, + "PacketMirroringFilter": { + "id": "PacketMirroringFilter", + "type": "object", + "properties": { + "cidrRanges": { + "description": "One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source (ingress) or destination (egress) IP in the IP header. If no ranges are specified, all IPv4 traffic that matches the specified IPProtocols is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use \"0.0.0.0/0,::/0\".", + "type": "array", + "items": { + "type": "string" + } + }, + "IPProtocols": { + "description": "Protocols that apply as filter on mirrored traffic. If no protocols are specified, all traffic that matches the specified CIDR ranges is mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is mirrored.", + "type": "array", + "items": { + "type": "string" + } + }, + "direction": { + "description": "Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. The default is BOTH.", + "type": "string", + "enumDescriptions": [ + "Default, both directions are mirrored.", + "Only egress traffic is mirrored.", + "Only ingress traffic is mirrored." ], - "description": "Attach a list of network endpoints to the specified network endpoint group." + "enum": [ + "BOTH", + "EGRESS", + "INGRESS" + ] + } + } + }, + "PacketMirroringList": { + "id": "PacketMirroringList", + "description": "Contains a list of PacketMirroring resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#packetMirroring for packetMirrorings.", + "default": "compute#packetMirroringList", + "type": "string" }, - "detachNetworkEndpoints": { - "id": "compute.regionNetworkEndpointGroups.detachNetworkEndpoints", - "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", - "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/detachNetworkEndpoints", - "httpMethod": "POST", - "parameters": { - "networkEndpointGroup": { - "description": "The name of the network endpoint group you are detaching network endpoints from. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of PacketMirroring resources.", + "type": "array", + "items": { + "$ref": "PacketMirroring" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region where the network endpoint group is located. It should comply with RFC1035.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface: MixerMutationRequestBuilder", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "networkEndpointGroup" - ], - "request": { - "$ref": "RegionNetworkEndpointGroupsDetachEndpointsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Detach the network endpoint from the specified network endpoint group." + } + } + } + }, + "PacketMirroringAggregatedList": { + "id": "PacketMirroringAggregatedList", + "description": "Contains a list of packetMirrorings.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#packetMirroringAggregatedList", + "type": "string" }, - "listNetworkEndpoints": { - "id": "compute.regionNetworkEndpointGroups.listNetworkEndpoints", - "path": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", - "flatPath": "projects/{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}/listNetworkEndpoints", - "httpMethod": "POST", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "networkEndpointGroup": { - "description": "The name of the network endpoint group from which you want to generate a list of included network endpoints. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of PacketMirroring resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of packetMirrorings.", + "$ref": "PacketMirroringsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region where the network endpoint group is located. It should comply with RFC1035.", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "networkEndpointGroup" - ], - "response": { - "$ref": "NetworkEndpointGroupsListNetworkEndpoints" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the network endpoints in the specified network endpoint group." + } + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } } } }, - "networks": { - "methods": { - "list": { - "id": "compute.networks.list", - "path": "projects/{project}/global/networks", - "flatPath": "projects/{project}/global/networks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "PacketMirroringsScopedList": { + "id": "PacketMirroringsScopedList", + "type": "object", + "properties": { + "packetMirrorings": { + "description": "A list of packetMirrorings contained in this scope.", + "type": "array", + "items": { + "$ref": "PacketMirroring" + } + }, + "warning": { + "description": "Informational warning which replaces the list of packetMirrorings when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "NetworkList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of networks available to the specified project." + } + } + } + }, + "Project": { + "id": "Project", + "description": "Represents a Project resource. A project is used to organize resources in a Google Cloud Platform environment. For more information, read about the Resource Hierarchy.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#project for projects.", + "default": "compute#project", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server. This is *not* the project ID, and is just a unique ID used by Compute Engine to identify resources.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "The project ID. For example: my-example-project. Use the project ID to make requests to Compute Engine.", + "type": "string" + }, + "description": { + "description": "An optional textual description of the resource.", + "type": "string" + }, + "commonInstanceMetadata": { + "description": "Metadata key/value pairs available to all instances contained in this project. See Custom metadata for more information.", + "$ref": "Metadata" + }, + "quotas": { + "description": "[Output Only] Quotas assigned to this project.", + "type": "array", + "items": { + "$ref": "Quota" + } }, - "get": { - "id": "compute.networks.get", - "path": "projects/{project}/global/networks/{network}", - "flatPath": "projects/{project}/global/networks/{network}", - "httpMethod": "GET", - "parameters": { - "network": { - "description": "Name of the network to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "network" - ], - "response": { - "$ref": "Network" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "usageExportLocation": { + "description": "The naming prefix for daily usage reports and the Google Cloud Storage bucket where they are stored.", + "$ref": "UsageExportLocation" + }, + "enabledFeatures": { + "description": "Restricted features enabled for use on this project.", + "type": "array", + "items": { + "type": "string" + } + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "defaultServiceAccount": { + "description": "[Output Only] Default service account used by VMs running in this project.", + "type": "string" + }, + "xpnProjectStatus": { + "description": "[Output Only] The role this project has in a shared VPC configuration. Currently, only projects with the host role, which is specified by the value HOST, are differentiated.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified network." + "enum": [ + "HOST", + "UNSPECIFIED_XPN_PROJECT_STATUS" + ] }, - "insert": { - "id": "compute.networks.insert", - "path": "projects/{project}/global/networks", - "flatPath": "projects/{project}/global/networks", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" + "defaultNetworkTier": { + "description": "This signifies the default network tier used for configuring resources of the project and can only take the following values: PREMIUM, STANDARD. Initially the default network tier is PREMIUM.", + "type": "string", + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking products.", + "Public internet quality, only limited support for other networking products.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." ], - "request": { - "$ref": "Network" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" + ] + }, + "vmDnsSetting": { + "description": "[Output Only] Default internal DNS setting used by VMs running in this project.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Creates a network in the specified project using the data included in the request." + "enum": [ + "GLOBAL_DEFAULT", + "UNSPECIFIED_VM_DNS_SETTING", + "ZONAL_DEFAULT", + "ZONAL_ONLY" + ] }, - "delete": { - "id": "compute.networks.delete", - "path": "projects/{project}/global/networks/{network}", - "flatPath": "projects/{project}/global/networks/{network}", - "httpMethod": "DELETE", - "parameters": { - "network": { - "description": "Name of the network to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "network" + "cloudArmorTier": { + "description": "[Output Only] The Cloud Armor tier for this project. It can be one of the following values: CA_STANDARD, CA_ENTERPRISE_PAYGO. If this field is not specified, it is assumed to be CA_STANDARD.", + "type": "string", + "enumDescriptions": [ + "Enterprise tier protection billed annually.", + "Enterprise tier protection billed monthly.", + "Standard protection." ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "CA_ENTERPRISE_ANNUAL", + "CA_ENTERPRISE_PAYGO", + "CA_STANDARD" + ] + } + } + }, + "Quota": { + "id": "Quota", + "description": "A quotas entry.", + "type": "object", + "properties": { + "metric": { + "description": "[Output Only] Name of the quota metric.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "Guest CPUs", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "The total number of snapshots allowed for a single project.", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Deletes the specified network." + "enum": [ + "A2_CPUS", + "AFFINITY_GROUPS", + "AUTOSCALERS", + "BACKEND_BUCKETS", + "BACKEND_SERVICES", + "C2D_CPUS", + "C2_CPUS", + "C3_CPUS", + "COMMITMENTS", + "COMMITTED_A2_CPUS", + "COMMITTED_C2D_CPUS", + "COMMITTED_C2_CPUS", + "COMMITTED_C3_CPUS", + "COMMITTED_CPUS", + "COMMITTED_E2_CPUS", + "COMMITTED_LICENSES", + "COMMITTED_LOCAL_SSD_TOTAL_GB", + "COMMITTED_M3_CPUS", + "COMMITTED_MEMORY_OPTIMIZED_CPUS", + "COMMITTED_N2A_CPUS", + "COMMITTED_N2D_CPUS", + "COMMITTED_N2_CPUS", + "COMMITTED_NVIDIA_A100_80GB_GPUS", + "COMMITTED_NVIDIA_A100_GPUS", + "COMMITTED_NVIDIA_H100_GPUS", + "COMMITTED_NVIDIA_K80_GPUS", + "COMMITTED_NVIDIA_L4_GPUS", + "COMMITTED_NVIDIA_P100_GPUS", + "COMMITTED_NVIDIA_P4_GPUS", + "COMMITTED_NVIDIA_T4_GPUS", + "COMMITTED_NVIDIA_V100_GPUS", + "COMMITTED_T2A_CPUS", + "COMMITTED_T2D_CPUS", + "COMMITTED_Z3_CPUS", + "CPUS", + "CPUS_ALL_REGIONS", + "DISKS_TOTAL_GB", + "E2_CPUS", + "EXTERNAL_MANAGED_FORWARDING_RULES", + "EXTERNAL_NETWORK_LB_FORWARDING_RULES", + "EXTERNAL_PROTOCOL_FORWARDING_RULES", + "EXTERNAL_VPN_GATEWAYS", + "FIREWALLS", + "FORWARDING_RULES", + "GLOBAL_EXTERNAL_MANAGED_BACKEND_SERVICES", + "GLOBAL_EXTERNAL_MANAGED_FORWARDING_RULES", + "GLOBAL_EXTERNAL_PROXY_LB_BACKEND_SERVICES", + "GLOBAL_INTERNAL_ADDRESSES", + "GLOBAL_INTERNAL_MANAGED_BACKEND_SERVICES", + "GLOBAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES", + "GPUS_ALL_REGIONS", + "HDB_TOTAL_GB", + "HDB_TOTAL_IOPS", + "HDB_TOTAL_THROUGHPUT", + "HEALTH_CHECKS", + "IMAGES", + "INSTANCES", + "INSTANCE_GROUPS", + "INSTANCE_GROUP_MANAGERS", + "INSTANCE_TEMPLATES", + "INTERCONNECTS", + "INTERCONNECT_ATTACHMENTS_PER_REGION", + "INTERCONNECT_ATTACHMENTS_TOTAL_MBPS", + "INTERCONNECT_TOTAL_GBPS", + "INTERNAL_ADDRESSES", + "INTERNAL_TRAFFIC_DIRECTOR_FORWARDING_RULES", + "IN_PLACE_SNAPSHOTS", + "IN_USE_ADDRESSES", + "IN_USE_BACKUP_SCHEDULES", + "IN_USE_SNAPSHOT_SCHEDULES", + "LOCAL_SSD_TOTAL_GB", + "M1_CPUS", + "M2_CPUS", + "M3_CPUS", + "MACHINE_IMAGES", + "N2A_CPUS", + "N2D_CPUS", + "N2_CPUS", + "NETWORKS", + "NETWORK_ATTACHMENTS", + "NETWORK_ENDPOINT_GROUPS", + "NETWORK_FIREWALL_POLICIES", + "NET_LB_SECURITY_POLICIES_PER_REGION", + "NET_LB_SECURITY_POLICY_RULES_PER_REGION", + "NET_LB_SECURITY_POLICY_RULE_ATTRIBUTES_PER_REGION", + "NODE_GROUPS", + "NODE_TEMPLATES", + "NVIDIA_A100_80GB_GPUS", + "NVIDIA_A100_GPUS", + "NVIDIA_K80_GPUS", + "NVIDIA_L4_GPUS", + "NVIDIA_P100_GPUS", + "NVIDIA_P100_VWS_GPUS", + "NVIDIA_P4_GPUS", + "NVIDIA_P4_VWS_GPUS", + "NVIDIA_T4_GPUS", + "NVIDIA_T4_VWS_GPUS", + "NVIDIA_V100_GPUS", + "PACKET_MIRRORINGS", + "PD_EXTREME_TOTAL_PROVISIONED_IOPS", + "PREEMPTIBLE_CPUS", + "PREEMPTIBLE_LOCAL_SSD_GB", + "PREEMPTIBLE_NVIDIA_A100_80GB_GPUS", + "PREEMPTIBLE_NVIDIA_A100_GPUS", + "PREEMPTIBLE_NVIDIA_H100_GPUS", + "PREEMPTIBLE_NVIDIA_K80_GPUS", + "PREEMPTIBLE_NVIDIA_L4_GPUS", + "PREEMPTIBLE_NVIDIA_P100_GPUS", + "PREEMPTIBLE_NVIDIA_P100_VWS_GPUS", + "PREEMPTIBLE_NVIDIA_P4_GPUS", + "PREEMPTIBLE_NVIDIA_P4_VWS_GPUS", + "PREEMPTIBLE_NVIDIA_T4_GPUS", + "PREEMPTIBLE_NVIDIA_T4_VWS_GPUS", + "PREEMPTIBLE_NVIDIA_V100_GPUS", + "PREEMPTIBLE_TPU_LITE_DEVICE_V5", + "PREEMPTIBLE_TPU_LITE_PODSLICE_V5", + "PREEMPTIBLE_TPU_PODSLICE_V4", + "PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK", + "PSC_INTERNAL_LB_FORWARDING_RULES", + "PUBLIC_ADVERTISED_PREFIXES", + "PUBLIC_DELEGATED_PREFIXES", + "REGIONAL_AUTOSCALERS", + "REGIONAL_EXTERNAL_MANAGED_BACKEND_SERVICES", + "REGIONAL_EXTERNAL_NETWORK_LB_BACKEND_SERVICES", + "REGIONAL_INSTANCE_GROUP_MANAGERS", + "REGIONAL_INTERNAL_LB_BACKEND_SERVICES", + "REGIONAL_INTERNAL_MANAGED_BACKEND_SERVICES", + "REGIONAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES", + "RESERVATIONS", + "RESOURCE_POLICIES", + "ROUTERS", + "ROUTES", + "SECURITY_POLICIES", + "SECURITY_POLICIES_PER_REGION", + "SECURITY_POLICY_ADVANCED_RULES_PER_REGION", + "SECURITY_POLICY_CEVAL_RULES", + "SECURITY_POLICY_RULES", + "SECURITY_POLICY_RULES_PER_REGION", + "SERVICE_ATTACHMENTS", + "SNAPSHOTS", + "SSD_TOTAL_GB", + "SSL_CERTIFICATES", + "SSL_POLICIES", + "STATIC_ADDRESSES", + "STATIC_BYOIP_ADDRESSES", + "STATIC_EXTERNAL_IPV6_ADDRESS_RANGES", + "SUBNETWORKS", + "T2A_CPUS", + "T2D_CPUS", + "TARGET_HTTPS_PROXIES", + "TARGET_HTTP_PROXIES", + "TARGET_INSTANCES", + "TARGET_POOLS", + "TARGET_SSL_PROXIES", + "TARGET_TCP_PROXIES", + "TARGET_VPN_GATEWAYS", + "TPU_LITE_DEVICE_V5", + "TPU_LITE_PODSLICE_V5", + "TPU_PODSLICE_V4", + "URL_MAPS", + "VARIABLE_IPV6_PUBLIC_DELEGATED_PREFIXES", + "VPN_GATEWAYS", + "VPN_TUNNELS", + "XPN_SERVICE_PROJECTS" + ] }, - "patch": { - "id": "compute.networks.patch", - "path": "projects/{project}/global/networks/{network}", - "flatPath": "projects/{project}/global/networks/{network}", - "httpMethod": "PATCH", - "parameters": { - "network": { - "description": "Name of the network to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "network" - ], - "request": { - "$ref": "Network" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified network with the data included in the request. Only routingConfig can be modified." + "limit": { + "description": "[Output Only] Quota limit for this metric.", + "type": "number", + "format": "double" }, - "updatePeering": { - "id": "compute.networks.updatePeering", - "path": "projects/{project}/global/networks/{network}/updatePeering", - "flatPath": "projects/{project}/global/networks/{network}/updatePeering", - "httpMethod": "PATCH", - "parameters": { - "network": { - "description": "Name of the network resource which the updated peering is belonging to.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "network" - ], - "request": { - "$ref": "NetworksUpdatePeeringRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified network peering with the data included in the request. You can only modify the NetworkPeering.export_custom_routes field and the NetworkPeering.import_custom_routes field." + "usage": { + "description": "[Output Only] Current usage of this metric.", + "type": "number", + "format": "double" }, - "addPeering": { - "id": "compute.networks.addPeering", - "path": "projects/{project}/global/networks/{network}/addPeering", - "flatPath": "projects/{project}/global/networks/{network}/addPeering", - "httpMethod": "POST", - "parameters": { - "network": { - "description": "Name of the network resource to add peering to.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "network" - ], - "request": { - "$ref": "NetworksAddPeeringRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Adds a peering to the specified network." + "owner": { + "description": "[Output Only] Owning resource. This is the resource on which this quota is applied.", + "type": "string" + } + } + }, + "UsageExportLocation": { + "id": "UsageExportLocation", + "description": "The location in Cloud Storage and naming method of the daily usage report. Contains bucket_name and report_name prefix.", + "type": "object", + "properties": { + "bucketName": { + "description": "The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This can either be the bucket name by itself, such as example-bucket, or the bucket name with gs:// or https://storage.googleapis.com/ in front of it, such as gs://example-bucket.", + "type": "string" }, - "removePeering": { - "id": "compute.networks.removePeering", - "path": "projects/{project}/global/networks/{network}/removePeering", - "flatPath": "projects/{project}/global/networks/{network}/removePeering", - "httpMethod": "POST", - "parameters": { - "network": { - "description": "Name of the network resource to remove peering from.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "network" - ], - "request": { - "$ref": "NetworksRemovePeeringRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes a peering from the specified network." + "reportNamePrefix": { + "description": "An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage_gce. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions.", + "type": "string" + } + } + }, + "InstanceMoveRequest": { + "id": "InstanceMoveRequest", + "type": "object", + "properties": { + "targetInstance": { + "description": "The URL of the target instance to move. This can be a full or partial URL. For example, the following are all valid URLs to an instance: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance ", + "type": "string" }, - "switchToCustomMode": { - "id": "compute.networks.switchToCustomMode", - "path": "projects/{project}/global/networks/{network}/switchToCustomMode", - "flatPath": "projects/{project}/global/networks/{network}/switchToCustomMode", - "httpMethod": "POST", - "parameters": { - "network": { - "description": "Name of the network to be updated.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "network" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Switches the network mode from auto subnet mode to custom subnet mode." + "destinationZone": { + "description": "The URL of the destination zone to move the instance. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone ", + "type": "string" + } + } + }, + "DiskMoveRequest": { + "id": "DiskMoveRequest", + "type": "object", + "properties": { + "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: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - projects/project/zones/zone/disks/disk - zones/zone/disks/disk ", + "type": "string" }, - "getEffectiveFirewalls": { - "id": "compute.networks.getEffectiveFirewalls", - "path": "projects/{project}/global/networks/{network}/getEffectiveFirewalls", - "flatPath": "projects/{project}/global/networks/{network}/getEffectiveFirewalls", - "httpMethod": "GET", - "parameters": { - "network": { - "description": "Name of the network for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "network" - ], - "response": { - "$ref": "NetworksGetEffectiveFirewallsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the effective firewalls on a given network." + "destinationZone": { + "description": "The URL of the destination zone to move the disk. This can be a full or partial URL. For example, the following are all valid URLs to a zone: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - projects/project/zones/zone - zones/zone ", + "type": "string" + } + } + }, + "ProjectsListXpnHostsRequest": { + "id": "ProjectsListXpnHostsRequest", + "type": "object", + "properties": { + "organization": { + "description": "Optional organization ID managed by Cloud Resource Manager, for which to list shared VPC host projects. If not specified, the organization will be inferred from the project.", + "type": "string" + } + } + }, + "XpnHostList": { + "id": "XpnHostList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#xpnHostList for lists of shared VPC hosts.", + "default": "compute#xpnHostList", + "type": "string" }, - "listPeeringRoutes": { - "id": "compute.networks.listPeeringRoutes", - "path": "projects/{project}/global/networks/{network}/listPeeringRoutes", - "flatPath": "projects/{project}/global/networks/{network}/listPeeringRoutes", - "httpMethod": "GET", - "parameters": { - "direction": { - "description": "The direction of the exchanged routes.", - "location": "query", + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "[Output Only] A list of shared VPC host project URLs.", + "type": "array", + "items": { + "$ref": "Project" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", "type": "string", "enumDescriptions": [ - "For routes exported from peer network.", - "For routes exported from local network." + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false ], "enum": [ - "INCOMING", - "OUTGOING" - ] - }, - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "network": { - "description": "Name of the network for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "peeringName": { - "description": "The response will show routes exchanged over the given peering connection.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The region of the request. The response will include all subnet routes, static routes and dynamic routes in the region.", - "location": "query", - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "network" - ], - "response": { - "$ref": "ExchangedPeeringRoutesList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the peering routes exchanged over peering connection." - } - } - }, - "nodeGroups": { - "methods": { - "list": { - "id": "compute.nodeGroups.list", - "path": "projects/{project}/zones/{zone}/nodeGroups", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "NodeGroupList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + } + } + } + }, + "ProjectsEnableXpnResourceRequest": { + "id": "ProjectsEnableXpnResourceRequest", + "type": "object", + "properties": { + "xpnResource": { + "description": "Service resource (a.k.a service project) ID.", + "$ref": "XpnResourceId" + } + } + }, + "XpnResourceId": { + "id": "XpnResourceId", + "description": "Service resource (a.k.a service project) ID.", + "type": "object", + "properties": { + "type": { + "description": "The type of the service resource.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves a list of node groups available to the specified project. Note: use nodeGroups.listNodes for more details about each group." + "enum": [ + "PROJECT", + "XPN_RESOURCE_TYPE_UNSPECIFIED" + ] }, - "aggregatedList": { - "id": "compute.nodeGroups.aggregatedList", - "path": "projects/{project}/aggregated/nodeGroups", - "flatPath": "projects/{project}/aggregated/nodeGroups", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "NodeGroupAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of node groups. Note: use nodeGroups.listNodes for more details about each group. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "id": { + "description": "The ID of the service resource. In the case of projects, this field supports project id (e.g., my-project-123) and project number (e.g. 12345678).", + "type": "string" + } + } + }, + "ProjectsDisableXpnResourceRequest": { + "id": "ProjectsDisableXpnResourceRequest", + "type": "object", + "properties": { + "xpnResource": { + "description": "Service resource (a.k.a service project) ID.", + "$ref": "XpnResourceId" + } + } + }, + "ProjectsGetXpnResources": { + "id": "ProjectsGetXpnResources", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#projectsGetXpnResources for lists of service resources (a.k.a service projects)", + "default": "compute#projectsGetXpnResources", + "type": "string" }, - "get": { - "id": "compute.nodeGroups.get", - "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", - "httpMethod": "GET", - "parameters": { - "nodeGroup": { - "description": "Name of the node group to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "response": { - "$ref": "NodeGroup" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified NodeGroup. Get a list of available NodeGroups by making a list() request. Note: the \"nodes\" field should not be used. Use nodeGroups.listNodes instead." + "resources": { + "description": "Service resources (a.k.a service projects) attached to this project as their shared VPC host.", + "type": "array", + "items": { + "$ref": "XpnResourceId" + } }, - "insert": { - "id": "compute.nodeGroups.insert", - "path": "projects/{project}/zones/{zone}/nodeGroups", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups", - "httpMethod": "POST", - "parameters": { - "initialNodeCount": { - "description": "Initial count of nodes in the node group.", - "location": "query", - "required": true, - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "initialNodeCount" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + } + } + }, + "ProjectsSetDefaultNetworkTierRequest": { + "id": "ProjectsSetDefaultNetworkTierRequest", + "type": "object", + "properties": { + "networkTier": { + "description": "Default network tier to be set.", + "type": "string", + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking products.", + "Public internet quality, only limited support for other networking products.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." ], - "request": { - "$ref": "NodeGroup" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" + ] + } + } + }, + "ProjectsSetCloudArmorTierRequest": { + "id": "ProjectsSetCloudArmorTierRequest", + "type": "object", + "properties": { + "cloudArmorTier": { + "description": "Managed protection tier to be set.", + "type": "string", + "enumDescriptions": [ + "Enterprise tier protection billed annually.", + "Enterprise tier protection billed monthly.", + "Standard protection." ], - "description": "Creates a NodeGroup resource in the specified project using the data included in the request." + "enum": [ + "CA_ENTERPRISE_ANNUAL", + "CA_ENTERPRISE_PAYGO", + "CA_STANDARD" + ] + } + } + }, + "PublicAdvertisedPrefixList": { + "id": "PublicAdvertisedPrefixList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes.", + "default": "compute#publicAdvertisedPrefixList", + "type": "string" }, - "delete": { - "id": "compute.nodeGroups.delete", - "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", - "httpMethod": "DELETE", - "parameters": { - "nodeGroup": { - "description": "Name of the NodeGroup resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified NodeGroup resource." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "addNodes": { - "id": "compute.nodeGroups.addNodes", - "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/addNodes", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/addNodes", - "httpMethod": "POST", - "parameters": { - "nodeGroup": { - "description": "Name of the NodeGroup resource.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of PublicAdvertisedPrefix resources.", + "type": "array", + "items": { + "$ref": "PublicAdvertisedPrefix" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "request": { - "$ref": "NodeGroupsAddNodesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Adds specified number of nodes to the node group." + } + } + } + }, + "PublicAdvertisedPrefix": { + "id": "PublicAdvertisedPrefix", + "description": "A public advertised prefix represents an aggregated IP prefix or netblock which customers bring to cloud. The IP prefix is a single unit of route advertisement and is announced globally to the internet.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#publicAdvertisedPrefix for public advertised prefixes.", + "default": "compute#publicAdvertisedPrefix", + "type": "string" }, - "deleteNodes": { - "id": "compute.nodeGroups.deleteNodes", - "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/deleteNodes", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/deleteNodes", - "httpMethod": "POST", - "parameters": { - "nodeGroup": { - "description": "Name of the NodeGroup resource whose nodes will be deleted.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "request": { - "$ref": "NodeGroupsDeleteNodesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes specified nodes from the node group." + "id": { + "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", + "type": "string", + "format": "uint64" }, - "listNodes": { - "id": "compute.nodeGroups.listNodes", - "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/listNodes", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/listNodes", - "httpMethod": "POST", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "nodeGroup": { - "description": "Name of the NodeGroup resource whose nodes you want to list.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "response": { - "$ref": "NodeGroupsListNodes" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists nodes in the node group." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "setNodeTemplate": { - "id": "compute.nodeGroups.setNodeTemplate", - "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/setNodeTemplate", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/setNodeTemplate", - "httpMethod": "POST", - "parameters": { - "nodeGroup": { - "description": "Name of the NodeGroup resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "request": { - "$ref": "NodeGroupsSetNodeTemplateRequest" - }, - "response": { - "$ref": "Operation" + "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])?", + "annotations": { + "required": [ + "compute.publicAdvertisedPrefixes.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "ipCidrRange": { + "description": "The address range, in CIDR format, represented by this public advertised prefix.", + "type": "string" + }, + "dnsVerificationIp": { + "description": "The address to be used for reverse DNS verification.", + "type": "string" + }, + "sharedSecret": { + "description": "[Output Only] The shared secret to be used for reverse DNS verification.", + "type": "string" + }, + "status": { + "description": "The status of the public advertised prefix. Possible values include: - `INITIAL`: RPKI validation is complete. - `PTR_CONFIGURED`: User has configured the PTR. - `VALIDATED`: Reverse DNS lookup is successful. - `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. - `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being configured. - `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. - `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. ", + "type": "string", + "enumDescriptions": [ + "The prefix is announced to Internet.", + "RPKI validation is complete.", + "The prefix is fully configured.", + "The prefix is being configured.", + "The prefix is being removed.", + "User has configured the PTR.", + "The prefix is currently withdrawn but ready to be announced.", + "Reverse DNS lookup failed.", + "Reverse DNS lookup is successful." ], - "description": "Updates the node template of the node group." + "enum": [ + "ANNOUNCED_TO_INTERNET", + "INITIAL", + "PREFIX_CONFIGURATION_COMPLETE", + "PREFIX_CONFIGURATION_IN_PROGRESS", + "PREFIX_REMOVAL_IN_PROGRESS", + "PTR_CONFIGURED", + "READY_TO_ANNOUNCE", + "REVERSE_DNS_LOOKUP_FAILED", + "VALIDATED" + ] }, - "patch": { - "id": "compute.nodeGroups.patch", - "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}", - "httpMethod": "PATCH", - "parameters": { - "nodeGroup": { - "description": "Name of the NodeGroup resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" + "pdpScope": { + "description": "Specifies how child public delegated prefix will be scoped. It could be one of following values: - `REGIONAL`: The public delegated prefix is regional only. The provisioning will take a few minutes. - `GLOBAL`: The public delegated prefix is global only. The provisioning will take ~4 weeks. - `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is BYOIP V1 legacy prefix. This is output only value and no longer supported in BYOIP V2. ", + "type": "string", + "enumDescriptions": [ + "The public delegated prefix is global only. The provisioning will take ~4 weeks.", + "The public delegated prefixes is BYOIP V1 legacy prefix. This is output only value and no longer supported in BYOIP V2.", + "The public delegated prefix is regional only. The provisioning will take a few minutes." ], - "request": { - "$ref": "NodeGroup" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "GLOBAL", + "GLOBAL_AND_REGIONAL", + "REGIONAL" + ] + }, + "publicDelegatedPrefixs": { + "description": "[Output Only] The list of public delegated prefixes that exist for this public advertised prefix.", + "type": "array", + "items": { + "$ref": "PublicAdvertisedPrefixPublicDelegatedPrefix" + } + }, + "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 new PublicAdvertisedPrefix. An up-to-date fingerprint must be provided in order to update the PublicAdvertisedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicAdvertisedPrefix.", + "type": "string", + "format": "byte" + }, + "byoipApiVersion": { + "description": "[Output Only] The version of BYOIP API.", + "type": "string", + "enumDescriptions": [ + "This public advertised prefix can be used to create both regional and global public delegated prefixes. It usually takes 4 weeks to create or delete a public delegated prefix. The BGP status cannot be changed.", + "This public advertised prefix can only be used to create regional public delegated prefixes. Public delegated prefix creation and deletion takes minutes and the BGP status can be modified." ], - "description": "Updates the specified node group." + "enum": [ + "V1", + "V2" + ] + } + } + }, + "PublicAdvertisedPrefixPublicDelegatedPrefix": { + "id": "PublicAdvertisedPrefixPublicDelegatedPrefix", + "description": "Represents a CIDR range which can be used to assign addresses.", + "type": "object", + "properties": { + "name": { + "description": "The name of the public delegated prefix", + "type": "string" }, - "simulateMaintenanceEvent": { - "id": "compute.nodeGroups.simulateMaintenanceEvent", - "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/simulateMaintenanceEvent", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/simulateMaintenanceEvent", - "httpMethod": "POST", - "parameters": { - "nodeGroup": { - "description": "Name of the NodeGroup resource whose nodes will go under maintenance simulation.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "region": { + "description": "The region of the public delegated prefix if it is regional. If absent, the prefix is global.", + "type": "string" + }, + "project": { + "description": "The project number of the public delegated prefix", + "type": "string" + }, + "status": { + "description": "The status of the public delegated prefix. Possible values are: INITIALIZING: The public delegated prefix is being initialized and addresses cannot be created yet. ANNOUNCED: The public delegated prefix is active.", + "type": "string" + }, + "ipRange": { + "description": "The IP address range of the public delegated prefix", + "type": "string" + } + } + }, + "PublicDelegatedPrefixList": { + "id": "PublicDelegatedPrefixList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#publicDelegatedPrefixList for public delegated prefixes.", + "default": "compute#publicDelegatedPrefixList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of PublicDelegatedPrefix resources.", + "type": "array", + "items": { + "$ref": "PublicDelegatedPrefix" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "request": { - "$ref": "NodeGroupsSimulateMaintenanceEventRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Simulates maintenance event on specified nodes from the node group." + } + } + } + }, + "PublicDelegatedPrefix": { + "id": "PublicDelegatedPrefix", + "description": "A PublicDelegatedPrefix resource represents an IP block within a PublicAdvertisedPrefix that is configured within a single cloud scope (global or region). IPs in the block can be allocated to resources within that scope. Public delegated prefixes may be further broken up into smaller IP blocks in the same scope as the parent block.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#publicDelegatedPrefix for public delegated prefixes.", + "default": "compute#publicDelegatedPrefix", + "type": "string" }, - "performMaintenance": { - "id": "compute.nodeGroups.performMaintenance", - "path": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/performMaintenance", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{nodeGroup}/performMaintenance", - "httpMethod": "POST", - "parameters": { - "nodeGroup": { - "description": "Name of the node group scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "nodeGroup" - ], - "request": { - "$ref": "NodeGroupsPerformMaintenanceRequest" - }, - "response": { - "$ref": "Operation" + "id": { + "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.publicDelegatedPrefixes.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the public delegated prefix resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "ipCidrRange": { + "description": "The IP address range, in CIDR format, represented by this public delegated prefix.", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the public delegated prefix, which can be one of following values: - `INITIALIZING` The public delegated prefix is being initialized and addresses cannot be created yet. - `READY_TO_ANNOUNCE` The public delegated prefix is a live migration prefix and is active. - `ANNOUNCED` The public delegated prefix is active. - `DELETING` The public delegated prefix is being deprovsioned. ", + "type": "string", + "enumDescriptions": [ + "The public delegated prefix is active.", + "The prefix is announced within Google network.", + "The prefix is announced to Internet and within Google.", + "The public delegated prefix is being deprovsioned.", + "The public delegated prefix is being initialized and addresses cannot be created yet.", + "The public delegated prefix is currently withdrawn but ready to be announced." ], - "description": "Perform maintenance on a subset of nodes in the node group." + "enum": [ + "ANNOUNCED", + "ANNOUNCED_TO_GOOGLE", + "ANNOUNCED_TO_INTERNET", + "DELETING", + "INITIALIZING", + "READY_TO_ANNOUNCE" + ] }, - "getIamPolicy": { - "id": "compute.nodeGroups.getIamPolicy", - "path": "projects/{project}/zones/{zone}/nodeGroups/{resource}/getIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" + "parentPrefix": { + "description": "The URL of parent prefix. Either PublicAdvertisedPrefix or PublicDelegatedPrefix.", + "type": "string" + }, + "publicDelegatedSubPrefixs": { + "description": "The list of sub public delegated prefixes that exist for this public delegated prefix.", + "type": "array", + "items": { + "$ref": "PublicDelegatedPrefixPublicDelegatedSubPrefix" + } + }, + "isLiveMigration": { + "description": "If true, the prefix will be live migrated.", + "type": "boolean" + }, + "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 new PublicDelegatedPrefix. An up-to-date fingerprint must be provided in order to update the PublicDelegatedPrefix, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a PublicDelegatedPrefix.", + "type": "string", + "format": "byte" + }, + "mode": { + "description": "The public delegated prefix mode for IPv6 only.", + "type": "string", + "enumDescriptions": [ + "The public delegated prefix is used for further sub-delegation only. Such prefixes cannot set allocatablePrefixLength.", + "The public delegated prefix is used for creating forwarding rules only. Such prefixes cannot set publicDelegatedSubPrefixes." ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "DELEGATION", + "EXTERNAL_IPV6_FORWARDING_RULE_CREATION" + ] + }, + "allocatablePrefixLength": { + "description": "The allocatable prefix length supported by this public delegated prefix. This field is optional and cannot be set for prefixes in DELEGATION mode. It cannot be set for IPv4 prefixes either, and it always defaults to 32.", + "type": "integer", + "format": "int32" + }, + "byoipApiVersion": { + "description": "[Output Only] The version of BYOIP API.", + "type": "string", + "enumDescriptions": [ + "This public delegated prefix usually takes 4 weeks to delete, and the BGP status cannot be changed. Announce and Withdraw APIs can not be used on this prefix.", + "This public delegated prefix takes minutes to delete. Announce and Withdraw APIs can be used on this prefix to change the BGP status." ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "enum": [ + "V1", + "V2" + ] + } + } + }, + "PublicDelegatedPrefixPublicDelegatedSubPrefix": { + "id": "PublicDelegatedPrefixPublicDelegatedSubPrefix", + "description": "Represents a sub PublicDelegatedPrefix.", + "type": "object", + "properties": { + "name": { + "description": "The name of the sub public delegated prefix.", + "type": "string" }, - "setIamPolicy": { - "id": "compute.nodeGroups.setIamPolicy", - "path": "projects/{project}/zones/{zone}/nodeGroups/{resource}/setIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] The region of the sub public delegated prefix if it is regional. If absent, the sub prefix is global.", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the sub public delegated prefix.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "request": { - "$ref": "ZoneSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ACTIVE", + "INACTIVE" + ] + }, + "ipCidrRange": { + "description": "The IP address range, in CIDR format, represented by this sub public delegated prefix.", + "type": "string" + }, + "delegateeProject": { + "description": "Name of the project scoping this PublicDelegatedSubPrefix.", + "type": "string" + }, + "isAddress": { + "description": "Whether the sub prefix is delegated to create Address resources in the delegatee project.", + "type": "boolean" + }, + "mode": { + "description": "The PublicDelegatedSubPrefix mode for IPv6 only.", + "type": "string", + "enumDescriptions": [ + "The public delegated prefix is used for further sub-delegation only. Such prefixes cannot set allocatablePrefixLength.", + "The public delegated prefix is used for creating forwarding rules only. Such prefixes cannot set publicDelegatedSubPrefixes." ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "enum": [ + "DELEGATION", + "EXTERNAL_IPV6_FORWARDING_RULE_CREATION" + ] }, - "testIamPermissions": { - "id": "compute.nodeGroups.testIamPermissions", - "path": "projects/{project}/zones/{zone}/nodeGroups/{resource}/testIamPermissions", - "flatPath": "projects/{project}/zones/{zone}/nodeGroups/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "allocatablePrefixLength": { + "description": "The allocatable prefix length supported by this PublicDelegatedSubPrefix.", + "type": "integer", + "format": "int32" + } + } + }, + "PublicDelegatedPrefixAggregatedList": { + "id": "PublicDelegatedPrefixAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#publicDelegatedPrefixAggregatedList for aggregated lists of public delegated prefixes.", + "default": "compute#publicDelegatedPrefixAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of PublicDelegatedPrefixesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of PublicDelegatedPrefixes.", + "$ref": "PublicDelegatedPrefixesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + } + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } } } }, - "nodeTemplates": { - "methods": { - "list": { - "id": "compute.nodeTemplates.list", - "path": "projects/{project}/regions/{region}/nodeTemplates", - "flatPath": "projects/{project}/regions/{region}/nodeTemplates", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "NodeTemplateList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of node templates available to the specified project." + "PublicDelegatedPrefixesScopedList": { + "id": "PublicDelegatedPrefixesScopedList", + "type": "object", + "properties": { + "publicDelegatedPrefixes": { + "description": "[Output Only] A list of PublicDelegatedPrefixes contained in this scope.", + "type": "array", + "items": { + "$ref": "PublicDelegatedPrefix" + } }, - "aggregatedList": { - "id": "compute.nodeTemplates.aggregatedList", - "path": "projects/{project}/aggregated/nodeTemplates", - "flatPath": "projects/{project}/aggregated/nodeTemplates", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", + "warning": { + "description": "[Output Only] Informational warning which replaces the list of public delegated prefixes when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "NodeTemplateAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of node templates. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." - }, - "get": { - "id": "compute.nodeTemplates.get", - "path": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", - "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", - "httpMethod": "GET", - "parameters": { - "nodeTemplate": { - "description": "Name of the node template to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "nodeTemplate" - ], - "response": { - "$ref": "NodeTemplate" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified node template." + } + } + } + }, + "RegionList": { + "id": "RegionList", + "description": "Contains a list of region resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#regionList for lists of regions.", + "default": "compute#regionList", + "type": "string" }, - "insert": { - "id": "compute.nodeTemplates.insert", - "path": "projects/{project}/regions/{region}/nodeTemplates", - "flatPath": "projects/{project}/regions/{region}/nodeTemplates", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "NodeTemplate" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a NodeTemplate resource in the specified project using the data included in the request." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "delete": { - "id": "compute.nodeTemplates.delete", - "path": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", - "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{nodeTemplate}", - "httpMethod": "DELETE", - "parameters": { - "nodeTemplate": { - "description": "Name of the NodeTemplate resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of Region resources.", + "type": "array", + "items": { + "$ref": "Region" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "nodeTemplate" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified NodeTemplate resource." + } + } + } + }, + "Region": { + "id": "Region", + "description": "Represents a Region resource. A region is a geographical area where a resource is located. For more information, read Regions and Zones.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#region for regions.", + "default": "compute#region", + "type": "string" }, - "getIamPolicy": { - "id": "compute.nodeTemplates.getIamPolicy", - "path": "projects/{project}/regions/{region}/nodeTemplates/{resource}/getIamPolicy", - "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "setIamPolicy": { - "id": "compute.nodeTemplates.setIamPolicy", - "path": "projects/{project}/regions/{region}/nodeTemplates/{resource}/setIamPolicy", - "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "type": "string" + }, + "description": { + "description": "[Output Only] Textual description of the resource.", + "type": "string" + }, + "status": { + "description": "[Output Only] Status of the region, either UP or DOWN.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "enum": [ + "DOWN", + "UP" + ] }, - "testIamPermissions": { - "id": "compute.nodeTemplates.testIamPermissions", - "path": "projects/{project}/regions/{region}/nodeTemplates/{resource}/testIamPermissions", - "flatPath": "projects/{project}/regions/{region}/nodeTemplates/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "zones": { + "description": "[Output Only] A list of zones available in this region, in the form of resource URLs.", + "type": "array", + "items": { + "type": "string" + } + }, + "quotas": { + "description": "[Output Only] Quotas assigned to this region.", + "type": "array", + "items": { + "$ref": "Quota" + } + }, + "deprecated": { + "description": "[Output Only] The deprecation status associated with this region.", + "$ref": "DeprecationStatus" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "supportsPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" + }, + "quotaStatusWarning": { + "description": "[Output Only] Warning of fetching the `quotas` field for this region. This field is populated only if fetching of the `quotas` field fails.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + } } } }, - "nodeTypes": { - "methods": { - "list": { - "id": "compute.nodeTypes.list", - "path": "projects/{project}/zones/{zone}/nodeTypes", - "flatPath": "projects/{project}/zones/{zone}/nodeTypes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "ResourcePolicyList": { + "id": "ResourcePolicyList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource.Always compute#resourcePoliciesList for listsof resourcePolicies", + "default": "compute#resourcePolicyList", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string" + }, + "items": { + "description": "[Output Only] A list of ResourcePolicy resources.", + "type": "array", + "items": { + "$ref": "ResourcePolicy" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "NodeTypeList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of node types available to the specified project." + } }, - "aggregatedList": { - "id": "compute.nodeTypes.aggregatedList", - "path": "projects/{project}/aggregated/nodeTypes", - "flatPath": "projects/{project}/aggregated/nodeTypes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "NodeTypeAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of node types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" }, - "get": { - "id": "compute.nodeTypes.get", - "path": "projects/{project}/zones/{zone}/nodeTypes/{nodeType}", - "flatPath": "projects/{project}/zones/{zone}/nodeTypes/{nodeType}", - "httpMethod": "GET", - "parameters": { - "nodeType": { - "description": "Name of the node type to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "nodeType" - ], - "response": { - "$ref": "NodeType" + "etag": { + "type": "string" + } + } + }, + "ResourcePolicy": { + "id": "ResourcePolicy", + "description": "Represents a Resource Policy resource. You can use resource policies to schedule actions for some Compute Engine resources. For example, you can use them to schedule persistent disk snapshots.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#resource_policies for resource policies.", + "default": "compute#resourcePolicy", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined fully-qualified URL for this resource.", + "type": "string" + }, + "region": { + "type": "string" + }, + "description": { + "type": "string" + }, + "name": { + "description": "The name of the resource, provided by the client when initially creating the resource. The resource name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "annotations": { + "required": [ + "compute.instances.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "string" + }, + "snapshotSchedulePolicy": { + "description": "Resource policy for persistent disks for creating snapshots.", + "$ref": "ResourcePolicySnapshotSchedulePolicy" + }, + "groupPlacementPolicy": { + "description": "Resource policy for instances for placement configuration.", + "$ref": "ResourcePolicyGroupPlacementPolicy" + }, + "instanceSchedulePolicy": { + "description": "Resource policy for scheduling instance operations.", + "$ref": "ResourcePolicyInstanceSchedulePolicy" + }, + "diskConsistencyGroupPolicy": { + "description": "Resource policy for disk consistency groups.", + "$ref": "ResourcePolicyDiskConsistencyGroupPolicy" + }, + "status": { + "description": "[Output Only] The status of resource policy creation.", + "type": "string", + "enumDescriptions": [ + "Resource policy is being created.", + "Resource policy is being deleted.", + "Resource policy is expired and will not run again.", + "", + "Resource policy is ready to be used." ], - "description": "Returns the specified node type." + "enum": [ + "CREATING", + "DELETING", + "EXPIRED", + "INVALID", + "READY" + ] + }, + "resourceStatus": { + "description": "[Output Only] The system status of the resource policy.", + "$ref": "ResourcePolicyResourceStatus" } } }, - "regionNotificationEndpoints": { - "methods": { - "list": { - "id": "compute.regionNotificationEndpoints.list", - "path": "projects/{project}/regions/{region}/notificationEndpoints", - "flatPath": "projects/{project}/regions/{region}/notificationEndpoints", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" + "ResourcePolicySnapshotSchedulePolicy": { + "id": "ResourcePolicySnapshotSchedulePolicy", + "description": "A snapshot schedule policy specifies when and how frequently snapshots are to be created for the target disk. Also specifies how many and how long these scheduled snapshots should be retained.", + "type": "object", + "properties": { + "schedule": { + "description": "A Vm Maintenance Policy specifies what kind of infrastructure maintenance we are allowed to perform on this VM and when. Schedule that is applied to disks covered by this policy.", + "$ref": "ResourcePolicySnapshotSchedulePolicySchedule" + }, + "retentionPolicy": { + "description": "Retention policy applied to snapshots created by this resource policy.", + "$ref": "ResourcePolicySnapshotSchedulePolicyRetentionPolicy" + }, + "snapshotProperties": { + "description": "Properties with which snapshots are created such as labels, encryption keys.", + "$ref": "ResourcePolicySnapshotSchedulePolicySnapshotProperties" + } + } + }, + "ResourcePolicySnapshotSchedulePolicySchedule": { + "id": "ResourcePolicySnapshotSchedulePolicySchedule", + "description": "A schedule for disks where the schedueled operations are performed.", + "type": "object", + "properties": { + "hourlySchedule": { + "$ref": "ResourcePolicyHourlyCycle" + }, + "dailySchedule": { + "$ref": "ResourcePolicyDailyCycle" + }, + "weeklySchedule": { + "$ref": "ResourcePolicyWeeklyCycle" + } + } + }, + "ResourcePolicyHourlyCycle": { + "id": "ResourcePolicyHourlyCycle", + "description": "Time window specified for hourly operations.", + "type": "object", + "properties": { + "hoursInCycle": { + "description": "Defines a schedule with units measured in hours. The value determines how many hours pass between the start of each cycle.", + "type": "integer", + "format": "int32" + }, + "startTime": { + "description": "Time within the window to start the operations. It must be in format \"HH:MM\", where HH : [00-23] and MM : [00-00] GMT.", + "type": "string" + }, + "duration": { + "description": "[Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario.", + "type": "string" + } + } + }, + "ResourcePolicyDailyCycle": { + "id": "ResourcePolicyDailyCycle", + "description": "Time window specified for daily operations.", + "type": "object", + "properties": { + "daysInCycle": { + "description": "Defines a schedule with units measured in days. The value determines how many days pass between the start of each cycle.", + "type": "integer", + "format": "int32" + }, + "startTime": { + "description": "Start time of the window. This must be in UTC format that resolves to one of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 and 08:00 are valid.", + "type": "string" + }, + "duration": { + "description": "[Output only] A predetermined duration for the window, automatically chosen to be the smallest possible in the given scenario.", + "type": "string" + } + } + }, + "ResourcePolicyWeeklyCycle": { + "id": "ResourcePolicyWeeklyCycle", + "description": "Time window specified for weekly operations.", + "type": "object", + "properties": { + "dayOfWeeks": { + "description": "Up to 7 intervals/windows, one for each day of the week.", + "type": "array", + "items": { + "$ref": "ResourcePolicyWeeklyCycleDayOfWeek" + } + } + } + }, + "ResourcePolicyWeeklyCycleDayOfWeek": { + "id": "ResourcePolicyWeeklyCycleDayOfWeek", + "type": "object", + "properties": { + "day": { + "description": "Defines a schedule that runs on specific days of the week. Specify one or more days. The following options are available: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "" ], - "response": { - "$ref": "NotificationEndpointList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "FRIDAY", + "INVALID", + "MONDAY", + "SATURDAY", + "SUNDAY", + "THURSDAY", + "TUESDAY", + "WEDNESDAY" + ] + }, + "startTime": { + "description": "Time within the window to start the operations. It must be in format \"HH:MM\", where HH : [00-23] and MM : [00-00] GMT.", + "type": "string" + }, + "duration": { + "description": "[Output only] Duration of the time window, automatically chosen to be smallest possible in the given scenario.", + "type": "string" + } + } + }, + "ResourcePolicySnapshotSchedulePolicyRetentionPolicy": { + "id": "ResourcePolicySnapshotSchedulePolicyRetentionPolicy", + "description": "Policy for retention of scheduled snapshots.", + "type": "object", + "properties": { + "maxRetentionDays": { + "description": "Maximum age of the snapshot that is allowed to be kept.", + "type": "integer", + "format": "int32" + }, + "onSourceDiskDelete": { + "description": "Specifies the behavior to apply to scheduled snapshots when the source disk is deleted.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "description": "Lists the NotificationEndpoints for a project in the given region." + "enum": [ + "APPLY_RETENTION_POLICY", + "KEEP_AUTO_SNAPSHOTS", + "UNSPECIFIED_ON_SOURCE_DISK_DELETE" + ] + } + } + }, + "ResourcePolicySnapshotSchedulePolicySnapshotProperties": { + "id": "ResourcePolicySnapshotSchedulePolicySnapshotProperties", + "description": "Specified snapshot properties for scheduled snapshots created by this policy.", + "type": "object", + "properties": { + "labels": { + "description": "Labels to apply to scheduled snapshots. These can be later modified by the setLabels method. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "storageLocations": { + "description": "Cloud Storage bucket storage location of the auto snapshot (regional or multi-regional).", + "type": "array", + "items": { + "type": "string" + } + }, + "guestFlush": { + "description": "Indication to perform a 'guest aware' snapshot.", + "type": "boolean" + }, + "chainName": { + "description": "Chain name that the snapshot is created in.", + "type": "string" + } + } + }, + "ResourcePolicyGroupPlacementPolicy": { + "id": "ResourcePolicyGroupPlacementPolicy", + "description": "A GroupPlacementPolicy specifies resource placement configuration. It specifies the failure bucket separation", + "type": "object", + "properties": { + "vmCount": { + "description": "Number of VMs in this placement group. Google does not recommend that you use this field unless you use a compact policy and you want your policy to work only if it contains this exact number of VMs.", + "type": "integer", + "format": "int32" + }, + "availabilityDomainCount": { + "description": "The number of availability domains to spread instances across. If two instances are in different availability domain, they are not in the same low latency network.", + "type": "integer", + "format": "int32" }, - "get": { - "id": "compute.regionNotificationEndpoints.get", - "path": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", - "flatPath": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", - "httpMethod": "GET", - "parameters": { - "notificationEndpoint": { - "description": "Name of the NotificationEndpoint resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "notificationEndpoint" - ], - "response": { - "$ref": "NotificationEndpoint" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "collocation": { + "description": "Specifies network collocation", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Returns the specified NotificationEndpoint resource in the given region." + "enum": [ + "COLLOCATED", + "UNSPECIFIED_COLLOCATION" + ] + } + } + }, + "ResourcePolicyInstanceSchedulePolicy": { + "id": "ResourcePolicyInstanceSchedulePolicy", + "description": "An InstanceSchedulePolicy specifies when and how frequent certain operations are performed on the instance.", + "type": "object", + "properties": { + "vmStartSchedule": { + "description": "Specifies the schedule for starting instances.", + "$ref": "ResourcePolicyInstanceSchedulePolicySchedule" }, - "insert": { - "id": "compute.regionNotificationEndpoints.insert", - "path": "projects/{project}/regions/{region}/notificationEndpoints", - "flatPath": "projects/{project}/regions/{region}/notificationEndpoints", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "NotificationEndpoint" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Create a NotificationEndpoint in the specified project in the given region using the parameters that are included in the request." + "vmStopSchedule": { + "description": "Specifies the schedule for stopping instances.", + "$ref": "ResourcePolicyInstanceSchedulePolicySchedule" }, - "delete": { - "id": "compute.regionNotificationEndpoints.delete", - "path": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", - "flatPath": "projects/{project}/regions/{region}/notificationEndpoints/{notificationEndpoint}", - "httpMethod": "DELETE", - "parameters": { - "notificationEndpoint": { - "description": "Name of the NotificationEndpoint resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "notificationEndpoint" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified NotificationEndpoint in the given region" + "timeZone": { + "description": "Specifies the time zone to be used in interpreting Schedule.schedule. The value of this field must be a time zone name from the tz database: https://wikipedia.org/wiki/Tz_database.", + "type": "string" + }, + "startTime": { + "description": "The start time of the schedule. The timestamp is an RFC3339 string.", + "type": "string" + }, + "expirationTime": { + "description": "The expiration time of the schedule. The timestamp is an RFC3339 string.", + "type": "string" } } }, - "packetMirrorings": { - "methods": { - "get": { - "id": "compute.packetMirrorings.get", - "path": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", - "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", - "httpMethod": "GET", - "parameters": { - "packetMirroring": { - "description": "Name of the PacketMirroring resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "packetMirroring" - ], - "response": { - "$ref": "PacketMirroring" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified PacketMirroring resource." + "ResourcePolicyInstanceSchedulePolicySchedule": { + "id": "ResourcePolicyInstanceSchedulePolicySchedule", + "description": "Schedule for an instance operation.", + "type": "object", + "properties": { + "schedule": { + "description": "Specifies the frequency for the operation, using the unix-cron format.", + "type": "string" + } + } + }, + "ResourcePolicyDiskConsistencyGroupPolicy": { + "id": "ResourcePolicyDiskConsistencyGroupPolicy", + "description": "Resource policy for disk consistency groups.", + "type": "object", + "properties": {} + }, + "ResourcePolicyResourceStatus": { + "id": "ResourcePolicyResourceStatus", + "description": "Contains output only fields. Use this sub-message for all output fields set on ResourcePolicy. The internal structure of this \"status\" field should mimic the structure of ResourcePolicy proto specification.", + "type": "object", + "properties": { + "instanceSchedulePolicy": { + "description": "[Output Only] Specifies a set of output values reffering to the instance_schedule_policy system status. This field should have the same name as corresponding policy field.", + "$ref": "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus" + } + } + }, + "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus": { + "id": "ResourcePolicyResourceStatusInstanceSchedulePolicyStatus", + "type": "object", + "properties": { + "nextRunStartTime": { + "description": "[Output Only] The next time the schedule is planned to run. The actual time might be slightly different. The timestamp is an RFC3339 string.", + "type": "string" }, - "insert": { - "id": "compute.packetMirrorings.insert", - "path": "projects/{project}/regions/{region}/packetMirrorings", - "flatPath": "projects/{project}/regions/{region}/packetMirrorings", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "PacketMirroring" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a PacketMirroring resource in the specified project and region using the data included in the request." + "lastRunStartTime": { + "description": "[Output Only] The last time the schedule successfully ran. The timestamp is an RFC3339 string.", + "type": "string" + } + } + }, + "ResourcePolicyAggregatedList": { + "id": "ResourcePolicyAggregatedList", + "description": "Contains a list of resourcePolicies.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#resourcePolicyAggregatedList", + "type": "string" }, - "patch": { - "id": "compute.packetMirrorings.patch", - "path": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", - "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", - "httpMethod": "PATCH", - "parameters": { - "packetMirroring": { - "description": "Name of the PacketMirroring resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "packetMirroring" - ], - "request": { - "$ref": "PacketMirroring" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified PacketMirroring resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "delete": { - "id": "compute.packetMirrorings.delete", - "path": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", - "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{packetMirroring}", - "httpMethod": "DELETE", - "parameters": { - "packetMirroring": { - "description": "Name of the PacketMirroring resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "packetMirroring" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified PacketMirroring resource." + "items": { + "description": "A list of ResourcePolicy resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of resourcePolicies.", + "$ref": "ResourcePoliciesScopedList" + } }, - "list": { - "id": "compute.packetMirrorings.list", - "path": "projects/{project}/regions/{region}/packetMirrorings", - "flatPath": "projects/{project}/regions/{region}/packetMirrorings", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "PacketMirroringList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of PacketMirroring resources available to the specified project and region." + } }, - "aggregatedList": { - "id": "compute.packetMirrorings.aggregatedList", - "path": "projects/{project}/aggregated/packetMirrorings", - "flatPath": "projects/{project}/aggregated/packetMirrorings", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "PacketMirroringAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of packetMirrorings. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "etag": { + "type": "string" }, - "testIamPermissions": { - "id": "compute.packetMirrorings.testIamPermissions", - "path": "projects/{project}/regions/{region}/packetMirrorings/{resource}/testIamPermissions", - "flatPath": "projects/{project}/regions/{region}/packetMirrorings/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "ResourcePoliciesScopedList": { + "id": "ResourcePoliciesScopedList", + "type": "object", + "properties": { + "resourcePolicies": { + "description": "A list of resourcePolicies contained in this scope.", + "type": "array", + "items": { + "$ref": "ResourcePolicy" + } + }, + "warning": { + "description": "Informational warning which replaces the list of resourcePolicies when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + } } } }, - "projects": { - "methods": { - "get": { - "id": "compute.projects.get", - "path": "projects/{project}", - "flatPath": "projects/{project}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "Project" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified Project resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request." + "RouteList": { + "id": "RouteList", + "description": "Contains a list of Route resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#routeList", + "type": "string" }, - "setCommonInstanceMetadata": { - "id": "compute.projects.setCommonInstanceMetadata", - "path": "projects/{project}/setCommonInstanceMetadata", - "flatPath": "projects/{project}/setCommonInstanceMetadata", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "Metadata" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets metadata common to all instances within the specified project using the data included in the request." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "setUsageExportBucket": { - "id": "compute.projects.setUsageExportBucket", - "path": "projects/{project}/setUsageExportBucket", - "flatPath": "projects/{project}/setUsageExportBucket", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of Route resources.", + "type": "array", + "items": { + "$ref": "Route" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "UsageExportLocation" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/devstorage.full_control", - "https://www.googleapis.com/auth/devstorage.read_only", - "https://www.googleapis.com/auth/devstorage.read_write" - ], - "description": "Enables the usage export feature and sets the usage export bucket where reports are stored. If you provide an empty request body using this method, the usage export feature will be disabled." - }, - "moveInstance": { - "id": "compute.projects.moveInstance", - "path": "projects/{project}/moveInstance", - "flatPath": "projects/{project}/moveInstance", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "InstanceMoveRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "deprecated": true, - "description": "Moves an instance and its attached persistent disks from one zone to another. *Note*: Moving VMs or disks by using this method might cause unexpected behavior. For more information, see the [known issue](/compute/docs/troubleshooting/known-issues#moving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior). [Deprecated] This method is deprecated. See [moving instance across zones](/compute/docs/instances/moving-instance-across-zones) instead." + } + } + } + }, + "Route": { + "id": "Route", + "description": "Represents a Route resource. A route defines a path from VM instances in the VPC network to a specific destination. This destination can be inside or outside the VPC network. For more information, read the Routes overview.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of this resource. Always compute#routes for Route resources.", + "default": "compute#route", + "type": "string" }, - "moveDisk": { - "id": "compute.projects.moveDisk", - "path": "projects/{project}/moveDisk", - "flatPath": "projects/{project}/moveDisk", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "DiskMoveRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Moves a persistent disk from one zone to another." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "listXpnHosts": { - "id": "compute.projects.listXpnHosts", - "path": "projects/{project}/listXpnHosts", - "flatPath": "projects/{project}/listXpnHosts", - "httpMethod": "POST", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "ProjectsListXpnHostsRequest" - }, - "response": { - "$ref": "XpnHostList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Lists all shared VPC host projects visible to the user in an organization." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "enableXpnHost": { - "id": "compute.projects.enableXpnHost", - "path": "projects/{project}/enableXpnHost", - "flatPath": "projects/{project}/enableXpnHost", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "Operation" + "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])?`. The first character must be a lowercase letter, and all following characters (except for the last character) must be a dash, lowercase letter, or digit. The last character must be a lowercase letter or digit.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "annotations": { + "required": [ + "compute.routes.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Enable this project as a shared VPC host project." + "type": "string" }, - "disableXpnHost": { - "id": "compute.projects.disableXpnHost", - "path": "projects/{project}/disableXpnHost", - "flatPath": "projects/{project}/disableXpnHost", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "Operation" + "description": { + "description": "An optional description of this resource. Provide this field when you create the resource.", + "type": "string" + }, + "network": { + "description": "Fully-qualified URL of the network that this route applies to.", + "annotations": { + "required": [ + "compute.routes.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Disable this project as a shared VPC host project." + "type": "string" }, - "enableXpnResource": { - "id": "compute.projects.enableXpnResource", - "path": "projects/{project}/enableXpnResource", - "flatPath": "projects/{project}/enableXpnResource", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } + "tags": { + "description": "A list of instance tags to which this route applies.", + "annotations": { + "required": [ + "compute.routes.insert" + ] }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "ProjectsEnableXpnResourceRequest" + "type": "array", + "items": { + "type": "string" + } + }, + "destRange": { + "description": "The destination range of outgoing packets that this route applies to. Both IPv4 and IPv6 are supported. Must specify an IPv4 range (e.g. 192.0.2.0/24) or an IPv6 range in RFC 4291 format (e.g. 2001:db8::/32). IPv6 range will be displayed using RFC 5952 compressed format.", + "annotations": { + "required": [ + "compute.routes.insert" + ] }, - "response": { - "$ref": "Operation" + "type": "string" + }, + "priority": { + "description": "The priority of this route. Priority is used to break ties in cases where there is more than one matching route of equal prefix length. In cases where multiple routes have equal prefix length, the one with the lowest-numbered priority value wins. The default value is `1000`. The priority value must be from `0` to `65535`, inclusive.", + "annotations": { + "required": [ + "compute.routes.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Enable service resource (a.k.a service project) for a host project, so that subnets in the host project can be used by instances in the service project." + "type": "integer", + "format": "uint32" }, - "disableXpnResource": { - "id": "compute.projects.disableXpnResource", - "path": "projects/{project}/disableXpnResource", - "flatPath": "projects/{project}/disableXpnResource", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "nextHopInstance": { + "description": "The URL to an instance that should handle matching packets. You can specify this as a full or partial URL. For example: https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/", + "type": "string" + }, + "nextHopIp": { + "description": "The network IP address of an instance that should handle matching packets. Both IPv6 address and IPv4 addresses are supported. Must specify an IPv4 address in dot-decimal notation (e.g. 192.0.2.99) or an IPv6 address in RFC 4291 format (e.g. 2001:db8::2d9:51:0:0 or 2001:db8:0:0:2d9:51:0:0). IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.", + "type": "string" + }, + "nextHopNetwork": { + "description": "The URL of the local network if it should handle matching packets.", + "type": "string" + }, + "nextHopGateway": { + "description": "The URL to a gateway that should handle matching packets. You can only specify the internet gateway using a full or partial valid URL: projects/ project/global/gateways/default-internet-gateway", + "type": "string" + }, + "nextHopPeering": { + "description": "[Output Only] The network peering name that should handle matching packets, which should conform to RFC1035.", + "type": "string" + }, + "nextHopIlb": { + "description": "The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that should handle matching packets or the IP address of the forwarding Rule. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/regions/region /forwardingRules/forwardingRule - regions/region/forwardingRules/forwardingRule If an IP address is provided, must specify an IPv4 address in dot-decimal notation or an IPv6 address in RFC 4291 format. For example, the following are all valid IP addresses: - 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses will be displayed using RFC 5952 compressed format (e.g. 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address.", + "type": "string" + }, + "warnings": { + "description": "[Output Only] If potential misconfigurations are detected for this route, this field will be populated with warning messages.", + "type": "array", + "items": { + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "ProjectsDisableXpnResourceRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Disable a service resource (also known as service project) associated with this host project." + } + }, + "nextHopVpnTunnel": { + "description": "The URL to a VpnTunnel that should handle matching packets.", + "type": "string" + }, + "nextHopHub": { + "description": "[Output Only] The full resource name of the Network Connectivity Center hub that will handle matching packets.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined fully-qualified URL for this resource.", + "type": "string" }, - "getXpnHost": { - "id": "compute.projects.getXpnHost", - "path": "projects/{project}/getXpnHost", - "flatPath": "projects/{project}/getXpnHost", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "Project" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "routeType": { + "description": "[Output Only] The type of this route, which can be one of the following values: - 'TRANSIT' for a transit route that this router learned from another Cloud Router and will readvertise to one of its BGP peers - 'SUBNET' for a route from a subnet of the VPC - 'BGP' for a route learned from a BGP peer of this router - 'STATIC' for a static route", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Gets the shared VPC host project that this project links to. May be empty if no link exists." + "enum": [ + "BGP", + "STATIC", + "SUBNET", + "TRANSIT" + ] }, - "getXpnResources": { - "id": "compute.projects.getXpnResources", - "path": "projects/{project}/getXpnResources", - "flatPath": "projects/{project}/getXpnResources", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ProjectsGetXpnResources" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Gets service resources (a.k.a service project) associated with this host project." + "asPaths": { + "description": "[Output Only] AS path.", + "type": "array", + "items": { + "$ref": "RouteAsPath" + } }, - "setDefaultNetworkTier": { - "id": "compute.projects.setDefaultNetworkTier", - "path": "projects/{project}/setDefaultNetworkTier", - "flatPath": "projects/{project}/setDefaultNetworkTier", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" + "routeStatus": { + "description": "[Output only] The status of the route.", + "type": "string", + "enumDescriptions": [ + "This route is processed and active.", + "The route is dropped due to the VPC exceeding the dynamic route limit. For dynamic route limit, please refer to the Learned route example", + "This route is processed but inactive due to failure from the backend. The backend may have rejected the route", + "This route is being processed internally. The status will change once processed." ], - "request": { - "$ref": "ProjectsSetDefaultNetworkTierRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ACTIVE", + "DROPPED", + "INACTIVE", + "PENDING" + ] + } + } + }, + "RouteAsPath": { + "id": "RouteAsPath", + "type": "object", + "properties": { + "pathSegmentType": { + "description": "[Output Only] The type of the AS Path, which can be one of the following values: - 'AS_SET': unordered set of autonomous systems that the route in has traversed - 'AS_SEQUENCE': ordered set of autonomous systems that the route has traversed - 'AS_CONFED_SEQUENCE': ordered set of Member Autonomous Systems in the local confederation that the route has traversed - 'AS_CONFED_SET': unordered set of Member Autonomous Systems in the local confederation that the route has traversed ", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Sets the default network tier of the project. The default network tier is used when an address/forwardingRule/instance is created without specifying the network tier field." + "enum": [ + "AS_CONFED_SEQUENCE", + "AS_CONFED_SET", + "AS_SEQUENCE", + "AS_SET" + ] }, - "setCloudArmorTier": { - "id": "compute.projects.setCloudArmorTier", - "path": "projects/{project}/setCloudArmorTier", - "flatPath": "projects/{project}/setCloudArmorTier", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "ProjectsSetCloudArmorTierRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the Cloud Armor tier of the project. To set ENTERPRISE or above the billing account of the project must be subscribed to Cloud Armor Enterprise. See Subscribing to Cloud Armor Enterprise for more information." + "asLists": { + "description": "[Output Only] The AS numbers of the AS Path.", + "type": "array", + "items": { + "type": "integer", + "format": "uint32" + } } } }, - "publicAdvertisedPrefixes": { - "methods": { - "list": { - "id": "compute.publicAdvertisedPrefixes.list", - "path": "projects/{project}/global/publicAdvertisedPrefixes", - "flatPath": "projects/{project}/global/publicAdvertisedPrefixes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "PublicAdvertisedPrefixList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the PublicAdvertisedPrefixes for a project." + "Router": { + "id": "Router", + "description": "Represents a Cloud Router resource. For more information about Cloud Router, read the Cloud Router overview.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#router for routers.", + "default": "compute#router", + "type": "string" }, - "get": { - "id": "compute.publicAdvertisedPrefixes.get", - "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", - "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicAdvertisedPrefix": { - "description": "Name of the PublicAdvertisedPrefix resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "publicAdvertisedPrefix" - ], - "response": { - "$ref": "PublicAdvertisedPrefix" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified PublicAdvertisedPrefix resource." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "insert": { - "id": "compute.publicAdvertisedPrefixes.insert", - "path": "projects/{project}/global/publicAdvertisedPrefixes", - "flatPath": "projects/{project}/global/publicAdvertisedPrefixes", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "PublicAdvertisedPrefix" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a PublicAdvertisedPrefix in the specified project using the parameters that are included in the request." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "delete": { - "id": "compute.publicAdvertisedPrefixes.delete", - "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", - "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicAdvertisedPrefix": { - "description": "Name of the PublicAdvertisedPrefix resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "publicAdvertisedPrefix" - ], - "response": { - "$ref": "Operation" + "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])?", + "annotations": { + "required": [ + "compute.routers.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified PublicAdvertisedPrefix" + "type": "string" }, - "patch": { - "id": "compute.publicAdvertisedPrefixes.patch", - "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", - "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicAdvertisedPrefix": { - "description": "Name of the PublicAdvertisedPrefix resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "publicAdvertisedPrefix" - ], - "request": { - "$ref": "PublicAdvertisedPrefix" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified Router resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" }, - "announce": { - "id": "compute.publicAdvertisedPrefixes.announce", - "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/announce", - "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/announce", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicAdvertisedPrefix": { - "description": "The name of the public advertised prefix. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "publicAdvertisedPrefix" - ], - "response": { - "$ref": "Operation" + "region": { + "description": "[Output Only] URI of the region where the router resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "network": { + "description": "URI of the network to which this router belongs.", + "annotations": { + "required": [ + "compute.routers.insert", + "compute.routers.update" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Announces the specified PublicAdvertisedPrefix" + "type": "string" + }, + "interfaces": { + "description": "Router interfaces. To create a BGP peer that uses a router interface, the interface must have one of the following fields specified: - linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create a router interface without any of these fields specified. However, you cannot create a BGP peer that uses that interface.", + "type": "array", + "items": { + "$ref": "RouterInterface" + } + }, + "bgpPeers": { + "description": "BGP information that must be configured into the routing stack to establish BGP peering. This information must specify the peer ASN and either the interface name, IP address, or peer IP address. Please refer to RFC4273.", + "type": "array", + "items": { + "$ref": "RouterBgpPeer" + } + }, + "bgp": { + "description": "BGP information specific to this router.", + "$ref": "RouterBgp" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "nats": { + "description": "A list of NAT services created in this router.", + "type": "array", + "items": { + "$ref": "RouterNat" + } + }, + "encryptedInterconnectRouter": { + "description": "Indicates if a router is dedicated for use with encrypted VLAN attachments (interconnectAttachments).", + "type": "boolean" }, - "withdraw": { - "id": "compute.publicAdvertisedPrefixes.withdraw", - "path": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/withdraw", - "flatPath": "projects/{project}/global/publicAdvertisedPrefixes/{publicAdvertisedPrefix}/withdraw", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicAdvertisedPrefix": { - "description": "The name of the public advertised prefix. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "publicAdvertisedPrefix" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Withdraws the specified PublicAdvertisedPrefix" + "md5AuthenticationKeys": { + "description": "Keys used for MD5 authentication.", + "type": "array", + "items": { + "$ref": "RouterMd5AuthenticationKey" + } } } }, - "globalPublicDelegatedPrefixes": { - "methods": { - "list": { - "id": "compute.globalPublicDelegatedPrefixes.list", - "path": "projects/{project}/global/publicDelegatedPrefixes", - "flatPath": "projects/{project}/global/publicDelegatedPrefixes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "PublicDelegatedPrefixList" + "RouterInterface": { + "id": "RouterInterface", + "type": "object", + "properties": { + "name": { + "description": "Name of this interface entry. 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])?", + "annotations": { + "required": [ + "compute.routers.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the global PublicDelegatedPrefixes for a project." + "type": "string" }, - "get": { - "id": "compute.globalPublicDelegatedPrefixes.get", - "path": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicDelegatedPrefix": { - "description": "Name of the PublicDelegatedPrefix resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "publicDelegatedPrefix" - ], - "response": { - "$ref": "PublicDelegatedPrefix" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "linkedVpnTunnel": { + "description": "URI of the linked VPN tunnel, which must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.", + "type": "string" + }, + "linkedInterconnectAttachment": { + "description": "URI of the linked Interconnect attachment. It must be in the same region as the router. Each interface can have one linked resource, which can be a VPN tunnel, an Interconnect attachment, or a subnetwork.", + "type": "string" + }, + "ipRange": { + "description": "IP address and range of the interface. - For Internet Protocol version 4 (IPv4), the IP range must be in the RFC3927 link-local IP address space. The value must be a CIDR-formatted string, for example, 169.254.0.1/30. Note: Do not truncate the IP address, as it represents the IP address of the interface. - For Internet Protocol version 6 (IPv6), the value must be a unique local address (ULA) range from fdff:1::/64 with a mask length of 126 or less. This value should be a CIDR-formatted string, for example, fc00:0:1:1::1/112. Within the router's VPC, this IPv6 prefix will be reserved exclusively for this connection and cannot be used for any other purpose. ", + "type": "string" + }, + "managementType": { + "description": "[Output Only] The resource that configures and manages this interface. - MANAGED_BY_USER is the default value and can be managed directly by users. - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by Cloud Interconnect, specifically, by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of interface when the PARTNER InterconnectAttachment is created, updated, or deleted. ", + "type": "string", + "enumDescriptions": [ + "The interface is automatically created for PARTNER type InterconnectAttachment, Google will automatically create/update/delete this interface when the PARTNER InterconnectAttachment is created/provisioned/deleted. This type of interface cannot be manually managed by user.", + "Default value, the interface is manually created and managed by user." ], - "description": "Returns the specified global PublicDelegatedPrefix resource." + "enum": [ + "MANAGED_BY_ATTACHMENT", + "MANAGED_BY_USER" + ] }, - "insert": { - "id": "compute.globalPublicDelegatedPrefixes.insert", - "path": "projects/{project}/global/publicDelegatedPrefixes", - "flatPath": "projects/{project}/global/publicDelegatedPrefixes", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" + "privateIpAddress": { + "description": "The regional private internal IP address that is used to establish BGP sessions to a VM instance acting as a third-party Router Appliance, such as a Next Gen Firewall, a Virtual Router, or an SD-WAN VM.", + "type": "string" + }, + "redundantInterface": { + "description": "Name of the interface that will be redundant with the current interface you are creating. The redundantInterface must belong to the same Cloud Router as the interface here. To establish the BGP session to a Router Appliance VM, you must create two BGP peers. The two BGP peers must be attached to two separate interfaces that are redundant with each other. The redundant_interface must be 1-63 characters long, and comply with RFC1035. Specifically, the redundant_interface 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" + }, + "subnetwork": { + "description": "The URI of the subnetwork resource that this interface belongs to, which must be in the same region as the Cloud Router. When you establish a BGP session to a VM instance using this interface, the VM instance must belong to the same subnetwork as the subnetwork specified here.", + "type": "string" + }, + "ipVersion": { + "description": "IP version of this interface.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "request": { - "$ref": "PublicDelegatedPrefix" + "enum": [ + "IPV4", + "IPV6" + ] + } + } + }, + "RouterBgpPeer": { + "id": "RouterBgpPeer", + "type": "object", + "properties": { + "name": { + "description": "Name of this BGP peer. 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])?", + "annotations": { + "required": [ + "compute.routers.insert" + ] }, - "response": { - "$ref": "Operation" + "type": "string" + }, + "interfaceName": { + "description": "Name of the interface the BGP peer is associated with.", + "type": "string" + }, + "ipAddress": { + "description": "IP address of the interface inside Google Cloud Platform.", + "type": "string" + }, + "peerIpAddress": { + "description": "IP address of the BGP interface outside Google Cloud Platform.", + "type": "string" + }, + "peerAsn": { + "description": "Peer BGP Autonomous System Number (ASN). Each BGP interface may use a different value.", + "annotations": { + "required": [ + "compute.routers.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "integer", + "format": "uint32" + }, + "advertisedRoutePriority": { + "description": "The priority of routes advertised to this BGP peer. Where there is more than one matching route of maximum length, the routes with the lowest priority value win.", + "type": "integer", + "format": "uint32" + }, + "advertiseMode": { + "description": "User-specified flag to indicate which mode to use for advertisement.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Creates a global PublicDelegatedPrefix in the specified project using the parameters that are included in the request." + "enum": [ + "CUSTOM", + "DEFAULT" + ] }, - "delete": { - "id": "compute.globalPublicDelegatedPrefixes.delete", - "path": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicDelegatedPrefix": { - "description": "Name of the PublicDelegatedPrefix resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "publicDelegatedPrefix" + "advertisedGroups": { + "description": "User-specified list of prefix groups to advertise in custom mode, which currently supports the following option: - ALL_SUBNETS: Advertises all of the router's own VPC subnets. This excludes any routes learned for subnets that use VPC Network Peering. Note that this field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the \"bgp\" message). These groups are advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.", + "type": "array", + "items": { + "type": "string", + "enumDescriptions": [ + "Advertise all available subnets (including peer VPC subnets)." + ], + "enum": [ + "ALL_SUBNETS" + ] + } + }, + "advertisedIpRanges": { + "description": "User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and overrides the list defined for the router (in the \"bgp\" message). These IP ranges are advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges.", + "type": "array", + "items": { + "$ref": "RouterAdvertisedIpRange" + } + }, + "managementType": { + "description": "[Output Only] The resource that configures and manages this BGP peer. - MANAGED_BY_USER is the default value and can be managed by you or other users - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed by Cloud Interconnect, specifically by an InterconnectAttachment of type PARTNER. Google automatically creates, updates, and deletes this type of BGP peer when the PARTNER InterconnectAttachment is created, updated, or deleted. ", + "type": "string", + "enumDescriptions": [ + "The BGP peer is automatically created for PARTNER type InterconnectAttachment; Google will automatically create/delete this BGP peer when the PARTNER InterconnectAttachment is created/deleted, and Google will update the ipAddress and peerIpAddress when the PARTNER InterconnectAttachment is provisioned. This type of BGP peer cannot be created or deleted, but can be modified for all fields except for name, ipAddress and peerIpAddress.", + "Default value, the BGP peer is manually created and managed by user." ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "MANAGED_BY_ATTACHMENT", + "MANAGED_BY_USER" + ] + }, + "enable": { + "description": "The status of the BGP peer connection. If set to FALSE, any active session with the peer is terminated and all associated routing information is removed. If set to TRUE, the peer connection can be established with routing information. The default is TRUE.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Deletes the specified global PublicDelegatedPrefix." + "enum": [ + "FALSE", + "TRUE" + ] }, - "patch": { - "id": "compute.globalPublicDelegatedPrefixes.patch", - "path": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "flatPath": "projects/{project}/global/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicDelegatedPrefix": { - "description": "Name of the PublicDelegatedPrefix resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "publicDelegatedPrefix" + "bfd": { + "description": "BFD configuration for the BGP peering.", + "$ref": "RouterBgpPeerBfd" + }, + "routerApplianceInstance": { + "description": "URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance must be located in zones contained in the same region as this Cloud Router. The VM instance is the peer side of the BGP session.", + "type": "string" + }, + "enableIpv6": { + "description": "Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6.", + "type": "boolean" + }, + "ipv6NexthopAddress": { + "description": "IPv6 address of the interface inside Google Cloud Platform.", + "type": "string" + }, + "peerIpv6NexthopAddress": { + "description": "IPv6 address of the BGP interface outside Google Cloud Platform.", + "type": "string" + }, + "md5AuthenticationKeyName": { + "description": "Present if MD5 authentication is enabled for the peering. Must be the name of one of the entries in the Router.md5_authentication_keys. The field must comply with RFC1035.", + "type": "string" + }, + "customLearnedRoutePriority": { + "description": "The user-defined custom learned route priority for a BGP session. This value is applied to all custom learned route ranges for the session. You can choose a value from `0` to `65335`. If you don't provide a value, Google Cloud assigns a priority of `100` to the ranges.", + "type": "integer", + "format": "int32" + }, + "customLearnedIpRanges": { + "description": "A list of user-defined custom learned route IP address ranges for a BGP session.", + "type": "array", + "items": { + "$ref": "RouterBgpPeerCustomLearnedIpRange" + } + }, + "enableIpv4": { + "description": "Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.", + "type": "boolean" + }, + "ipv4NexthopAddress": { + "description": "IPv4 address of the interface inside Google Cloud Platform.", + "type": "string" + }, + "peerIpv4NexthopAddress": { + "description": "IPv4 address of the BGP interface outside Google Cloud Platform.", + "type": "string" + }, + "exportPolicies": { + "description": "List of export policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_EXPORT type. Note that Route Policies are currently available in preview. Please use Beta API to use Route Policies.", + "type": "array", + "items": { + "type": "string" + } + }, + "importPolicies": { + "description": "List of import policies applied to this peer, in the order they must be evaluated. The name must correspond to an existing policy that has ROUTE_POLICY_TYPE_IMPORT type. Note that Route Policies are currently available in preview. Please use Beta API to use Route Policies.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "RouterAdvertisedIpRange": { + "id": "RouterAdvertisedIpRange", + "description": "Description-tagged IP ranges for the router to advertise.", + "type": "object", + "properties": { + "range": { + "description": "The IP range to advertise. The value must be a CIDR-formatted string.", + "type": "string" + }, + "description": { + "description": "User-specified description for the IP range.", + "type": "string" + } + } + }, + "RouterBgpPeerBfd": { + "id": "RouterBgpPeerBfd", + "type": "object", + "properties": { + "sessionInitializationMode": { + "description": "The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer. The default is DISABLED.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "request": { - "$ref": "PublicDelegatedPrefix" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ACTIVE", + "DISABLED", + "PASSIVE" + ] + }, + "minTransmitInterval": { + "description": "The minimum interval, in milliseconds, between BFD control packets transmitted to the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the corresponding receive interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000.", + "type": "integer", + "format": "uint32" + }, + "minReceiveInterval": { + "description": "The minimum interval, in milliseconds, between BFD control packets received from the peer router. The actual value is negotiated between the two routers and is equal to the greater of this value and the transmit interval of the other router. If set, this value must be between 1000 and 30000. The default is 1000.", + "type": "integer", + "format": "uint32" + }, + "multiplier": { + "description": "The number of consecutive BFD packets that must be missed before BFD declares that a peer is unavailable. If set, the value must be a value between 5 and 16. The default is 5.", + "type": "integer", + "format": "uint32" + } + } + }, + "RouterBgpPeerCustomLearnedIpRange": { + "id": "RouterBgpPeerCustomLearnedIpRange", + "type": "object", + "properties": { + "range": { + "description": "The custom learned route IP address range. Must be a valid CIDR-formatted prefix. If an IP address is provided without a subnet mask, it is interpreted as, for IPv4, a `/32` singular IP address range, and, for IPv6, `/128`.", + "type": "string" + } + } + }, + "RouterBgp": { + "id": "RouterBgp", + "type": "object", + "properties": { + "asn": { + "description": "Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, either 16-bit or 32-bit. The value will be fixed for this router resource. All VPN tunnels that link to this router will have the same local ASN.", + "type": "integer", + "format": "uint32" + }, + "advertiseMode": { + "description": "User-specified flag to indicate which mode to use for advertisement. The options are DEFAULT or CUSTOM.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Patches the specified global PublicDelegatedPrefix resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + "enum": [ + "CUSTOM", + "DEFAULT" + ] + }, + "advertisedGroups": { + "description": "User-specified list of prefix groups to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These groups will be advertised in addition to any specified prefixes. Leave this field blank to advertise no custom groups.", + "type": "array", + "items": { + "type": "string", + "enumDescriptions": [ + "Advertise all available subnets (including peer VPC subnets)." + ], + "enum": [ + "ALL_SUBNETS" + ] + } + }, + "advertisedIpRanges": { + "description": "User-specified list of individual IP ranges to advertise in custom mode. This field can only be populated if advertise_mode is CUSTOM and is advertised to all peers of the router. These IP ranges will be advertised in addition to any specified groups. Leave this field blank to advertise no custom IP ranges.", + "type": "array", + "items": { + "$ref": "RouterAdvertisedIpRange" + } + }, + "keepaliveInterval": { + "description": "The interval in seconds between BGP keepalive messages that are sent to the peer. Hold time is three times the interval at which keepalive messages are sent, and the hold time is the maximum number of seconds allowed to elapse between successive keepalive messages that BGP receives from a peer. BGP will use the smaller of either the local hold time value or the peer's hold time value as the hold time for the BGP connection between the two peers. If set, this value must be between 20 and 60. The default is 20.", + "type": "integer", + "format": "uint32" + }, + "identifierRange": { + "description": "Explicitly specifies a range of valid BGP Identifiers for this Router. It is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at least /30, even if the BGP sessions are over IPv6. It must not overlap with any IPv4 BGP session ranges. Other vendors commonly call this \"router ID\".", + "type": "string" } } }, - "publicDelegatedPrefixes": { - "methods": { - "list": { - "id": "compute.publicDelegatedPrefixes.list", - "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes", - "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "PublicDelegatedPrefixList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the PublicDelegatedPrefixes for a project in the given region." + "RouterNat": { + "id": "RouterNat", + "description": "Represents a Nat resource. It enables the VMs within the specified subnetworks to access Internet without external IP addresses. It specifies a list of subnetworks (and the ranges within) that want to use NAT. Customers can also provide the external IPs that would be used for NAT. GCP would auto-allocate ephemeral IPs if no external IPs are provided.", + "type": "object", + "properties": { + "name": { + "description": "Unique name of this Nat service. 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" }, - "get": { - "id": "compute.publicDelegatedPrefixes.get", - "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicDelegatedPrefix": { - "description": "Name of the PublicDelegatedPrefix resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "publicDelegatedPrefix" - ], - "response": { - "$ref": "PublicDelegatedPrefix" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": { + "description": "Indicates whether this NAT is used for public or private IP translation. If unspecified, it defaults to PUBLIC.", + "type": "string", + "enumDescriptions": [ + "NAT used for private IP translation.", + "NAT used for public IP translation. This is the default." ], - "description": "Returns the specified PublicDelegatedPrefix resource in the given region." + "enum": [ + "PRIVATE", + "PUBLIC" + ] }, - "insert": { - "id": "compute.publicDelegatedPrefixes.insert", - "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes", - "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "PublicDelegatedPrefix" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "autoNetworkTier": { + "description": "The network tier to use when automatically reserving NAT IP addresses. Must be one of: PREMIUM, STANDARD. If not specified, then the current project-level default tier is used.", + "type": "string", + "enumDescriptions": [ + "Public internet quality with fixed bandwidth.", + "High quality, Google-grade network tier, support for all networking products.", + "Public internet quality, only limited support for other networking products.", + "(Output only) Temporary tier for FIXED_STANDARD when fixed standard tier is expired or not configured." ], - "description": "Creates a PublicDelegatedPrefix in the specified project in the given region using the parameters that are included in the request." + "enum": [ + "FIXED_STANDARD", + "PREMIUM", + "STANDARD", + "STANDARD_OVERRIDES_FIXED_STANDARD" + ] }, - "delete": { - "id": "compute.publicDelegatedPrefixes.delete", - "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicDelegatedPrefix": { - "description": "Name of the PublicDelegatedPrefix resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "publicDelegatedPrefix" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified PublicDelegatedPrefix in the given region." + "endpointTypes": { + "description": "List of NAT-ted endpoint types supported by the Nat Gateway. If the list is empty, then it will be equivalent to include ENDPOINT_TYPE_VM", + "type": "array", + "items": { + "type": "string", + "enumDescriptions": [ + "This is used for regional Application Load Balancers (internal and external) and regional proxy Network Load Balancers (internal and external) endpoints.", + "This is used for Secure Web Gateway endpoints.", + "This is the default." + ], + "enum": [ + "ENDPOINT_TYPE_MANAGED_PROXY_LB", + "ENDPOINT_TYPE_SWG", + "ENDPOINT_TYPE_VM" + ] + } }, - "patch": { - "id": "compute.publicDelegatedPrefixes.patch", - "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicDelegatedPrefix": { - "description": "Name of the PublicDelegatedPrefix resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "publicDelegatedPrefix" - ], - "request": { - "$ref": "PublicDelegatedPrefix" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "sourceSubnetworkIpRangesToNat": { + "description": "Specify the Nat option, which can take one of the following values: - ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in the field subnetwork below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should not be any other Router.Nat section in any Router for this network in this region.", + "type": "string", + "enumDescriptions": [ + "All the IP ranges in every Subnetwork are allowed to Nat.", + "All the primary IP ranges in every Subnetwork are allowed to Nat.", + "A list of Subnetworks are allowed to Nat (specified in the field subnetwork below)" ], - "description": "Patches the specified PublicDelegatedPrefix resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + "enum": [ + "ALL_SUBNETWORKS_ALL_IP_RANGES", + "ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES", + "LIST_OF_SUBNETWORKS" + ] }, - "announce": { - "id": "compute.publicDelegatedPrefixes.announce", - "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/announce", - "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/announce", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicDelegatedPrefix": { - "description": "The name of the public delegated prefix. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region where the public delegated prefix is located. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "publicDelegatedPrefix" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "subnetworks": { + "description": "A list of Subnetwork resources whose traffic should be translated by NAT Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the SubnetworkIpRangeToNatOption above.", + "type": "array", + "items": { + "$ref": "RouterNatSubnetworkToNat" + } + }, + "natIps": { + "description": "A list of URLs of the IP resources used for this Nat service. These IP addresses must be valid static external IP addresses assigned to the project.", + "type": "array", + "items": { + "type": "string" + } + }, + "drainNatIps": { + "description": "A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT only.", + "type": "array", + "items": { + "type": "string" + } + }, + "natIpAllocateOption": { + "description": "Specify the NatIpAllocateOption, which can take one of the following values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. When there are not enough specified Nat IPs, the Nat service fails for new VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be empty. ", + "type": "string", + "enumDescriptions": [ + "Nat IPs are allocated by GCP; customers can not specify any Nat IPs.", + "Only use Nat IPs provided by customers. When specified Nat IPs are not enough then the Nat service fails for new VMs." ], - "description": "Announces the specified PublicDelegatedPrefix in the given region." + "enum": [ + "AUTO_ONLY", + "MANUAL_ONLY" + ] + }, + "minPortsPerVm": { + "description": "Minimum number of ports allocated to a VM from this NAT config. If not set, a default number of ports is allocated to a VM. This is rounded up to the nearest power of 2. For example, if the value of this field is 50, at least 64 ports are allocated to a VM.", + "type": "integer", + "format": "int32" + }, + "maxPortsPerVm": { + "description": "Maximum number of ports allocated to a VM from this NAT config when Dynamic Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this field has no effect. If Dynamic Port Allocation is enabled, and this field is set, it must be set to a power of two greater than minPortsPerVm, or 64 if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this field is not set, a maximum of 65536 ports will be allocated to a VM from this NAT config.", + "type": "integer", + "format": "int32" + }, + "enableDynamicPortAllocation": { + "description": "Enable Dynamic Port Allocation. If not specified, it is disabled by default. If set to true, - Dynamic Port Allocation will be enabled on this NAT config. - enableEndpointIndependentMapping cannot be set to true. - If minPorts is set, minPortsPerVm must be set to a power of two greater than or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be allocated to a VM from this NAT config. ", + "type": "boolean" + }, + "udpIdleTimeoutSec": { + "description": "Timeout (in seconds) for UDP connections. Defaults to 30s if not set.", + "type": "integer", + "format": "int32" + }, + "icmpIdleTimeoutSec": { + "description": "Timeout (in seconds) for ICMP connections. Defaults to 30s if not set.", + "type": "integer", + "format": "int32" + }, + "tcpEstablishedIdleTimeoutSec": { + "description": "Timeout (in seconds) for TCP established connections. Defaults to 1200s if not set.", + "type": "integer", + "format": "int32" + }, + "tcpTransitoryIdleTimeoutSec": { + "description": "Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not set.", + "type": "integer", + "format": "int32" + }, + "tcpTimeWaitTimeoutSec": { + "description": "Timeout (in seconds) for TCP connections that are in TIME_WAIT state. Defaults to 120s if not set.", + "type": "integer", + "format": "int32" + }, + "logConfig": { + "description": "Configure logging on this NAT.", + "$ref": "RouterNatLogConfig" + }, + "rules": { + "description": "A list of rules associated with this NAT.", + "type": "array", + "items": { + "$ref": "RouterNatRule" + } + }, + "enableEndpointIndependentMapping": { + "type": "boolean" + } + } + }, + "RouterNatSubnetworkToNat": { + "id": "RouterNatSubnetworkToNat", + "description": "Defines the IP ranges that want to use NAT for a subnetwork.", + "type": "object", + "properties": { + "name": { + "description": "URL for the subnetwork resource that will use NAT.", + "type": "string" + }, + "sourceIpRangesToNat": { + "description": "Specify the options for NAT ranges in the Subnetwork. All options of a single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only valid option with multiple values is: [\"PRIMARY_IP_RANGE\", \"LIST_OF_SECONDARY_IP_RANGES\"] Default: [ALL_IP_RANGES]", + "type": "array", + "items": { + "type": "string", + "enumDescriptions": [ + "The primary and all the secondary ranges are allowed to Nat.", + "A list of secondary ranges are allowed to Nat.", + "The primary range is allowed to Nat." + ], + "enum": [ + "ALL_IP_RANGES", + "LIST_OF_SECONDARY_IP_RANGES", + "PRIMARY_IP_RANGE" + ] + } + }, + "secondaryIpRangeNames": { + "description": "A list of the secondary ranges of the Subnetwork that are allowed to use NAT. This can be populated only if \"LIST_OF_SECONDARY_IP_RANGES\" is one of the values in source_ip_ranges_to_nat.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "RouterNatLogConfig": { + "id": "RouterNatLogConfig", + "description": "Configuration of logging on a NAT.", + "type": "object", + "properties": { + "enable": { + "description": "Indicates whether or not to export logs. This is false by default.", + "type": "boolean" }, - "withdraw": { - "id": "compute.publicDelegatedPrefixes.withdraw", - "path": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/withdraw", - "flatPath": "projects/{project}/regions/{region}/publicDelegatedPrefixes/{publicDelegatedPrefix}/withdraw", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "publicDelegatedPrefix": { - "description": "The name of the public delegated prefix. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region where the public delegated prefix is located. It should comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "publicDelegatedPrefix" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "filter": { + "description": "Specify the desired filtering of logs on this NAT. If unspecified, logs are exported for all connections handled by this NAT. This option can take one of the following values: - ERRORS_ONLY: Export logs only for connection failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - ALL: Export logs for all connections, successful and unsuccessful. ", + "type": "string", + "enumDescriptions": [ + "Export logs for all (successful and unsuccessful) connections.", + "Export logs for connection failures only.", + "Export logs for successful connections only." ], - "description": "Withdraws the specified PublicDelegatedPrefix in the given region." + "enum": [ + "ALL", + "ERRORS_ONLY", + "TRANSLATIONS_ONLY" + ] + } + } + }, + "RouterNatRule": { + "id": "RouterNatRule", + "type": "object", + "properties": { + "ruleNumber": { + "description": "An integer uniquely identifying a rule in the list. The rule number must be a positive value between 0 and 65000, and must be unique among rules within a NAT.", + "type": "integer", + "format": "uint32" }, - "aggregatedList": { - "id": "compute.publicDelegatedPrefixes.aggregatedList", - "path": "projects/{project}/aggregated/publicDelegatedPrefixes", - "flatPath": "projects/{project}/aggregated/publicDelegatedPrefixes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "PublicDelegatedPrefixAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all PublicDelegatedPrefix resources owned by the specific project across all scopes. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "description": { + "description": "An optional description of this rule.", + "type": "string" + }, + "match": { + "description": "CEL expression that specifies the match condition that egress traffic from a VM is evaluated against. If it evaluates to true, the corresponding `action` is enforced. The following examples are valid match expressions for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || destination.ip == '8.8.8.8'` The following example is a valid match expression for private NAT: `nexthop.hub == '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'`", + "type": "string" + }, + "action": { + "description": "The action to be enforced for traffic that matches this rule.", + "$ref": "RouterNatRuleAction" } } }, - "regions": { - "methods": { - "list": { - "id": "compute.regions.list", - "path": "projects/{project}/regions", - "flatPath": "projects/{project}/regions", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "RegionList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of region resources available to the specified project. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `items.quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method." + "RouterNatRuleAction": { + "id": "RouterNatRuleAction", + "type": "object", + "properties": { + "sourceNatActiveIps": { + "description": "A list of URLs of the IP resources used for this NAT rule. These IP addresses must be valid static external IP addresses assigned to the project. This field is used for public NAT.", + "type": "array", + "items": { + "type": "string" + } }, - "get": { - "id": "compute.regions.get", - "path": "projects/{project}/regions/{region}", - "flatPath": "projects/{project}/regions/{region}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "Region" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified Region resource. To decrease latency for this method, you can optionally omit any unneeded information from the response by using a field mask. This practice is especially recommended for unused quota information (the `quotas` field). To exclude one or more fields, set your request's `fields` query parameter to only include the fields you need. For example, to only include the `id` and `selfLink` fields, add the query parameter `?fields=id,selfLink` to your request. This method fails if the quota information is unavailable for the region and if the organization policy constraint compute.requireBasicQuotaInResponse is enforced. This constraint, when enforced, disables the fail-open behaviour when quota information (the `items.quotas` field) is unavailable for the region. It is recommended to use the default setting for the constraint unless your application requires the fail-closed behaviour for this method." + "sourceNatDrainIps": { + "description": "A list of URLs of the IP resources to be drained. These IPs must be valid static external IPs that have been assigned to the NAT. These IPs should be used for updating/patching a NAT rule only. This field is used for public NAT.", + "type": "array", + "items": { + "type": "string" + } + }, + "sourceNatActiveRanges": { + "description": "A list of URLs of the subnetworks used as source ranges for this NAT Rule. These subnetworks must have purpose set to PRIVATE_NAT. This field is used for private NAT.", + "type": "array", + "items": { + "type": "string" + } + }, + "sourceNatDrainRanges": { + "description": "A list of URLs of subnetworks representing source ranges to be drained. This is only supported on patch/update, and these subnetworks must have previously been used as active ranges in this NAT Rule. This field is used for private NAT.", + "type": "array", + "items": { + "type": "string" + } } } }, - "resourcePolicies": { - "methods": { - "list": { - "id": "compute.resourcePolicies.list", - "path": "projects/{project}/regions/{region}/resourcePolicies", - "flatPath": "projects/{project}/regions/{region}/resourcePolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "ResourcePolicyList" + "RouterMd5AuthenticationKey": { + "id": "RouterMd5AuthenticationKey", + "type": "object", + "properties": { + "name": { + "description": "Name used to identify the key. Must be unique within a router. Must be referenced by exactly one bgpPeer. Must comply with RFC1035.", + "annotations": { + "required": [ + "compute.routers.insert", + "compute.routers.update" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "A list all the resource policies that have been configured for the specified project in specified region." + "type": "string" }, - "aggregatedList": { - "id": "compute.resourcePolicies.aggregatedList", - "path": "projects/{project}/aggregated/resourcePolicies", - "flatPath": "projects/{project}/aggregated/resourcePolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ResourcePolicyAggregatedList" + "key": { + "description": "[Input only] Value of the key. For patch and update calls, it can be skipped to copy the value from the previous configuration. This is allowed if the key with the same name existed before the operation. Maximum length is 80 characters. Can only contain printable ASCII characters.", + "annotations": { + "required": [ + "compute.routers.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of resource policies. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "type": "string" + } + } + }, + "RouterList": { + "id": "RouterList", + "description": "Contains a list of Router resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#router for routers.", + "default": "compute#routerList", + "type": "string" }, - "get": { - "id": "compute.resourcePolicies.get", - "path": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", - "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Router resources.", + "type": "array", + "items": { + "$ref": "Router" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resourcePolicy": { - "description": "Name of the resource policy to retrieve.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resourcePolicy" - ], - "response": { - "$ref": "ResourcePolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves all information of the specified resource policy." + } + } + } + }, + "RouterAggregatedList": { + "id": "RouterAggregatedList", + "description": "Contains a list of routers.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#routerAggregatedList", + "type": "string" }, - "insert": { - "id": "compute.resourcePolicies.insert", - "path": "projects/{project}/regions/{region}/resourcePolicies", - "flatPath": "projects/{project}/regions/{region}/resourcePolicies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "ResourcePolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a new resource policy." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "delete": { - "id": "compute.resourcePolicies.delete", - "path": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", - "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "resourcePolicy": { - "description": "Name of the resource policy to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resourcePolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified resource policy." + "items": { + "description": "A list of Router resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of routers.", + "$ref": "RoutersScopedList" + } }, - "patch": { - "id": "compute.resourcePolicies.patch", - "path": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", - "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resourcePolicy}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "resourcePolicy": { - "description": "Id of the resource policy to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "updateMask": { - "description": "update_mask indicates fields to be updated as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resourcePolicy" - ], - "request": { - "$ref": "ResourcePolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Modify the specified resource policy." + } }, - "getIamPolicy": { - "id": "compute.resourcePolicies.getIamPolicy", - "path": "projects/{project}/regions/{region}/resourcePolicies/{resource}/getIamPolicy", - "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "RoutersScopedList": { + "id": "RoutersScopedList", + "type": "object", + "properties": { + "routers": { + "description": "A list of routers contained in this scope.", + "type": "array", + "items": { + "$ref": "Router" + } + }, + "warning": { + "description": "Informational warning which replaces the list of routers when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" + } + } + } + }, + "RouterStatusResponse": { + "id": "RouterStatusResponse", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#routerStatusResponse", + "type": "string" + }, + "result": { + "$ref": "RouterStatus" + } + } + }, + "RouterStatus": { + "id": "RouterStatus", + "type": "object", + "properties": { + "network": { + "description": "URI of the network to which this router belongs.", + "type": "string" + }, + "bestRoutes": { + "description": "A list of the best dynamic routes for this Cloud Router's Virtual Private Cloud (VPC) network in the same region as this Cloud Router. Lists all of the best routes per prefix that are programmed into this region's VPC data plane. When global dynamic routing mode is turned on in the VPC network, this list can include cross-region dynamic routes from Cloud Routers in other regions.", + "type": "array", + "items": { + "$ref": "Route" + } + }, + "bestRoutesForRouter": { + "description": "A list of the best BGP routes learned by this Cloud Router. It is possible that routes listed might not be programmed into the data plane, if the Google Cloud control plane finds a more optimal route for a prefix than a route learned by this Cloud Router.", + "type": "array", + "items": { + "$ref": "Route" + } + }, + "bgpPeerStatus": { + "type": "array", + "items": { + "$ref": "RouterStatusBgpPeerStatus" + } + }, + "natStatus": { + "type": "array", + "items": { + "$ref": "RouterStatusNatStatus" + } + } + } + }, + "RouterStatusBgpPeerStatus": { + "id": "RouterStatusBgpPeerStatus", + "type": "object", + "properties": { + "name": { + "description": "Name of this BGP peer. Unique within the Routers resource.", + "type": "string" + }, + "linkedVpnTunnel": { + "description": "URL of the VPN tunnel that this BGP peer controls.", + "type": "string" + }, + "routerApplianceInstance": { + "description": "[Output only] URI of the VM instance that is used as third-party router appliances such as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM instance is the peer side of the BGP session.", + "type": "string" + }, + "ipAddress": { + "description": "IP address of the local BGP interface.", + "type": "string" + }, + "peerIpAddress": { + "description": "IP address of the remote BGP interface.", + "type": "string" + }, + "ipv6NexthopAddress": { + "description": "IPv6 address of the local BGP interface.", + "type": "string" + }, + "peerIpv6NexthopAddress": { + "description": "IPv6 address of the remote BGP interface.", + "type": "string" + }, + "enableIpv6": { + "description": "Enable IPv6 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 6.", + "type": "boolean" + }, + "status": { + "description": "Status of the BGP peer: {UP, DOWN}", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "DOWN", + "UNKNOWN", + "UP" + ] + }, + "state": { + "description": "The state of the BGP session. For a list of possible values for this field, see BGP session states.", + "type": "string" + }, + "uptime": { + "description": "Time this session has been up. Format: 14 years, 51 weeks, 6 days, 23 hours, 59 minutes, 59 seconds", + "type": "string" + }, + "uptimeSeconds": { + "description": "Time this session has been up, in seconds. Format: 145", + "type": "string" + }, + "numLearnedRoutes": { + "description": "Number of routes learned from the remote BGP Peer.", + "type": "integer", + "format": "uint32" + }, + "advertisedRoutes": { + "description": "Routes that were advertised to the remote BGP peer", + "type": "array", + "items": { + "$ref": "Route" + } + }, + "bfdStatus": { + "$ref": "BfdStatus" + }, + "md5AuthEnabled": { + "description": "Informs whether MD5 authentication is enabled on this BGP peer.", + "type": "boolean" + }, + "statusReason": { + "description": "Indicates why particular status was returned.", + "type": "string", + "enumDescriptions": [ + "BGP peer disabled because it requires IPv4 but the underlying connection is IPv6-only.", + "BGP peer disabled because it requires IPv6 but the underlying connection is IPv4-only.", + "Indicates internal problems with configuration of MD5 authentication. This particular reason can only be returned when md5AuthEnabled is true and status is DOWN.", + "" ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "enum": [ + "IPV4_PEER_ON_IPV6_ONLY_CONNECTION", + "IPV6_PEER_ON_IPV4_ONLY_CONNECTION", + "MD5_AUTH_INTERNAL_PROBLEM", + "STATUS_REASON_UNSPECIFIED" + ] }, - "setIamPolicy": { - "id": "compute.resourcePolicies.setIamPolicy", - "path": "projects/{project}/regions/{region}/resourcePolicies/{resource}/setIamPolicy", - "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" + "ipv4NexthopAddress": { + "description": "IPv4 address of the local BGP interface.", + "type": "string" + }, + "peerIpv4NexthopAddress": { + "description": "IPv4 address of the remote BGP interface.", + "type": "string" + }, + "enableIpv4": { + "description": "Enable IPv4 traffic over BGP Peer. It is enabled by default if the peerIpAddress is version 4.", + "type": "boolean" + } + } + }, + "BfdStatus": { + "id": "BfdStatus", + "description": "Next free: 15", + "type": "object", + "properties": { + "uptimeMs": { + "description": "Session uptime in milliseconds. Value will be 0 if session is not up.", + "type": "string", + "format": "int64" + }, + "localState": { + "description": "The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "" ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ADMIN_DOWN", + "DOWN", + "INIT", + "STATE_UNSPECIFIED", + "UP" + ] + }, + "localDiagnostic": { + "description": "The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "enum": [ + "ADMINISTRATIVELY_DOWN", + "CONCATENATED_PATH_DOWN", + "CONTROL_DETECTION_TIME_EXPIRED", + "DIAGNOSTIC_UNSPECIFIED", + "ECHO_FUNCTION_FAILED", + "FORWARDING_PLANE_RESET", + "NEIGHBOR_SIGNALED_SESSION_DOWN", + "NO_DIAGNOSTIC", + "PATH_DOWN", + "REVERSE_CONCATENATED_PATH_DOWN" + ] }, - "testIamPermissions": { - "id": "compute.resourcePolicies.testIamPermissions", - "path": "projects/{project}/regions/{region}/resourcePolicies/{resource}/testIamPermissions", - "flatPath": "projects/{project}/regions/{region}/resourcePolicies/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" + "controlPacketCounts": { + "description": "Control packet counts for the current BFD session.", + "$ref": "BfdStatusPacketCounts" + }, + "txPacket": { + "description": "The most recent Tx control packet for this BFD session.", + "$ref": "BfdPacket" + }, + "rxPacket": { + "description": "The most recent Rx control packet for this BFD session.", + "$ref": "BfdPacket" + }, + "controlPacketIntervals": { + "description": "Inter-packet time interval statistics for control packets.", + "type": "array", + "items": { + "$ref": "PacketIntervals" + } + }, + "negotiatedLocalControlTxIntervalMs": { + "description": "Negotiated transmit interval for control packets.", + "type": "integer", + "format": "uint32" + }, + "bfdSessionInitializationMode": { + "description": "The BFD session initialization mode for this BGP peer. If set to ACTIVE, the Cloud Router will initiate the BFD session for this BGP peer. If set to PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP peer.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "ACTIVE", + "DISABLED", + "PASSIVE" + ] + }, + "configUpdateTimestampMicros": { + "description": "Unix timestamp of the most recent config update.", + "type": "string", + "format": "int64" + } + } + }, + "BfdStatusPacketCounts": { + "id": "BfdStatusPacketCounts", + "type": "object", + "properties": { + "numTx": { + "description": "Number of packets transmitted since the beginning of the current BFD session.", + "type": "integer", + "format": "uint32" + }, + "numRx": { + "description": "Number of packets received since the beginning of the current BFD session.", + "type": "integer", + "format": "uint32" + }, + "numRxSuccessful": { + "description": "Number of packets received that were successfully processed since the beginning of the current BFD session.", + "type": "integer", + "format": "uint32" + }, + "numRxRejected": { + "description": "Number of packets received that were rejected because of errors since the beginning of the current BFD session.", + "type": "integer", + "format": "uint32" + } + } + }, + "BfdPacket": { + "id": "BfdPacket", + "type": "object", + "properties": { + "version": { + "description": "The version number of the BFD protocol, as specified in section 4.1 of RFC5880.", + "type": "integer", + "format": "uint32" + }, + "diagnostic": { + "description": "The diagnostic code specifies the local system's reason for the last change in session state. This allows remote systems to determine the reason that the previous session failed, for example. These diagnostic codes are specified in section 4.1 of RFC5880", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "", + "", + "", + "", + "" ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "ADMINISTRATIVELY_DOWN", + "CONCATENATED_PATH_DOWN", + "CONTROL_DETECTION_TIME_EXPIRED", + "DIAGNOSTIC_UNSPECIFIED", + "ECHO_FUNCTION_FAILED", + "FORWARDING_PLANE_RESET", + "NEIGHBOR_SIGNALED_SESSION_DOWN", + "NO_DIAGNOSTIC", + "PATH_DOWN", + "REVERSE_CONCATENATED_PATH_DOWN" + ] + }, + "state": { + "description": "The current BFD session state as seen by the transmitting system. These states are specified in section 4.1 of RFC5880", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "" + ], + "enum": [ + "ADMIN_DOWN", + "DOWN", + "INIT", + "STATE_UNSPECIFIED", + "UP" + ] + }, + "poll": { + "description": "The Poll bit of the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "boolean" + }, + "final": { + "description": "The Final bit of the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "boolean" + }, + "controlPlaneIndependent": { + "description": "The Control Plane Independent bit of the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "boolean" + }, + "authenticationPresent": { + "description": "The Authentication Present bit of the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "boolean" + }, + "demand": { + "description": "The demand bit of the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "boolean" + }, + "multipoint": { + "description": "The multipoint bit of the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "boolean" + }, + "multiplier": { + "description": "The detection time multiplier of the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "integer", + "format": "uint32" + }, + "length": { + "description": "The length of the BFD Control packet in bytes. This is specified in section 4.1 of RFC5880", + "type": "integer", + "format": "uint32" + }, + "myDiscriminator": { + "description": "The My Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "integer", + "format": "uint32" + }, + "yourDiscriminator": { + "description": "The Your Discriminator value in the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "integer", + "format": "uint32" + }, + "minTxIntervalMs": { + "description": "The Desired Min TX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "integer", + "format": "uint32" + }, + "minRxIntervalMs": { + "description": "The Required Min RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "integer", + "format": "uint32" + }, + "minEchoRxIntervalMs": { + "description": "The Required Min Echo RX Interval value in the BFD packet. This is specified in section 4.1 of RFC5880", + "type": "integer", + "format": "uint32" } } }, - "routes": { - "methods": { - "list": { - "id": "compute.routes.list", - "path": "projects/{project}/global/routes", - "flatPath": "projects/{project}/global/routes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "RouteList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "PacketIntervals": { + "id": "PacketIntervals", + "description": "Next free: 7", + "type": "object", + "properties": { + "type": { + "description": "The type of packets for which inter-packet intervals were computed.", + "type": "string", + "enumDescriptions": [ + "Only applies to Echo packets. This shows the intervals between sending and receiving the same packet.", + "Intervals between received packets.", + "Intervals between transmitted packets.", + "" ], - "description": "Retrieves the list of Route resources available to the specified project." + "enum": [ + "LOOPBACK", + "RECEIVE", + "TRANSMIT", + "TYPE_UNSPECIFIED" + ] }, - "get": { - "id": "compute.routes.get", - "path": "projects/{project}/global/routes/{route}", - "flatPath": "projects/{project}/global/routes/{route}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "route": { - "description": "Name of the Route resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "route" - ], - "response": { - "$ref": "Route" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "duration": { + "description": "From how long ago in the past these intervals were observed.", + "type": "string", + "enumDescriptions": [ + "", + "", + "From BfdSession object creation time.", + "" ], - "description": "Returns the specified Route resource." + "enum": [ + "DURATION_UNSPECIFIED", + "HOUR", + "MAX", + "MINUTE" + ] }, - "insert": { - "id": "compute.routes.insert", - "path": "projects/{project}/global/routes", - "flatPath": "projects/{project}/global/routes", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "Route" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a Route resource in the specified project using the data included in the request." + "numIntervals": { + "description": "Number of inter-packet intervals from which these statistics were derived.", + "type": "string", + "format": "int64" }, - "delete": { - "id": "compute.routes.delete", - "path": "projects/{project}/global/routes/{route}", - "flatPath": "projects/{project}/global/routes/{route}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "route": { - "description": "Name of the Route resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "route" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified Route resource." + "minMs": { + "description": "Minimum observed inter-packet interval in milliseconds.", + "type": "string", + "format": "int64" + }, + "maxMs": { + "description": "Maximum observed inter-packet interval in milliseconds.", + "type": "string", + "format": "int64" + }, + "avgMs": { + "description": "Average observed inter-packet interval in milliseconds.", + "type": "string", + "format": "int64" } } }, - "routers": { - "methods": { - "get": { - "id": "compute.routers.get", - "path": "projects/{project}/regions/{region}/routers/{router}", - "flatPath": "projects/{project}/regions/{region}/routers/{router}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "router": { - "description": "Name of the Router resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "router" - ], - "response": { - "$ref": "Router" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified Router resource." + "RouterStatusNatStatus": { + "id": "RouterStatusNatStatus", + "description": "Status of a NAT contained in this router.", + "type": "object", + "properties": { + "name": { + "description": "Unique name of this NAT.", + "type": "string" }, - "insert": { - "id": "compute.routers.insert", - "path": "projects/{project}/regions/{region}/routers", - "flatPath": "projects/{project}/regions/{region}/routers", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "Router" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a Router resource in the specified project and region using the data included in the request." + "userAllocatedNatIpResources": { + "description": "A list of fully qualified URLs of reserved IP address resources.", + "type": "array", + "items": { + "type": "string" + } }, - "update": { - "id": "compute.routers.update", - "path": "projects/{project}/regions/{region}/routers/{router}", - "flatPath": "projects/{project}/regions/{region}/routers/{router}", - "httpMethod": "PUT", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "drainUserAllocatedNatIps": { + "description": "A list of IPs user-allocated for NAT that are in drain mode. Example: [\"1.1.1.1\", \"179.12.26.133\"].", + "type": "array", + "items": { + "type": "string" + } + }, + "userAllocatedNatIps": { + "description": "A list of IPs user-allocated for NAT. They will be raw IP strings like \"179.12.26.133\".", + "type": "array", + "items": { + "type": "string" + } + }, + "autoAllocatedNatIps": { + "description": "A list of IPs auto-allocated for NAT. Example: [\"1.1.1.1\", \"129.2.16.89\"]", + "type": "array", + "items": { + "type": "string" + } + }, + "drainAutoAllocatedNatIps": { + "description": "A list of IPs auto-allocated for NAT that are in drain mode. Example: [\"1.1.1.1\", \"179.12.26.133\"].", + "type": "array", + "items": { + "type": "string" + } + }, + "minExtraNatIpsNeeded": { + "description": "The number of extra IPs to allocate. This will be greater than 0 only if user-specified IPs are NOT enough to allow all configured VMs to use NAT. This value is meaningful only when auto-allocation of NAT IPs is *not* used.", + "type": "integer", + "format": "int32" + }, + "numVmEndpointsWithNatMappings": { + "description": "Number of VM endpoints (i.e., Nics) that can use NAT.", + "type": "integer", + "format": "int32" + }, + "ruleStatus": { + "description": "Status of rules in this NAT.", + "type": "array", + "items": { + "$ref": "RouterStatusNatStatusNatRuleStatus" + } + } + } + }, + "RouterStatusNatStatusNatRuleStatus": { + "id": "RouterStatusNatStatusNatRuleStatus", + "description": "Status of a NAT Rule contained in this NAT.", + "type": "object", + "properties": { + "ruleNumber": { + "description": "Rule number of the rule.", + "type": "integer", + "format": "int32" + }, + "activeNatIps": { + "description": "A list of active IPs for NAT. Example: [\"1.1.1.1\", \"179.12.26.133\"].", + "type": "array", + "items": { + "type": "string" + } + }, + "drainNatIps": { + "description": "A list of IPs for NAT that are in drain mode. Example: [\"1.1.1.1\", \"179.12.26.133\"].", + "type": "array", + "items": { + "type": "string" + } + }, + "minExtraIpsNeeded": { + "description": "The number of extra IPs to allocate. This will be greater than 0 only if the existing IPs in this NAT Rule are NOT enough to allow all configured VMs to use NAT.", + "type": "integer", + "format": "int32" + }, + "numVmEndpointsWithNatMappings": { + "description": "Number of VM endpoints (i.e., NICs) that have NAT Mappings from this NAT Rule.", + "type": "integer", + "format": "int32" + } + } + }, + "VmEndpointNatMappingsList": { + "id": "VmEndpointNatMappingsList", + "description": "Contains a list of VmEndpointNatMappings.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#vmEndpointNatMappingsList for lists of Nat mappings of VM endpoints.", + "default": "compute#vmEndpointNatMappingsList", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string" + }, + "result": { + "description": "[Output Only] A list of Nat mapping information of VM endpoints.", + "type": "array", + "items": { + "$ref": "VmEndpointNatMappings" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "router": { - "description": "Name of the Router resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "router" - ], - "request": { - "$ref": "Router" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified Router resource with the data included in the request. This method conforms to PUT semantics, which requests that the state of the target resource be created or replaced with the state defined by the representation enclosed in the request message payload." + } + } + } + }, + "VmEndpointNatMappings": { + "id": "VmEndpointNatMappings", + "description": "Contain information of Nat mapping for a VM endpoint (i.e., NIC).", + "type": "object", + "properties": { + "instanceName": { + "description": "Name of the VM instance which the endpoint belongs to", + "type": "string" }, - "patch": { - "id": "compute.routers.patch", - "path": "projects/{project}/regions/{region}/routers/{router}", - "flatPath": "projects/{project}/regions/{region}/routers/{router}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "router": { - "description": "Name of the Router resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "router" - ], - "request": { - "$ref": "Router" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified Router resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + "interfaceNatMappings": { + "type": "array", + "items": { + "$ref": "VmEndpointNatMappingsInterfaceNatMappings" + } + } + } + }, + "VmEndpointNatMappingsInterfaceNatMappings": { + "id": "VmEndpointNatMappingsInterfaceNatMappings", + "description": "Contain information of Nat mapping for an interface of this endpoint.", + "type": "object", + "properties": { + "sourceVirtualIp": { + "description": "Primary IP of the VM for this NIC.", + "type": "string" }, - "delete": { - "id": "compute.routers.delete", - "path": "projects/{project}/regions/{region}/routers/{router}", - "flatPath": "projects/{project}/regions/{region}/routers/{router}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "router": { - "description": "Name of the Router resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "router" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified Router resource." + "sourceAliasIpRange": { + "description": "Alias IP range for this interface endpoint. It will be a private (RFC 1918) IP range. Examples: \"10.33.4.55/32\", or \"192.168.5.0/24\".", + "type": "string" }, - "list": { - "id": "compute.routers.list", - "path": "projects/{project}/regions/{region}/routers", - "flatPath": "projects/{project}/regions/{region}/routers", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "RouterList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of Router resources available to the specified project." + "numTotalNatPorts": { + "description": "Total number of ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field nat_ip_port_ranges.", + "type": "integer", + "format": "int32" }, - "aggregatedList": { - "id": "compute.routers.aggregatedList", - "path": "projects/{project}/aggregated/routers", - "flatPath": "projects/{project}/aggregated/routers", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "RouterAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of routers. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "natIpPortRanges": { + "description": "A list of all IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: [\"2.2.2.2:12345-12355\", \"1.1.1.1:2234-2234\"].", + "type": "array", + "items": { + "type": "string" + } }, - "getRouterStatus": { - "id": "compute.routers.getRouterStatus", - "path": "projects/{project}/regions/{region}/routers/{router}/getRouterStatus", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/getRouterStatus", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "router": { - "description": "Name of the Router resource to query.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "router" - ], - "response": { - "$ref": "RouterStatusResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves runtime information of the specified router." + "drainNatIpPortRanges": { + "description": "List of all drain IP:port-range mappings assigned to this interface. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: [\"2.2.2.2:12345-12355\", \"1.1.1.1:2234-2234\"].", + "type": "array", + "items": { + "type": "string" + } }, - "getNatMappingInfo": { - "id": "compute.routers.getNatMappingInfo", - "path": "projects/{project}/regions/{region}/routers/{router}/getNatMappingInfo", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/getNatMappingInfo", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "natName": { - "description": "Name of the nat service to filter the Nat Mapping information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035.", - "location": "query", - "type": "string" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "router": { - "description": "Name of the Router resource to query for Nat Mapping information of VM endpoints.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "router" - ], - "response": { - "$ref": "VmEndpointNatMappingsList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves runtime Nat mapping information of VM endpoints." + "numTotalDrainNatPorts": { + "description": "Total number of drain ports across all NAT IPs allocated to this interface. It equals to the aggregated port number in the field drain_nat_ip_port_ranges.", + "type": "integer", + "format": "int32" + }, + "ruleMappings": { + "description": "Information about mappings provided by rules in this NAT.", + "type": "array", + "items": { + "$ref": "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings" + } + } + } + }, + "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings": { + "id": "VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings", + "description": "Contains information of NAT Mappings provided by a NAT Rule.", + "type": "object", + "properties": { + "ruleNumber": { + "description": "Rule number of the NAT Rule.", + "type": "integer", + "format": "int32" + }, + "numTotalNatPorts": { + "description": "Total number of ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field nat_ip_port_ranges.", + "type": "integer", + "format": "int32" + }, + "natIpPortRanges": { + "description": "A list of all IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: [\"2.2.2.2:12345-12355\", \"1.1.1.1:2234-2234\"].", + "type": "array", + "items": { + "type": "string" + } + }, + "drainNatIpPortRanges": { + "description": "List of all drain IP:port-range mappings assigned to this interface by this rule. These ranges are inclusive, that is, both the first and the last ports can be used for NAT. Example: [\"2.2.2.2:12345-12355\", \"1.1.1.1:2234-2234\"].", + "type": "array", + "items": { + "type": "string" + } + }, + "numTotalDrainNatPorts": { + "description": "Total number of drain ports across all NAT IPs allocated to this interface by this rule. It equals the aggregated port number in the field drain_nat_ip_port_ranges.", + "type": "integer", + "format": "int32" + } + } + }, + "NatIpInfoResponse": { + "id": "NatIpInfoResponse", + "type": "object", + "properties": { + "result": { + "description": "[Output Only] A list of NAT IP information.", + "type": "array", + "items": { + "$ref": "NatIpInfo" + } + } + } + }, + "NatIpInfo": { + "id": "NatIpInfo", + "description": "Contains NAT IP information of a NAT config (i.e. usage status, mode).", + "type": "object", + "properties": { + "natName": { + "description": "Name of the NAT config which the NAT IP belongs to.", + "type": "string" }, - "getNatIpInfo": { - "id": "compute.routers.getNatIpInfo", - "path": "projects/{project}/regions/{region}/routers/{router}/getNatIpInfo", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/getNatIpInfo", - "httpMethod": "GET", - "parameters": { - "natName": { - "description": "Name of the nat service to filter the NAT IP information. If it is omitted, all nats for this router will be returned. Name should conform to RFC1035.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "router": { - "description": "Name of the Router resource to query for Nat IP information. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "router" - ], - "response": { - "$ref": "NatIpInfoResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves runtime NAT IP information." + "natIpInfoMappings": { + "description": "A list of all NAT IPs assigned to this NAT config.", + "type": "array", + "items": { + "$ref": "NatIpInfoNatIpInfoMapping" + } + } + } + }, + "NatIpInfoNatIpInfoMapping": { + "id": "NatIpInfoNatIpInfoMapping", + "description": "Contains information of a NAT IP.", + "type": "object", + "properties": { + "natIp": { + "description": "NAT IP address. For example: 203.0.113.11.", + "type": "string" }, - "preview": { - "id": "compute.routers.preview", - "path": "projects/{project}/regions/{region}/routers/{router}/preview", - "flatPath": "projects/{project}/regions/{region}/routers/{router}/preview", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "router": { - "description": "Name of the Router resource to query.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "router" + "usage": { + "description": "Specifies whether NAT IP is currently serving at least one endpoint or not.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "request": { - "$ref": "Router" - }, - "response": { - "$ref": "RoutersPreviewResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "IN_USE", + "UNUSED" + ] + }, + "mode": { + "description": "Specifies whether NAT IP is auto or manual.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Preview fields auto-generated during router create and update operations. Calling this method does NOT create or update the router." + "enum": [ + "AUTO", + "MANUAL" + ] } } }, - "serviceAttachments": { - "methods": { - "aggregatedList": { - "id": "compute.serviceAttachments.aggregatedList", - "path": "projects/{project}/aggregated/serviceAttachments", - "flatPath": "projects/{project}/aggregated/serviceAttachments", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ServiceAttachmentAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of all ServiceAttachment resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "RoutersPreviewResponse": { + "id": "RoutersPreviewResponse", + "type": "object", + "properties": { + "resource": { + "description": "Preview of given router.", + "$ref": "Router" + } + } + }, + "ServiceAttachmentAggregatedList": { + "id": "ServiceAttachmentAggregatedList", + "description": "Contains a list of ServiceAttachmentsScopedList.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#serviceAttachmentAggregatedList", + "type": "string" }, - "list": { - "id": "compute.serviceAttachments.list", - "path": "projects/{project}/regions/{region}/serviceAttachments", - "flatPath": "projects/{project}/regions/{region}/serviceAttachments", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "ServiceAttachmentList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the ServiceAttachments for a project in the given scope." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "get": { - "id": "compute.serviceAttachments.get", - "path": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", - "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "serviceAttachment": { - "description": "Name of the ServiceAttachment resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "serviceAttachment" - ], - "response": { - "$ref": "ServiceAttachment" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified ServiceAttachment resource in the given scope." + "items": { + "description": "A list of ServiceAttachmentsScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of ServiceAttachments.", + "$ref": "ServiceAttachmentsScopedList" + } }, - "insert": { - "id": "compute.serviceAttachments.insert", - "path": "projects/{project}/regions/{region}/serviceAttachments", - "flatPath": "projects/{project}/regions/{region}/serviceAttachments", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "ServiceAttachment" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a ServiceAttachment in the specified project in the given scope using the parameters that are included in the request." + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "delete": { - "id": "compute.serviceAttachments.delete", - "path": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", - "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region of this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "serviceAttachment": { - "description": "Name of the ServiceAttachment resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "serviceAttachment" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified ServiceAttachment in the given scope" + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" }, - "patch": { - "id": "compute.serviceAttachments.patch", - "path": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", - "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{serviceAttachment}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The region scoping this request and should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "serviceAttachment": { - "description": "The resource id of the ServiceAttachment to patch. It should conform to RFC1035 resource name or be a string form on an unsigned long number.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "serviceAttachment" - ], - "request": { + } + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "ServiceAttachmentsScopedList": { + "id": "ServiceAttachmentsScopedList", + "type": "object", + "properties": { + "serviceAttachments": { + "description": "A list of ServiceAttachments contained in this scope.", + "type": "array", + "items": { "$ref": "ServiceAttachment" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified ServiceAttachment resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + } }, - "getIamPolicy": { - "id": "compute.serviceAttachments.getIamPolicy", - "path": "projects/{project}/regions/{region}/serviceAttachments/{resource}/getIamPolicy", - "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "Informational warning which replaces the list of service attachments when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + } + } + } + }, + "ServiceAttachment": { + "id": "ServiceAttachment", + "description": "Represents a ServiceAttachment resource. A service attachment represents a service that a producer has exposed. It encapsulates the load balancer which fronts the service runs and a list of NAT IP ranges that the producers uses to represent the consumers connecting to the service.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#serviceAttachment for service attachments.", + "default": "compute#serviceAttachment", + "type": "string" }, - "setIamPolicy": { - "id": "compute.serviceAttachments.setIamPolicy", - "path": "projects/{project}/regions/{region}/serviceAttachments/{resource}/setIamPolicy", - "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } + "id": { + "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.serviceAttachments.insert" + ] }, - "parameterOrder": [ - "project", - "region", - "resource" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the service attachment resides. This field applies only to the region resource. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "producerForwardingRule": { + "description": "The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is serving the endpoint identified by this service attachment.", + "deprecated": true, + "type": "string" + }, + "targetService": { + "description": "The URL of a service serving the endpoint identified by this service attachment.", + "type": "string" + }, + "connectionPreference": { + "description": "The connection preference of service attachment. The value can be set to ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always accepts the connection from consumer forwarding rules.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ACCEPT_AUTOMATIC", + "ACCEPT_MANUAL", + "CONNECTION_PREFERENCE_UNSPECIFIED" + ] + }, + "connectedEndpoints": { + "description": "[Output Only] An array of connections for all the consumers connected to this service attachment.", + "type": "array", + "items": { + "$ref": "ServiceAttachmentConnectedEndpoint" + } + }, + "natSubnets": { + "description": "An array of URLs where each entry is the URL of a subnet provided by the service producer to use for NAT in this service attachment.", + "type": "array", + "items": { + "type": "string" + } + }, + "enableProxyProtocol": { + "description": "If true, enable the proxy protocol which is for supplying client TCP/IP address data in TCP connections that traverse proxies on their way to destination servers.", + "type": "boolean" + }, + "consumerRejectLists": { + "description": "Specifies a list of projects or networks that are not allowed to connect to this service attachment. The project can be specified using its project ID or project number and the network can be specified using its URL. A given service attachment can manage connections at either the project or network level. Therefore, both the reject and accept lists for a given service attachment must contain either only projects or only networks.", + "type": "array", + "items": { + "type": "string" + } + }, + "consumerAcceptLists": { + "description": "Specifies which consumer projects or networks are allowed to connect to the service attachment. Each project or network has a connection limit. A given service attachment can manage connections at either the project or network level. Therefore, both the accept and reject lists for a given service attachment must contain either only projects or only networks.", + "type": "array", + "items": { + "$ref": "ServiceAttachmentConsumerProjectLimit" + } + }, + "pscServiceAttachmentId": { + "description": "[Output Only] An 128-bit global unique ID of the PSC service attachment.", + "$ref": "Uint128" + }, + "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 ServiceAttachment. An up-to-date fingerprint must be provided in order to patch/update the ServiceAttachment; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the ServiceAttachment.", + "type": "string", + "format": "byte" + }, + "domainNames": { + "description": "If specified, the domain name will be used during the integration between the PSC connected endpoints and the Cloud DNS. For example, this is a valid domain name: \"p.mycompany.com.\". Current max number of domain names supported is 1.", + "type": "array", + "items": { + "type": "string" + } + }, + "reconcileConnections": { + "description": "This flag determines whether a consumer accept/reject list change can reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. - If false, connection policy update will only affect existing PENDING PSC endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched regardless how the connection policy is modified . - If true, update will affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to the reject list. For newly created service attachment, this boolean defaults to false.", + "type": "boolean" + }, + "propagatedConnectionLimit": { + "description": "The number of consumer spokes that connected Private Service Connect endpoints can be propagated to through Network Connectivity Center. This limit lets the service producer limit how many propagated Private Service Connect connections can be established to this service attachment from a single consumer. If the connection preference of the service attachment is ACCEPT_MANUAL, the limit applies to each project or network that is listed in the consumer accept list. If the connection preference of the service attachment is ACCEPT_AUTOMATIC, the limit applies to each project that contains a connected endpoint. If unspecified, the default propagated connection limit is 250.", + "type": "integer", + "format": "uint32" + } + } + }, + "ServiceAttachmentConnectedEndpoint": { + "id": "ServiceAttachmentConnectedEndpoint", + "description": "[Output Only] A connection connected to this service attachment.", + "type": "object", + "properties": { + "status": { + "description": "The status of a connected endpoint to this service attachment.", + "type": "string", + "enumDescriptions": [ + "The connection has been accepted by the producer.", + "The connection has been closed by the producer.", + "The connection has been accepted by the producer, but the producer needs to take further action before the forwarding rule can serve traffic.", + "The connection is pending acceptance by the producer.", + "The consumer is still connected but not using the connection.", + "" ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + "enum": [ + "ACCEPTED", + "CLOSED", + "NEEDS_ATTENTION", + "PENDING", + "REJECTED", + "STATUS_UNSPECIFIED" + ] + }, + "pscConnectionId": { + "description": "The PSC connection id of the connected endpoint.", + "type": "string", + "format": "uint64" + }, + "endpoint": { + "description": "The url of a connected endpoint.", + "type": "string" + }, + "consumerNetwork": { + "description": "The url of the consumer network.", + "type": "string" + }, + "propagatedConnectionCount": { + "description": "The number of consumer Network Connectivity Center spokes that the connected Private Service Connect endpoint has propagated to.", + "type": "integer", + "format": "uint32" + } + } + }, + "ServiceAttachmentConsumerProjectLimit": { + "id": "ServiceAttachmentConsumerProjectLimit", + "type": "object", + "properties": { + "projectIdOrNum": { + "description": "The project id or number for the project to set the limit for.", + "type": "string" + }, + "networkUrl": { + "description": "The network URL for the network to set the limit for.", + "type": "string" + }, + "connectionLimit": { + "description": "The value of the limit to set.", + "type": "integer", + "format": "uint32" + } + } + }, + "Uint128": { + "id": "Uint128", + "type": "object", + "properties": { + "high": { + "type": "string", + "format": "uint64" + }, + "low": { + "type": "string", + "format": "uint64" + } + } + }, + "ServiceAttachmentList": { + "id": "ServiceAttachmentList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#serviceAttachment for service attachments.", + "default": "compute#serviceAttachmentList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "testIamPermissions": { - "id": "compute.serviceAttachments.testIamPermissions", - "path": "projects/{project}/regions/{region}/serviceAttachments/{resource}/testIamPermissions", - "flatPath": "projects/{project}/regions/{region}/serviceAttachments/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of ServiceAttachment resources.", + "type": "array", + "items": { + "$ref": "ServiceAttachment" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + } } } }, - "snapshotSettings": { - "methods": { - "get": { - "id": "compute.snapshotSettings.get", - "path": "projects/{project}/global/snapshotSettings", - "flatPath": "projects/{project}/global/snapshotSettings", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "SnapshotSettings" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "SnapshotSettings": { + "id": "SnapshotSettings", + "type": "object", + "properties": { + "storageLocation": { + "description": "Policy of which storage location is going to be resolved, and additional data that particularizes how the policy is going to be carried out.", + "$ref": "SnapshotSettingsStorageLocationSettings" + } + } + }, + "SnapshotSettingsStorageLocationSettings": { + "id": "SnapshotSettingsStorageLocationSettings", + "type": "object", + "properties": { + "policy": { + "description": "The chosen location policy.", + "type": "string", + "enumDescriptions": [ + "Store snapshot in the same region as with the originating disk. No additional parameters are needed.", + "Store snapshot in the nearest multi region Cloud Storage bucket, relative to the originating disk. No additional parameters are needed.", + "Store snapshot in the specific locations, as specified by the user. The list of regions to store must be defined under the `locations` field.", + "" ], - "description": "Get snapshot settings." + "enum": [ + "LOCAL_REGION", + "NEAREST_MULTI_REGION", + "SPECIFIC_LOCATIONS", + "STORAGE_LOCATION_POLICY_UNSPECIFIED" + ] }, - "patch": { - "id": "compute.snapshotSettings.patch", - "path": "projects/{project}/global/snapshotSettings", - "flatPath": "projects/{project}/global/snapshotSettings", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "updateMask": { - "description": "update_mask indicates fields to be updated as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "SnapshotSettings" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patch snapshot settings." + "locations": { + "description": "When the policy is SPECIFIC_LOCATIONS, snapshots will be stored in the locations listed in this field. Keys are Cloud Storage bucket locations. Only one location can be specified.", + "type": "object", + "additionalProperties": { + "$ref": "SnapshotSettingsStorageLocationSettingsStorageLocationPreference" + } } } }, - "sslCertificates": { - "methods": { - "list": { - "id": "compute.sslCertificates.list", - "path": "projects/{project}/global/sslCertificates", - "flatPath": "projects/{project}/global/sslCertificates", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "SslCertificateList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of SslCertificate resources available to the specified project." + "SnapshotSettingsStorageLocationSettingsStorageLocationPreference": { + "id": "SnapshotSettingsStorageLocationSettingsStorageLocationPreference", + "description": "A structure for specifying storage locations.", + "type": "object", + "properties": { + "name": { + "description": "Name of the location. It should be one of the Cloud Storage buckets. Only one location can be specified.", + "type": "string" + } + } + }, + "SslCertificateList": { + "id": "SslCertificateList", + "description": "Contains a list of SslCertificate resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#sslCertificateList", + "type": "string" }, - "get": { - "id": "compute.sslCertificates.get", - "path": "projects/{project}/global/sslCertificates/{sslCertificate}", - "flatPath": "projects/{project}/global/sslCertificates/{sslCertificate}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "sslCertificate": { - "description": "Name of the SslCertificate resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "sslCertificate" - ], - "response": { - "$ref": "SslCertificate" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified SslCertificate resource." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.sslCertificates.insert", - "path": "projects/{project}/global/sslCertificates", - "flatPath": "projects/{project}/global/sslCertificates", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { + "items": { + "description": "A list of SslCertificate resources.", + "type": "array", + "items": { "$ref": "SslCertificate" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a SslCertificate resource in the specified project using the data included in the request." + } }, - "delete": { - "id": "compute.sslCertificates.delete", - "path": "projects/{project}/global/sslCertificates/{sslCertificate}", - "flatPath": "projects/{project}/global/sslCertificates/{sslCertificate}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "sslCertificate": { - "description": "Name of the SslCertificate resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "sslCertificate" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified SslCertificate resource." + } + } + } + }, + "SslCertificate": { + "id": "SslCertificate", + "description": "Represents an SSL certificate resource. Google Compute Engine has two SSL certificate resources: * [Global](/compute/docs/reference/rest/v1/sslCertificates) * [Regional](/compute/docs/reference/rest/v1/regionSslCertificates) The global SSL certificates (sslCertificates) are used by: - Global external Application Load Balancers - Classic Application Load Balancers - Proxy Network Load Balancers (with target SSL proxies) The regional SSL certificates (regionSslCertificates) are used by: - Regional external Application Load Balancers - Regional internal Application Load Balancers Optionally, certificate file contents that you upload can contain a set of up to five PEM-encoded certificates. The API call creates an object (sslCertificate) that holds this data. You can use SSL keys and certificates to secure connections to a load balancer. For more information, read Creating and using SSL certificates, SSL certificates quotas and limits, and Troubleshooting SSL certificates.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#sslCertificate for SSL certificates.", + "default": "compute#sslCertificate", + "type": "string" }, - "aggregatedList": { - "id": "compute.sslCertificates.aggregatedList", - "path": "projects/{project}/aggregated/sslCertificates", - "flatPath": "projects/{project}/aggregated/sslCertificates", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "SslCertificateAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output only] Server-defined URL for the resource.", + "type": "string" + }, + "certificate": { + "description": "A value read into memory from a certificate file. The certificate file must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.", + "type": "string" + }, + "privateKey": { + "description": "A value read into memory from a write-only private key file. The private key file must be in PEM format. For security, only insert requests include this field.", + "type": "string" + }, + "managed": { + "description": "Configuration and status of a managed SSL certificate.", + "$ref": "SslCertificateManagedSslCertificate" + }, + "selfManaged": { + "description": "Configuration and status of a self-managed SSL certificate.", + "$ref": "SslCertificateSelfManagedSslCertificate" + }, + "type": { + "description": "(Optional) Specifies the type of SSL certificate, either \"SELF_MANAGED\" or \"MANAGED\". If not specified, the certificate is self-managed and the fields certificate and private_key are used.", + "type": "string", + "enumDescriptions": [ + "Google-managed SSLCertificate.", + "Certificate uploaded by user.", + "" ], - "description": "Retrieves the list of all SslCertificate resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "MANAGED", + "SELF_MANAGED", + "TYPE_UNSPECIFIED" + ] + }, + "subjectAlternativeNames": { + "description": "[Output Only] Domains associated with the certificate via Subject Alternative Name.", + "type": "array", + "items": { + "type": "string" + } + }, + "expireTime": { + "description": "[Output Only] Expire time of the certificate. RFC3339", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the regional SSL Certificate resides. This field is not applicable to global SSL Certificate.", + "type": "string" } } }, - "regionSslCertificates": { - "methods": { - "list": { - "id": "compute.regionSslCertificates.list", - "path": "projects/{project}/regions/{region}/sslCertificates", - "flatPath": "projects/{project}/regions/{region}/sslCertificates", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "SslCertificateList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of SslCertificate resources available to the specified project in the specified region." + "SslCertificateManagedSslCertificate": { + "id": "SslCertificateManagedSslCertificate", + "description": "Configuration and status of a managed SSL certificate.", + "type": "object", + "properties": { + "domains": { + "description": "The domains for which a managed SSL certificate will be generated. Each Google-managed SSL certificate supports up to the [maximum number of domains per Google-managed SSL certificate](/load-balancing/docs/quotas#ssl_certificates).", + "type": "array", + "items": { + "type": "string" + } }, - "get": { - "id": "compute.regionSslCertificates.get", - "path": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", - "flatPath": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "sslCertificate": { - "description": "Name of the SslCertificate resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "sslCertificate" - ], - "response": { - "$ref": "SslCertificate" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "status": { + "description": "[Output only] Status of the managed certificate resource.", + "type": "string", + "enumDescriptions": [ + "The certificate management is working, and a certificate has been provisioned.", + "", + "The certificate management is working. GCP will attempt to provision the first certificate.", + "Certificate provisioning failed due to an issue with the DNS or load balancing configuration. For details of which domain failed, consult domain_status field.", + "Certificate provisioning failed due to an issue with the DNS or load balancing configuration. It won't be retried. To try again delete and create a new managed SslCertificate resource. For details of which domain failed, consult domain_status field.", + "Renewal of the certificate has failed due to an issue with the DNS or load balancing configuration. The existing cert is still serving; however, it will expire shortly. To provision a renewed certificate, delete and create a new managed SslCertificate resource. For details on which domain failed, consult domain_status field." ], - "description": "Returns the specified SslCertificate resource in the specified region. Get a list of available SSL certificates by making a list() request." + "enum": [ + "ACTIVE", + "MANAGED_CERTIFICATE_STATUS_UNSPECIFIED", + "PROVISIONING", + "PROVISIONING_FAILED", + "PROVISIONING_FAILED_PERMANENTLY", + "RENEWAL_FAILED" + ] }, - "insert": { - "id": "compute.regionSslCertificates.insert", - "path": "projects/{project}/regions/{region}/sslCertificates", - "flatPath": "projects/{project}/regions/{region}/sslCertificates", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "domainStatus": { + "description": "[Output only] Detailed statuses of the domains specified for managed certificate resource.", + "type": "object", + "additionalProperties": { + "type": "string", + "enumDescriptions": [ + "A managed certificate can be provisioned, no issues for this domain.", + "", + "Failed to check CAA records for the domain.", + "Certificate issuance forbidden by an explicit CAA record for the domain.", + "There seems to be problem with the user's DNS or load balancer configuration for this domain.", + "Reached rate-limit for certificates per top-level private domain.", + "Certificate provisioning for this domain is under way. GCP will attempt to provision the first certificate." + ], + "enum": [ + "ACTIVE", + "DOMAIN_STATUS_UNSPECIFIED", + "FAILED_CAA_CHECKING", + "FAILED_CAA_FORBIDDEN", + "FAILED_NOT_VISIBLE", + "FAILED_RATE_LIMITED", + "PROVISIONING" + ] + } + } + } + }, + "SslCertificateSelfManagedSslCertificate": { + "id": "SslCertificateSelfManagedSslCertificate", + "description": "Configuration and status of a self-managed SSL certificate.", + "type": "object", + "properties": { + "certificate": { + "description": "A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.", + "type": "string" + }, + "privateKey": { + "description": "A write-only private key in PEM format. Only insert requests will include this field.", + "type": "string" + } + } + }, + "SslCertificateAggregatedList": { + "id": "SslCertificateAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#sslCertificateAggregatedList for lists of SSL Certificates.", + "default": "compute#sslCertificateAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of SslCertificatesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of SslCertificates.", + "$ref": "SslCertificatesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { + } + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SslCertificatesScopedList": { + "id": "SslCertificatesScopedList", + "type": "object", + "properties": { + "sslCertificates": { + "description": "List of SslCertificates contained in this scope.", + "type": "array", + "items": { "$ref": "SslCertificate" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a SslCertificate resource in the specified project and region using the data included in the request" + } }, - "delete": { - "id": "compute.regionSslCertificates.delete", - "path": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", - "flatPath": "projects/{project}/regions/{region}/sslCertificates/{sslCertificate}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "Informational warning which replaces the list of backend services when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "sslCertificate": { - "description": "Name of the SslCertificate resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "sslCertificate" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified SslCertificate resource in the region." + } } } }, - "sslPolicies": { - "methods": { - "list": { - "id": "compute.sslPolicies.list", - "path": "projects/{project}/global/sslPolicies", - "flatPath": "projects/{project}/global/sslPolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "SslPoliciesList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all the SSL policies that have been configured for the specified project." + "SslPoliciesList": { + "id": "SslPoliciesList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#sslPoliciesList for lists of sslPolicies.", + "default": "compute#sslPoliciesList", + "type": "string" }, - "get": { - "id": "compute.sslPolicies.get", - "path": "projects/{project}/global/sslPolicies/{sslPolicy}", - "flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "sslPolicy": { - "description": "Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "sslPolicy" - ], - "response": { - "$ref": "SslPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all of the ordered rules present in a single specified policy." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.sslPolicies.insert", - "path": "projects/{project}/global/sslPolicies", - "flatPath": "projects/{project}/global/sslPolicies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { + "items": { + "description": "A list of SslPolicy resources.", + "type": "array", + "items": { "$ref": "SslPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Returns the specified SSL policy resource." + } }, - "delete": { - "id": "compute.sslPolicies.delete", - "path": "projects/{project}/global/sslPolicies/{sslPolicy}", - "flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "sslPolicy": { - "description": "Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "sslPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified SSL policy. The SSL policy resource can be deleted only if it is not in use by any TargetHttpsProxy or TargetSslProxy resources." + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "patch": { - "id": "compute.sslPolicies.patch", - "path": "projects/{project}/global/sslPolicies/{sslPolicy}", - "flatPath": "projects/{project}/global/sslPolicies/{sslPolicy}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "sslPolicy": { - "description": "Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "sslPolicy" - ], - "request": { - "$ref": "SslPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified SSL policy with the data included in the request." + } + } + } + }, + "SslPolicy": { + "id": "SslPolicy", + "description": "Represents an SSL Policy resource. Use SSL policies to control SSL features, such as versions and cipher suites, that are offered by Application Load Balancers and proxy Network Load Balancers. For more information, read SSL policies overview.", + "type": "object", + "properties": { + "kind": { + "description": "[Output only] Type of the resource. Always compute#sslPolicyfor SSL policies.", + "default": "compute#sslPolicy", + "type": "string" }, - "listAvailableFeatures": { - "id": "compute.sslPolicies.listAvailableFeatures", - "path": "projects/{project}/global/sslPolicies/listAvailableFeatures", - "flatPath": "projects/{project}/global/sslPolicies/listAvailableFeatures", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "name": { + "description": "Name of the resource. 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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "profile": { + "description": "Profile specifies the set of SSL features that can be used by the load balancer when negotiating SSL with clients. This can be one of COMPATIBLE, MODERN, RESTRICTED, or CUSTOM. If using CUSTOM, the set of SSL features to enable must be specified in the customFeatures field.", + "type": "string", + "enumDescriptions": [ + "Compatible profile. Allows the broadset set of clients, even those which support only out-of-date SSL features to negotiate with the load balancer.", + "Custom profile. Allow only the set of allowed SSL features specified in the customFeatures field.", + "Modern profile. Supports a wide set of SSL features, allowing modern clients to negotiate SSL with the load balancer.", + "Restricted profile. Supports a reduced set of SSL features, intended to meet stricter compliance requirements." ], - "response": { - "$ref": "SslPoliciesListAvailableFeaturesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "COMPATIBLE", + "CUSTOM", + "MODERN", + "RESTRICTED" + ] + }, + "minTlsVersion": { + "description": "The minimum version of SSL protocol that can be used by the clients to establish a connection with the load balancer. This can be one of TLS_1_0, TLS_1_1, TLS_1_2.", + "type": "string", + "enumDescriptions": [ + "TLS 1.0", + "TLS 1.1", + "TLS 1.2" ], - "description": "Lists all features that can be specified in the SSL policy when using custom profile." + "enum": [ + "TLS_1_0", + "TLS_1_1", + "TLS_1_2" + ] }, - "aggregatedList": { - "id": "compute.sslPolicies.aggregatedList", - "path": "projects/{project}/aggregated/sslPolicies", - "flatPath": "projects/{project}/aggregated/sslPolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "enabledFeatures": { + "description": "[Output Only] The list of features enabled in the SSL policy.", + "type": "array", + "items": { + "type": "string" + } + }, + "customFeatures": { + "description": "A list of features enabled when the selected profile is CUSTOM. The method returns the set of features that can be specified in this list. This field must be empty if the profile is not CUSTOM.", + "type": "array", + "items": { + "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 SslPolicy. An up-to-date fingerprint must be provided in order to update the SslPolicy, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve an SslPolicy.", + "type": "string", + "format": "byte" + }, + "warnings": { + "description": "[Output Only] If potential misconfigurations are detected for this SSL policy, this field will be populated with warning messages.", + "type": "array", + "items": { + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", + "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "SslPoliciesAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of all SslPolicy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + } + }, + "region": { + "description": "[Output Only] URL of the region where the regional SSL policy resides. This field is not applicable to global SSL policies.", + "type": "string" } } }, - "regionSslPolicies": { - "methods": { - "list": { - "id": "compute.regionSslPolicies.list", - "path": "projects/{project}/regions/{region}/sslPolicies", - "flatPath": "projects/{project}/regions/{region}/sslPolicies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "SslPoliciesList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all the SSL policies that have been configured for the specified project and region." + "SslPoliciesListAvailableFeaturesResponse": { + "id": "SslPoliciesListAvailableFeaturesResponse", + "type": "object", + "properties": { + "features": { + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SslPoliciesAggregatedList": { + "id": "SslPoliciesAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#sslPolicyAggregatedList for lists of SSL Policies.", + "default": "compute#sslPoliciesAggregatedList", + "type": "string" }, - "get": { - "id": "compute.regionSslPolicies.get", - "path": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", - "flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "sslPolicy": { - "description": "Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "sslPolicy" - ], - "response": { - "$ref": "SslPolicy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all of the ordered rules present in a single specified policy." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of SslPoliciesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of SSL policies.", + "$ref": "SslPoliciesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "insert": { - "id": "compute.regionSslPolicies.insert", - "path": "projects/{project}/regions/{region}/sslPolicies", - "flatPath": "projects/{project}/regions/{region}/sslPolicies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "SslPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a new policy in the specified project and region using the data included in the request." + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" }, - "delete": { - "id": "compute.regionSslPolicies.delete", - "path": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", - "flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "sslPolicy": { - "description": "Name of the SSL policy to delete. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "sslPolicy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified SSL policy. The SSL policy resource can be deleted only if it is not in use by any TargetHttpsProxy or TargetSslProxy resources." + } }, - "patch": { - "id": "compute.regionSslPolicies.patch", - "path": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", - "flatPath": "projects/{project}/regions/{region}/sslPolicies/{sslPolicy}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "sslPolicy": { - "description": "Name of the SSL policy to update. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "sslPolicy" - ], - "request": { - "$ref": "SslPolicy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified SSL policy with the data included in the request." + "etag": { + "type": "string" }, - "listAvailableFeatures": { - "id": "compute.regionSslPolicies.listAvailableFeatures", - "path": "projects/{project}/regions/{region}/sslPolicies/listAvailableFeatures", - "flatPath": "projects/{project}/regions/{region}/sslPolicies/listAvailableFeatures", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "SslPoliciesListAvailableFeaturesResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists all features that can be specified in the SSL policy when using custom profile." + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } } } }, - "storagePoolTypes": { - "methods": { - "list": { - "id": "compute.storagePoolTypes.list", - "path": "projects/{project}/zones/{zone}/storagePoolTypes", - "flatPath": "projects/{project}/zones/{zone}/storagePoolTypes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "StoragePoolTypeList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of storage pool types available to the specified project." + "SslPoliciesScopedList": { + "id": "SslPoliciesScopedList", + "type": "object", + "properties": { + "sslPolicies": { + "description": "A list of SslPolicies contained in this scope.", + "type": "array", + "items": { + "$ref": "SslPolicy" + } }, - "aggregatedList": { - "id": "compute.storagePoolTypes.aggregatedList", - "path": "projects/{project}/aggregated/storagePoolTypes", - "flatPath": "projects/{project}/aggregated/storagePoolTypes", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "warning": { + "description": "Informational warning which replaces the list of SSL policies when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "StoragePoolTypeAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of storage pool types. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + } + } + } + }, + "StoragePoolTypeList": { + "id": "StoragePoolTypeList", + "description": "Contains a list of storage pool types.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#storagePoolTypeList for storage pool types.", + "default": "compute#storagePoolTypeList", + "type": "string" }, - "get": { - "id": "compute.storagePoolTypes.get", - "path": "projects/{project}/zones/{zone}/storagePoolTypes/{storagePoolType}", - "flatPath": "projects/{project}/zones/{zone}/storagePoolTypes/{storagePoolType}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of StoragePoolType resources.", + "type": "array", + "items": { + "$ref": "StoragePoolType" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "storagePoolType": { - "description": "Name of the storage pool type to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "storagePoolType" - ], - "response": { - "$ref": "StoragePoolType" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified storage pool type." + } } } }, - "storagePools": { - "methods": { - "list": { - "id": "compute.storagePools.list", - "path": "projects/{project}/zones/{zone}/storagePools", - "flatPath": "projects/{project}/zones/{zone}/storagePools", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "StoragePoolList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of storage pools contained within the specified zone." + "StoragePoolType": { + "id": "StoragePoolType", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#storagePoolType for storage pool types.", + "default": "compute#storagePoolType", + "type": "string" }, - "aggregatedList": { - "id": "compute.storagePools.aggregatedList", - "path": "projects/{project}/aggregated/storagePools", - "flatPath": "projects/{project}/aggregated/storagePools", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", + "type": "string" + }, + "description": { + "description": "[Output Only] An optional description of this resource.", + "type": "string" + }, + "deprecated": { + "description": "[Output Only] The deprecation status associated with this storage pool type.", + "$ref": "DeprecationStatus" + }, + "zone": { + "description": "[Output Only] URL of the zone where the storage pool type resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource with the resource id.", + "type": "string" + }, + "minSizeGb": { + "description": "[Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb instead.", + "type": "string", + "format": "int64" + }, + "minPoolProvisionedCapacityGb": { + "description": "[Output Only] Minimum storage pool size in GB.", + "type": "string", + "format": "int64" + }, + "maxPoolProvisionedCapacityGb": { + "description": "[Output Only] Maximum storage pool size in GB.", + "type": "string", + "format": "int64" + }, + "minPoolProvisionedIops": { + "description": "[Output Only] Minimum provisioned IOPS.", + "type": "string", + "format": "int64" + }, + "maxPoolProvisionedIops": { + "description": "[Output Only] Maximum provisioned IOPS.", + "type": "string", + "format": "int64" + }, + "minPoolProvisionedThroughput": { + "description": "[Output Only] Minimum provisioned throughput.", + "type": "string", + "format": "int64" + }, + "maxPoolProvisionedThroughput": { + "description": "[Output Only] Maximum provisioned throughput.", + "type": "string", + "format": "int64" + }, + "supportedDiskTypes": { + "description": "[Output Only] The list of disk types supported in this storage pool type.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "StoragePoolTypeAggregatedList": { + "id": "StoragePoolTypeAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#storagePoolTypeAggregatedList .", + "default": "compute#storagePoolTypeAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of StoragePoolTypesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of storage pool types.", + "$ref": "StoragePoolTypesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "StoragePoolAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of storage pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + } + } + } + }, + "StoragePoolTypesScopedList": { + "id": "StoragePoolTypesScopedList", + "type": "object", + "properties": { + "storagePoolTypes": { + "description": "[Output Only] A list of storage pool types contained in this scope.", + "type": "array", + "items": { + "$ref": "StoragePoolType" + } }, - "get": { - "id": "compute.storagePools.get", - "path": "projects/{project}/zones/{zone}/storagePools/{storagePool}", - "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] Informational warning which replaces the list of storage pool types when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "storagePool": { - "description": "Name of the storage pool to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "storagePool" - ], - "response": { - "$ref": "StoragePool" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns a specified storage pool. Gets a list of available storage pools by making a list() request." + } + } + } + }, + "StoragePoolList": { + "id": "StoragePoolList", + "description": "A list of StoragePool resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#storagePoolList for lists of storagePools.", + "default": "compute#storagePoolList", + "type": "string" }, - "insert": { - "id": "compute.storagePools.insert", - "path": "projects/{project}/zones/{zone}/storagePools", - "flatPath": "projects/{project}/zones/{zone}/storagePools", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of StoragePool resources.", + "type": "array", + "items": { "$ref": "StoragePool" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a storage pool in the specified project using the data in the request." + } }, - "delete": { - "id": "compute.storagePools.delete", - "path": "projects/{project}/zones/{zone}/storagePools/{storagePool}", - "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "storagePool": { - "description": "Name of the storage pool to delete.", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "storagePool" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified storage pool. Deleting a storagePool removes its data permanently and is irreversible. However, deleting a storagePool does not delete any snapshots previously made from the storagePool. You must separately delete snapshots." + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" }, - "getIamPolicy": { - "id": "compute.storagePools.getIamPolicy", - "path": "projects/{project}/zones/{zone}/storagePools/{resource}/getIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" }, - "setIamPolicy": { - "id": "compute.storagePools.setIamPolicy", - "path": "projects/{project}/zones/{zone}/storagePools/{resource}/setIamPolicy", - "flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "request": { - "$ref": "ZoneSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + } }, - "testIamPermissions": { - "id": "compute.storagePools.testIamPermissions", - "path": "projects/{project}/zones/{zone}/storagePools/{resource}/testIamPermissions", - "flatPath": "projects/{project}/zones/{zone}/storagePools/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" + "etag": { + "type": "string" + }, + "unreachables": { + "description": "[Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "StoragePool": { + "id": "StoragePool", + "description": "Represents a zonal storage pool resource.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#storagePool for storage pools.", + "default": "compute#storagePool", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.storagePools.insert" + ] }, - "response": { - "$ref": "TestPermissionsResponse" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "poolProvisionedCapacityGb": { + "description": "Size, in GiB, of the storage pool. For more information about the size limits, see https://cloud.google.com/compute/docs/disks/storage-pools.", + "annotations": { + "required": [ + "compute.storagePools.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "type": "string", + "format": "int64" + }, + "poolProvisionedIops": { + "description": "Provisioned IOPS of the storage pool. Only relevant if the storage pool type is hyperdisk-balanced.", + "type": "string", + "format": "int64" + }, + "poolProvisionedThroughput": { + "description": "Provisioned throughput of the storage pool. Only relevant if the storage pool type is hyperdisk-balanced or hyperdisk-throughput.", + "type": "string", + "format": "int64" + }, + "zone": { + "description": "[Output Only] URL of the zone where the storage pool resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "state": { + "description": "[Output Only] The status of storage pool creation. - CREATING: Storage pool is provisioning. storagePool. - FAILED: Storage pool creation failed. - READY: Storage pool is ready for use. - DELETING: Storage pool is deleting. ", + "type": "string", + "enumDescriptions": [ + "StoragePool is provisioning", + "StoragePool is deleting.", + "StoragePool creation failed.", + "StoragePool is ready for use." ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY" + ] }, - "update": { - "id": "compute.storagePools.update", - "path": "projects/{project}/zones/{zone}/storagePools/{storagePool}", - "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "storagePool": { - "description": "The storagePool name for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "updateMask": { - "description": "update_mask indicates fields to be updated as part of this request.", - "location": "query", - "type": "string", - "format": "google-fieldmask" - }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "storagePool" + "selfLink": { + "description": "[Output Only] Server-defined fully-qualified URL for this resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL for this resource's resource id.", + "type": "string" + }, + "labels": { + "description": "Labels to apply to this storage pool. These can be later modified by the setLabels method.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this storage pool, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a storage pool.", + "type": "string", + "format": "byte" + }, + "resourceStatus": { + "description": "[Output Only] Status information for the storage pool resource.", + "$ref": "StoragePoolResourceStatus" + }, + "storagePoolType": { + "description": "Type of the storage pool.", + "type": "string" + }, + "status": { + "description": "[Output Only] Status information for the storage pool resource.", + "$ref": "StoragePoolResourceStatus" + }, + "capacityProvisioningType": { + "description": "Provisioning type of the byte capacity of the pool.", + "type": "string", + "enumDescriptions": [ + "Advanced provisioning \"thinly\" allocates the related resource.", + "Standard provisioning allocates the related resource for the pool disks' exclusive use.", + "" ], - "request": { - "$ref": "StoragePool" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "ADVANCED", + "STANDARD", + "UNSPECIFIED" + ] + }, + "performanceProvisioningType": { + "description": "Provisioning type of the performance-related parameters of the pool, such as throughput and IOPS.", + "type": "string", + "enumDescriptions": [ + "Advanced provisioning \"thinly\" allocates the related resource.", + "Standard provisioning allocates the related resource for the pool disks' exclusive use.", + "" ], - "description": "Updates the specified storagePool with the data included in the request. The update is performed only on selected fields included as part of update-mask. Only the following fields can be modified: pool_provisioned_capacity_gb, pool_provisioned_iops and pool_provisioned_throughput." + "enum": [ + "ADVANCED", + "STANDARD", + "UNSPECIFIED" + ] + } + } + }, + "StoragePoolResourceStatus": { + "id": "StoragePoolResourceStatus", + "description": "[Output Only] Contains output only fields.", + "type": "object", + "properties": { + "lastResizeTimestamp": { + "description": "[Output Only] Timestamp of the last successful resize in RFC3339 text format.", + "type": "string" }, - "listDisks": { - "id": "compute.storagePools.listDisks", - "path": "projects/{project}/zones/{zone}/storagePools/{storagePool}/listDisks", - "flatPath": "projects/{project}/zones/{zone}/storagePools/{storagePool}/listDisks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "diskCount": { + "description": "[Output Only] Number of disks used.", + "type": "string", + "format": "int64" + }, + "poolUsedCapacityBytes": { + "description": "[Output Only] Space used by data stored in disks within the storage pool (in bytes). This will reflect the total number of bytes written to the disks in the pool, in contrast to the capacity of those disks.", + "type": "string", + "format": "int64" + }, + "poolUserWrittenBytes": { + "description": "[Output Only] Amount of data written into the pool, before it is compacted.", + "type": "string", + "format": "int64" + }, + "totalProvisionedDiskCapacityGb": { + "description": "[Output Only] Sum of all the capacity provisioned in disks in this storage pool. A disk's provisioned capacity is the same as its total capacity.", + "type": "string", + "format": "int64" + }, + "maxTotalProvisionedDiskCapacityGb": { + "description": "[Output Only] Maximum allowed aggregate disk size in gigabytes.", + "type": "string", + "format": "int64" + }, + "poolUsedIops": { + "description": "[Output Only] Sum of all the disks' provisioned IOPS, minus some amount that is allowed per disk that is not counted towards pool's IOPS capacity. For more information, see https://cloud.google.com/compute/docs/disks/storage-pools.", + "type": "string", + "format": "int64" + }, + "totalProvisionedDiskIops": { + "description": "[Output Only] Sum of all the disks' provisioned IOPS.", + "type": "string", + "format": "int64" + }, + "poolUsedThroughput": { + "description": "[Output Only] Sum of all the disks' provisioned throughput in MB/s.", + "type": "string", + "format": "int64" + }, + "totalProvisionedDiskThroughput": { + "description": "[Output Only] Sum of all the disks' provisioned throughput in MB/s, minus some amount that is allowed per disk that is not counted towards pool's throughput capacity.", + "type": "string", + "format": "int64" + } + } + }, + "StoragePoolAggregatedList": { + "id": "StoragePoolAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#storagePoolAggregatedList for aggregated lists of storage pools.", + "default": "compute#storagePoolAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of StoragePoolsScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of storage pool.", + "$ref": "StoragePoolsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "storagePool": { - "description": "Name of the storage pool to list disks of.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "The name of the zone for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "storagePool" - ], - "response": { - "$ref": "StoragePoolListDisks" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the disks in a specified storage pool." + } + }, + "etag": { + "type": "string" + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } } } }, - "subnetworks": { - "methods": { - "list": { - "id": "compute.subnetworks.list", - "path": "projects/{project}/regions/{region}/subnetworks", - "flatPath": "projects/{project}/regions/{region}/subnetworks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "SubnetworkList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of subnetworks available to the specified project." + "StoragePoolsScopedList": { + "id": "StoragePoolsScopedList", + "type": "object", + "properties": { + "storagePools": { + "description": "[Output Only] A list of storage pool contained in this scope.", + "type": "array", + "items": { + "$ref": "StoragePool" + } }, - "aggregatedList": { - "id": "compute.subnetworks.aggregatedList", - "path": "projects/{project}/aggregated/subnetworks", - "flatPath": "projects/{project}/aggregated/subnetworks", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", + "warning": { + "description": "[Output Only] Informational warning which replaces the list of storage pool when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "SubnetworkAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of subnetworks. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." - }, - "listUsable": { - "id": "compute.subnetworks.listUsable", - "path": "projects/{project}/aggregated/subnetworks/listUsable", - "flatPath": "projects/{project}/aggregated/subnetworks/listUsable", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "UsableSubnetworksAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of all usable subnetworks in the project." + } + } + } + }, + "StoragePoolListDisks": { + "id": "StoragePoolListDisks", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#storagePoolListDisks for lists of disks in a storagePool.", + "default": "compute#storagePoolListDisks", + "type": "string" }, - "get": { - "id": "compute.subnetworks.get", - "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", - "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "subnetwork": { - "description": "Name of the Subnetwork resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "subnetwork" - ], - "response": { - "$ref": "Subnetwork" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified subnetwork." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.subnetworks.insert", - "path": "projects/{project}/regions/{region}/subnetworks", - "flatPath": "projects/{project}/regions/{region}/subnetworks", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of StoragePoolDisk resources.", + "type": "array", + "items": { + "$ref": "StoragePoolDisk" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" + } + }, + "etag": { + "type": "string" + }, + "unreachables": { + "description": "[Output Only] Unreachable resources. end_interface: MixerListResponseWithEtagBuilder", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "StoragePoolDisk": { + "id": "StoragePoolDisk", + "type": "object", + "properties": { + "disk": { + "description": "[Output Only] The URL of the disk.", + "type": "string" + }, + "name": { + "description": "[Output Only] The name of the disk.", + "type": "string" + }, + "status": { + "description": "[Output Only] The disk status.", + "type": "string", + "enumDescriptions": [ + "Disk is provisioning", + "Disk is deleting.", + "Disk creation failed.", + "Disk is ready for use.", + "Source data is being copied into the disk.", + "Disk is currently unavailable and cannot be accessed, attached or detached." ], - "request": { + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY", + "RESTORING", + "UNAVAILABLE" + ] + }, + "type": { + "description": "[Output Only] The disk type.", + "type": "string" + }, + "sizeGb": { + "description": "[Output Only] The disk size, in GB.", + "type": "string", + "format": "int64" + }, + "provisionedIops": { + "description": "[Output Only] The number of IOPS provisioned for the disk.", + "type": "string", + "format": "int64" + }, + "provisionedThroughput": { + "description": "[Output Only] The throughput provisioned for the disk.", + "type": "string", + "format": "int64" + }, + "usedBytes": { + "description": "[Output Only] Amount of disk space used.", + "type": "string", + "format": "int64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "attachedInstances": { + "description": "[Output Only] Instances this disk is attached to.", + "type": "array", + "items": { + "type": "string" + } + }, + "resourcePolicies": { + "description": "[Output Only] Resource policies applied to disk for automatic snapshot creations.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SubnetworkList": { + "id": "SubnetworkList", + "description": "Contains a list of Subnetwork resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#subnetworkList for lists of subnetworks.", + "default": "compute#subnetworkList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Subnetwork resources.", + "type": "array", + "items": { "$ref": "Subnetwork" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a subnetwork in the specified project using the data included in the request." + } }, - "delete": { - "id": "compute.subnetworks.delete", - "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", - "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "subnetwork": { - "description": "Name of the Subnetwork resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "subnetwork" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + } + } + } + }, + "Subnetwork": { + "id": "Subnetwork", + "description": "Represents a Subnetwork resource. A subnetwork (also known as a subnet) is a logical partition of a Virtual Private Cloud network with one primary IP range and zero or more secondary IP ranges. For more information, read Virtual Private Cloud (VPC) Network.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#subnetwork for Subnetwork resources.", + "default": "compute#subnetwork", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "The name of the resource, provided by the client when initially creating the resource. 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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource. This field can be set only at resource creation time.", + "type": "string" + }, + "network": { + "description": "The URL of the network to which this subnetwork belongs, provided by the client when initially creating the subnetwork. This field can be set only at resource creation time.", + "type": "string" + }, + "ipCidrRange": { + "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. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.", + "type": "string" + }, + "reservedInternalRange": { + "description": "The URL of the reserved internal range.", + "type": "string" + }, + "gatewayAddress": { + "description": "[Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.", + "type": "string" + }, + "region": { + "description": "URL of the region where the Subnetwork resides. This field can be set only at resource creation time.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "privateIpGoogleAccess": { + "description": "Whether the VMs in this subnet can access Google services without assigned external IP addresses. This field can be both set at resource creation time and updated using setPrivateIpGoogleAccess.", + "type": "boolean" + }, + "secondaryIpRanges": { + "description": "An array of configurations for secondary IP ranges for VM instances contained in this subnetwork. The primary IP of such VM must belong to the primary ipCidrRange of the subnetwork. The alias IPs may belong to either primary or secondary ranges. This field can be updated with a patch request.", + "type": "array", + "items": { + "$ref": "SubnetworkSecondaryRange" + } + }, + "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. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.", + "type": "string", + "format": "byte" + }, + "enableFlowLogs": { + "description": "Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. This field isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY.", + "type": "boolean" + }, + "privateIpv6GoogleAccess": { + "description": "This field is for internal use. This field can be both set at resource creation time and updated using patch.", + "type": "string", + "enumDescriptions": [ + "Disable private IPv6 access to/from Google services.", + "Bidirectional private IPv6 access to/from Google services.", + "Outbound private IPv6 access from VMs in this subnet to Google services." ], - "description": "Deletes the specified subnetwork." + "enum": [ + "DISABLE_GOOGLE_ACCESS", + "ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE", + "ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE" + ] }, - "expandIpCidrRange": { - "id": "compute.subnetworks.expandIpCidrRange", - "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/expandIpCidrRange", - "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/expandIpCidrRange", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "subnetwork": { - "description": "Name of the Subnetwork resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "subnetwork" + "ipv6CidrRange": { + "description": "[Output Only] This field is for internal use.", + "type": "string" + }, + "externalIpv6Prefix": { + "description": "The external IPv6 address range that is owned by this subnetwork.", + "type": "string" + }, + "internalIpv6Prefix": { + "description": "The internal IPv6 address range that is owned by this subnetwork.", + "type": "string" + }, + "purpose": { + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "type": "string", + "enumDescriptions": [ + "Subnet reserved for Global Envoy-based Load Balancing.", + "Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy purpose, please use REGIONAL_MANAGED_PROXY instead.", + "Regular user created or automatically created subnet.", + "Subnetwork used as source range for Private NAT Gateways.", + "Regular user created or automatically created subnet.", + "Subnetworks created for Private Service Connect in the producer network.", + "Subnetwork used for Regional Envoy-based Load Balancing." ], - "request": { - "$ref": "SubnetworksExpandIpCidrRangeRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "GLOBAL_MANAGED_PROXY", + "INTERNAL_HTTPS_LOAD_BALANCER", + "PRIVATE", + "PRIVATE_NAT", + "PRIVATE_RFC_1918", + "PRIVATE_SERVICE_CONNECT", + "REGIONAL_MANAGED_PROXY" + ] + }, + "role": { + "description": "The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request.", + "type": "string", + "enumDescriptions": [ + "The ACTIVE subnet that is currently used.", + "The BACKUP subnet that could be promoted to ACTIVE." ], - "description": "Expands the IP CIDR range of the subnetwork to a specified value." + "enum": [ + "ACTIVE", + "BACKUP" + ] }, - "patch": { - "id": "compute.subnetworks.patch", - "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", - "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}", - "httpMethod": "PATCH", - "parameters": { - "drainTimeoutSeconds": { - "description": "The drain timeout specifies the upper bound in seconds on the amount of time allowed to drain connections from the current ACTIVE subnetwork to the current BACKUP subnetwork. The drain timeout is only applicable when the following conditions are true: - the subnetwork being patched has purpose = INTERNAL_HTTPS_LOAD_BALANCER - the subnetwork being patched has role = BACKUP - the patch request is setting the role to ACTIVE. Note that after this patch operation the roles of the ACTIVE and BACKUP subnetworks will be swapped.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "subnetwork": { - "description": "Name of the Subnetwork resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "subnetwork" + "state": { + "description": "[Output Only] The state of the subnetwork, which can be one of the following values: READY: Subnetwork is created and ready to use DRAINING: 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", + "type": "string", + "enumDescriptions": [ + "Subnetwork is being drained.", + "Subnetwork is ready for use." ], - "request": { - "$ref": "Subnetwork" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "DRAINING", + "READY" + ] + }, + "logConfig": { + "description": "This field denotes the VPC flow logging options for this subnetwork. If logging is enabled, logs are exported to Cloud Logging.", + "$ref": "SubnetworkLogConfig" + }, + "stackType": { + "description": "The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch.", + "type": "string", + "enumDescriptions": [ + "New VMs in this subnet can have both IPv4 and IPv6 addresses.", + "New VMs in this subnet will only be assigned IPv4 addresses.", + "New VMs in this subnet will only be assigned IPv6 addresses." ], - "description": "Patches the specified subnetwork with the data included in the request. Only certain fields can be updated with a patch request as indicated in the field descriptions. You must specify the current fingerprint of the subnetwork resource being patched." + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY", + "IPV6_ONLY" + ] }, - "getIamPolicy": { - "id": "compute.subnetworks.getIamPolicy", - "path": "projects/{project}/regions/{region}/subnetworks/{resource}/getIamPolicy", - "flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/getIamPolicy", - "httpMethod": "GET", - "parameters": { - "optionsRequestedPolicyVersion": { - "description": "Requested IAM Policy version.", - "location": "query", - "type": "integer", - "format": "int32" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" + "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.", + "type": "string", + "enumDescriptions": [ + "VMs on this subnet will be assigned IPv6 addresses that are accessible via the Internet, as well as the VPC network.", + "VMs on this subnet will be assigned IPv6 addresses that are only accessible over the VPC network." ], - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "EXTERNAL", + "INTERNAL" + ] + } + } + }, + "SubnetworkSecondaryRange": { + "id": "SubnetworkSecondaryRange", + "description": "Represents a secondary IP range of a subnetwork.", + "type": "object", + "properties": { + "rangeName": { + "description": "The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork.", + "type": "string" + }, + "ipCidrRange": { + "description": "The range of IP addresses belonging to this subnetwork secondary range. Provide this property when you create the subnetwork. Ranges must be unique and non-overlapping with all primary and secondary IP ranges within a network. Only IPv4 is supported. The range can be any range listed in the Valid ranges list.", + "type": "string" + }, + "reservedInternalRange": { + "description": "The URL of the reserved internal range.", + "type": "string" + } + } + }, + "SubnetworkLogConfig": { + "id": "SubnetworkLogConfig", + "description": "The available logging options for this subnetwork.", + "type": "object", + "properties": { + "enable": { + "description": "Whether to enable flow logging for this subnetwork. If this field is not explicitly set, it will not appear in get listings. If not set the default behavior is determined by the org policy, if there is no org policy specified, then it will default to disabled. Flow logging isn't supported if the subnet purpose field is set to REGIONAL_MANAGED_PROXY.", + "type": "boolean" + }, + "aggregationInterval": { + "description": "Can only be specified if VPC flow logging for this subnetwork is enabled. Toggles the aggregation interval for collecting flow logs. Increasing the interval time will reduce the amount of generated flow logs for long lasting connections. Default is an interval of 5 seconds per connection.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "", + "", + "" ], - "description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists." + "enum": [ + "INTERVAL_10_MIN", + "INTERVAL_15_MIN", + "INTERVAL_1_MIN", + "INTERVAL_30_SEC", + "INTERVAL_5_MIN", + "INTERVAL_5_SEC" + ] }, - "setIamPolicy": { - "id": "compute.subnetworks.setIamPolicy", - "path": "projects/{project}/regions/{region}/subnetworks/{resource}/setIamPolicy", - "flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/setIamPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "flowSampling": { + "description": "Can only be specified if VPC flow logging for this subnetwork is enabled. The value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs within the subnetwork where 1.0 means all collected logs are reported and 0.0 means no logs are reported. Default is 0.5 unless otherwise specified by the org policy, which means half of all collected logs are reported.", + "type": "number", + "format": "float" + }, + "metadata": { + "description": "Can only be specified if VPC flow logs for this subnetwork is enabled. Configures whether all, none or a subset of metadata fields should be added to the reported VPC flow logs. Default is EXCLUDE_ALL_METADATA.", + "type": "string", + "enumDescriptions": [ + "", + "", + "" + ], + "enum": [ + "CUSTOM_METADATA", + "EXCLUDE_ALL_METADATA", + "INCLUDE_ALL_METADATA" + ] + }, + "metadataFields": { + "description": "Can only be specified if VPC flow logs for this subnetwork is enabled and \"metadata\" was set to CUSTOM_METADATA.", + "type": "array", + "items": { + "type": "string" + } + }, + "filterExpr": { + "description": "Can only be specified if VPC flow logs for this subnetwork is enabled. The filter expression is used to define which VPC flow logs should be exported to Cloud Logging.", + "type": "string" + } + } + }, + "SubnetworkAggregatedList": { + "id": "SubnetworkAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#subnetworkAggregatedList for aggregated lists of subnetworks.", + "default": "compute#subnetworkAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of SubnetworksScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of Subnetworks.", + "$ref": "SubnetworksScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } + } + } + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "SubnetworksScopedList": { + "id": "SubnetworksScopedList", + "type": "object", + "properties": { + "subnetworks": { + "description": "A list of subnetworks contained in this scope.", + "type": "array", + "items": { + "$ref": "Subnetwork" + } + }, + "warning": { + "description": "An informational warning that appears when the list of addresses is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] + }, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetPolicyRequest" - }, - "response": { - "$ref": "Policy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the access control policy on the specified resource. Replaces any existing policy." + } + } + } + }, + "UsableSubnetworksAggregatedList": { + "id": "UsableSubnetworksAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#usableSubnetworksAggregatedList for aggregated lists of usable subnetworks.", + "default": "compute#usableSubnetworksAggregatedList", + "type": "string" }, - "testIamPermissions": { - "id": "compute.subnetworks.testIamPermissions", - "path": "projects/{project}/regions/{region}/subnetworks/{resource}/testIamPermissions", - "flatPath": "projects/{project}/regions/{region}/subnetworks/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string" + }, + "items": { + "description": "[Output] A list of usable subnetwork URLs.", + "type": "array", + "items": { + "$ref": "UsableSubnetwork" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results. In special cases listUsable may return 0 subnetworks and nextPageToken which still should be used to get the next page of results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" + } + } + } + }, + "UsableSubnetwork": { + "id": "UsableSubnetwork", + "description": "Subnetwork which the current user has compute.subnetworks.use permission on.", + "type": "object", + "properties": { + "subnetwork": { + "description": "Subnetwork URL.", + "type": "string" + }, + "network": { + "description": "Network URL.", + "type": "string" + }, + "ipCidrRange": { + "description": "The range of internal addresses that are owned by this subnetwork.", + "type": "string" + }, + "secondaryIpRanges": { + "description": "Secondary IP ranges.", + "type": "array", + "items": { + "$ref": "UsableSubnetworkSecondaryRange" + } + }, + "stackType": { + "description": "The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the subnet can be assigned both IPv4 and IPv6 addresses. If not specified, IPV4_ONLY is used. This field can be both set at resource creation time and updated using patch.", + "type": "string", + "enumDescriptions": [ + "New VMs in this subnet can have both IPv4 and IPv6 addresses.", + "New VMs in this subnet will only be assigned IPv4 addresses.", + "New VMs in this subnet will only be assigned IPv6 addresses." ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY", + "IPV6_ONLY" + ] + }, + "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.", + "type": "string", + "enumDescriptions": [ + "VMs on this subnet will be assigned IPv6 addresses that are accessible via the Internet, as well as the VPC network.", + "VMs on this subnet will be assigned IPv6 addresses that are only accessible over the VPC network." ], - "description": "Returns permissions that a caller has on the specified resource." + "enum": [ + "EXTERNAL", + "INTERNAL" + ] }, - "setPrivateIpGoogleAccess": { - "id": "compute.subnetworks.setPrivateIpGoogleAccess", - "path": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/setPrivateIpGoogleAccess", - "flatPath": "projects/{project}/regions/{region}/subnetworks/{subnetwork}/setPrivateIpGoogleAccess", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "subnetwork": { - "description": "Name of the Subnetwork resource.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "subnetwork" + "purpose": { + "description": "The purpose of the resource. This field can be either PRIVATE, GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or PRIVATE is the default purpose for user-created subnets or subnets that are automatically created in auto mode networks. Subnets with purpose set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks that are reserved for Envoy-based load balancers. A subnet with purpose set to PRIVATE_SERVICE_CONNECT is used to publish services using Private Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. The enableFlowLogs field isn't supported if the subnet purpose field is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY.", + "type": "string", + "enumDescriptions": [ + "Subnet reserved for Global Envoy-based Load Balancing.", + "Subnet reserved for Internal HTTP(S) Load Balancing. This is a legacy purpose, please use REGIONAL_MANAGED_PROXY instead.", + "Regular user created or automatically created subnet.", + "Subnetwork used as source range for Private NAT Gateways.", + "Regular user created or automatically created subnet.", + "Subnetworks created for Private Service Connect in the producer network.", + "Subnetwork used for Regional Envoy-based Load Balancing." ], - "request": { - "$ref": "SubnetworksSetPrivateIpGoogleAccessRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "GLOBAL_MANAGED_PROXY", + "INTERNAL_HTTPS_LOAD_BALANCER", + "PRIVATE", + "PRIVATE_NAT", + "PRIVATE_RFC_1918", + "PRIVATE_SERVICE_CONNECT", + "REGIONAL_MANAGED_PROXY" + ] + }, + "role": { + "description": "The role of subnetwork. Currently, this field is only used when purpose is set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being used for Envoy-based load balancers in a region. A BACKUP subnetwork is one that is ready to be promoted to ACTIVE or is currently draining. This field can be updated with a patch request.", + "type": "string", + "enumDescriptions": [ + "The ACTIVE subnet that is currently used.", + "The BACKUP subnet that could be promoted to ACTIVE." ], - "description": "Set whether VMs in this subnet can access Google services without assigning external IP addresses through Private Google Access." + "enum": [ + "ACTIVE", + "BACKUP" + ] + }, + "externalIpv6Prefix": { + "description": "[Output Only] The external IPv6 address range that is assigned to this subnetwork.", + "type": "string" + }, + "internalIpv6Prefix": { + "description": "[Output Only] The internal IPv6 address range that is assigned to this subnetwork.", + "type": "string" } } }, - "targetGrpcProxies": { - "methods": { - "list": { - "id": "compute.targetGrpcProxies.list", - "path": "projects/{project}/global/targetGrpcProxies", - "flatPath": "projects/{project}/global/targetGrpcProxies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "UsableSubnetworkSecondaryRange": { + "id": "UsableSubnetworkSecondaryRange", + "description": "Secondary IP range of a usable subnetwork.", + "type": "object", + "properties": { + "rangeName": { + "description": "The name associated with this subnetwork secondary range, used when adding an alias IP range to a VM instance. The name must be 1-63 characters long, and comply with RFC1035. The name must be unique within the subnetwork.", + "type": "string" + }, + "ipCidrRange": { + "description": "The range of IP addresses belonging to this subnetwork secondary range.", + "type": "string" + } + } + }, + "SubnetworksExpandIpCidrRangeRequest": { + "id": "SubnetworksExpandIpCidrRangeRequest", + "type": "object", + "properties": { + "ipCidrRange": { + "description": "The IP (in CIDR format or netmask) of internal addresses that are legal on this Subnetwork. This range should be disjoint from other subnetworks within this network. This range can only be larger than (i.e. a superset of) the range previously defined before the update.", + "type": "string" + } + } + }, + "SubnetworksSetPrivateIpGoogleAccessRequest": { + "id": "SubnetworksSetPrivateIpGoogleAccessRequest", + "type": "object", + "properties": { + "privateIpGoogleAccess": { + "type": "boolean" + } + } + }, + "TargetGrpcProxyList": { + "id": "TargetGrpcProxyList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies.", + "default": "compute#targetGrpcProxyList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetGrpcProxy resources.", + "type": "array", + "items": { + "$ref": "TargetGrpcProxy" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetGrpcProxyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Lists the TargetGrpcProxies for a project in the given scope." + } + } + } + }, + "TargetGrpcProxy": { + "id": "TargetGrpcProxy", + "description": "Represents a Target gRPC Proxy resource. A target gRPC proxy is a component of load balancers intended for load balancing gRPC traffic. Only global forwarding rules with load balancing scheme INTERNAL_SELF_MANAGED can reference a target gRPC proxy. The target gRPC Proxy references a URL map that specifies how traffic is routed to gRPC backend services.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#targetGrpcProxy for target grpc proxies.", + "default": "compute#targetGrpcProxy", + "type": "string" }, - "get": { - "id": "compute.targetGrpcProxies.get", - "path": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", - "flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "targetGrpcProxy": { - "description": "Name of the TargetGrpcProxy resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetGrpcProxy" - ], - "response": { - "$ref": "TargetGrpcProxy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified TargetGrpcProxy resource in the given scope." + "id": { + "description": "[Output Only] The unique identifier for the resource type. The server generates this identifier.", + "type": "string", + "format": "uint64" }, - "insert": { - "id": "compute.targetGrpcProxies.insert", - "path": "projects/{project}/global/targetGrpcProxies", - "flatPath": "projects/{project}/global/targetGrpcProxies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "TargetGrpcProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a TargetGrpcProxy in the specified project in the given scope using the parameters that are included in the request." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "delete": { - "id": "compute.targetGrpcProxies.delete", - "path": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", - "flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetGrpcProxy": { - "description": "Name of the TargetGrpcProxy resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetGrpcProxy" - ], - "response": { - "$ref": "Operation" + "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])?", + "annotations": { + "required": [ + "compute.targetGrpcProxies.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetGrpcProxy in the given scope" + "type": "string" }, - "patch": { - "id": "compute.targetGrpcProxies.patch", - "path": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", - "flatPath": "projects/{project}/global/targetGrpcProxies/{targetGrpcProxy}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetGrpcProxy": { - "description": "Name of the TargetGrpcProxy resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetGrpcProxy" - ], - "request": { - "$ref": "TargetGrpcProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified TargetGrpcProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "selfLinkWithId": { + "description": "[Output Only] Server-defined URL with id for the resource.", + "type": "string" + }, + "urlMap": { + "description": "URL to the UrlMap resource that defines the mapping from URL to the BackendService. The protocol field in the BackendService must be set to GRPC.", + "type": "string" + }, + "validateForProxyless": { + "description": "If true, indicates that the BackendServices referenced by the urlMap may be accessed by gRPC applications without using a sidecar proxy. This will enable configuration checks on urlMap and its referenced BackendServices to not allow unsupported features. A gRPC application must use \"xds:///\" scheme in the target URI of the service it is connecting to. If false, indicates that the BackendServices referenced by the urlMap will be accessed by gRPC applications via a sidecar proxy. In this case, a gRPC application must not use \"xds:///\" scheme in the target URI of the service it is connecting to", + "type": "boolean" + }, + "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 TargetGrpcProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetGrpcProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetGrpcProxy.", + "type": "string", + "format": "byte" } } }, - "targetHttpProxies": { - "methods": { - "list": { - "id": "compute.targetHttpProxies.list", - "path": "projects/{project}/global/targetHttpProxies", - "flatPath": "projects/{project}/global/targetHttpProxies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetHttpProxyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of TargetHttpProxy resources available to the specified project." + "TargetHttpProxyList": { + "id": "TargetHttpProxyList", + "description": "A list of TargetHttpProxy resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource. Always compute#targetHttpProxyList for lists of target HTTP proxies.", + "default": "compute#targetHttpProxyList", + "type": "string" }, - "get": { - "id": "compute.targetHttpProxies.get", - "path": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", - "flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "targetHttpProxy": { - "description": "Name of the TargetHttpProxy resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetHttpProxy" - ], - "response": { - "$ref": "TargetHttpProxy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified TargetHttpProxy resource." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.targetHttpProxies.insert", - "path": "projects/{project}/global/targetHttpProxies", - "flatPath": "projects/{project}/global/targetHttpProxies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { + "items": { + "description": "A list of TargetHttpProxy resources.", + "type": "array", + "items": { "$ref": "TargetHttpProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a TargetHttpProxy resource in the specified project using the data included in the request." + } }, - "delete": { - "id": "compute.targetHttpProxies.delete", - "path": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", - "flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetHttpProxy": { - "description": "Name of the TargetHttpProxy resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "targetHttpProxy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetHttpProxy resource." + } + } + } + }, + "TargetHttpProxy": { + "id": "TargetHttpProxy", + "description": "Represents a Target HTTP Proxy resource. Google Compute Engine has two Target HTTP Proxy resources: * [Global](/compute/docs/reference/rest/v1/targetHttpProxies) * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies) A target HTTP proxy is a component of Google Cloud HTTP load balancers. * targetHttpProxies are used by global external Application Load Balancers, classic Application Load Balancers, cross-region internal Application Load Balancers, and Traffic Director. * regionTargetHttpProxies are used by regional internal Application Load Balancers and regional external Application Load Balancers. Forwarding rules reference a target HTTP proxy, and the target proxy then references a URL map. For more information, read Using Target Proxies and Forwarding rule concepts.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#targetHttpProxy for target HTTP proxies.", + "default": "compute#targetHttpProxy", + "type": "string" }, - "patch": { - "id": "compute.targetHttpProxies.patch", - "path": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", - "flatPath": "projects/{project}/global/targetHttpProxies/{targetHttpProxy}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetHttpProxy": { - "description": "Name of the TargetHttpProxy resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetHttpProxy" - ], - "request": { + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "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" + }, + "region": { + "description": "[Output Only] URL of the region where the regional Target HTTP Proxy resides. This field is not applicable to global Target HTTP Proxies.", + "type": "string" + }, + "proxyBind": { + "description": "This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false.", + "type": "boolean" + }, + "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 TargetHttpProxy. An up-to-date fingerprint must be provided in order to patch/update the TargetHttpProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpProxy.", + "type": "string", + "format": "byte" + }, + "httpKeepAliveTimeoutSec": { + "description": "Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported.", + "type": "integer", + "format": "int32" + } + } + }, + "UrlMapReference": { + "id": "UrlMapReference", + "type": "object", + "properties": { + "urlMap": { + "type": "string" + } + } + }, + "TargetHttpProxyAggregatedList": { + "id": "TargetHttpProxyAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#targetHttpProxyAggregatedList for lists of Target HTTP Proxies.", + "default": "compute#targetHttpProxyAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetHttpProxiesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of TargetHttpProxies.", + "$ref": "TargetHttpProxiesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "TargetHttpProxiesScopedList": { + "id": "TargetHttpProxiesScopedList", + "type": "object", + "properties": { + "targetHttpProxies": { + "description": "A list of TargetHttpProxies contained in this scope.", + "type": "array", + "items": { "$ref": "TargetHttpProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified TargetHttpProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + } }, - "setUrlMap": { - "id": "compute.targetHttpProxies.setUrlMap", - "path": "projects/{project}/targetHttpProxies/{targetHttpProxy}/setUrlMap", - "flatPath": "projects/{project}/targetHttpProxies/{targetHttpProxy}/setUrlMap", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "Informational warning which replaces the list of backend services when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetHttpProxy": { - "description": "Name of the TargetHttpProxy to set a URL map for.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "targetHttpProxy" - ], - "request": { - "$ref": "UrlMapReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the URL map for TargetHttpProxy." + } + } + } + }, + "TargetHttpsProxyList": { + "id": "TargetHttpsProxyList", + "description": "Contains a list of TargetHttpsProxy resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource. Always compute#targetHttpsProxyList for lists of target HTTPS proxies.", + "default": "compute#targetHttpsProxyList", + "type": "string" }, - "aggregatedList": { - "id": "compute.targetHttpProxies.aggregatedList", - "path": "projects/{project}/aggregated/targetHttpProxies", - "flatPath": "projects/{project}/aggregated/targetHttpProxies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetHttpsProxy resources.", + "type": "array", + "items": { + "$ref": "TargetHttpsProxy" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetHttpProxyAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of all TargetHttpProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + } } } }, - "regionTargetHttpProxies": { - "methods": { - "list": { - "id": "compute.regionTargetHttpProxies.list", - "path": "projects/{project}/regions/{region}/targetHttpProxies", - "flatPath": "projects/{project}/regions/{region}/targetHttpProxies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "TargetHttpProxyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of TargetHttpProxy resources available to the specified project in the specified region." + "TargetHttpsProxy": { + "id": "TargetHttpsProxy", + "description": "Represents a Target HTTPS Proxy resource. Google Compute Engine has two Target HTTPS Proxy resources: * [Global](/compute/docs/reference/rest/v1/targetHttpsProxies) * [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies) A target HTTPS proxy is a component of GCP HTTPS load balancers. * targetHttpProxies are used by global external Application Load Balancers, classic Application Load Balancers, cross-region internal Application Load Balancers, and Traffic Director. * regionTargetHttpProxies are used by regional internal Application Load Balancers and regional external Application Load Balancers. Forwarding rules reference a target HTTPS proxy, and the target proxy then references a URL map. For more information, read Using Target Proxies and Forwarding rule concepts.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#targetHttpsProxy for target HTTPS proxies.", + "default": "compute#targetHttpsProxy", + "type": "string" }, - "get": { - "id": "compute.regionTargetHttpProxies.get", - "path": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", - "flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "targetHttpProxy": { - "description": "Name of the TargetHttpProxy resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetHttpProxy" - ], - "response": { - "$ref": "TargetHttpProxy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified TargetHttpProxy resource in the specified region." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "insert": { - "id": "compute.regionTargetHttpProxies.insert", - "path": "projects/{project}/regions/{region}/targetHttpProxies", - "flatPath": "projects/{project}/regions/{region}/targetHttpProxies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "TargetHttpProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a TargetHttpProxy resource in the specified project and region using the data included in the request." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "delete": { - "id": "compute.regionTargetHttpProxies.delete", - "path": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", - "flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetHttpProxy": { - "description": "Name of the TargetHttpProxy resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetHttpProxy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetHttpProxy resource." + "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" }, - "setUrlMap": { - "id": "compute.regionTargetHttpProxies.setUrlMap", - "path": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}/setUrlMap", - "flatPath": "projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}/setUrlMap", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetHttpProxy": { - "description": "Name of the TargetHttpProxy to set a URL map for.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetHttpProxy" + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "urlMap": { + "description": "A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService. For example, the following are all valid URLs for specifying a URL map: - https://www.googleapis.compute/v1/projects/project/global/urlMaps/ url-map - projects/project/global/urlMaps/url-map - global/urlMaps/url-map ", + "type": "string" + }, + "sslCertificates": { + "description": "URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. At least one SSL certificate must be specified. SslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate resource or Certificate Manager Certificate resource. Mixing Classic Certificates and Certificate Manager Certificates is not allowed. Certificate Manager Certificates must include the certificatemanager API. Certificate Manager Certificates are not supported by Global external Application Load Balancer or Classic Application Load Balancer, use certificate_map instead. Currently, you may specify up to 15 Classic SSL Certificates. Certificate Manager Certificates accepted formats are: - //certificatemanager.googleapis.com/projects/{project}/locations/{ location}/certificates/{resourceName}. - https://certificatemanager.googleapis.com/v1alpha1/projects/{project }/locations/{location}/certificates/{resourceName}. ", + "type": "array", + "items": { + "type": "string" + } + }, + "certificateMap": { + "description": "URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for Global external Application Load Balancer or Classic Application Load Balancer. For other products use Certificate Manager Certificates instead. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", + "type": "string" + }, + "quicOverride": { + "description": "Specifies the QUIC override policy for this TargetHttpsProxy resource. This setting determines whether the load balancer attempts to negotiate QUIC with clients. You can specify NONE, ENABLE, or DISABLE. - When quic-override is set to NONE, Google manages whether QUIC is used. - When quic-override is set to ENABLE, the load balancer uses QUIC when possible. - When quic-override is set to DISABLE, the load balancer doesn't use QUIC. - If the quic-override flag is not specified, NONE is implied. ", + "type": "string", + "enumDescriptions": [ + "The load balancer will not attempt to negotiate QUIC with clients.", + "The load balancer will attempt to negotiate QUIC with clients.", + "No overrides to the default QUIC policy. This option is implicit if no QUIC override has been specified in the request." ], - "request": { - "$ref": "UrlMapReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "DISABLE", + "ENABLE", + "NONE" + ] + }, + "sslPolicy": { + "description": "URL of SslPolicy resource that will be associated with the TargetHttpsProxy resource. If not set, the TargetHttpsProxy resource has no SSL policy configured.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the regional TargetHttpsProxy resides. This field is not applicable to global TargetHttpsProxies.", + "type": "string" + }, + "proxyBind": { + "description": "This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false.", + "type": "boolean" + }, + "serverTlsPolicy": { + "description": "Optional. A URL referring to a networksecurity.ServerTlsPolicy resource that describes how the proxy should authenticate inbound traffic. serverTlsPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL or EXTERNAL_MANAGED. For details which ServerTlsPolicy resources are accepted with INTERNAL_SELF_MANAGED and which with EXTERNAL, EXTERNAL_MANAGED loadBalancingScheme consult ServerTlsPolicy documentation. If left blank, communications are not encrypted.", + "type": "string" + }, + "authorizationPolicy": { + "description": "Optional. A URL referring to a networksecurity.AuthorizationPolicy resource that describes how the proxy should authorize inbound traffic. If left blank, access will not be restricted by an authorization policy. Refer to the AuthorizationPolicy resource for additional details. authorizationPolicy only applies to a global TargetHttpsProxy attached to globalForwardingRules with the loadBalancingScheme set to INTERNAL_SELF_MANAGED. Note: This field currently has no impact.", + "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 TargetHttpsProxy. An up-to-date fingerprint must be provided in order to patch the TargetHttpsProxy; otherwise, the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve the TargetHttpsProxy.", + "type": "string", + "format": "byte" + }, + "httpKeepAliveTimeoutSec": { + "description": "Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported.", + "type": "integer", + "format": "int32" + }, + "tlsEarlyData": { + "description": " Specifies whether TLS 1.3 0-RTT Data (\"Early Data\") should be accepted for this service. Early Data allows a TLS resumption handshake to include the initial application payload (a HTTP request) alongside the handshake, reducing the effective round trips to \"zero\". This applies to TLS 1.3 connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). This can improve application performance, especially on networks where interruptions may be common, such as on mobile. Requests with Early Data will have the \"Early-Data\" HTTP header set on the request, with a value of \"1\", to allow the backend to determine whether Early Data was included. Note: TLS Early Data may allow requests to be replayed, as the data is sent to the backend before the handshake has fully completed. Applications that allow idempotent HTTP methods to make non-idempotent changes, such as a GET request updating a database, should not accept Early Data on those requests, and reject requests with the \"Early-Data: 1\" HTTP header by returning a HTTP 425 (Too Early) status code, in order to remain RFC compliant. The default value is DISABLED.", + "type": "string", + "enumDescriptions": [ + "TLS 1.3 Early Data is not advertised, and any (invalid) attempts to send Early Data will be rejected by closing the connection.", + "This enables TLS 1.3 0-RTT, and only allows Early Data to be included on requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE). This mode does not enforce any other limitations for requests with Early Data. The application owner should validate that Early Data is acceptable for a given request path.", + "This enables TLS 1.3 0-RTT, and only allows Early Data to be included on requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE) without query parameters. Requests that send Early Data with non-idempotent HTTP methods or with query parameters will be rejected with a HTTP 425." ], - "description": "Changes the URL map for TargetHttpProxy." + "enum": [ + "DISABLED", + "PERMISSIVE", + "STRICT" + ] } } }, - "targetHttpsProxies": { - "methods": { - "list": { - "id": "compute.targetHttpsProxies.list", - "path": "projects/{project}/global/targetHttpsProxies", - "flatPath": "projects/{project}/global/targetHttpsProxies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "TargetHttpsProxyAggregatedList": { + "id": "TargetHttpsProxyAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#targetHttpsProxyAggregatedList for lists of Target HTTP Proxies.", + "default": "compute#targetHttpsProxyAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetHttpsProxiesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of TargetHttpsProxies.", + "$ref": "TargetHttpsProxiesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetHttpsProxyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of TargetHttpsProxy resources available to the specified project." + } }, - "aggregatedList": { - "id": "compute.targetHttpsProxies.aggregatedList", - "path": "projects/{project}/aggregated/targetHttpsProxies", - "flatPath": "projects/{project}/aggregated/targetHttpsProxies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "TargetHttpsProxiesScopedList": { + "id": "TargetHttpsProxiesScopedList", + "type": "object", + "properties": { + "targetHttpsProxies": { + "description": "A list of TargetHttpsProxies contained in this scope.", + "type": "array", + "items": { + "$ref": "TargetHttpsProxy" + } + }, + "warning": { + "description": "Informational warning which replaces the list of backend services when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetHttpsProxyAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + } + } + } + }, + "TargetHttpsProxiesSetSslCertificatesRequest": { + "id": "TargetHttpsProxiesSetSslCertificatesRequest", + "type": "object", + "properties": { + "sslCertificates": { + "description": "New set of SslCertificate resources to associate with this TargetHttpsProxy resource. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "TargetHttpsProxiesSetCertificateMapRequest": { + "id": "TargetHttpsProxiesSetCertificateMapRequest", + "type": "object", + "properties": { + "certificateMap": { + "description": "URL of the Certificate Map to associate with this TargetHttpsProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", + "type": "string" + } + } + }, + "SslPolicyReference": { + "id": "SslPolicyReference", + "type": "object", + "properties": { + "sslPolicy": { + "description": "URL of the SSL policy resource. Set this to empty string to clear any existing SSL policy associated with the target proxy resource.", + "type": "string" + } + } + }, + "TargetHttpsProxiesSetQuicOverrideRequest": { + "id": "TargetHttpsProxiesSetQuicOverrideRequest", + "type": "object", + "properties": { + "quicOverride": { + "description": "QUIC policy for the TargetHttpsProxy resource.", + "type": "string", + "enumDescriptions": [ + "The load balancer will not attempt to negotiate QUIC with clients.", + "The load balancer will attempt to negotiate QUIC with clients.", + "No overrides to the default QUIC policy. This option is implicit if no QUIC override has been specified in the request." ], - "description": "Retrieves the list of all TargetHttpsProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "DISABLE", + "ENABLE", + "NONE" + ] + } + } + }, + "RegionTargetHttpsProxiesSetSslCertificatesRequest": { + "id": "RegionTargetHttpsProxiesSetSslCertificatesRequest", + "type": "object", + "properties": { + "sslCertificates": { + "description": "New set of SslCertificate resources to associate with this TargetHttpsProxy resource.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "TargetInstanceList": { + "id": "TargetInstanceList", + "description": "Contains a list of TargetInstance resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#targetInstanceList", + "type": "string" }, - "get": { - "id": "compute.targetHttpsProxies.get", - "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", - "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetHttpsProxy" - ], - "response": { - "$ref": "TargetHttpsProxy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified TargetHttpsProxy resource." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "insert": { - "id": "compute.targetHttpsProxies.insert", - "path": "projects/{project}/global/targetHttpsProxies", - "flatPath": "projects/{project}/global/targetHttpsProxies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "TargetHttpsProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a TargetHttpsProxy resource in the specified project using the data included in the request." + "items": { + "description": "A list of TargetInstance resources.", + "type": "array", + "items": { + "$ref": "TargetInstance" + } }, - "patch": { - "id": "compute.targetHttpsProxies.patch", - "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", - "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "targetHttpsProxy" - ], - "request": { - "$ref": "TargetHttpsProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified TargetHttpsProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + } + } + } + }, + "TargetInstance": { + "id": "TargetInstance", + "description": "Represents a Target Instance resource. You can use a target instance to handle traffic for one or more forwarding rules, which is ideal for forwarding protocol traffic that is managed by a single source. For example, ESP, AH, TCP, or UDP. For more information, read Target instances.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] The type of the resource. Always compute#targetInstance for target instances.", + "default": "compute#targetInstance", + "type": "string" }, - "delete": { - "id": "compute.targetHttpsProxies.delete", - "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", - "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetHttpsProxy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetHttpsProxy resource." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "setUrlMap": { - "id": "compute.targetHttpsProxies.setUrlMap", - "path": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", - "flatPath": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource whose URL map is to be set.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetHttpsProxy" - ], - "request": { - "$ref": "UrlMapReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "zone": { + "description": "[Output Only] URL of the zone where the target instance resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "natPolicy": { + "description": "Must have a value of NO_NAT. Protocol forwarding delivers packets while preserving the destination IP address of the forwarding rule referencing the target instance.", + "type": "string", + "enumDescriptions": [ + "No NAT performed." ], - "description": "Changes the URL map for TargetHttpsProxy." + "enum": [ + "NO_NAT" + ] }, - "setSslCertificates": { - "id": "compute.targetHttpsProxies.setSslCertificates", - "path": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", - "flatPath": "projects/{project}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "instance": { + "description": "A URL to the virtual machine instance that handles traffic for this target instance. When creating a target instance, you can provide the fully-qualified URL or a valid partial URL to the desired virtual machine. For example, the following are all valid URLs: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance - zones/zone/instances/instance ", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "network": { + "description": "The URL of the network this target instance uses to forward traffic. If not specified, the traffic will be forwarded to the network that the default network interface belongs to.", + "type": "string" + }, + "securityPolicy": { + "description": "[Output Only] The resource URL for the security policy associated with this target instance.", + "type": "string" + } + } + }, + "TargetInstanceAggregatedList": { + "id": "TargetInstanceAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#targetInstanceAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetInstance resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of target instances.", + "$ref": "TargetInstancesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource to set an SslCertificates resource for.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "targetHttpsProxy" - ], - "request": { - "$ref": "TargetHttpsProxiesSetSslCertificatesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Replaces SslCertificates for TargetHttpsProxy." + } }, - "setCertificateMap": { - "id": "compute.targetHttpsProxies.setCertificateMap", - "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setCertificateMap", - "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setCertificateMap", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "TargetInstancesScopedList": { + "id": "TargetInstancesScopedList", + "type": "object", + "properties": { + "targetInstances": { + "description": "A list of target instances contained in this scope.", + "type": "array", + "items": { + "$ref": "TargetInstance" + } + }, + "warning": { + "description": "Informational warning which replaces the list of addresses when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "targetHttpsProxy" - ], - "request": { - "$ref": "TargetHttpsProxiesSetCertificateMapRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the Certificate Map for TargetHttpsProxy." + } + } + } + }, + "TargetPoolList": { + "id": "TargetPoolList", + "description": "Contains a list of TargetPool resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#targetPoolList for lists of target pools.", + "default": "compute#targetPoolList", + "type": "string" }, - "setSslPolicy": { - "id": "compute.targetHttpsProxies.setSslPolicy", - "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setSslPolicy", - "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setSslPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetHttpsProxy" - ], - "request": { - "$ref": "SslPolicyReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the SSL policy for TargetHttpsProxy. The SSL policy specifies the server-side support for SSL features. This affects connections between clients and the HTTPS proxy load balancer. They do not affect the connection between the load balancer and the backends." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "setQuicOverride": { - "id": "compute.targetHttpsProxies.setQuicOverride", - "path": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setQuicOverride", - "flatPath": "projects/{project}/global/targetHttpsProxies/{targetHttpsProxy}/setQuicOverride", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of TargetPool resources.", + "type": "array", + "items": { + "$ref": "TargetPool" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource to set the QUIC override policy for. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "targetHttpsProxy" - ], - "request": { - "$ref": "TargetHttpsProxiesSetQuicOverrideRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + } + } + } + }, + "TargetPool": { + "id": "TargetPool", + "description": "Represents a Target Pool resource. Target pools are used with external passthrough Network Load Balancers. A target pool references member instances, an associated legacy HttpHealthCheck resource, and, optionally, a backup target pool. For more information, read Using target pools.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#targetPool for target pools.", + "default": "compute#targetPool", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the target pool resides.", + "type": "string" + }, + "healthChecks": { + "description": "The URL of the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if the health checks pass. Only legacy HttpHealthChecks are supported. Only one health check may be specified.", + "type": "array", + "items": { + "type": "string" + } + }, + "instances": { + "description": "A list of resource URLs to the virtual machine instances serving this pool. They must live in zones contained in the same region as this pool.", + "type": "array", + "items": { + "type": "string" + } + }, + "sessionAffinity": { + "description": "Session 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.", + "type": "string", + "enumDescriptions": [ + "2-tuple hash on packet's source and destination IP addresses. Connections from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy.", + "1-tuple hash only on packet's source IP address. Connections from the same source IP address will be served by the same backend VM while that VM remains healthy. This option can only be used for Internal TCP/UDP Load Balancing.", + "5-tuple hash on packet's source and destination IP addresses, IP protocol, and source and destination ports. Connections for the same IP protocol from the same source IP address and port to the same destination IP address and port will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing.", + "3-tuple hash on packet's source and destination IP addresses, and IP protocol. Connections for the same IP protocol from the same source IP address to the same destination IP address will be served by the same backend VM while that VM remains healthy. This option cannot be used for HTTP(S) load balancing.", + "Hash based on a cookie generated by the L7 loadbalancer. Only valid for HTTP(S) load balancing.", + "The hash is based on a user specified header field.", + "The hash is based on a user provided cookie.", + "No session affinity. Connections from the same client IP may go to any instance in the pool.", + "Strong cookie-based affinity. Connections bearing the same cookie will be served by the same backend VM while that VM remains healthy, as long as the cookie has not expired." ], - "description": "Sets the QUIC override policy for TargetHttpsProxy." + "enum": [ + "CLIENT_IP", + "CLIENT_IP_NO_DESTINATION", + "CLIENT_IP_PORT_PROTO", + "CLIENT_IP_PROTO", + "GENERATED_COOKIE", + "HEADER_FIELD", + "HTTP_COOKIE", + "NONE", + "STRONG_COOKIE_AFFINITY" + ] + }, + "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]. If 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. In 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.", + "type": "number", + "format": "float" + }, + "backupPool": { + "description": "The server-defined URL for the resource. 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]. backupPool 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. In 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" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "securityPolicy": { + "description": "[Output Only] The resource URL for the security policy associated with this target pool.", + "type": "string" } } }, - "regionTargetHttpsProxies": { - "methods": { - "list": { - "id": "compute.regionTargetHttpsProxies.list", - "path": "projects/{project}/regions/{region}/targetHttpsProxies", - "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "TargetPoolAggregatedList": { + "id": "TargetPoolAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#targetPoolAggregatedList for aggregated lists of target pools.", + "default": "compute#targetPoolAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetPool resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of target pools.", + "$ref": "TargetPoolsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "TargetHttpsProxyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of TargetHttpsProxy resources available to the specified project in the specified region." + } }, - "get": { - "id": "compute.regionTargetHttpsProxies.get", - "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", - "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetHttpsProxy" - ], - "response": { - "$ref": "TargetHttpsProxy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified TargetHttpsProxy resource in the specified region." + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "TargetPoolsScopedList": { + "id": "TargetPoolsScopedList", + "type": "object", + "properties": { + "targetPools": { + "description": "A list of target pools contained in this scope.", + "type": "array", + "items": { + "$ref": "TargetPool" + } }, - "insert": { - "id": "compute.regionTargetHttpsProxies.insert", - "path": "projects/{project}/regions/{region}/targetHttpsProxies", - "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "Informational warning which replaces the list of addresses when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "TargetHttpsProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a TargetHttpsProxy resource in the specified project and region using the data included in the request." + } + } + } + }, + "TargetPoolInstanceHealth": { + "id": "TargetPoolInstanceHealth", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#targetPoolInstanceHealth when checking the health of an instance.", + "default": "compute#targetPoolInstanceHealth", + "type": "string" }, - "delete": { - "id": "compute.regionTargetHttpsProxies.delete", - "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", - "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetHttpsProxy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetHttpsProxy resource." + "healthStatus": { + "type": "array", + "items": { + "$ref": "HealthStatus" + } + } + } + }, + "TargetPoolsAddHealthCheckRequest": { + "id": "TargetPoolsAddHealthCheckRequest", + "type": "object", + "properties": { + "healthChecks": { + "description": "The HttpHealthCheck to add to the target pool.", + "type": "array", + "items": { + "$ref": "HealthCheckReference" + } + } + } + }, + "TargetPoolsRemoveHealthCheckRequest": { + "id": "TargetPoolsRemoveHealthCheckRequest", + "type": "object", + "properties": { + "healthChecks": { + "description": "Health check URL to be removed. This can be a full or valid partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/beta/projects/project /global/httpHealthChecks/health-check - projects/project/global/httpHealthChecks/health-check - global/httpHealthChecks/health-check ", + "type": "array", + "items": { + "$ref": "HealthCheckReference" + } + } + } + }, + "TargetPoolsAddInstanceRequest": { + "id": "TargetPoolsAddInstanceRequest", + "type": "object", + "properties": { + "instances": { + "description": "A full or partial URL to an instance to add to this target pool. This can be a full or partial URL. For example, the following are valid URLs: - https://www.googleapis.com/compute/v1/projects/project-id/zones/zone /instances/instance-name - projects/project-id/zones/zone/instances/instance-name - zones/zone/instances/instance-name ", + "type": "array", + "items": { + "$ref": "InstanceReference" + } + } + } + }, + "TargetPoolsRemoveInstanceRequest": { + "id": "TargetPoolsRemoveInstanceRequest", + "type": "object", + "properties": { + "instances": { + "description": "URLs of the instances to be removed from target pool.", + "type": "array", + "items": { + "$ref": "InstanceReference" + } + } + } + }, + "TargetSslProxyList": { + "id": "TargetSslProxyList", + "description": "Contains a list of TargetSslProxy resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#targetSslProxyList", + "type": "string" }, - "patch": { - "id": "compute.regionTargetHttpsProxies.patch", - "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", - "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetSslProxy resources.", + "type": "array", + "items": { + "$ref": "TargetSslProxy" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "targetHttpsProxy" - ], - "request": { - "$ref": "TargetHttpsProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified regional TargetHttpsProxy resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + } + } + } + }, + "TargetSslProxy": { + "id": "TargetSslProxy", + "description": "Represents a Target SSL Proxy resource. A target SSL proxy is a component of a Proxy Network Load Balancer. The forwarding rule references the target SSL proxy, and the target proxy then references a backend service. For more information, read Proxy Network Load Balancer overview.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#targetSslProxy for target SSL proxies.", + "default": "compute#targetSslProxy", + "type": "string" }, - "setUrlMap": { - "id": "compute.regionTargetHttpsProxies.setUrlMap", - "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", - "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setUrlMap", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy to set a URL map for.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetHttpsProxy" - ], - "request": { - "$ref": "UrlMapReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the URL map for TargetHttpsProxy." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "setSslCertificates": { - "id": "compute.regionTargetHttpsProxies.setSslCertificates", - "path": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", - "flatPath": "projects/{project}/regions/{region}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetHttpsProxy": { - "description": "Name of the TargetHttpsProxy resource to set an SslCertificates resource for.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetHttpsProxy" - ], - "request": { - "$ref": "RegionTargetHttpsProxiesSetSslCertificatesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "service": { + "description": "URL to the BackendService resource.", + "type": "string" + }, + "sslCertificates": { + "description": "URLs to SslCertificate resources that are used to authenticate connections to Backends. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates. sslCertificates do not apply when the load balancing scheme is set to INTERNAL_SELF_MANAGED.", + "type": "array", + "items": { + "type": "string" + } + }, + "certificateMap": { + "description": "URL of a certificate map that identifies a certificate map associated with the given target proxy. This field can only be set for global target proxies. If set, sslCertificates will be ignored. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", + "type": "string" + }, + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Replaces SslCertificates for TargetHttpsProxy." + "enum": [ + "NONE", + "PROXY_V1" + ] + }, + "sslPolicy": { + "description": "URL of SslPolicy resource that will be associated with the TargetSslProxy resource. If not set, the TargetSslProxy resource will not have any SSL policy configured.", + "type": "string" } } }, - "targetInstances": { - "methods": { - "list": { - "id": "compute.targetInstances.list", - "path": "projects/{project}/zones/{zone}/targetInstances", - "flatPath": "projects/{project}/zones/{zone}/targetInstances", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "zone": { - "description": "Name of the zone scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "TargetInstanceList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "TargetSslProxiesSetBackendServiceRequest": { + "id": "TargetSslProxiesSetBackendServiceRequest", + "type": "object", + "properties": { + "service": { + "description": "The URL of the new BackendService resource for the targetSslProxy.", + "type": "string" + } + } + }, + "TargetSslProxiesSetSslCertificatesRequest": { + "id": "TargetSslProxiesSetSslCertificatesRequest", + "type": "object", + "properties": { + "sslCertificates": { + "description": "New set of URLs to SslCertificate resources to associate with this TargetSslProxy. At least one SSL certificate must be specified. Currently, you may specify up to 15 SSL certificates.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "TargetSslProxiesSetCertificateMapRequest": { + "id": "TargetSslProxiesSetCertificateMapRequest", + "type": "object", + "properties": { + "certificateMap": { + "description": "URL of the Certificate Map to associate with this TargetSslProxy. Accepted format is //certificatemanager.googleapis.com/projects/{project }/locations/{location}/certificateMaps/{resourceName}.", + "type": "string" + } + } + }, + "TargetSslProxiesSetProxyHeaderRequest": { + "id": "TargetSslProxiesSetProxyHeaderRequest", + "type": "object", + "properties": { + "proxyHeader": { + "description": "The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves a list of TargetInstance resources available to the specified project and zone." + "enum": [ + "NONE", + "PROXY_V1" + ] + } + } + }, + "TargetTcpProxyList": { + "id": "TargetTcpProxyList", + "description": "Contains a list of TargetTcpProxy resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#targetTcpProxyList", + "type": "string" }, - "aggregatedList": { - "id": "compute.targetInstances.aggregatedList", - "path": "projects/{project}/aggregated/targetInstances", - "flatPath": "projects/{project}/aggregated/targetInstances", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetInstanceAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of target instances. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "get": { - "id": "compute.targetInstances.get", - "path": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", - "flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of TargetTcpProxy resources.", + "type": "array", + "items": { + "$ref": "TargetTcpProxy" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "targetInstance": { - "description": "Name of the TargetInstance resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "zone": { - "description": "Name of the zone scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone", - "targetInstance" - ], - "response": { - "$ref": "TargetInstance" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified TargetInstance resource." + } + } + } + }, + "TargetTcpProxy": { + "id": "TargetTcpProxy", + "description": "Represents a Target TCP Proxy resource. A target TCP proxy is a component of a Proxy Network Load Balancer. The forwarding rule references the target TCP proxy, and the target proxy then references a backend service. For more information, read Proxy Network Load Balancer overview.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#targetTcpProxy for target TCP proxies.", + "default": "compute#targetTcpProxy", + "type": "string" }, - "insert": { - "id": "compute.targetInstances.insert", - "path": "projects/{project}/zones/{zone}/targetInstances", - "flatPath": "projects/{project}/zones/{zone}/targetInstances", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "zone": { - "description": "Name of the zone scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone" - ], - "request": { - "$ref": "TargetInstance" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a TargetInstance resource in the specified project and zone using the data included in the request." + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" }, - "delete": { - "id": "compute.targetInstances.delete", - "path": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", - "flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetInstance": { - "description": "Name of the TargetInstance resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "targetInstance" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetInstance resource." + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" }, - "setSecurityPolicy": { - "id": "compute.targetInstances.setSecurityPolicy", - "path": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}/setSecurityPolicy", - "flatPath": "projects/{project}/zones/{zone}/targetInstances/{targetInstance}/setSecurityPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetInstance": { - "description": "Name of the TargetInstance resource to which the security policy should be set. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" - }, - "zone": { - "description": "Name of the zone scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "zone", - "targetInstance" - ], - "request": { - "$ref": "SecurityPolicyReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "service": { + "description": "URL to the BackendService resource.", + "type": "string" + }, + "proxyHeader": { + "description": "Specifies the type of proxy header to append before sending data to the backend, either NONE or PROXY_V1. The default is NONE.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Sets the Google Cloud Armor security policy for the specified target instance. For more information, see Google Cloud Armor Overview" + "enum": [ + "NONE", + "PROXY_V1" + ] + }, + "proxyBind": { + "description": "This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field is set to true, Envoy proxies set up inbound traffic interception and bind to the IP address and port specified in the forwarding rule. This is generally useful when using Traffic Director to configure Envoy as a gateway or middle proxy (in other words, not a sidecar proxy). The Envoy proxy listens for inbound requests and handles requests when it receives them. The default is false.", + "type": "boolean" + }, + "region": { + "description": "[Output Only] URL of the region where the regional TCP proxy resides. This field is not applicable to global TCP proxy.", + "type": "string" } } }, - "targetPools": { - "methods": { - "list": { - "id": "compute.targetPools.list", - "path": "projects/{project}/regions/{region}/targetPools", - "flatPath": "projects/{project}/regions/{region}/targetPools", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "TargetPoolList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of target pools available to the specified project and region." + "TargetTcpProxyAggregatedList": { + "id": "TargetTcpProxyAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#targetTcpProxyAggregatedList for lists of Target TCP Proxies.", + "default": "compute#targetTcpProxyAggregatedList", + "type": "string" }, - "aggregatedList": { - "id": "compute.targetPools.aggregatedList", - "path": "projects/{project}/aggregated/targetPools", - "flatPath": "projects/{project}/aggregated/targetPools", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetPoolAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of target pools. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "get": { - "id": "compute.targetPools.get", - "path": "projects/{project}/regions/{region}/targetPools/{targetPool}", - "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "items": { + "description": "A list of TargetTcpProxiesScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of TargetTcpProxies.", + "$ref": "TargetTcpProxiesScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetPool": { - "description": "Name of the TargetPool resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "response": { - "$ref": "TargetPool" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified target pool." + } }, - "insert": { - "id": "compute.targetPools.insert", - "path": "projects/{project}/regions/{region}/targetPools", - "flatPath": "projects/{project}/regions/{region}/targetPools", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "TargetPool" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a target pool in the specified project and region using the data included in the request." + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "TargetTcpProxiesScopedList": { + "id": "TargetTcpProxiesScopedList", + "type": "object", + "properties": { + "targetTcpProxies": { + "description": "A list of TargetTcpProxies contained in this scope.", + "type": "array", + "items": { + "$ref": "TargetTcpProxy" + } }, - "delete": { - "id": "compute.targetPools.delete", - "path": "projects/{project}/regions/{region}/targetPools/{targetPool}", - "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "warning": { + "description": "Informational warning which replaces the list of backend services when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetPool": { - "description": "Name of the TargetPool resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + } + } + } + }, + "TargetTcpProxiesSetBackendServiceRequest": { + "id": "TargetTcpProxiesSetBackendServiceRequest", + "type": "object", + "properties": { + "service": { + "description": "The URL of the new BackendService resource for the targetTcpProxy.", + "type": "string" + } + } + }, + "TargetTcpProxiesSetProxyHeaderRequest": { + "id": "TargetTcpProxiesSetProxyHeaderRequest", + "type": "object", + "properties": { + "proxyHeader": { + "description": "The new type of proxy header to append before sending data to the backend. NONE or PROXY_V1 are allowed.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Deletes the specified target pool." + "enum": [ + "NONE", + "PROXY_V1" + ] + } + } + }, + "TargetVpnGatewayList": { + "id": "TargetVpnGatewayList", + "description": "Contains a list of TargetVpnGateway resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways.", + "default": "compute#targetVpnGatewayList", + "type": "string" }, - "getHealth": { - "id": "compute.targetPools.getHealth", - "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/getHealth", - "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/getHealth", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "targetPool": { - "description": "Name of the TargetPool resource to which the queried instance belongs.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "request": { - "$ref": "InstanceReference" - }, - "response": { - "$ref": "TargetPoolInstanceHealth" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Gets the most recent health check results for each IP for the instance that is referenced by the given target pool." + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" }, - "addHealthCheck": { - "id": "compute.targetPools.addHealthCheck", - "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/addHealthCheck", - "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/addHealthCheck", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetPool": { - "description": "Name of the target pool to add a health check to.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "request": { - "$ref": "TargetPoolsAddHealthCheckRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Adds health check URLs to a target pool." + "items": { + "description": "A list of TargetVpnGateway resources.", + "type": "array", + "items": { + "$ref": "TargetVpnGateway" + } }, - "removeHealthCheck": { - "id": "compute.targetPools.removeHealthCheck", - "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeHealthCheck", - "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeHealthCheck", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetPool": { - "description": "Name of the target pool to remove health checks from.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "request": { - "$ref": "TargetPoolsRemoveHealthCheckRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes health check URL from a target pool." + } + } + } + }, + "TargetVpnGateway": { + "id": "TargetVpnGateway", + "description": "Represents a Target VPN Gateway resource. The target VPN gateway resource represents a Classic Cloud VPN gateway. For more information, read the the Cloud VPN Overview.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways.", + "default": "compute#targetVpnGateway", + "type": "string" }, - "addInstance": { - "id": "compute.targetPools.addInstance", - "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/addInstance", - "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/addInstance", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetPool": { - "description": "Name of the TargetPool resource to add instances to.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "request": { - "$ref": "TargetPoolsAddInstanceRequest" + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.targetVpnGateways.insert" + ] }, - "response": { - "$ref": "Operation" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the target VPN gateway resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "network": { + "description": "URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created.", + "annotations": { + "required": [ + "compute.targetVpnGateways.insert" + ] }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "string" + }, + "tunnels": { + "description": "[Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are created using the compute.vpntunnels.insert method and associated with a VPN gateway.", + "type": "array", + "items": { + "type": "string" + } + }, + "status": { + "description": "[Output Only] The status of the VPN gateway, which can be one of the following: CREATING, READY, FAILED, or DELETING.", + "type": "string", + "enumDescriptions": [ + "", + "", + "", + "" ], - "description": "Adds an instance to a target pool." + "enum": [ + "CREATING", + "DELETING", + "FAILED", + "READY" + ] }, - "removeInstance": { - "id": "compute.targetPools.removeInstance", - "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeInstance", - "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/removeInstance", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "forwardingRules": { + "description": "[Output Only] A list of URLs to the ForwardingRule resources. ForwardingRules are created using compute.forwardingRules.insert and associated with a VPN gateway.", + "type": "array", + "items": { + "type": "string" + } + }, + "labels": { + "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this TargetVpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a TargetVpnGateway.", + "type": "string", + "format": "byte" + } + } + }, + "TargetVpnGatewayAggregatedList": { + "id": "TargetVpnGatewayAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways.", + "default": "compute#targetVpnGatewayAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of TargetVpnGateway resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of target VPN gateways.", + "$ref": "TargetVpnGatewaysScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetPool": { - "description": "Name of the TargetPool resource to remove instances from.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "request": { - "$ref": "TargetPoolsRemoveInstanceRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Removes instance URL from a target pool." + } }, - "setBackup": { - "id": "compute.targetPools.setBackup", - "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/setBackup", - "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/setBackup", - "httpMethod": "POST", - "parameters": { - "failoverRatio": { - "description": "New failoverRatio value for the target pool.", - "location": "query", - "type": "number", - "format": "float" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "TargetVpnGatewaysScopedList": { + "id": "TargetVpnGatewaysScopedList", + "type": "object", + "properties": { + "targetVpnGateways": { + "description": "[Output Only] A list of target VPN gateways contained in this scope.", + "type": "array", + "items": { + "$ref": "TargetVpnGateway" + } + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of addresses when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetPool": { - "description": "Name of the TargetPool resource to set a backup pool for.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "request": { - "$ref": "TargetReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes a backup target pool's configurations." + } + } + } + }, + "UrlMapList": { + "id": "UrlMapList", + "description": "Contains a list of UrlMap resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#urlMapList", + "type": "string" }, - "setSecurityPolicy": { - "id": "compute.targetPools.setSecurityPolicy", - "path": "projects/{project}/regions/{region}/targetPools/{targetPool}/setSecurityPolicy", - "flatPath": "projects/{project}/regions/{region}/targetPools/{targetPool}/setSecurityPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of UrlMap resources.", + "type": "array", + "items": { + "$ref": "UrlMap" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "targetPool": { - "description": "Name of the TargetPool resource to which the security policy should be set. The name should conform to RFC1035.", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "targetPool" - ], - "request": { - "$ref": "SecurityPolicyReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the Google Cloud Armor security policy for the specified target pool. For more information, see Google Cloud Armor Overview" + } + } + } + }, + "UrlMap": { + "id": "UrlMap", + "description": "Represents a URL Map resource. Compute Engine has two URL Map resources: * [Global](/compute/docs/reference/rest/v1/urlMaps) * [Regional](/compute/docs/reference/rest/v1/regionUrlMaps) A URL map resource is a component of certain types of cloud load balancers and Traffic Director: * urlMaps are used by global external Application Load Balancers, classic Application Load Balancers, and cross-region internal Application Load Balancers. * regionUrlMaps are used by internal Application Load Balancers, regional external Application Load Balancers and regional internal Application Load Balancers. For a list of supported URL map features by the load balancer type, see the Load balancing features: Routing and traffic management table. For a list of supported URL map features for Traffic Director, see the Traffic Director features: Routing and traffic management table. This resource defines mappings from hostnames and URL paths to either a backend service or a backend bucket. To use the global urlMaps resource, the backend service must have a loadBalancingScheme of either EXTERNAL, EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use the regionUrlMaps resource, the backend service must have a loadBalancingScheme of INTERNAL_MANAGED. For more information, read URL Map Concepts.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#urlMaps for url maps.", + "default": "compute#urlMap", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "hostRules": { + "description": "The list of host rules to use against the URL.", + "type": "array", + "items": { + "$ref": "HostRule" + } + }, + "pathMatchers": { + "description": "The list of named PathMatchers to use against the URL.", + "type": "array", + "items": { + "$ref": "PathMatcher" + } + }, + "tests": { + "description": "The list of expected URL mapping tests. Request to update the UrlMap succeeds only if all test cases pass. You can specify a maximum of 100 tests per UrlMap. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", + "type": "array", + "items": { + "$ref": "UrlMapTest" + } + }, + "defaultService": { + "description": "The full or partial URL of the defaultService resource to which traffic is directed if none of the hostRules match. If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. However, if defaultService is specified, defaultRouteAction cannot contain any defaultRouteAction.weightedBackendServices. Conversely, if defaultRouteAction specifies any defaultRouteAction.weightedBackendServices, defaultService must not be specified. If defaultService is specified, then set either defaultUrlRedirect , or defaultRouteAction.weightedBackendService Don't set both. defaultService has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", + "type": "string" + }, + "defaultRouteAction": { + "description": "defaultRouteAction takes effect when none of the hostRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If defaultRouteAction specifies any weightedBackendServices, defaultService must not be set. Conversely if defaultService is set, defaultRouteAction cannot contain any weightedBackendServices. Only one of defaultRouteAction or defaultUrlRedirect must be set. URL maps for classic Application Load Balancers only support the urlRewrite action within defaultRouteAction. defaultRouteAction has no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", + "$ref": "HttpRouteAction" + }, + "defaultUrlRedirect": { + "description": "When none of the specified hostRules match, the request is redirected to a URL specified by defaultUrlRedirect. If defaultUrlRedirect is specified, defaultService or defaultRouteAction must not be set. Not supported when the URL map is bound to a target gRPC proxy.", + "$ref": "HttpRedirectAction" + }, + "headerAction": { + "description": "Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction specified here take effect after headerAction specified under pathMatcher. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", + "$ref": "HttpHeaderAction" + }, + "defaultCustomErrorResponsePolicy": { + "description": "defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the load balancer level and applies only when no policy has been defined for the error code at lower levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a UrlMap with the following configuration: - defaultCustomErrorResponsePolicy containing policies for responding to 5xx and 4xx errors - A PathMatcher configured for *.example.com has defaultCustomErrorResponsePolicy for 4xx. If a request for http://www.example.com/ encounters a 404, the policy in pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the request for http://www.example.com/ encounters a 502, the policy in UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request that does not match any host in *.example.com such as http://www.myotherexample.com/, encounters a 404, UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers.", + "$ref": "CustomErrorResponsePolicy" + }, + "fingerprint": { + "description": "Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field is ignored when inserting a UrlMap. An up-to-date fingerprint must be provided in order to update the UrlMap, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a UrlMap.", + "type": "string", + "format": "byte" + }, + "region": { + "description": "[Output Only] URL of the region where the regional URL map resides. This field is not applicable to global URL maps. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + } + } + }, + "HostRule": { + "id": "HostRule", + "description": "UrlMaps A host-matching rule for a URL. If matched, will use the named PathMatcher to select the BackendService.", + "type": "object", + "properties": { + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "hosts": { + "description": "The list of host patterns to match. They must be valid hostnames with optional port numbers in the format host:port. * matches any string of ([a-z0-9-.]*). In that case, * must be the first character, and if followed by anything, the immediate following character must be either - or .. * based matching is not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", + "type": "array", + "items": { + "type": "string" + } + }, + "pathMatcher": { + "description": "The name of the PathMatcher to use to match the path portion of the URL if the hostRule matches the URL's host portion.", + "type": "string" + } + } + }, + "PathMatcher": { + "id": "PathMatcher", + "description": "A matcher for the path portion of the URL. The BackendService from the longest-matched rule will serve the URL. If no rule was matched, the default service is used.", + "type": "object", + "properties": { + "name": { + "description": "The name to which this PathMatcher is referred by the HostRule.", + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "defaultService": { + "description": "The full or partial URL to the BackendService resource. This URL is used if none of the pathRules or routeRules defined by this PathMatcher are matched. For example, the following are all valid URLs to a BackendService resource: - https://www.googleapis.com/compute/v1/projects/project /global/backendServices/backendService - compute/v1/projects/project/global/backendServices/backendService - global/backendServices/backendService If defaultRouteAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. However, if defaultService is specified, defaultRouteAction cannot contain any weightedBackendServices. Conversely, if defaultRouteAction specifies any weightedBackendServices, defaultService must not be specified. If defaultService is specified, then set either defaultUrlRedirect or defaultRouteAction.weightedBackendService. Don't set both. Authorization requires one or more of the following Google IAM permissions on the specified resource default_service: - compute.backendBuckets.use - compute.backendServices.use ", + "type": "string" + }, + "defaultRouteAction": { + "description": "defaultRouteAction takes effect when none of the pathRules or routeRules match. The load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If defaultRouteAction specifies any weightedBackendServices, defaultService must not be set. Conversely if defaultService is set, defaultRouteAction cannot contain any weightedBackendServices. If defaultRouteAction is specified, don't set defaultUrlRedirect. If defaultRouteAction.weightedBackendServices is specified, don't set defaultService. URL maps for classic Application Load Balancers only support the urlRewrite action within a path matcher's defaultRouteAction.", + "$ref": "HttpRouteAction" + }, + "defaultUrlRedirect": { + "description": "When none of the specified pathRules or routeRules match, the request is redirected to a URL specified by defaultUrlRedirect. If defaultUrlRedirect is specified, then set either defaultService or defaultRouteAction. Don't set both. Not supported when the URL map is bound to a target gRPC proxy.", + "$ref": "HttpRedirectAction" + }, + "pathRules": { + "description": "The list of path rules. Use this list instead of routeRules when routing based on simple path matching is all that's required. The order by which path rules are specified does not matter. Matches are always done on the longest-path-first basis. For example: a pathRule with a path /a/b/c/* will match before /a/b/* irrespective of the order in which those paths appear in this list. Within a given pathMatcher, only one of pathRules or routeRules must be set.", + "type": "array", + "items": { + "$ref": "PathRule" + } + }, + "routeRules": { + "description": "The list of HTTP route rules. Use this list instead of pathRules when advanced route matching and routing actions are desired. routeRules are evaluated in order of priority, from the lowest to highest number. Within a given pathMatcher, you can set only one of pathRules or routeRules.", + "type": "array", + "items": { + "$ref": "HttpRouteRule" + } + }, + "headerAction": { + "description": "Specifies changes to request and response headers that need to take effect for the selected backend service. HeaderAction specified here are applied after the matching HttpRouteRule HeaderAction and before the HeaderAction in the UrlMap HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", + "$ref": "HttpHeaderAction" + }, + "defaultCustomErrorResponsePolicy": { + "description": "defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. This policy takes effect at the PathMatcher level and applies only when no policy has been defined for the error code at lower levels like RouteRule and PathRule within this PathMatcher. If an error code does not have a policy defined in defaultCustomErrorResponsePolicy, then a policy defined for the error code in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy is configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with pathMatcher.defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the response from the service is returned to the client. defaultCustomErrorResponsePolicy is supported only for global external Application Load Balancers.", + "$ref": "CustomErrorResponsePolicy" + } + } + }, + "HttpRouteAction": { + "id": "HttpRouteAction", + "type": "object", + "properties": { + "weightedBackendServices": { + "description": "A list of weighted backend services to send traffic to when a route match occurs. The weights determine the fraction of traffic that flows to their corresponding backend service. If all traffic needs to go to a single backend service, there must be one weightedBackendService with weight set to a non-zero number. After a backend service is identified and before forwarding the request to the backend service, advanced routing actions such as URL rewrites and header transformations are applied depending on additional settings specified in this HttpRouteAction.", + "type": "array", + "items": { + "$ref": "WeightedBackendService" + } + }, + "urlRewrite": { + "description": "The spec to modify the URL of the request, before forwarding the request to the matched service. urlRewrite is the only action supported in UrlMaps for classic Application Load Balancers. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", + "$ref": "UrlRewrite" + }, + "timeout": { + "description": "Specifies the timeout for the selected route. Timeout is computed from the time the request has been fully processed (known as *end-of-stream*) up until the response has been processed. Timeout includes all retries. If not specified, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", + "$ref": "Duration" + }, + "retryPolicy": { + "description": "Specifies the retry policy associated with this route.", + "$ref": "HttpRetryPolicy" + }, + "requestMirrorPolicy": { + "description": "Specifies the policy on how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer does not wait for responses from the shadow service. Before sending traffic to the shadow service, the host / authority header is suffixed with -shadow. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", + "$ref": "RequestMirrorPolicy" + }, + "corsPolicy": { + "description": "The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard. Not supported when the URL map is bound to a target gRPC proxy.", + "$ref": "CorsPolicy" + }, + "faultInjectionPolicy": { + "description": "The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by a load balancer on a percentage of requests before sending those requests to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests. timeout and retry_policy is ignored by clients that are configured with a fault_injection_policy if: 1. The traffic is generated by fault injection AND 2. The fault injection is not a delay fault injection. Fault injection is not supported with the classic Application Load Balancer . To see which load balancers support fault injection, see Load balancing: Routing and traffic management features.", + "$ref": "HttpFaultInjection" + }, + "maxStreamDuration": { + "description": "Specifies the maximum duration (timeout) for streams on the selected route. Unlike the timeout field where the timeout duration starts from the time the request has been fully processed (known as *end-of-stream*), the duration in this field is computed from the beginning of the stream until the response has been processed, including all retries. A stream that does not complete in this duration is closed. If not specified, this field uses the maximum maxStreamDuration value among all backend services associated with the route. This field is only allowed if the Url map is used with backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED.", + "$ref": "Duration" + } + } + }, + "WeightedBackendService": { + "id": "WeightedBackendService", + "description": "In contrast to a single BackendService in HttpRouteAction to which all matching traffic is directed to, WeightedBackendService allows traffic to be split across multiple backend services. The volume of traffic for each backend service is proportional to the weight specified in each WeightedBackendService", + "type": "object", + "properties": { + "backendService": { + "description": "The full or partial URL to the default BackendService resource. Before forwarding the request to backendService, the load balancer applies any relevant headerActions specified as part of this backendServiceWeight.", + "type": "string" + }, + "weight": { + "description": "Specifies the fraction of traffic sent to a backend service, computed as weight / (sum of all weightedBackendService weights in routeAction) . The selection of a backend service is determined only for new traffic. Once a user's request has been directed to a backend service, subsequent requests are sent to the same backend service as determined by the backend service's session affinity policy. Don't configure session affinity if you're using weighted traffic splitting. If you do, the weighted traffic splitting configuration takes precedence. The value must be from 0 to 1000.", + "type": "integer", + "format": "uint32" + }, + "headerAction": { + "description": "Specifies changes to request and response headers that need to take effect for the selected backendService. headerAction specified here take effect before headerAction in the enclosing HttpRouteRule, PathMatcher and UrlMap. headerAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", + "$ref": "HttpHeaderAction" + } + } + }, + "HttpHeaderAction": { + "id": "HttpHeaderAction", + "description": "The request and response header transformations that take effect before the request is passed along to the selected backendService.", + "type": "object", + "properties": { + "requestHeadersToRemove": { + "description": "A list of header names for headers that need to be removed from the request before forwarding the request to the backendService.", + "type": "array", + "items": { + "type": "string" + } + }, + "requestHeadersToAdd": { + "description": "Headers to add to a matching request before forwarding the request to the backendService.", + "type": "array", + "items": { + "$ref": "HttpHeaderOption" + } + }, + "responseHeadersToRemove": { + "description": "A list of header names for headers that need to be removed from the response before sending the response back to the client.", + "type": "array", + "items": { + "type": "string" + } + }, + "responseHeadersToAdd": { + "description": "Headers to add the response before sending the response back to the client.", + "type": "array", + "items": { + "$ref": "HttpHeaderOption" + } } } }, - "targetSslProxies": { - "methods": { - "list": { - "id": "compute.targetSslProxies.list", - "path": "projects/{project}/global/targetSslProxies", - "flatPath": "projects/{project}/global/targetSslProxies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetSslProxyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of TargetSslProxy resources available to the specified project." - }, - "get": { - "id": "compute.targetSslProxies.get", - "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}", - "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "targetSslProxy": { - "description": "Name of the TargetSslProxy resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetSslProxy" - ], - "response": { - "$ref": "TargetSslProxy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified TargetSslProxy resource." - }, - "insert": { - "id": "compute.targetSslProxies.insert", - "path": "projects/{project}/global/targetSslProxies", - "flatPath": "projects/{project}/global/targetSslProxies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "TargetSslProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a TargetSslProxy resource in the specified project using the data included in the request." + "HttpHeaderOption": { + "id": "HttpHeaderOption", + "description": "Specification determining how headers are added to requests or responses.", + "type": "object", + "properties": { + "headerName": { + "description": "The name of the header.", + "type": "string" }, - "delete": { - "id": "compute.targetSslProxies.delete", - "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}", - "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetSslProxy": { - "description": "Name of the TargetSslProxy resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetSslProxy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetSslProxy resource." + "headerValue": { + "description": "The value of the header to add.", + "type": "string" }, - "setBackendService": { - "id": "compute.targetSslProxies.setBackendService", - "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setBackendService", - "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setBackendService", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetSslProxy": { - "description": "Name of the TargetSslProxy resource whose BackendService resource is to be set.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetSslProxy" - ], - "request": { - "$ref": "TargetSslProxiesSetBackendServiceRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the BackendService for TargetSslProxy." + "replace": { + "description": "If false, headerValue is appended to any values that already exist for the header. If true, headerValue is set for the header, discarding any values that were set for that header. The default value is false. ", + "type": "boolean" + } + } + }, + "UrlRewrite": { + "id": "UrlRewrite", + "description": "The spec for modifying the path before sending the request to the matched backend service.", + "type": "object", + "properties": { + "pathPrefixRewrite": { + "description": "Before forwarding the request to the selected backend service, the matching portion of the request's path is replaced by pathPrefixRewrite. The value must be from 1 to 1024 characters.", + "type": "string" }, - "setSslCertificates": { - "id": "compute.targetSslProxies.setSslCertificates", - "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslCertificates", - "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslCertificates", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetSslProxy": { - "description": "Name of the TargetSslProxy resource whose SslCertificate resource is to be set.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetSslProxy" - ], - "request": { - "$ref": "TargetSslProxiesSetSslCertificatesRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes SslCertificates for TargetSslProxy." + "hostRewrite": { + "description": "Before forwarding the request to the selected service, the request's host header is replaced with contents of hostRewrite. The value must be from 1 to 255 characters.", + "type": "string" }, - "setCertificateMap": { - "id": "compute.targetSslProxies.setCertificateMap", - "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setCertificateMap", - "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setCertificateMap", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetSslProxy": { - "description": "Name of the TargetSslProxy resource whose CertificateMap is to be set. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetSslProxy" - ], - "request": { - "$ref": "TargetSslProxiesSetCertificateMapRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the Certificate Map for TargetSslProxy." + "pathTemplateRewrite": { + "description": " If specified, the pattern rewrites the URL path (based on the :path header) using the HTTP template syntax. A corresponding path_template_match must be specified. Any template variables must exist in the path_template_match field. - -At least one variable must be specified in the path_template_match field - You can omit variables from the rewritten URL - The * and ** operators cannot be matched unless they have a corresponding variable name - e.g. {format=*} or {var=**}. For example, a path_template_match of /static/{format=**} could be rewritten as /static/content/{format} to prefix /content to the URL. Variables can also be re-ordered in a rewrite, so that /{country}/{format}/{suffix=**} can be rewritten as /content/{format}/{country}/{suffix}. At least one non-empty routeRules[].matchRules[].path_template_match is required. Only one of path_prefix_rewrite or path_template_rewrite may be specified.", + "type": "string" + } + } + }, + "HttpRetryPolicy": { + "id": "HttpRetryPolicy", + "description": "The retry policy associates with HttpRouteRule", + "type": "object", + "properties": { + "retryConditions": { + "description": "Specifies one or more conditions when this retry policy applies. Valid values are: - 5xx: retry is attempted if the instance or endpoint responds with any 5xx response code, or if the instance or endpoint does not respond at all. For example, disconnects, reset, read timeout, connection failure, and refused streams. - gateway-error: Similar to 5xx, but only applies to response codes 502, 503 or 504. - connect-failure: a retry is attempted on failures connecting to the instance or endpoint. For example, connection timeouts. - retriable-4xx: a retry is attempted if the instance or endpoint responds with a 4xx response code. The only error that you can retry is error code 409. - refused-stream: a retry is attempted if the instance or endpoint resets the stream with a REFUSED_STREAM error code. This reset type indicates that it is safe to retry. - cancelled: a retry is attempted if the gRPC status code in the response header is set to cancelled. - deadline-exceeded: a retry is attempted if the gRPC status code in the response header is set to deadline-exceeded. - internal: a retry is attempted if the gRPC status code in the response header is set to internal. - resource-exhausted: a retry is attempted if the gRPC status code in the response header is set to resource-exhausted. - unavailable: a retry is attempted if the gRPC status code in the response header is set to unavailable. Only the following codes are supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true. - cancelled - deadline-exceeded - internal - resource-exhausted - unavailable ", + "type": "array", + "items": { + "type": "string" + } }, - "setProxyHeader": { - "id": "compute.targetSslProxies.setProxyHeader", - "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setProxyHeader", - "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setProxyHeader", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetSslProxy": { - "description": "Name of the TargetSslProxy resource whose ProxyHeader is to be set.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetSslProxy" - ], - "request": { - "$ref": "TargetSslProxiesSetProxyHeaderRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the ProxyHeaderType for TargetSslProxy." + "numRetries": { + "description": "Specifies the allowed number retries. This number must be \u003e 0. If not specified, defaults to 1.", + "type": "integer", + "format": "uint32" }, - "setSslPolicy": { - "id": "compute.targetSslProxies.setSslPolicy", - "path": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslPolicy", - "flatPath": "projects/{project}/global/targetSslProxies/{targetSslProxy}/setSslPolicy", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetSslProxy": { - "description": "Name of the TargetSslProxy resource whose SSL policy is to be set. The name must be 1-63 characters long, and comply with RFC1035.", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetSslProxy" - ], - "request": { - "$ref": "SslPolicyReference" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the SSL policy for TargetSslProxy. The SSL policy specifies the server-side support for SSL features. This affects connections between clients and the load balancer. They do not affect the connection between the load balancer and the backends." + "perTryTimeout": { + "description": "Specifies a non-zero timeout per retry attempt. If not specified, will use the timeout set in the HttpRouteAction field. If timeout in the HttpRouteAction field is not set, this field uses the largest timeout among all backend services associated with the route. Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.", + "$ref": "Duration" } } }, - "targetTcpProxies": { - "methods": { - "list": { - "id": "compute.targetTcpProxies.list", - "path": "projects/{project}/global/targetTcpProxies", - "flatPath": "projects/{project}/global/targetTcpProxies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetTcpProxyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of TargetTcpProxy resources available to the specified project." + "RequestMirrorPolicy": { + "id": "RequestMirrorPolicy", + "description": "A policy that specifies how requests intended for the route's backends are shadowed to a separate mirrored backend service. The load balancer doesn't wait for responses from the shadow service. Before sending traffic to the shadow service, the host or authority header is suffixed with -shadow.", + "type": "object", + "properties": { + "backendService": { + "description": "The full or partial URL to the BackendService resource being mirrored to. The backend service configured for a mirroring policy must reference backends that are of the same type as the original backend service matched in the URL map. Serverless NEG backends are not currently supported as a mirrored backend service. ", + "type": "string" + } + } + }, + "CorsPolicy": { + "id": "CorsPolicy", + "description": "The specification for allowing client-side cross-origin requests. For more information about the W3C recommendation for cross-origin resource sharing (CORS), see Fetch API Living Standard.", + "type": "object", + "properties": { + "allowOrigins": { + "description": "Specifies the list of origins that is allowed to do CORS requests. An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes.", + "type": "array", + "items": { + "type": "string" + } + }, + "allowOriginRegexes": { + "description": "Specifies a regular expression that matches allowed origins. For more information, see regular expression syntax . An origin is allowed if it matches either an item in allowOrigins or an item in allowOriginRegexes. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED.", + "type": "array", + "items": { + "type": "string" + } }, - "aggregatedList": { - "id": "compute.targetTcpProxies.aggregatedList", - "path": "projects/{project}/aggregated/targetTcpProxies", - "flatPath": "projects/{project}/aggregated/targetTcpProxies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetTcpProxyAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of all TargetTcpProxy resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "allowMethods": { + "description": "Specifies the content for the Access-Control-Allow-Methods header.", + "type": "array", + "items": { + "type": "string" + } }, - "get": { - "id": "compute.targetTcpProxies.get", - "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", - "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "targetTcpProxy": { - "description": "Name of the TargetTcpProxy resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetTcpProxy" - ], - "response": { - "$ref": "TargetTcpProxy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified TargetTcpProxy resource." + "allowHeaders": { + "description": "Specifies the content for the Access-Control-Allow-Headers header.", + "type": "array", + "items": { + "type": "string" + } }, - "insert": { - "id": "compute.targetTcpProxies.insert", - "path": "projects/{project}/global/targetTcpProxies", - "flatPath": "projects/{project}/global/targetTcpProxies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "TargetTcpProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a TargetTcpProxy resource in the specified project using the data included in the request." + "exposeHeaders": { + "description": "Specifies the content for the Access-Control-Expose-Headers header.", + "type": "array", + "items": { + "type": "string" + } }, - "delete": { - "id": "compute.targetTcpProxies.delete", - "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", - "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetTcpProxy": { - "description": "Name of the TargetTcpProxy resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetTcpProxy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetTcpProxy resource." + "maxAge": { + "description": "Specifies how long results of a preflight request can be cached in seconds. This field translates to the Access-Control-Max-Age header.", + "type": "integer", + "format": "int32" }, - "setBackendService": { - "id": "compute.targetTcpProxies.setBackendService", - "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setBackendService", - "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setBackendService", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetTcpProxy": { - "description": "Name of the TargetTcpProxy resource whose BackendService resource is to be set.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetTcpProxy" - ], - "request": { - "$ref": "TargetTcpProxiesSetBackendServiceRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the BackendService for TargetTcpProxy." + "allowCredentials": { + "description": "In response to a preflight request, setting this to true indicates that the actual request can include user credentials. This field translates to the Access-Control-Allow-Credentials header. Default is false.", + "type": "boolean" }, - "setProxyHeader": { - "id": "compute.targetTcpProxies.setProxyHeader", - "path": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setProxyHeader", - "flatPath": "projects/{project}/global/targetTcpProxies/{targetTcpProxy}/setProxyHeader", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetTcpProxy": { - "description": "Name of the TargetTcpProxy resource whose ProxyHeader is to be set.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "targetTcpProxy" - ], - "request": { - "$ref": "TargetTcpProxiesSetProxyHeaderRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Changes the ProxyHeaderType for TargetTcpProxy." + "disabled": { + "description": "If true, disables the CORS policy. The default value is false, which indicates that the CORS policy is in effect.", + "type": "boolean" } } }, - "regionTargetTcpProxies": { - "methods": { - "list": { - "id": "compute.regionTargetTcpProxies.list", - "path": "projects/{project}/regions/{region}/targetTcpProxies", - "flatPath": "projects/{project}/regions/{region}/targetTcpProxies", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "TargetTcpProxyList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of TargetTcpProxy resources available to the specified project in a given region." - }, - "get": { - "id": "compute.regionTargetTcpProxies.get", - "path": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", - "flatPath": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "targetTcpProxy": { - "description": "Name of the TargetTcpProxy resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetTcpProxy" - ], - "response": { - "$ref": "TargetTcpProxy" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified TargetTcpProxy resource." + "HttpFaultInjection": { + "id": "HttpFaultInjection", + "description": "The specification for fault injection introduced into traffic to test the resiliency of clients to backend service failure. As part of fault injection, when clients send requests to a backend service, delays can be introduced by the load balancer on a percentage of requests before sending those request to the backend service. Similarly requests from clients can be aborted by the load balancer for a percentage of requests.", + "type": "object", + "properties": { + "delay": { + "description": "The specification for how client requests are delayed as part of fault injection, before being sent to a backend service.", + "$ref": "HttpFaultDelay" }, - "insert": { - "id": "compute.regionTargetTcpProxies.insert", - "path": "projects/{project}/regions/{region}/targetTcpProxies", - "flatPath": "projects/{project}/regions/{region}/targetTcpProxies", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "TargetTcpProxy" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a TargetTcpProxy resource in the specified project and region using the data included in the request." + "abort": { + "description": "The specification for how client requests are aborted as part of fault injection.", + "$ref": "HttpFaultAbort" + } + } + }, + "HttpFaultDelay": { + "id": "HttpFaultDelay", + "description": "Specifies the delay introduced by the load balancer before forwarding the request to the backend service as part of fault injection.", + "type": "object", + "properties": { + "fixedDelay": { + "description": "Specifies the value of the fixed delay interval.", + "$ref": "Duration" }, - "delete": { - "id": "compute.regionTargetTcpProxies.delete", - "path": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", - "flatPath": "projects/{project}/regions/{region}/targetTcpProxies/{targetTcpProxy}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetTcpProxy": { - "description": "Name of the TargetTcpProxy resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetTcpProxy" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified TargetTcpProxy resource." + "percentage": { + "description": "The percentage of traffic for connections, operations, or requests for which a delay is introduced as part of fault injection. The value must be from 0.0 to 100.0 inclusive.", + "type": "number", + "format": "double" + } + } + }, + "HttpFaultAbort": { + "id": "HttpFaultAbort", + "description": "Specification for how requests are aborted as part of fault injection.", + "type": "object", + "properties": { + "httpStatus": { + "description": "The HTTP status code used to abort the request. The value must be from 200 to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP status code according to this mapping table. HTTP status 200 is mapped to gRPC status UNKNOWN. Injecting an OK status is currently not supported by Traffic Director.", + "type": "integer", + "format": "uint32" + }, + "percentage": { + "description": "The percentage of traffic for connections, operations, or requests that is aborted as part of fault injection. The value must be from 0.0 to 100.0 inclusive.", + "type": "number", + "format": "double" } } }, - "targetVpnGateways": { - "methods": { - "list": { - "id": "compute.targetVpnGateways.list", - "path": "projects/{project}/regions/{region}/targetVpnGateways", - "flatPath": "projects/{project}/regions/{region}/targetVpnGateways", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "TargetVpnGatewayList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of target VPN gateways available to the specified project and region." + "HttpRedirectAction": { + "id": "HttpRedirectAction", + "description": "Specifies settings for an HTTP redirect.", + "type": "object", + "properties": { + "hostRedirect": { + "description": "The host that is used in the redirect response instead of the one that was supplied in the request. The value must be from 1 to 255 characters.", + "type": "string" }, - "aggregatedList": { - "id": "compute.targetVpnGateways.aggregatedList", - "path": "projects/{project}/aggregated/targetVpnGateways", - "flatPath": "projects/{project}/aggregated/targetVpnGateways", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "TargetVpnGatewayAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of target VPN gateways. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "pathRedirect": { + "description": "The path that is used in the redirect response instead of the one that was supplied in the request. pathRedirect cannot be supplied together with prefixRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters.", + "type": "string" }, - "get": { - "id": "compute.targetVpnGateways.get", - "path": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", - "flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "targetVpnGateway": { - "description": "Name of the target VPN gateway to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetVpnGateway" - ], - "response": { - "$ref": "TargetVpnGateway" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified target VPN gateway." + "prefixRedirect": { + "description": "The prefix that replaces the prefixMatch specified in the HttpRouteRuleMatch, retaining the remaining portion of the URL before redirecting the request. prefixRedirect cannot be supplied together with pathRedirect. Supply one alone or neither. If neither is supplied, the path of the original request is used for the redirect. The value must be from 1 to 1024 characters.", + "type": "string" }, - "insert": { - "id": "compute.targetVpnGateways.insert", - "path": "projects/{project}/regions/{region}/targetVpnGateways", - "flatPath": "projects/{project}/regions/{region}/targetVpnGateways", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "TargetVpnGateway" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "redirectResponseCode": { + "description": "The HTTP Status code to use for this RedirectAction. Supported values are: - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds to 301. - FOUND, which corresponds to 302. - SEE_OTHER which corresponds to 303. - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the request method is retained. - PERMANENT_REDIRECT, which corresponds to 308. In this case, the request method is retained. ", + "type": "string", + "enumDescriptions": [ + "Http Status Code 302 - Found.", + "Http Status Code 301 - Moved Permanently.", + "Http Status Code 308 - Permanent Redirect maintaining HTTP method.", + "Http Status Code 303 - See Other.", + "Http Status Code 307 - Temporary Redirect maintaining HTTP method." ], - "description": "Creates a target VPN gateway in the specified project and region using the data included in the request." + "enum": [ + "FOUND", + "MOVED_PERMANENTLY_DEFAULT", + "PERMANENT_REDIRECT", + "SEE_OTHER", + "TEMPORARY_REDIRECT" + ] }, - "delete": { - "id": "compute.targetVpnGateways.delete", - "path": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", - "flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "targetVpnGateway": { - "description": "Name of the target VPN gateway to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "targetVpnGateway" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified target VPN gateway." + "httpsRedirect": { + "description": "If set to true, the URL scheme in the redirected request is set to HTTPS. If set to false, the URL scheme of the redirected request remains the same as that of the request. This must only be set for URL maps used in TargetHttpProxys. Setting this true for TargetHttpsProxy is not permitted. The default is set to false.", + "type": "boolean" }, - "setLabels": { - "id": "compute.targetVpnGateways.setLabels", - "path": "projects/{project}/regions/{region}/targetVpnGateways/{resource}/setLabels", - "flatPath": "projects/{project}/regions/{region}/targetVpnGateways/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on a TargetVpnGateway. To learn more about labels, read the Labeling Resources documentation." + "stripQuery": { + "description": "If set to true, any accompanying query portion of the original URL is removed before redirecting the request. If set to false, the query portion of the original URL is retained. The default is set to false. ", + "type": "boolean" } } }, - "urlMaps": { - "methods": { - "list": { - "id": "compute.urlMaps.list", - "path": "projects/{project}/global/urlMaps", - "flatPath": "projects/{project}/global/urlMaps", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "UrlMapList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of UrlMap resources available to the specified project." + "PathRule": { + "id": "PathRule", + "description": "A path-matching rule for a URL. If matched, will use the specified BackendService to handle the traffic arriving at this URL.", + "type": "object", + "properties": { + "service": { + "description": "The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. However, if service is specified, routeAction cannot contain any weightedBackendServices. Conversely, if routeAction specifies any weightedBackendServices, service must not be specified. Only one of urlRedirect, service or routeAction.weightedBackendService must be set.", + "type": "string" + }, + "routeAction": { + "description": "In response to a matching path, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If routeAction specifies any weightedBackendServices, service must not be set. Conversely if service is set, routeAction cannot contain any weightedBackendServices. Only one of routeAction or urlRedirect must be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a path rule's routeAction.", + "$ref": "HttpRouteAction" + }, + "urlRedirect": { + "description": "When a path pattern is matched, the request is redirected to a URL specified by urlRedirect. If urlRedirect is specified, service or routeAction must not be set. Not supported when the URL map is bound to a target gRPC proxy.", + "$ref": "HttpRedirectAction" + }, + "paths": { + "description": "The list of path patterns to match. Each must start with / and the only place a * is allowed is at the end following a /. The string fed to the path matcher does not include any text after the first ? or #, and those chars are not allowed here.", + "type": "array", + "items": { + "type": "string" + } + }, + "customErrorResponsePolicy": { + "description": "customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the PathRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A PathRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in PathRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. customErrorResponsePolicy is supported only for global external Application Load Balancers.", + "$ref": "CustomErrorResponsePolicy" + } + } + }, + "CustomErrorResponsePolicy": { + "id": "CustomErrorResponsePolicy", + "description": "Specifies the custom error response policy that must be applied when the backend service or backend bucket responds with an error.", + "type": "object", + "properties": { + "errorResponseRules": { + "description": "Specifies rules for returning error responses. In a given policy, if you specify rules for both a range of error codes as well as rules for specific error codes then rules with specific error codes have a higher priority. For example, assume that you configure a rule for 401 (Un-authorized) code, and another for all 4 series error codes (4XX). If the backend service returns a 401, then the rule for 401 will be applied. However if the backend service returns a 403, the rule for 4xx takes effect.", + "type": "array", + "items": { + "$ref": "CustomErrorResponsePolicyCustomErrorResponseRule" + } + }, + "errorService": { + "description": "The full or partial URL to the BackendBucket resource that contains the custom error content. Examples are: - https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket - compute/v1/projects/project/global/backendBuckets/myBackendBucket - global/backendBuckets/myBackendBucket If errorService is not specified at lower levels like pathMatcher, pathRule and routeRule, an errorService specified at a higher level in the UrlMap will be used. If UrlMap.defaultCustomErrorResponsePolicy contains one or more errorResponseRules[], it must specify errorService. If load balancer cannot reach the backendBucket, a simple Not Found Error will be returned, with the original response code (or overrideResponseCode if configured). errorService is not supported for internal or regional HTTP/HTTPS load balancers.", + "type": "string" + } + } + }, + "CustomErrorResponsePolicyCustomErrorResponseRule": { + "id": "CustomErrorResponsePolicyCustomErrorResponseRule", + "description": "Specifies the mapping between the response code that will be returned along with the custom error content and the response code returned by the backend service.", + "type": "object", + "properties": { + "matchResponseCodes": { + "description": "Valid values include: - A number between 400 and 599: For example 401 or 503, in which case the load balancer applies the policy if the error code exactly matches this value. - 5xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 500 to 599. - 4xx: Load Balancer will apply the policy if the backend service responds with any response code in the range of 400 to 499. Values must be unique within matchResponseCodes and across all errorResponseRules of CustomErrorResponsePolicy.", + "type": "array", + "items": { + "type": "string" + } + }, + "path": { + "description": "The full path to a file within backendBucket . For example: /errors/defaultError.html path must start with a leading slash. path cannot have trailing slashes. If the file is not available in backendBucket or the load balancer cannot reach the BackendBucket, a simple Not Found Error is returned to the client. The value must be from 1 to 1024 characters", + "type": "string" + }, + "overrideResponseCode": { + "description": "The HTTP status code returned with the response containing the custom error content. If overrideResponseCode is not supplied, the same response code returned by the original backend bucket or backend service is returned to the client.", + "type": "integer", + "format": "int32" + } + } + }, + "HttpRouteRule": { + "id": "HttpRouteRule", + "description": "The HttpRouteRule setting specifies how to match an HTTP request and the corresponding routing action that load balancing proxies perform.", + "type": "object", + "properties": { + "priority": { + "description": "For routeRules within a given pathMatcher, priority determines the order in which a load balancer interprets routeRules. RouteRules are evaluated in order of priority, from the lowest to highest number. The priority of a rule decreases as its number increases (1, 2, 3, N+1). The first rule that matches the request is applied. You cannot configure two or more routeRules with the same priority. Priority for each rule must be set to a number from 0 to 2147483647 inclusive. Priority numbers can have gaps, which enable you to add or remove rules in the future without affecting the rest of the rules. For example, 1, 2, 3, 4, 5, 9, 12, 16 is a valid series of priority numbers to which you could add rules numbered from 6 to 8, 10 to 11, and 13 to 15 in the future without any impact on existing rules.", + "type": "integer", + "format": "int32" + }, + "description": { + "description": "The short description conveying the intent of this routeRule. The description can have a maximum length of 1024 characters.", + "type": "string" + }, + "matchRules": { + "description": "The list of criteria for matching attributes of a request to this routeRule. This list has OR semantics: the request matches this routeRule when any of the matchRules are satisfied. However predicates within a given matchRule have AND semantics. All predicates within a matchRule must match for the request to match the rule.", + "type": "array", + "items": { + "$ref": "HttpRouteRuleMatch" + } + }, + "service": { + "description": "The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is also specified, advanced routing actions, such as URL rewrites, take effect before sending the request to the backend. However, if service is specified, routeAction cannot contain any weightedBackendServices. Conversely, if routeAction specifies any weightedBackendServices, service must not be specified. Only one of urlRedirect, service or routeAction.weightedBackendService must be set.", + "type": "string" + }, + "routeAction": { + "description": "In response to a matching matchRule, the load balancer performs advanced routing actions, such as URL rewrites and header transformations, before forwarding the request to the selected backend. If routeAction specifies any weightedBackendServices, service must not be set. Conversely if service is set, routeAction cannot contain any weightedBackendServices. Only one of urlRedirect, service or routeAction.weightedBackendService must be set. URL maps for classic Application Load Balancers only support the urlRewrite action within a route rule's routeAction.", + "$ref": "HttpRouteAction" + }, + "urlRedirect": { + "description": "When this rule is matched, the request is redirected to a URL specified by urlRedirect. If urlRedirect is specified, service or routeAction must not be set. Not supported when the URL map is bound to a target gRPC proxy.", + "$ref": "HttpRedirectAction" + }, + "headerAction": { + "description": "Specifies changes to request and response headers that need to take effect for the selected backendService. The headerAction value specified here is applied before the matching pathMatchers[].headerAction and after pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction HeaderAction is not supported for load balancers that have their loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", + "$ref": "HttpHeaderAction" + }, + "customErrorResponsePolicy": { + "description": "customErrorResponsePolicy specifies how the Load Balancer returns error responses when BackendServiceor BackendBucket responds with an error. If a policy for an error code is not configured for the RouteRule, a policy for the error code configured in pathMatcher.defaultCustomErrorResponsePolicy is applied. If one is not specified in pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider a UrlMap with the following configuration: - UrlMap.defaultCustomErrorResponsePolicy are configured with policies for 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the error code 404. If the request is for www.myotherdomain.com and a 404 is encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes effect. If a 404 response is encountered for the request www.example.com/current_events/, the pathMatcher's policy takes effect. If however, the request for www.example.com/coming_soon/ encounters a 404, the policy in RouteRule.customErrorResponsePolicy takes effect. If any of the requests in this example encounter a 500 error code, the policy at UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with routeRules.routeAction.retryPolicy, retries take precedence. Only once all retries are exhausted, the customErrorResponsePolicy is applied. While attempting a retry, if load balancer is successful in reaching the service, the customErrorResponsePolicy is ignored and the response from the service is returned to the client. customErrorResponsePolicy is supported only for global external Application Load Balancers.", + "$ref": "CustomErrorResponsePolicy" + } + } + }, + "HttpRouteRuleMatch": { + "id": "HttpRouteRuleMatch", + "description": "HttpRouteRuleMatch specifies a set of criteria for matching requests to an HttpRouteRule. All specified criteria must be satisfied for a match to occur.", + "type": "object", + "properties": { + "prefixMatch": { + "description": "For satisfying the matchRule condition, the request's path must begin with the specified prefixMatch. prefixMatch must begin with a /. The value must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified.", + "type": "string" }, - "aggregatedList": { - "id": "compute.urlMaps.aggregatedList", - "path": "projects/{project}/aggregated/urlMaps", - "flatPath": "projects/{project}/aggregated/urlMaps", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Name of the project scoping this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "UrlMapsAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of all UrlMap resources, regional and global, available to the specified project. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "fullPathMatch": { + "description": "For satisfying the matchRule condition, the path of the request must exactly match the value specified in fullPathMatch after removing any query parameters and anchor that may be part of the original URL. fullPathMatch must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or regexMatch must be specified.", + "type": "string" }, - "get": { - "id": "compute.urlMaps.get", - "path": "projects/{project}/global/urlMaps/{urlMap}", - "flatPath": "projects/{project}/global/urlMaps/{urlMap}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "urlMap": { - "description": "Name of the UrlMap resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "urlMap" - ], - "response": { - "$ref": "UrlMap" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified UrlMap resource." + "regexMatch": { + "description": "For satisfying the matchRule condition, the path of the request must satisfy the regular expression specified in regexMatch after removing any query parameters and anchor supplied with the original URL. For more information about regular expression syntax, see Syntax. Only one of prefixMatch, fullPathMatch or regexMatch must be specified. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED.", + "type": "string" }, - "insert": { - "id": "compute.urlMaps.insert", - "path": "projects/{project}/global/urlMaps", - "flatPath": "projects/{project}/global/urlMaps", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project" - ], - "request": { - "$ref": "UrlMap" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a UrlMap resource in the specified project using the data included in the request." + "ignoreCase": { + "description": "Specifies that prefixMatch and fullPathMatch matches are case sensitive. The default value is false. ignoreCase must not be used with regexMatch. Not supported when the URL map is bound to a target gRPC proxy.", + "type": "boolean" }, - "delete": { - "id": "compute.urlMaps.delete", - "path": "projects/{project}/global/urlMaps/{urlMap}", - "flatPath": "projects/{project}/global/urlMaps/{urlMap}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "urlMap": { - "description": "Name of the UrlMap resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "urlMap" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified UrlMap resource." + "headerMatches": { + "description": "Specifies a list of header match criteria, all of which must match corresponding headers in the request.", + "type": "array", + "items": { + "$ref": "HttpHeaderMatch" + } }, - "update": { - "id": "compute.urlMaps.update", - "path": "projects/{project}/global/urlMaps/{urlMap}", - "flatPath": "projects/{project}/global/urlMaps/{urlMap}", - "httpMethod": "PUT", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "urlMap": { - "description": "Name of the UrlMap resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "urlMap" - ], - "request": { - "$ref": "UrlMap" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified UrlMap resource with the data included in the request." + "queryParameterMatches": { + "description": "Specifies a list of query parameter match criteria, all of which must match corresponding query parameters in the request. Not supported when the URL map is bound to a target gRPC proxy.", + "type": "array", + "items": { + "$ref": "HttpQueryParameterMatch" + } }, - "patch": { - "id": "compute.urlMaps.patch", - "path": "projects/{project}/global/urlMaps/{urlMap}", - "flatPath": "projects/{project}/global/urlMaps/{urlMap}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "urlMap": { - "description": "Name of the UrlMap resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "urlMap" - ], - "request": { - "$ref": "UrlMap" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified UrlMap resource with the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules." + "metadataFilters": { + "description": "Opaque filter criteria used by the load balancer to restrict routing configuration to a limited set of xDS compliant clients. In their xDS requests to the load balancer, xDS clients present node metadata. When there is a match, the relevant routing configuration is made available to those proxies. For each metadataFilter in this list, if its filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels must match the corresponding label provided in the metadata. If its filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must match with corresponding labels provided in the metadata. If multiple metadata filters are specified, all of them need to be satisfied in order to be considered a match. metadataFilters specified here is applied after those specified in ForwardingRule that refers to the UrlMap this HttpRouteRuleMatch belongs to. metadataFilters only applies to load balancers that have loadBalancingScheme set to INTERNAL_SELF_MANAGED. Not supported when the URL map is bound to a target gRPC proxy that has validateForProxyless field set to true.", + "type": "array", + "items": { + "$ref": "MetadataFilter" + } }, - "validate": { - "id": "compute.urlMaps.validate", - "path": "projects/{project}/global/urlMaps/{urlMap}/validate", - "flatPath": "projects/{project}/global/urlMaps/{urlMap}/validate", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "urlMap": { - "description": "Name of the UrlMap resource to be validated as.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "urlMap" - ], - "request": { - "$ref": "UrlMapsValidateRequest" - }, - "response": { - "$ref": "UrlMapsValidateResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap." + "pathTemplateMatch": { + "description": "If specified, the route is a pattern match expression that must match the :path header once the query string is removed. A pattern match allows you to match - The value must be between 1 and 1024 characters - The pattern must start with a leading slash (\"/\") - There may be no more than 5 operators in pattern Precisely one of prefix_match, full_path_match, regex_match or path_template_match must be set.", + "type": "string" + } + } + }, + "HttpHeaderMatch": { + "id": "HttpHeaderMatch", + "description": "matchRule criteria for request header matches.", + "type": "object", + "properties": { + "headerName": { + "description": "The name of the HTTP header to match. For matching against the HTTP request's authority, use a headerMatch with the header name \":authority\". For matching a request's method, use the headerName \":method\". When the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true, only non-binary user-specified custom metadata and the `content-type` header are supported. The following transport-level headers cannot be used in header matching rules: `:authority`, `:method`, `:path`, `:scheme`, `user-agent`, `accept-encoding`, `content-encoding`, `grpc-accept-encoding`, `grpc-encoding`, `grpc-previous-rpc-attempts`, `grpc-tags-bin`, `grpc-timeout` and `grpc-trace-bin`.", + "type": "string" }, - "invalidateCache": { - "id": "compute.urlMaps.invalidateCache", - "path": "projects/{project}/global/urlMaps/{urlMap}/invalidateCache", - "flatPath": "projects/{project}/global/urlMaps/{urlMap}/invalidateCache", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "urlMap": { - "description": "Name of the UrlMap scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "urlMap" - ], - "request": { - "$ref": "CacheInvalidationRule" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Initiates a cache invalidation operation, invalidating the specified path, scoped to the specified UrlMap. For more information, see [Invalidating cached content](/cdn/docs/invalidating-cached-content)." + "exactMatch": { + "description": "The value should exactly match contents of exactMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set.", + "type": "string" + }, + "regexMatch": { + "description": "The value of the header must match the regular expression specified in regexMatch. For more information about regular expression syntax, see Syntax. For matching against a port specified in the HTTP request, use a headerMatch with headerName set to PORT and a regular expression that satisfies the RFC2616 Host header's port specifier. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED.", + "type": "string" + }, + "rangeMatch": { + "description": "The header value must be an integer and its value must be in the range specified in rangeMatch. If the header does not contain an integer, number or is empty, the match fails. For example for a range [-5, 0] - -3 will match. - 0 will not match. - 0.25 will not match. - -3someString will not match. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set. rangeMatch is not supported for load balancers that have loadBalancingScheme set to EXTERNAL.", + "$ref": "Int64RangeMatch" + }, + "presentMatch": { + "description": "A header with the contents of headerName must exist. The match takes place whether or not the request's header has a value. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set.", + "type": "boolean" + }, + "prefixMatch": { + "description": "The value of the header must start with the contents of prefixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set.", + "type": "string" + }, + "suffixMatch": { + "description": "The value of the header must end with the contents of suffixMatch. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be set.", + "type": "string" + }, + "invertMatch": { + "description": "If set to false, the headerMatch is considered a match if the preceding match criteria are met. If set to true, the headerMatch is considered a match if the preceding match criteria are NOT met. The default setting is false. ", + "type": "boolean" } } }, - "regionUrlMaps": { - "methods": { - "list": { - "id": "compute.regionUrlMaps.list", - "path": "projects/{project}/regions/{region}/urlMaps", - "flatPath": "projects/{project}/regions/{region}/urlMaps", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "UrlMapList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of UrlMap resources available to the specified project in the specified region." + "Int64RangeMatch": { + "id": "Int64RangeMatch", + "description": "HttpRouteRuleMatch criteria for field values that must stay within the specified integer range.", + "type": "object", + "properties": { + "rangeStart": { + "description": "The start of the range (inclusive) in signed long integer format.", + "type": "string", + "format": "int64" + }, + "rangeEnd": { + "description": "The end of the range (exclusive) in signed long integer format.", + "type": "string", + "format": "int64" + } + } + }, + "HttpQueryParameterMatch": { + "id": "HttpQueryParameterMatch", + "description": "HttpRouteRuleMatch criteria for a request's query parameter.", + "type": "object", + "properties": { + "name": { + "description": "The name of the query parameter to match. The query parameter must exist in the request, in the absence of which the request match fails.", + "type": "string" + }, + "presentMatch": { + "description": "Specifies that the queryParameterMatch matches if the request contains the query parameter, irrespective of whether the parameter has a value or not. Only one of presentMatch, exactMatch, or regexMatch must be set. ", + "type": "boolean" + }, + "exactMatch": { + "description": "The queryParameterMatch matches if the value of the parameter exactly matches the contents of exactMatch. Only one of presentMatch, exactMatch, or regexMatch must be set. ", + "type": "string" + }, + "regexMatch": { + "description": "The queryParameterMatch matches if the value of the parameter matches the regular expression specified by regexMatch. For more information about regular expression syntax, see Syntax. Only one of presentMatch, exactMatch, or regexMatch must be set. Regular expressions can only be used when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. ", + "type": "string" + } + } + }, + "UrlMapTest": { + "id": "UrlMapTest", + "description": "Message for the expected URL mappings.", + "type": "object", + "properties": { + "description": { + "description": "Description of this test case.", + "type": "string" }, - "get": { - "id": "compute.regionUrlMaps.get", - "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}", - "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "urlMap": { - "description": "Name of the UrlMap resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "urlMap" - ], - "response": { - "$ref": "UrlMap" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified UrlMap resource." + "host": { + "description": "Host portion of the URL. If headers contains a host header, then host must also match the header value.", + "type": "string" }, - "insert": { - "id": "compute.regionUrlMaps.insert", - "path": "projects/{project}/regions/{region}/urlMaps", - "flatPath": "projects/{project}/regions/{region}/urlMaps", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "begin_interface: MixerMutationRequestBuilder Request ID to support idempotency.", - "location": "query", - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "UrlMap" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Creates a UrlMap resource in the specified project using the data included in the request." + "path": { + "description": "Path portion of the URL.", + "type": "string" }, - "delete": { - "id": "compute.regionUrlMaps.delete", - "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}", - "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "begin_interface: MixerMutationRequestBuilder Request ID to support idempotency.", - "location": "query", - "type": "string" - }, - "urlMap": { - "description": "Name of the UrlMap resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "urlMap" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified UrlMap resource." + "headers": { + "description": "HTTP headers for this request. If headers contains a host header, then host must also match the header value.", + "type": "array", + "items": { + "$ref": "UrlMapTestHeader" + } }, - "update": { - "id": "compute.regionUrlMaps.update", - "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}", - "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", - "httpMethod": "PUT", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "begin_interface: MixerMutationRequestBuilder Request ID to support idempotency.", - "location": "query", - "type": "string" - }, - "urlMap": { - "description": "Name of the UrlMap resource to update.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "urlMap" - ], - "request": { - "$ref": "UrlMap" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Updates the specified UrlMap resource with the data included in the request." + "service": { + "description": "Expected BackendService or BackendBucket resource the given URL should be mapped to. The service field cannot be set if expectedRedirectResponseCode is set.", + "type": "string" }, - "patch": { - "id": "compute.regionUrlMaps.patch", - "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}", - "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}", - "httpMethod": "PATCH", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "begin_interface: MixerMutationRequestBuilder Request ID to support idempotency.", - "location": "query", - "type": "string" - }, - "urlMap": { - "description": "Name of the UrlMap resource to patch.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "urlMap" - ], - "request": { - "$ref": "UrlMap" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Patches the specified UrlMap resource with the data included in the request. This method supports PATCH semantics and uses JSON merge patch format and processing rules." + "expectedOutputUrl": { + "description": "The expected output URL evaluated by the load balancer containing the scheme, host, path and query parameters. For rules that forward requests to backends, the test passes only when expectedOutputUrl matches the request forwarded by the load balancer to backends. For rules with urlRewrite, the test verifies that the forwarded request matches hostRewrite and pathPrefixRewrite in the urlRewrite action. When service is specified, expectedOutputUrl`s scheme is ignored. For rules with urlRedirect, the test passes only if expectedOutputUrl matches the URL in the load balancer's redirect response. If urlRedirect specifies https_redirect, the test passes only if the scheme in expectedOutputUrl is also set to HTTPS. If urlRedirect specifies strip_query, the test passes only if expectedOutputUrl does not contain any query parameters. expectedOutputUrl is optional when service is specified.", + "type": "string" }, - "validate": { - "id": "compute.regionUrlMaps.validate", - "path": "projects/{project}/regions/{region}/urlMaps/{urlMap}/validate", - "flatPath": "projects/{project}/regions/{region}/urlMaps/{urlMap}/validate", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region scoping this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "urlMap": { - "description": "Name of the UrlMap resource to be validated as.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "urlMap" - ], - "request": { - "$ref": "RegionUrlMapsValidateRequest" - }, - "response": { - "$ref": "UrlMapsValidateResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap." + "expectedRedirectResponseCode": { + "description": "For rules with urlRedirect, the test passes only if expectedRedirectResponseCode matches the HTTP status code in load balancer's redirect response. expectedRedirectResponseCode cannot be set when service is set.", + "type": "integer", + "format": "int32" } } }, - "vpnGateways": { - "methods": { - "list": { - "id": "compute.vpnGateways.list", - "path": "projects/{project}/regions/{region}/vpnGateways", - "flatPath": "projects/{project}/regions/{region}/vpnGateways", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "VpnGatewayList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of VPN gateways available to the specified project and region." + "UrlMapTestHeader": { + "id": "UrlMapTestHeader", + "description": "HTTP headers used in UrlMapTests.", + "type": "object", + "properties": { + "name": { + "description": "Header name.", + "type": "string" }, - "aggregatedList": { - "id": "compute.vpnGateways.aggregatedList", - "path": "projects/{project}/aggregated/vpnGateways", - "flatPath": "projects/{project}/aggregated/vpnGateways", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" + "value": { + "description": "Header value.", + "type": "string" + } + } + }, + "UrlMapsAggregatedList": { + "id": "UrlMapsAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#urlMapsAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of UrlMapsScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of UrlMaps.", + "$ref": "UrlMapsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "VpnGatewayAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves an aggregated list of VPN gateways. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + } }, - "get": { - "id": "compute.vpnGateways.get", - "path": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", - "flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "UrlMapsScopedList": { + "id": "UrlMapsScopedList", + "type": "object", + "properties": { + "urlMaps": { + "description": "A list of UrlMaps contained in this scope.", + "type": "array", + "items": { + "$ref": "UrlMap" + } + }, + "warning": { + "description": "Informational warning which replaces the list of backend services when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "vpnGateway": { - "description": "Name of the VPN gateway to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "vpnGateway" - ], - "response": { + } + } + } + }, + "UrlMapsValidateRequest": { + "id": "UrlMapsValidateRequest", + "type": "object", + "properties": { + "resource": { + "description": "Content of the UrlMap to be validated.", + "$ref": "UrlMap" + }, + "loadBalancingSchemes": { + "description": "Specifies the load balancer type(s) this validation request is for. Use EXTERNAL_MANAGED for global external Application Load Balancers and regional external Application Load Balancers. Use EXTERNAL for classic Application Load Balancers. Use INTERNAL_MANAGED for internal Application Load Balancers. For more information, refer to Choosing a load balancer. If unspecified, the load balancing scheme will be inferred from the backend service resources this URL map references. If that can not be inferred (for example, this URL map only references backend buckets, or this Url map is for rewrites and redirects only and doesn't reference any backends), EXTERNAL will be used as the default type. If specified, the scheme(s) must not conflict with the load balancing scheme of the backend service resources this Url map references.", + "type": "array", + "items": { + "type": "string", + "enumDescriptions": [ + "Signifies that this will be used for classic Application Load Balancers.", + "Signifies that this will be used for Envoy-based global external Application Load Balancers.", + "If unspecified, the validation will try to infer the scheme from the backend service resources this Url map references. If the inference is not possible, EXTERNAL will be used as the default type." + ], + "enum": [ + "EXTERNAL", + "EXTERNAL_MANAGED", + "LOAD_BALANCING_SCHEME_UNSPECIFIED" + ] + } + } + } + }, + "UrlMapsValidateResponse": { + "id": "UrlMapsValidateResponse", + "type": "object", + "properties": { + "result": { + "$ref": "UrlMapValidationResult" + } + } + }, + "UrlMapValidationResult": { + "id": "UrlMapValidationResult", + "description": "Message representing the validation result for a UrlMap.", + "type": "object", + "properties": { + "loadSucceeded": { + "description": "Whether the given UrlMap can be successfully loaded. If false, 'loadErrors' indicates the reasons.", + "type": "boolean" + }, + "loadErrors": { + "type": "array", + "items": { + "type": "string" + } + }, + "testPassed": { + "description": "If successfully loaded, this field indicates whether the test passed. If false, 'testFailures's indicate the reason of failure.", + "type": "boolean" + }, + "testFailures": { + "type": "array", + "items": { + "$ref": "TestFailure" + } + } + } + }, + "TestFailure": { + "id": "TestFailure", + "type": "object", + "properties": { + "host": { + "description": "Host portion of the URL.", + "type": "string" + }, + "path": { + "description": "Path portion including query parameters in the URL.", + "type": "string" + }, + "headers": { + "description": "HTTP headers of the request.", + "type": "array", + "items": { + "$ref": "UrlMapTestHeader" + } + }, + "expectedService": { + "description": "Expected BackendService or BackendBucket resource the given URL should be mapped to.", + "type": "string" + }, + "actualService": { + "description": "BackendService or BackendBucket returned by load balancer.", + "type": "string" + }, + "expectedOutputUrl": { + "description": "The expected output URL evaluated by a load balancer containing the scheme, host, path and query parameters.", + "type": "string" + }, + "actualOutputUrl": { + "description": "The actual output URL evaluated by a load balancer containing the scheme, host, path and query parameters.", + "type": "string" + }, + "expectedRedirectResponseCode": { + "description": "Expected HTTP status code for rule with `urlRedirect` calculated by load balancer", + "type": "integer", + "format": "int32" + }, + "actualRedirectResponseCode": { + "description": "Actual HTTP status code for rule with `urlRedirect` calculated by load balancer", + "type": "integer", + "format": "int32" + } + } + }, + "CacheInvalidationRule": { + "id": "CacheInvalidationRule", + "type": "object", + "properties": { + "path": { + "type": "string" + }, + "host": { + "description": "If set, this invalidation rule will only apply to requests with a Host header matching host.", + "type": "string" + } + } + }, + "RegionUrlMapsValidateRequest": { + "id": "RegionUrlMapsValidateRequest", + "type": "object", + "properties": { + "resource": { + "description": "Content of the UrlMap to be validated.", + "$ref": "UrlMap" + } + } + }, + "VpnGatewayList": { + "id": "VpnGatewayList", + "description": "Contains a list of VpnGateway resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#vpnGateway for VPN gateways.", + "default": "compute#vpnGatewayList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of VpnGateway resources.", + "type": "array", + "items": { "$ref": "VpnGateway" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified VPN gateway." + } }, - "getStatus": { - "id": "compute.vpnGateways.getStatus", - "path": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}/getStatus", - "flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}/getStatus", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "vpnGateway": { - "description": "Name of the VPN gateway to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } + } + } + } + }, + "VpnGateway": { + "id": "VpnGateway", + "description": "Represents a HA VPN gateway. HA VPN is a high-availability (HA) Cloud VPN solution that lets you securely connect your on-premises network to your Google Cloud Virtual Private Cloud network through an IPsec VPN connection in a single region. For more information about Cloud HA VPN solutions, see Cloud VPN topologies .", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#vpnGateway for VPN gateways.", + "default": "compute#vpnGateway", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.vpnGateways.insert" + ] }, - "parameterOrder": [ - "project", - "region", - "vpnGateway" - ], - "response": { - "$ref": "VpnGatewaysGetStatusResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the status for the specified VPN gateway." + "type": "string" }, - "insert": { - "id": "compute.vpnGateways.insert", - "path": "projects/{project}/regions/{region}/vpnGateways", - "flatPath": "projects/{project}/regions/{region}/vpnGateways", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - } + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the VPN gateway resides.", + "type": "string" + }, + "network": { + "description": "URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created.", + "annotations": { + "required": [ + "compute.vpnGateways.insert" + ] }, - "parameterOrder": [ - "project", - "region" + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "labels": { + "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this VpnGateway, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnGateway.", + "type": "string", + "format": "byte" + }, + "vpnInterfaces": { + "description": "The list of VPN interfaces associated with this VPN gateway.", + "type": "array", + "items": { + "$ref": "VpnGatewayVpnGatewayInterface" + } + }, + "stackType": { + "description": "The stack type for this VPN gateway to identify the IP protocols that are enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not specified, IPV4_ONLY is used if the gateway IP version is IPV4, or IPV4_IPV6 if the gateway IP version is IPV6.", + "type": "string", + "enumDescriptions": [ + "Enable VPN gateway with both IPv4 and IPv6 protocols.", + "Enable VPN gateway with only IPv4 protocol.", + "Enable VPN gateway with only IPv6 protocol." ], - "request": { - "$ref": "VpnGateway" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "enum": [ + "IPV4_IPV6", + "IPV4_ONLY", + "IPV6_ONLY" + ] + }, + "gatewayIpVersion": { + "description": "The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not specified, IPV4 will be used.", + "type": "string", + "enumDescriptions": [ + "Every HA-VPN gateway interface is configured with an IPv4 address.", + "Every HA-VPN gateway interface is configured with an IPv6 address." ], - "description": "Creates a VPN gateway in the specified project and region using the data included in the request." + "enum": [ + "IPV4", + "IPV6" + ] + } + } + }, + "VpnGatewayVpnGatewayInterface": { + "id": "VpnGatewayVpnGatewayInterface", + "description": "A VPN gateway interface.", + "type": "object", + "properties": { + "id": { + "description": "[Output Only] Numeric identifier for this VPN interface associated with the VPN gateway.", + "type": "integer", + "format": "uint32" }, - "delete": { - "id": "compute.vpnGateways.delete", - "path": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", - "flatPath": "projects/{project}/regions/{region}/vpnGateways/{vpnGateway}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "ipAddress": { + "description": "[Output Only] IP address for this VPN interface associated with the VPN gateway. The IP address could be either a regional external IP address or a regional internal IP address. The two IP addresses for a VPN gateway must be all regional external or regional internal IP addresses. There cannot be a mix of regional external IP addresses and regional internal IP addresses. For HA VPN over Cloud Interconnect, the IP addresses for both interfaces could either be regional internal IP addresses or regional external IP addresses. For regular (non HA VPN over Cloud Interconnect) HA VPN tunnels, the IP address must be a regional external IP address.", + "type": "string" + }, + "ipv6Address": { + "description": "[Output Only] IPv6 address for this VPN interface associated with the VPN gateway. The IPv6 address must be a regional external IPv6 address. The format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0).", + "type": "string" + }, + "interconnectAttachment": { + "description": "URL of the VLAN attachment (interconnectAttachment) resource for this VPN gateway interface. When the value of this field is present, the VPN gateway is used for HA VPN over Cloud Interconnect; all egress or ingress traffic for this VPN gateway interface goes through the specified VLAN attachment resource.", + "type": "string" + } + } + }, + "VpnGatewayAggregatedList": { + "id": "VpnGatewayAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#vpnGateway for VPN gateways.", + "default": "compute#vpnGatewayAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of VpnGateway resources.", + "type": "object", + "additionalProperties": { + "description": "[Output Only] Name of the scope containing this set of VPN gateways.", + "$ref": "VpnGatewaysScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "vpnGateway": { - "description": "Name of the VPN gateway to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "vpnGateway" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified VPN gateway." + } }, - "testIamPermissions": { - "id": "compute.vpnGateways.testIamPermissions", - "path": "projects/{project}/regions/{region}/vpnGateways/{resource}/testIamPermissions", - "flatPath": "projects/{project}/regions/{region}/vpnGateways/{resource}/testIamPermissions", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "VpnGatewaysScopedList": { + "id": "VpnGatewaysScopedList", + "type": "object", + "properties": { + "vpnGateways": { + "description": "[Output Only] A list of VPN gateways contained in this scope.", + "type": "array", + "items": { + "$ref": "VpnGateway" + } + }, + "warning": { + "description": "[Output Only] Informational warning which replaces the list of addresses when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "The name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "TestPermissionsRequest" - }, - "response": { - "$ref": "TestPermissionsResponse" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns permissions that a caller has on the specified resource." + } + } + } + }, + "VpnGatewaysGetStatusResponse": { + "id": "VpnGatewaysGetStatusResponse", + "type": "object", + "properties": { + "result": { + "$ref": "VpnGatewayStatus" + } + } + }, + "VpnGatewayStatus": { + "id": "VpnGatewayStatus", + "type": "object", + "properties": { + "vpnConnections": { + "description": "List of VPN connection for this VpnGateway.", + "type": "array", + "items": { + "$ref": "VpnGatewayStatusVpnConnection" + } + } + } + }, + "VpnGatewayStatusVpnConnection": { + "id": "VpnGatewayStatusVpnConnection", + "description": "A VPN connection contains all VPN tunnels connected from this VpnGateway to the same peer gateway. The peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway.", + "type": "object", + "properties": { + "peerExternalGateway": { + "description": "URL reference to the peer external VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway.", + "type": "string" }, - "setLabels": { - "id": "compute.vpnGateways.setLabels", - "path": "projects/{project}/regions/{region}/vpnGateways/{resource}/setLabels", - "flatPath": "projects/{project}/regions/{region}/vpnGateways/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" - }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on a VpnGateway. To learn more about labels, read the Labeling Resources documentation." + "peerGcpGateway": { + "description": "URL reference to the peer side VPN gateways to which the VPN tunnels in this VPN connection are connected. This field is mutually exclusive with peer_gcp_gateway.", + "type": "string" + }, + "tunnels": { + "description": "List of VPN tunnels that are in this VPN connection.", + "type": "array", + "items": { + "$ref": "VpnGatewayStatusTunnel" + } + }, + "state": { + "description": "HighAvailabilityRequirementState for the VPN connection.", + "$ref": "VpnGatewayStatusHighAvailabilityRequirementState" } } }, - "vpnTunnels": { - "methods": { - "list": { - "id": "compute.vpnTunnels.list", - "path": "projects/{project}/regions/{region}/vpnTunnels", - "flatPath": "projects/{project}/regions/{region}/vpnTunnels", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "VpnTunnelList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves a list of VpnTunnel resources contained in the specified project and region." + "VpnGatewayStatusTunnel": { + "id": "VpnGatewayStatusTunnel", + "description": "Contains some information about a VPN tunnel.", + "type": "object", + "properties": { + "localGatewayInterface": { + "description": "The VPN gateway interface this VPN tunnel is associated with.", + "type": "integer", + "format": "uint32" }, - "aggregatedList": { - "id": "compute.vpnTunnels.aggregatedList", - "path": "projects/{project}/aggregated/vpnTunnels", - "flatPath": "projects/{project}/aggregated/vpnTunnels", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "includeAllScopes": { - "description": "Indicates whether every visible scope for each scope type (zone, region, global) should be included in the response. For new resource types added after this field, the flag has no effect as new resource types will always include every visible scope for each scope type in response. For resource types which predate this field, if this flag is omitted or false, only scopes of the scope types where the resource type is expected to be found will be included.", - "location": "query", - "type": "boolean" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - }, - "serviceProjectNumber": { - "description": "The Shared VPC service project id or service project number for which aggregated list request is invoked for subnetworks list-usable api.", - "location": "query", - "type": "string", - "format": "int64" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "VpnTunnelAggregatedList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "peerGatewayInterface": { + "description": "The peer gateway interface this VPN tunnel is connected to, the peer gateway could either be an external VPN gateway or a Google Cloud VPN gateway.", + "type": "integer", + "format": "uint32" + }, + "tunnelUrl": { + "description": "URL reference to the VPN tunnel.", + "type": "string" + } + } + }, + "VpnGatewayStatusHighAvailabilityRequirementState": { + "id": "VpnGatewayStatusHighAvailabilityRequirementState", + "description": "Describes the high availability requirement state for the VPN connection between this Cloud VPN gateway and a peer gateway.", + "type": "object", + "properties": { + "state": { + "description": "Indicates the high availability requirement state for the VPN connection. Valid values are CONNECTION_REDUNDANCY_MET, CONNECTION_REDUNDANCY_NOT_MET.", + "type": "string", + "enumDescriptions": [ + "VPN tunnels are configured with adequate redundancy from Cloud VPN gateway to the peer VPN gateway. For both GCP-to-non-GCP and GCP-to-GCP connections, the adequate redundancy is a pre-requirement for users to get 99.99% availability on GCP side; please note that for any connection, end-to-end 99.99% availability is subject to proper configuration on the peer VPN gateway.", + "VPN tunnels are not configured with adequate redundancy from the Cloud VPN gateway to the peer gateway" ], - "description": "Retrieves an aggregated list of VPN tunnels. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`." + "enum": [ + "CONNECTION_REDUNDANCY_MET", + "CONNECTION_REDUNDANCY_NOT_MET" + ] }, - "get": { - "id": "compute.vpnTunnels.get", - "path": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", - "flatPath": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "vpnTunnel": { - "description": "Name of the VpnTunnel resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" - } - }, - "parameterOrder": [ - "project", - "region", - "vpnTunnel" + "unsatisfiedReason": { + "description": "Indicates the reason why the VPN connection does not meet the high availability redundancy criteria/requirement. Valid values is INCOMPLETE_TUNNELS_COVERAGE.", + "type": "string", + "enumDescriptions": [ + "" ], - "response": { + "enum": [ + "INCOMPLETE_TUNNELS_COVERAGE" + ] + } + } + }, + "VpnTunnelList": { + "id": "VpnTunnelList", + "description": "Contains a list of VpnTunnel resources.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels.", + "default": "compute#vpnTunnelList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of VpnTunnel resources.", + "type": "array", + "items": { "$ref": "VpnTunnel" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified VpnTunnel resource." + } }, - "insert": { - "id": "compute.vpnTunnels.insert", - "path": "projects/{project}/regions/{region}/vpnTunnels", - "flatPath": "projects/{project}/regions/{region}/vpnTunnels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } + } + } + } + }, + "VpnTunnel": { + "id": "VpnTunnel", + "description": "Represents a Cloud VPN Tunnel resource. For more information about VPN, read the the Cloud VPN Overview.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels.", + "default": "compute#vpnTunnel", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "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])?", + "annotations": { + "required": [ + "compute.vpnTunnels.insert" + ] }, - "parameterOrder": [ - "project", - "region" - ], - "request": { - "$ref": "VpnTunnel" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" + "type": "string" + }, + "description": { + "description": "An optional description of this resource. Provide this property when you create the resource.", + "type": "string" + }, + "region": { + "description": "[Output Only] URL of the region where the VPN tunnel resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.", + "type": "string" + }, + "targetVpnGateway": { + "description": "URL of the Target VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This field can be set only for Classic VPN tunnels.", + "type": "string" + }, + "vpnGateway": { + "description": "URL of the VPN gateway with which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created. This must be used (instead of target_vpn_gateway) if a High Availability VPN gateway resource is created.", + "type": "string" + }, + "vpnGatewayInterface": { + "description": "The interface ID of the VPN gateway with which this VPN tunnel is associated. Possible values are: `0`, `1`.", + "type": "integer", + "format": "int32" + }, + "peerExternalGateway": { + "description": "URL of the peer side external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field is exclusive with the field peerGcpGateway.", + "type": "string" + }, + "peerExternalGatewayInterface": { + "description": "The interface ID of the external VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. Possible values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the external VPN gateway redundancy type.", + "type": "integer", + "format": "int32" + }, + "peerGcpGateway": { + "description": "URL of the peer side HA VPN gateway to which this VPN tunnel is connected. Provided by the client when the VPN tunnel is created. This field can be used when creating highly available VPN from VPC network to VPC network, the field is exclusive with the field peerExternalGateway. If provided, the VPN tunnel will automatically use the same vpnGatewayInterface ID in the peer Google Cloud VPN gateway.", + "type": "string" + }, + "router": { + "description": "URL of the router resource to be used for dynamic routing.", + "type": "string" + }, + "peerIp": { + "description": "IP address of the peer VPN gateway. Only IPv4 is supported. This field can be set only for Classic VPN tunnels.", + "type": "string" + }, + "sharedSecret": { + "description": "Shared secret used to set the secure session between the Cloud VPN gateway and the peer VPN gateway.", + "type": "string" + }, + "sharedSecretHash": { + "description": "Hash of the shared secret.", + "type": "string" + }, + "status": { + "description": "[Output Only] The status of the VPN tunnel, which can be one of the following: - PROVISIONING: Resource is being allocated for the VPN tunnel. - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs from the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route resources are needed to setup the VPN tunnel. - FIRST_HANDSHAKE: Successful first handshake with the peer VPN. - ESTABLISHED: Secure session is successfully established with the peer VPN. - NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS - AUTHORIZATION_ERROR: Auth error (for example, bad shared secret). - NEGOTIATION_FAILURE: Handshake failed. - DEPROVISIONING: Resources are being deallocated for the VPN tunnel. - FAILED: Tunnel creation has failed and the tunnel is not ready to be used. - NO_INCOMING_PACKETS: No incoming packets from peer. - REJECTED: Tunnel configuration was rejected, can be result of being denied access. - ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all required resources. - STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted for Classic VPN tunnels or the project is in frozen state. - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, probably behind NAT. - TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing not allowed for an HA-VPN tunnel. ", + "type": "string", + "enumDescriptions": [ + "Cloud VPN is in the process of allocating all required resources (specifically, a borg task).", + "Auth error (e.g. bad shared secret).", + "Resources is being deallocated for the VPN tunnel.", + "Secure session is successfully established with peer VPN.", + "Tunnel creation has failed and the tunnel is not ready to be used.", + "Successful first handshake with peer VPN.", + "Handshake failed.", + "Deprecated, replaced by NO_INCOMING_PACKETS", + "No incoming packets from peer", + "Resource is being allocated for the VPN tunnel.", + "Tunnel configuration was rejected, can be result of being denylisted.", + "Tunnel is stopped due to its Forwarding Rules being deleted.", + "Waiting to receive all VPN-related configs from user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule and Route resources are needed to setup VPN tunnel." ], - "description": "Creates a VpnTunnel resource in the specified project and region using the data included in the request." + "enum": [ + "ALLOCATING_RESOURCES", + "AUTHORIZATION_ERROR", + "DEPROVISIONING", + "ESTABLISHED", + "FAILED", + "FIRST_HANDSHAKE", + "NEGOTIATION_FAILURE", + "NETWORK_ERROR", + "NO_INCOMING_PACKETS", + "PROVISIONING", + "REJECTED", + "STOPPED", + "WAITING_FOR_FULL_CONFIG" + ] }, - "delete": { - "id": "compute.vpnTunnels.delete", - "path": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", - "flatPath": "projects/{project}/regions/{region}/vpnTunnels/{vpnTunnel}", - "httpMethod": "DELETE", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Name of the region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "selfLink": { + "description": "[Output Only] Server-defined URL for the resource.", + "type": "string" + }, + "ikeVersion": { + "description": "IKE protocol version to use when establishing the VPN tunnel with the peer VPN gateway. Acceptable IKE versions are 1 or 2. The default version is 2.", + "type": "integer", + "format": "int32" + }, + "detailedStatus": { + "description": "[Output Only] Detailed status message for the VPN tunnel.", + "type": "string" + }, + "localTrafficSelector": { + "description": "Local traffic selector to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels.", + "type": "array", + "items": { + "type": "string" + } + }, + "remoteTrafficSelector": { + "description": "Remote traffic selectors to use when establishing the VPN tunnel with the peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported for Classic VPN tunnels. This field is output only for HA VPN tunnels.", + "type": "array", + "items": { + "type": "string" + } + }, + "labels": { + "description": "Labels for this resource. These can only be added or modified by the setLabels method. Each label key/value pair must comply with RFC1035. Label values may be empty.", + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "labelFingerprint": { + "description": "A fingerprint for the labels being applied to this VpnTunnel, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a VpnTunnel.", + "type": "string", + "format": "byte" + } + } + }, + "VpnTunnelAggregatedList": { + "id": "VpnTunnelAggregatedList", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels.", + "default": "compute#vpnTunnelAggregatedList", + "type": "string" + }, + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of VpnTunnelsScopedList resources.", + "type": "object", + "additionalProperties": { + "description": "Name of the scope containing this set of VPN tunnels.", + "$ref": "VpnTunnelsScopedList" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "vpnTunnel": { - "description": "Name of the VpnTunnel resource to delete.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "vpnTunnel" - ], - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Deletes the specified VpnTunnel resource." + } }, - "setLabels": { - "id": "compute.vpnTunnels.setLabels", - "path": "projects/{project}/regions/{region}/vpnTunnels/{resource}/setLabels", - "flatPath": "projects/{project}/regions/{region}/vpnTunnels/{resource}/setLabels", - "httpMethod": "POST", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "The region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" + "unreachables": { + "description": "[Output Only] Unreachable resources.", + "type": "array", + "items": { + "type": "string" + } + } + } + }, + "VpnTunnelsScopedList": { + "id": "VpnTunnelsScopedList", + "type": "object", + "properties": { + "vpnTunnels": { + "description": "A list of VPN tunnels contained in this scope.", + "type": "array", + "items": { + "$ref": "VpnTunnel" + } + }, + "warning": { + "description": "Informational warning which replaces the list of addresses when the list is empty.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "requestId": { - "description": "An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).", - "location": "query", + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" }, - "resource": { - "description": "Name or id of the resource for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, - "type": "string" + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "region", - "resource" - ], - "request": { - "$ref": "RegionSetLabelsRequest" - }, - "response": { - "$ref": "Operation" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute" - ], - "description": "Sets the labels on a VpnTunnel. To learn more about labels, read the Labeling Resources documentation." + } } } }, - "zones": { - "methods": { - "list": { - "id": "compute.zones.list", - "path": "projects/{project}/zones", - "flatPath": "projects/{project}/zones", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project" - ], - "response": { - "$ref": "ZoneList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Retrieves the list of Zone resources available to the specified project." + "ZoneList": { + "id": "ZoneList", + "description": "Contains a list of zone resources.", + "type": "object", + "properties": { + "kind": { + "description": "Type of resource.", + "default": "compute#zoneList", + "type": "string" }, - "get": { - "id": "compute.zones.get", - "path": "projects/{project}/zones/{zone}", - "flatPath": "projects/{project}/zones/{zone}", - "httpMethod": "GET", - "parameters": { - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" + "id": { + "description": "[Output Only] Unique identifier for the resource; defined by the server.", + "type": "string" + }, + "items": { + "description": "A list of Zone resources.", + "type": "array", + "items": { + "$ref": "Zone" + } + }, + "nextPageToken": { + "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.", + "type": "string" + }, + "selfLink": { + "description": "[Output Only] Server-defined URL for this resource.", + "type": "string" + }, + "warning": { + "description": "[Output Only] Informational warning message.", + "type": "object", + "properties": { + "code": { + "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.", + "type": "string", + "enumDescriptions": [ + "Warning about failed cleanup of transient changes made by a failed operation.", + "A link to a deprecated resource was created.", + "When deploying and at least one of the resources has a type marked as deprecated", + "The user created a boot disk that is larger than image size.", + "When deploying and at least one of the resources has a type marked as experimental", + "Warning that is present in an external api call", + "Warning that value of a field has been overridden. Deprecated unused field.", + "The operation involved use of an injected kernel, which is deprecated.", + "A WEIGHTED_MAGLEV backend service is associated with a health check that is not of type HTTP/HTTPS/HTTP2.", + "When deploying a deployment with a exceedingly large number of resources", + "Resource can't be retrieved due to list overhead quota exceed which captures the amount of resources filtered out by user-defined list filter.", + "A resource depends on a missing type", + "The route's nextHopIp address is not assigned to an instance on the network.", + "The route's next hop instance cannot ip forward.", + "The route's nextHopInstance URL refers to an instance that does not have an ipv6 interface on the same network as the route.", + "The route's nextHopInstance URL refers to an instance that does not exist.", + "The route's nextHopInstance URL refers to an instance that is not on the same network as the route.", + "The route's next hop instance does not have a status of RUNNING.", + "Error which is not critical. We decided to continue the process despite the mentioned error.", + "No results are present on a particular list page.", + "Success is reported, but some results may be missing due to errors", + "The user attempted to use a resource that requires a TOS they have not accepted.", + "Warning that a resource is in use.", + "One or more of the resources set to auto-delete could not be deleted because they were in use.", + "When a resource schema validation is ignored.", + "Instance template used in instance group manager is valid as such, but its application does not make a lot of sense, because it allows only single instance in instance group.", + "When undeclared properties in the schema are present", + "A given scope cannot be reached." + ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], + "enum": [ + "CLEANUP_FAILED", + "DEPRECATED_RESOURCE_USED", + "DEPRECATED_TYPE_USED", + "DISK_SIZE_LARGER_THAN_IMAGE_SIZE", + "EXPERIMENTAL_TYPE_USED", + "EXTERNAL_API_WARNING", + "FIELD_VALUE_OVERRIDEN", + "INJECTED_KERNELS_DEPRECATED", + "INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB", + "LARGE_DEPLOYMENT_WARNING", + "LIST_OVERHEAD_QUOTA_EXCEED", + "MISSING_TYPE_DEPENDENCY", + "NEXT_HOP_ADDRESS_NOT_ASSIGNED", + "NEXT_HOP_CANNOT_IP_FORWARD", + "NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE", + "NEXT_HOP_INSTANCE_NOT_FOUND", + "NEXT_HOP_INSTANCE_NOT_ON_NETWORK", + "NEXT_HOP_NOT_RUNNING", + "NOT_CRITICAL_ERROR", + "NO_RESULTS_ON_PAGE", + "PARTIAL_SUCCESS", + "REQUIRED_TOS_AGREEMENT", + "RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING", + "RESOURCE_NOT_DELETED", + "SCHEMA_VALIDATION_IGNORED", + "SINGLE_INSTANCE_PROPERTY_TEMPLATE", + "UNDECLARED_PROPERTIES", + "UNREACHABLE" + ] }, - "zone": { - "description": "Name of the zone resource to return.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}", - "location": "path", - "required": true, + "message": { + "description": "[Output Only] A human-readable description of the warning code.", "type": "string" + }, + "data": { + "description": "[Output Only] Metadata about this warning in key: value format. For example: \"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" } ", + "type": "array", + "items": { + "type": "object", + "properties": { + "key": { + "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).", + "type": "string" + }, + "value": { + "description": "[Output Only] A warning data value corresponding to the key.", + "type": "string" + } + } + } } - }, - "parameterOrder": [ - "project", - "zone" - ], - "response": { - "$ref": "Zone" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" - ], - "description": "Returns the specified Zone resource." + } } } }, - "regionZones": { - "methods": { - "list": { - "id": "compute.regionZones.list", - "path": "projects/{project}/regions/{region}/zones", - "flatPath": "projects/{project}/regions/{region}/zones", - "httpMethod": "GET", - "parameters": { - "filter": { - "description": "A filter expression that filters resources listed in the response. Most Compute resources support two types of filter expressions: expressions that support regular expressions and expressions that follow API improvement proposal AIP-160. These two types of filter expressions cannot be mixed in one request. If you want to use AIP-160, your expression must specify the field name, an operator, and the value that you want to use for filtering. The value must be a string, a number, or a boolean. The operator must be either `=`, `!=`, `\u003e`, `\u003c`, `\u003c=`, `\u003e=` or `:`. For example, if you are filtering Compute Engine instances, you can exclude instances named `example-instance` by specifying `name != example-instance`. The `:*` comparison can be used to test whether a key has been defined. For example, to find all objects with `owner` label use: ``` labels.owner:* ``` You can also filter nested fields. For example, you could specify `scheduling.automaticRestart = false` to include instances only if they are not scheduled for automatic restarts. You can use filtering on nested fields to filter based on resource labels. To filter on multiple expressions, provide each separate expression within parentheses. For example: ``` (scheduling.automaticRestart = true) (cpuPlatform = \"Intel Skylake\") ``` By default, each expression is an `AND` expression. However, you can include `AND` and `OR` expressions explicitly. For example: ``` (cpuPlatform = \"Intel Skylake\") OR (cpuPlatform = \"Intel Broadwell\") AND (scheduling.automaticRestart = true) ``` If you want to use a regular expression, use the `eq` (equal) or `ne` (not equal) operator against a single un-parenthesized expression with or without quotes or against multiple parenthesized expressions. Examples: `fieldname eq unquoted literal` `fieldname eq 'single quoted literal'` `fieldname eq \"double quoted literal\"` `(fieldname1 eq literal) (fieldname2 ne \"literal\")` The literal value is interpreted as a regular expression using Google RE2 library syntax. The literal value must match the entire field. For example, to filter for instances that do not end with name \"instance\", you would use `name ne .*instance`. You cannot combine constraints on multiple fields using regular expressions.", - "location": "query", - "type": "string" - }, - "maxResults": { - "description": "The maximum number of results per page that should be returned. If the number of available results is larger than `maxResults`, Compute Engine returns a `nextPageToken` that can be used to get the next page of results in subsequent list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)", - "default": "500", - "minimum": "0", - "location": "query", - "type": "integer", - "format": "uint32" - }, - "orderBy": { - "description": "Sorts list results by a certain order. By default, results are returned in alphanumerical order based on the resource name. You can also sort results in descending order based on the creation timestamp using `orderBy=\"creationTimestamp desc\"`. This sorts results based on the `creationTimestamp` field in reverse chronological order (newest result first). Use this to sort resources like operations so that the newest operation is returned first. Currently, only sorting by `name` or `creationTimestamp desc` is supported.", - "location": "query", - "type": "string" - }, - "pageToken": { - "description": "Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.", - "location": "query", - "type": "string" - }, - "project": { - "description": "Project ID for this request.", - "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))", - "location": "path", - "required": true, - "type": "string" - }, - "region": { - "description": "Region for this request.", - "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?", - "location": "path", - "required": true, - "type": "string" - }, - "returnPartialSuccess": { - "description": "Opt-in for partial success behavior which provides partial results in case of failure. The default value is false. For example, when partial success behavior is enabled, aggregatedList for a single zone scope either returns all resources in the zone or no resources, with an error code.", - "location": "query", - "type": "boolean" - } - }, - "parameterOrder": [ - "project", - "region" - ], - "response": { - "$ref": "ZoneList" - }, - "scopes": [ - "https://www.googleapis.com/auth/cloud-platform", - "https://www.googleapis.com/auth/compute", - "https://www.googleapis.com/auth/compute.readonly" + "Zone": { + "id": "Zone", + "description": "Represents a Zone resource. A zone is a deployment area. These deployment areas are subsets of a region. For example the zone us-east1-b is located in the us-east1 region. For more information, read Regions and Zones.", + "type": "object", + "properties": { + "kind": { + "description": "[Output Only] Type of the resource. Always compute#zone for zones.", + "default": "compute#zone", + "type": "string" + }, + "id": { + "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.", + "type": "string", + "format": "uint64" + }, + "creationTimestamp": { + "description": "[Output Only] Creation timestamp in RFC3339 text format.", + "type": "string" + }, + "name": { + "description": "[Output Only] Name of the resource.", + "type": "string" + }, + "description": { + "description": "[Output Only] Textual description of the resource.", + "type": "string" + }, + "status": { + "description": "[Output Only] Status of the zone, either UP or DOWN.", + "type": "string", + "enumDescriptions": [ + "", + "" ], - "description": "Retrieves the list of Zone resources under the specific region available to the specified project." + "enum": [ + "DOWN", + "UP" + ] + }, + "deprecated": { + "description": "[Output Only] The deprecation status associated with this zone.", + "$ref": "DeprecationStatus" + }, + "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.", + "type": "string" + }, + "availableCpuPlatforms": { + "description": "[Output Only] Available cpu/platform selections for the zone.", + "type": "array", + "items": { + "type": "string" + } + }, + "supportsPzs": { + "description": "[Output Only] Reserved for future use.", + "type": "boolean" } } } }, - "ownerDomain": "google.com", - "name": "compute", "version": "v1", - "parameters": { - "access_token": { - "type": "string", - "description": "OAuth access token.", - "location": "query" - }, - "alt": { - "type": "string", - "description": "Data format for response.", - "default": "json", - "enum": [ - "json", - "media", - "proto" - ], - "enumDescriptions": [ - "Responses with Content-Type of application/json", - "Media download with context-dependent Content-Type", - "Responses with Content-Type of application/x-protobuf" - ], - "location": "query" - }, - "callback": { - "type": "string", - "description": "JSONP", - "location": "query" - }, - "fields": { - "type": "string", - "description": "Selector specifying which fields to include in a partial response.", - "location": "query" - }, - "key": { - "type": "string", - "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", - "location": "query" - }, - "oauth_token": { - "type": "string", - "description": "OAuth 2.0 token for the current user.", - "location": "query" - }, - "prettyPrint": { - "type": "boolean", - "description": "Returns response with indentations and line breaks.", - "default": "true", - "location": "query" - }, - "quotaUser": { - "type": "string", - "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", - "location": "query" - }, - "upload_protocol": { - "type": "string", - "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", - "location": "query" - }, - "uploadType": { - "type": "string", - "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", - "location": "query" - }, - "userIp": { - "type": "string", - "description": "Legacy name for parameter that has been superseded by `quotaUser`.", - "location": "query" - }, - "$.xgafv": { - "type": "string", - "description": "V1 error format.", - "enum": [ - "1", - "2" - ], - "enumDescriptions": [ - "v1 error format", - "v2 error format" - ], - "location": "query" + "auth": { + "oauth2": { + "scopes": { + "https://www.googleapis.com/auth/cloud-platform": { + "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." + }, + "https://www.googleapis.com/auth/compute": { + "description": "View and manage your Google Compute Engine resources" + }, + "https://www.googleapis.com/auth/compute.readonly": { + "description": "View your Google Compute Engine resources" + }, + "https://www.googleapis.com/auth/devstorage.full_control": { + "description": "Manage your data and permissions in Cloud Storage and see the email address for your Google Account" + }, + "https://www.googleapis.com/auth/devstorage.read_only": { + "description": "View your data in Google Cloud Storage" + }, + "https://www.googleapis.com/auth/devstorage.read_write": { + "description": "Manage your data in Cloud Storage and see the email address of your Google Account" + } + } } }, - "ownerName": "Google", - "discoveryVersion": "v1" + "baseUrl": "https://compute.googleapis.com/compute/v1/", + "kind": "discovery#restDescription", + "rootUrl": "https://compute.googleapis.com/", + "documentationLink": "https://cloud.google.com/compute/", + "ownerDomain": "google.com", + "batchPath": "batch/compute/v1", + "id": "compute:v1" } From 1b01b5d132687c8487f30363f704f1633aea17ab Mon Sep 17 00:00:00 2001 From: Scott Hart Date: Mon, 4 Nov 2024 15:52:58 -0500 Subject: [PATCH 2/3] Update generated code --- .../v1/accelerator_types_proto_export.h | 2 +- .../addresses/v1/addresses_proto_export.h | 4 +- .../autoscalers/v1/autoscalers_client.h | 12 +- .../autoscalers/v1/autoscalers_proto_export.h | 6 +- .../v1/backend_buckets_client.h | 20 +- .../v1/backend_buckets_proto_export.h | 16 +- .../v1/backend_services_client.h | 22 +- .../v1/backend_services_proto_export.h | 20 +- .../compute/disk_types/v1/disk_types_client.h | 12 +- .../disk_types/v1/disk_types_proto_export.h | 4 +- google/cloud/compute/disks/v1/disks_client.h | 24 +- .../compute/disks/v1/disks_proto_export.h | 20 +- .../v1/external_vpn_gateways_client.h | 12 +- .../v1/external_vpn_gateways_proto_export.h | 8 +- .../v1/firewall_policies_client.h | 28 +- .../v1/firewall_policies_proto_export.h | 10 +- .../firewall_policies_rest_connection_impl.cc | 80 +- .../compute/firewalls/v1/firewalls_client.h | 8 +- .../firewalls/v1/firewalls_proto_export.h | 4 +- .../v1/forwarding_rules_client.h | 12 +- .../v1/forwarding_rules_proto_export.h | 10 +- .../v1/future_reservations_proto_export.h | 37 - .../v1/global_addresses_proto_export.h | 4 +- .../v1/global_forwarding_rules_client.h | 8 +- .../v1/global_forwarding_rules_proto_export.h | 10 +- .../global_network_endpoint_groups_client.h | 12 +- ...bal_network_endpoint_groups_proto_export.h | 8 +- .../v1/global_operations_client.h | 16 +- .../v1/global_operations_proto_export.h | 6 +- .../global_organization_operations_client.h | 6 +- ...bal_organization_operations_proto_export.h | 4 +- .../global_public_delegated_prefixes_client.h | 8 +- ...l_public_delegated_prefixes_proto_export.h | 4 +- .../health_checks/v1/health_checks_client.h | 12 +- .../v1/health_checks_proto_export.h | 6 +- .../v1/http_health_checks_client.h | 8 +- .../v1/http_health_checks_proto_export.h | 4 +- .../v1/https_health_checks_client.h | 8 +- .../v1/https_health_checks_proto_export.h | 4 +- .../v1/image_family_views_client.h | 4 +- .../v1/image_family_views_proto_export.h | 10 +- .../cloud/compute/images/v1/images_client.h | 24 +- .../compute/images/v1/images_proto_export.h | 20 +- ...nce_group_manager_resize_requests_client.h | 8 +- ...oup_manager_resize_requests_proto_export.h | 6 +- .../v1/instance_group_managers_client.h | 24 +- .../v1/instance_group_managers_proto_export.h | 10 +- .../v1/instance_groups_client.h | 16 +- .../v1/instance_groups_proto_export.h | 10 +- .../v1/instance_settings_client.h | 4 +- .../v1/instance_settings_proto_export.h | 4 +- .../v1/instance_templates_client.h | 24 +- .../v1/instance_templates_proto_export.h | 22 +- .../compute/instances/v1/instances_client.h | 48 +- .../instances/v1/instances_proto_export.h | 22 +- .../v1/instant_snapshots_client.h | 24 +- .../v1/instant_snapshots_proto_export.h | 16 +- .../v1/interconnect_attachments_client.h | 12 +- .../interconnect_attachments_proto_export.h | 8 +- .../v1/interconnect_locations_client.h | 8 +- .../v1/interconnect_locations_proto_export.h | 2 +- .../v1/interconnect_remote_locations_client.h | 8 +- ...terconnect_remote_locations_proto_export.h | 2 +- .../interconnects/v1/interconnects_client.h | 16 +- .../v1/interconnects_proto_export.h | 6 +- .../license_codes/v1/license_codes_client.h | 8 +- .../v1/license_codes_proto_export.h | 4 +- .../compute/licenses/v1/licenses_client.h | 20 +- .../licenses/v1/licenses_proto_export.h | 12 +- .../machine_images/v1/machine_images_client.h | 20 +- .../v1/machine_images_proto_export.h | 18 +- .../machine_types/v1/machine_types_client.h | 12 +- .../v1/machine_types_proto_export.h | 4 +- .../v1/network_attachments_client.h | 24 +- .../v1/network_attachments_proto_export.h | 12 +- .../network_edge_security_services_client.h | 8 +- ...work_edge_security_services_proto_export.h | 4 +- .../v1/network_endpoint_groups_client.h | 20 +- .../v1/network_endpoint_groups_proto_export.h | 10 +- .../v1/network_firewall_policies_client.h | 28 +- .../network_firewall_policies_proto_export.h | 12 +- .../compute/networks/v1/networks_client.h | 16 +- .../networks/v1/networks_proto_export.h | 16 +- .../node_groups/v1/node_groups_client.h | 28 +- .../node_groups/v1/node_groups_proto_export.h | 20 +- .../node_templates/v1/node_templates_client.h | 24 +- .../v1/node_templates_proto_export.h | 14 +- .../compute/node_types/v1/node_types_client.h | 12 +- .../node_types/v1/node_types_proto_export.h | 4 +- .../v1/packet_mirrorings_client.h | 16 +- .../v1/packet_mirrorings_proto_export.h | 6 +- .../compute/projects/v1/projects_client.h | 16 +- .../projects/v1/projects_proto_export.h | 8 +- .../v1/public_advertised_prefixes_client.h | 8 +- .../public_advertised_prefixes_proto_export.h | 4 +- .../v1/public_delegated_prefixes_client.h | 12 +- .../public_delegated_prefixes_proto_export.h | 6 +- .../v1/region_autoscalers_client.h | 8 +- .../v1/region_autoscalers_proto_export.h | 8 +- .../v1/region_backend_services_client.h | 18 +- .../v1/region_backend_services_proto_export.h | 16 +- .../v1/region_commitments_client.h | 12 +- .../v1/region_commitments_proto_export.h | 7 +- .../v1/region_disk_types_client.h | 8 +- .../v1/region_disk_types_proto_export.h | 6 +- .../region_disks/v1/region_disks_client.h | 20 +- .../v1/region_disks_proto_export.h | 20 +- .../v1/region_health_check_services_client.h | 8 +- ...egion_health_check_services_proto_export.h | 4 +- .../v1/region_health_checks_client.h | 8 +- .../v1/region_health_checks_proto_export.h | 4 +- .../region_instance_group_managers_client.h | 20 +- ...ion_instance_group_managers_proto_export.h | 10 +- .../v1/region_instance_groups_client.h | 12 +- .../v1/region_instance_groups_proto_export.h | 8 +- .../v1/region_instance_templates_client.h | 8 +- .../region_instance_templates_proto_export.h | 12 +- .../v1/region_instances_proto_export.h | 10 +- .../v1/region_instant_snapshots_client.h | 20 +- .../region_instant_snapshots_proto_export.h | 14 +- .../region_network_endpoint_groups_client.h | 12 +- ...ion_network_endpoint_groups_proto_export.h | 8 +- .../region_network_firewall_policies_client.h | 32 +- ...n_network_firewall_policies_proto_export.h | 14 +- .../v1/region_notification_endpoints_client.h | 8 +- ...gion_notification_endpoints_proto_export.h | 6 +- .../v1/region_operations_client.h | 12 +- .../v1/region_operations_proto_export.h | 4 +- .../v1/region_security_policies_client.h | 12 +- .../region_security_policies_proto_export.h | 6 +- .../v1/region_ssl_certificates_client.h | 8 +- .../v1/region_ssl_certificates_proto_export.h | 4 +- .../v1/region_ssl_policies_client.h | 12 +- .../v1/region_ssl_policies_proto_export.h | 4 +- .../v1/region_target_http_proxies_client.h | 8 +- .../region_target_http_proxies_proto_export.h | 6 +- .../v1/region_target_https_proxies_client.h | 8 +- ...region_target_https_proxies_proto_export.h | 8 +- .../v1/region_target_tcp_proxies_client.h | 8 +- .../region_target_tcp_proxies_proto_export.h | 4 +- .../v1/region_url_maps_client.h | 12 +- .../v1/region_url_maps_proto_export.h | 10 +- .../region_zones/v1/region_zones_client.h | 4 +- .../v1/region_zones_proto_export.h | 4 +- .../cloud/compute/regions/v1/regions_client.h | 8 +- .../compute/regions/v1/regions_proto_export.h | 6 +- .../reservations/v1/reservations_client.h | 24 +- .../v1/reservations_proto_export.h | 13 +- .../v1/resource_policies_client.h | 24 +- .../v1/resource_policies_proto_export.h | 12 +- .../cloud/compute/routers/v1/routers_client.h | 28 +- .../compute/routers/v1/routers_proto_export.h | 6 +- .../cloud/compute/routes/v1/routes_client.h | 8 +- .../compute/routes/v1/routes_proto_export.h | 6 +- .../v1/security_policies_client.h | 20 +- .../v1/security_policies_proto_export.h | 10 +- .../v1/service_attachments_client.h | 24 +- .../v1/service_attachments_proto_export.h | 12 +- .../v1/snapshot_settings_client.h | 4 +- .../v1/snapshot_settings_proto_export.h | 4 +- .../compute/snapshots/v1/snapshots_client.h | 20 +- .../snapshots/v1/snapshots_proto_export.h | 18 +- .../v1/ssl_certificates_client.h | 12 +- .../v1/ssl_certificates_proto_export.h | 6 +- .../ssl_policies/v1/ssl_policies_client.h | 16 +- .../v1/ssl_policies_proto_export.h | 6 +- .../v1/storage_pool_types_client.h | 12 +- .../v1/storage_pool_types_proto_export.h | 4 +- .../storage_pools/v1/storage_pools_client.h | 28 +- .../v1/storage_pools_proto_export.h | 12 +- .../subnetworks/v1/subnetworks_client.h | 28 +- .../subnetworks/v1/subnetworks_proto_export.h | 12 +- .../v1/target_grpc_proxies_client.h | 8 +- .../v1/target_grpc_proxies_proto_export.h | 4 +- .../v1/target_http_proxies_client.h | 12 +- .../v1/target_http_proxies_proto_export.h | 8 +- .../v1/target_https_proxies_client.h | 12 +- .../v1/target_https_proxies_proto_export.h | 10 +- .../v1/target_instances_client.h | 12 +- .../v1/target_instances_proto_export.h | 6 +- .../target_pools/v1/target_pools_client.h | 16 +- .../v1/target_pools_proto_export.h | 14 +- .../v1/target_ssl_proxies_client.h | 8 +- .../v1/target_ssl_proxies_proto_export.h | 6 +- .../v1/target_tcp_proxies_client.h | 12 +- .../v1/target_tcp_proxies_proto_export.h | 6 +- .../v1/target_vpn_gateways_client.h | 12 +- .../v1/target_vpn_gateways_proto_export.h | 6 +- .../compute/url_maps/v1/url_maps_client.h | 16 +- .../url_maps/v1/url_maps_proto_export.h | 8 +- .../vpn_gateways/v1/vpn_gateways_client.h | 20 +- .../v1/vpn_gateways_proto_export.h | 8 +- .../vpn_tunnels/v1/vpn_tunnels_client.h | 12 +- .../vpn_tunnels/v1/vpn_tunnels_proto_export.h | 6 +- .../v1/zone_operations_client.h | 12 +- .../v1/zone_operations_proto_export.h | 4 +- google/cloud/compute/zones/v1/zones_client.h | 8 +- .../compute/zones/v1/zones_proto_export.h | 4 +- .../v1/secure_source_manager_client.h | 12 +- .../v1/accelerator_types.proto | 2 +- .../compute/addresses/v1/addresses.proto | 6 +- .../compute/autoscalers/v1/autoscalers.proto | 6 +- .../backend_buckets/v1/backend_buckets.proto | 16 +- .../v1/backend_services.proto | 16 +- .../compute/disk_types/v1/disk_types.proto | 4 +- .../google/cloud/compute/disks/v1/disks.proto | 18 +- .../v1/external_vpn_gateways.proto | 10 +- .../v1/firewall_policies.proto | 10 +- .../compute/firewalls/v1/firewalls.proto | 6 +- .../v1/forwarding_rules.proto | 10 +- .../v1/global_addresses.proto | 6 +- .../v1/global_forwarding_rules.proto | 10 +- .../v1/global_network_endpoint_groups.proto | 8 +- .../v1/global_operations.proto | 8 +- .../v1/global_organization_operations.proto | 6 +- .../v1/global_public_delegated_prefixes.proto | 6 +- .../health_checks/v1/health_checks.proto | 8 +- .../v1/http_health_checks.proto | 6 +- .../v1/https_health_checks.proto | 6 +- .../v1/image_family_views.proto | 4 +- .../cloud/compute/images/v1/images.proto | 16 +- ...stance_group_manager_resize_requests.proto | 6 +- .../v1/instance_group_managers.proto | 8 +- .../instance_groups/v1/instance_groups.proto | 8 +- .../v1/instance_settings.proto | 6 +- .../v1/instance_templates.proto | 14 +- .../compute/instances/v1/instances.proto | 14 +- .../v1/instant_snapshots.proto | 16 +- .../v1/interconnect_attachments.proto | 8 +- .../v1/interconnect_locations.proto | 4 +- .../v1/interconnect_remote_locations.proto | 4 +- .../interconnects/v1/interconnects.proto | 8 +- .../license_codes/v1/license_codes.proto | 6 +- .../cloud/compute/licenses/v1/licenses.proto | 12 +- .../machine_images/v1/machine_images.proto | 12 +- .../machine_types/v1/machine_types.proto | 4 +- .../v1/network_attachments.proto | 12 +- .../v1/network_edge_security_services.proto | 6 +- .../v1/network_endpoint_groups.proto | 10 +- .../v1/network_firewall_policies.proto | 12 +- .../cloud/compute/networks/v1/networks.proto | 6 +- .../compute/node_groups/v1/node_groups.proto | 12 +- .../node_templates/v1/node_templates.proto | 12 +- .../compute/node_types/v1/node_types.proto | 4 +- .../v1/packet_mirrorings.proto | 8 +- .../cloud/compute/projects/v1/projects.proto | 8 +- .../v1/public_advertised_prefixes.proto | 6 +- .../v1/public_delegated_prefixes.proto | 8 +- .../v1/region_autoscalers.proto | 8 +- .../v1/region_backend_services.proto | 12 +- .../v1/region_commitments.proto | 6 +- .../v1/region_disk_types.proto | 6 +- .../region_disks/v1/region_disks.proto | 18 +- .../v1/region_health_check_services.proto | 6 +- .../v1/region_health_checks.proto | 6 +- .../v1/region_instance_group_managers.proto | 8 +- .../v1/region_instance_groups.proto | 8 +- .../v1/region_instance_templates.proto | 6 +- .../v1/region_instances.proto | 4 +- .../v1/region_instant_snapshots.proto | 14 +- .../v1/region_network_endpoint_groups.proto | 8 +- .../v1/region_network_firewall_policies.proto | 12 +- .../v1/region_notification_endpoints.proto | 6 +- .../v1/region_operations.proto | 6 +- .../v1/region_security_policies.proto | 6 +- .../v1/region_ssl_certificates.proto | 6 +- .../v1/region_ssl_policies.proto | 6 +- .../v1/region_target_http_proxies.proto | 8 +- .../v1/region_target_https_proxies.proto | 10 +- .../v1/region_target_tcp_proxies.proto | 6 +- .../region_url_maps/v1/region_url_maps.proto | 8 +- .../region_zones/v1/region_zones.proto | 4 +- .../cloud/compute/regions/v1/regions.proto | 4 +- .../reservations/v1/reservations.proto | 12 +- .../v1/resource_policies.proto | 12 +- .../cloud/compute/routers/v1/routers.proto | 6 +- .../cloud/compute/routes/v1/routes.proto | 8 +- .../v1/security_policies.proto | 10 +- .../v1/service_attachments.proto | 12 +- .../v1/snapshot_settings.proto | 6 +- .../compute/snapshots/v1/snapshots.proto | 16 +- .../v1/ssl_certificates.proto | 8 +- .../ssl_policies/v1/ssl_policies.proto | 8 +- .../v1/storage_pool_types.proto | 4 +- .../storage_pools/v1/storage_pools.proto | 12 +- .../compute/subnetworks/v1/subnetworks.proto | 12 +- .../v1/target_grpc_proxies.proto | 6 +- .../v1/target_http_proxies.proto | 10 +- .../v1/target_https_proxies.proto | 12 +- .../v1/target_instances.proto | 8 +- .../target_pools/v1/target_pools.proto | 12 +- .../v1/target_ssl_proxies.proto | 8 +- .../v1/target_tcp_proxies.proto | 8 +- .../v1/target_vpn_gateways.proto | 8 +- .../cloud/compute/url_maps/v1/url_maps.proto | 6 +- .../compute/v1/internal/common_000.proto | 60 +- .../compute/v1/internal/common_001.proto | 2 +- .../compute/v1/internal/common_002.proto | 4 +- .../compute/v1/internal/common_003.proto | 14 +- .../compute/v1/internal/common_004.proto | 2 +- .../compute/v1/internal/common_005.proto | 2 +- .../compute/v1/internal/common_006.proto | 57 +- .../compute/v1/internal/common_007.proto | 230 ++- .../compute/v1/internal/common_008.proto | 706 ++++--- .../compute/v1/internal/common_009.proto | 706 +++---- .../compute/v1/internal/common_010.proto | 410 ++-- .../compute/v1/internal/common_011.proto | 328 +-- .../compute/v1/internal/common_012.proto | 357 +++- .../compute/v1/internal/common_013.proto | 1567 ++++++++++++--- .../compute/v1/internal/common_014.proto | 1762 ++++------------- .../compute/v1/internal/common_015.proto | 603 +----- .../compute/v1/internal/common_016.proto | 505 ++++- .../compute/v1/internal/common_017.proto | 440 ++-- .../compute/v1/internal/common_018.proto | 337 +++- .../compute/v1/internal/common_019.proto | 1390 +++++++++---- .../compute/v1/internal/common_020.proto | 1266 +----------- .../compute/v1/internal/common_021.proto | 1022 +++++++++- .../compute/v1/internal/common_022.proto | 990 +-------- .../compute/v1/internal/common_023.proto | 263 ++- .../compute/v1/internal/common_024.proto | 252 ++- .../compute/v1/internal/common_025.proto | 320 +-- .../compute/v1/internal/common_026.proto | 329 +-- .../compute/v1/internal/common_027.proto | 333 +++- .../compute/v1/internal/common_028.proto | 1197 ++++++++--- .../compute/v1/internal/common_029.proto | 891 +-------- .../compute/v1/internal/common_030.proto | 510 ++++- .../compute/v1/internal/common_031.proto | 525 +---- .../compute/v1/internal/common_032.proto | 247 ++- .../compute/v1/internal/common_033.proto | 228 +-- .../compute/v1/internal/common_034.proto | 191 +- .../compute/v1/internal/common_035.proto | 279 +-- .../compute/v1/internal/common_036.proto | 126 +- .../compute/v1/internal/common_037.proto | 217 +- .../compute/v1/internal/common_038.proto | 367 ++-- .../compute/v1/internal/common_039.proto | 187 +- .../compute/v1/internal/common_040.proto | 468 ++++- .../compute/v1/internal/common_041.proto | 445 +---- .../compute/v1/internal/common_042.proto | 551 +++++- .../compute/v1/internal/common_043.proto | 598 +----- .../compute/v1/internal/common_044.proto | 572 +----- .../compute/v1/internal/common_045.proto | 25 +- .../compute/v1/internal/common_046.proto | 25 +- .../compute/v1/internal/common_047.proto | 22 +- .../compute/v1/internal/common_048.proto | 203 +- .../compute/v1/internal/common_049.proto | 207 +- .../compute/v1/internal/common_050.proto | 248 +-- .../compute/v1/internal/common_051.proto | 168 +- .../compute/v1/internal/common_052.proto | 217 +- .../compute/v1/internal/common_053.proto | 342 ++-- .../compute/v1/internal/common_054.proto | 174 +- .../compute/v1/internal/common_055.proto | 312 +-- .../compute/v1/internal/common_056.proto | 661 ++++++- .../compute/v1/internal/common_057.proto | 203 +- .../compute/v1/internal/common_058.proto | 312 +-- .../compute/v1/internal/common_059.proto | 652 +++++- .../compute/v1/internal/common_060.proto | 463 ++--- .../compute/v1/internal/common_061.proto | 561 +----- .../compute/v1/internal/common_062.proto | 297 +-- .../compute/v1/internal/common_063.proto | 204 +- .../compute/v1/internal/common_064.proto | 244 ++- .../compute/v1/internal/common_065.proto | 33 +- .../compute/v1/internal/common_066.proto | 545 ++++- .../compute/v1/internal/common_067.proto | 472 ++++- .../compute/v1/internal/common_068.proto | 612 +----- .../compute/v1/internal/common_069.proto | 642 +----- .../compute/v1/internal/common_070.proto | 299 ++- .../compute/v1/internal/common_071.proto | 161 +- .../compute/v1/internal/common_072.proto | 299 +-- .../compute/v1/internal/common_073.proto | 166 +- .../compute/v1/internal/common_074.proto | 442 ++++- .../compute/v1/internal/common_075.proto | 405 +++- .../compute/v1/internal/common_076.proto | 432 +--- .../compute/v1/internal/common_077.proto | 431 +--- .../compute/v1/internal/common_078.proto | 40 +- .../compute/v1/internal/common_079.proto | 453 ++++- .../compute/v1/internal/common_080.proto | 260 ++- .../compute/v1/internal/common_081.proto | 261 +-- .../compute/v1/internal/common_082.proto | 256 ++- .../compute/v1/internal/common_083.proto | 196 +- .../compute/v1/internal/common_084.proto | 350 +--- .../compute/v1/internal/common_085.proto | 186 +- .../compute/v1/internal/common_086.proto | 98 +- .../compute/v1/internal/common_087.proto | 285 ++- .../compute/v1/internal/common_088.proto | 176 +- .../compute/v1/internal/common_089.proto | 427 +--- .../compute/v1/internal/common_090.proto | 302 +-- .../compute/v1/internal/common_091.proto | 218 +- .../compute/v1/internal/common_092.proto | 430 ++-- .../compute/v1/internal/common_093.proto | 95 +- .../compute/v1/internal/common_094.proto | 280 +-- .../compute/v1/internal/common_095.proto | 143 +- .../compute/v1/internal/common_096.proto | 128 +- .../compute/v1/internal/common_097.proto | 146 +- .../compute/v1/internal/common_098.proto | 362 +++- .../compute/v1/internal/common_099.proto | 246 +-- .../compute/v1/internal/common_100.proto | 368 +--- .../compute/v1/internal/common_101.proto | 22 +- .../compute/v1/internal/common_102.proto | 42 +- .../compute/v1/internal/common_103.proto | 16 +- .../compute/v1/internal/common_104.proto | 20 +- .../compute/v1/internal/common_105.proto | 318 ++- .../compute/v1/internal/common_106.proto | 571 +++++- .../compute/v1/internal/common_107.proto | 359 ++-- .../compute/v1/internal/common_108.proto | 482 +---- .../compute/v1/internal/common_109.proto | 819 ++++++-- .../compute/v1/internal/common_110.proto | 110 +- .../compute/v1/internal/common_111.proto | 978 ++++----- .../compute/v1/internal/common_112.proto | 24 +- .../compute/v1/internal/common_113.proto | 475 +---- .../compute/v1/internal/common_114.proto | 218 +- .../compute/v1/internal/common_115.proto | 121 +- .../compute/v1/internal/common_116.proto | 228 +-- .../compute/v1/internal/common_117.proto | 137 +- .../compute/v1/internal/common_118.proto | 227 ++- .../compute/v1/internal/common_119.proto | 236 +-- .../compute/v1/internal/common_120.proto | 107 +- .../compute/v1/internal/common_121.proto | 207 +- .../compute/v1/internal/common_122.proto | 522 ++++- .../compute/v1/internal/common_123.proto | 375 +++- .../compute/v1/internal/common_124.proto | 627 +++--- .../compute/v1/internal/common_125.proto | 313 +-- .../compute/v1/internal/common_126.proto | 667 +------ .../compute/v1/internal/common_127.proto | 91 +- .../compute/v1/internal/common_128.proto | 125 +- .../compute/v1/internal/common_129.proto | 177 +- .../compute/v1/internal/common_130.proto | 223 ++- .../compute/v1/internal/common_131.proto | 494 +++-- .../compute/v1/internal/common_132.proto | 368 +--- .../compute/v1/internal/common_133.proto | 394 +--- .../compute/v1/internal/common_134.proto | 217 +- .../compute/v1/internal/common_135.proto | 93 +- .../compute/v1/internal/common_136.proto | 227 ++- .../compute/v1/internal/common_137.proto | 168 +- .../compute/v1/internal/common_138.proto | 410 +--- .../compute/v1/internal/common_139.proto | 14 +- .../compute/v1/internal/common_140.proto | 508 ++++- .../compute/v1/internal/common_141.proto | 462 ++++- .../compute/v1/internal/common_142.proto | 396 +--- .../compute/v1/internal/common_143.proto | 468 +---- .../compute/v1/internal/common_144.proto | 159 +- .../compute/v1/internal/common_145.proto | 34 - .../compute/v1/internal/common_146.proto | 39 - .../vpn_gateways/v1/vpn_gateways.proto | 10 +- .../compute/vpn_tunnels/v1/vpn_tunnels.proto | 8 +- .../zone_operations/v1/zone_operations.proto | 6 +- .../google/cloud/compute/zones/v1/zones.proto | 4 +- 446 files changed, 26988 insertions(+), 27590 deletions(-) delete mode 100644 google/cloud/compute/future_reservations/v1/future_reservations_proto_export.h delete mode 100644 protos/google/cloud/compute/v1/internal/common_145.proto delete mode 100644 protos/google/cloud/compute/v1/internal/common_146.proto diff --git a/google/cloud/compute/accelerator_types/v1/accelerator_types_proto_export.h b/google/cloud/compute/accelerator_types/v1/accelerator_types_proto_export.h index 9562230c268bc..4fea0f6b858ed 100644 --- a/google/cloud/compute/accelerator_types/v1/accelerator_types_proto_export.h +++ b/google/cloud/compute/accelerator_types/v1/accelerator_types_proto_export.h @@ -27,7 +27,7 @@ // IWYU pragma: begin_exports #include -#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ACCELERATOR_TYPES_V1_ACCELERATOR_TYPES_PROTO_EXPORT_H diff --git a/google/cloud/compute/addresses/v1/addresses_proto_export.h b/google/cloud/compute/addresses/v1/addresses_proto_export.h index cd2455e745c0a..735389613bfb0 100644 --- a/google/cloud/compute/addresses/v1/addresses_proto_export.h +++ b/google/cloud/compute/addresses/v1/addresses_proto_export.h @@ -28,8 +28,8 @@ // IWYU pragma: begin_exports #include #include -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ADDRESSES_V1_ADDRESSES_PROTO_EXPORT_H diff --git a/google/cloud/compute/autoscalers/v1/autoscalers_client.h b/google/cloud/compute/autoscalers/v1/autoscalers_client.h index 44a046cbe2005..0fb26953c8901 100644 --- a/google/cloud/compute/autoscalers/v1/autoscalers_client.h +++ b/google/cloud/compute/autoscalers/v1/autoscalers_client.h @@ -118,7 +118,7 @@ class AutoscalersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.autoscalers.v1.AggregatedListAutoscalersRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L125} - /// [google.cloud.cpp.compute.v1.AutoscalersScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L243} + /// [google.cloud.cpp.compute.v1.AutoscalersScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L243} /// // clang-format on StreamRange GetAutoscaler( @@ -342,7 +342,7 @@ class AutoscalersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.autoscalers.v1.GetAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L240} - /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L34} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L34} /// // clang-format on StatusOr GetAutoscaler( @@ -503,7 +503,7 @@ class AutoscalersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.autoscalers.v1.ListAutoscalersRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L287} - /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L34} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L34} /// // clang-format on StreamRange ListAutoscalers( @@ -543,7 +543,7 @@ class AutoscalersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.autoscalers.v1.ListAutoscalersRequest]: @cloud_cpp_reference_link{google/cloud/compute/autoscalers/v1/autoscalers.proto#L287} - /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L34} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L34} /// // clang-format on StreamRange ListAutoscalers( diff --git a/google/cloud/compute/autoscalers/v1/autoscalers_proto_export.h b/google/cloud/compute/autoscalers/v1/autoscalers_proto_export.h index 8f2066f17d5e0..ed4cd7969e981 100644 --- a/google/cloud/compute/autoscalers/v1/autoscalers_proto_export.h +++ b/google/cloud/compute/autoscalers/v1/autoscalers_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_AUTOSCALERS_V1_AUTOSCALERS_PROTO_EXPORT_H // IWYU pragma: begin_exports +#include #include -#include -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_AUTOSCALERS_V1_AUTOSCALERS_PROTO_EXPORT_H diff --git a/google/cloud/compute/backend_buckets/v1/backend_buckets_client.h b/google/cloud/compute/backend_buckets/v1/backend_buckets_client.h index fcb3ab0f7e645..d8e02582eb175 100644 --- a/google/cloud/compute/backend_buckets/v1/backend_buckets_client.h +++ b/google/cloud/compute/backend_buckets/v1/backend_buckets_client.h @@ -477,7 +477,7 @@ class BackendBucketsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_buckets.v1.GetBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L285} - /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_011.proto#L27} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L27} /// // clang-format on StatusOr GetBackendBucket( @@ -509,7 +509,7 @@ class BackendBucketsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_buckets.v1.GetBackendBucketRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L285} - /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_011.proto#L27} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L27} /// // clang-format on StatusOr GetBackendBucket( @@ -539,7 +539,7 @@ class BackendBucketsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_buckets.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L296} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -572,7 +572,7 @@ class BackendBucketsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_buckets.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L296} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -735,7 +735,7 @@ class BackendBucketsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_buckets.v1.ListBackendBucketsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L337} - /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_011.proto#L27} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L27} /// // clang-format on StreamRange @@ -776,7 +776,7 @@ class BackendBucketsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_buckets.v1.ListBackendBucketsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L337} - /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_011.proto#L27} + /// [google.cloud.cpp.compute.v1.BackendBucket]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_010.proto#L27} /// // clang-format on StreamRange @@ -1062,7 +1062,7 @@ class BackendBucketsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_buckets.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L467} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1097,7 +1097,7 @@ class BackendBucketsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_buckets.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L467} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1127,7 +1127,7 @@ class BackendBucketsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_buckets.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L483} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1162,7 +1162,7 @@ class BackendBucketsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_buckets.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_buckets/v1/backend_buckets.proto#L483} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/backend_buckets/v1/backend_buckets_proto_export.h b/google/cloud/compute/backend_buckets/v1/backend_buckets_proto_export.h index 53b7c36a272e1..cfddb75d20d93 100644 --- a/google/cloud/compute/backend_buckets/v1/backend_buckets_proto_export.h +++ b/google/cloud/compute/backend_buckets/v1/backend_buckets_proto_export.h @@ -26,14 +26,14 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_BACKEND_BUCKETS_V1_BACKEND_BUCKETS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_BACKEND_BUCKETS_V1_BACKEND_BUCKETS_PROTO_EXPORT_H diff --git a/google/cloud/compute/backend_services/v1/backend_services_client.h b/google/cloud/compute/backend_services/v1/backend_services_client.h index 8d76893f51a0c..c82407b852f78 100644 --- a/google/cloud/compute/backend_services/v1/backend_services_client.h +++ b/google/cloud/compute/backend_services/v1/backend_services_client.h @@ -246,7 +246,7 @@ class BackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_services.v1.AggregatedListBackendServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L281} - /// [google.cloud.cpp.compute.v1.BackendServicesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L135} + /// [google.cloud.cpp.compute.v1.BackendServicesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_011.proto#L135} /// // clang-format on StreamRange @@ -664,7 +664,7 @@ class BackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_services.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L431} - /// [google.cloud.cpp.compute.v1.BackendServiceGroupHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L772} + /// [google.cloud.cpp.compute.v1.BackendServiceGroupHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L814} /// // clang-format on StatusOr @@ -695,7 +695,7 @@ class BackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_services.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L445} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -728,7 +728,7 @@ class BackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_services.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L445} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -1301,7 +1301,7 @@ class BackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_services.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L684} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1336,7 +1336,7 @@ class BackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_services.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L684} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1494,7 +1494,7 @@ class BackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_services.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L732} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1529,7 +1529,7 @@ class BackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.backend_services.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/backend_services/v1/backend_services.proto#L732} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/backend_services/v1/backend_services_proto_export.h b/google/cloud/compute/backend_services/v1/backend_services_proto_export.h index a8ab9970a7b24..27ebf8ab3ca2d 100644 --- a/google/cloud/compute/backend_services/v1/backend_services_proto_export.h +++ b/google/cloud/compute/backend_services/v1/backend_services_proto_export.h @@ -27,16 +27,16 @@ // IWYU pragma: begin_exports #include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_BACKEND_SERVICES_V1_BACKEND_SERVICES_PROTO_EXPORT_H diff --git a/google/cloud/compute/disk_types/v1/disk_types_client.h b/google/cloud/compute/disk_types/v1/disk_types_client.h index c6114af3bc8a0..62a65116b2403 100644 --- a/google/cloud/compute/disk_types/v1/disk_types_client.h +++ b/google/cloud/compute/disk_types/v1/disk_types_client.h @@ -115,7 +115,7 @@ class DiskTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disk_types.v1.AggregatedListDiskTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disk_types/v1/disk_types.proto#L72} - /// [google.cloud.cpp.compute.v1.DiskTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L240} + /// [google.cloud.cpp.compute.v1.DiskTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L240} /// // clang-format on StreamRange GetDiskType( @@ -220,7 +220,7 @@ class DiskTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disk_types.v1.GetDiskTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/disk_types/v1/disk_types.proto#L154} - /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L34} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L34} /// // clang-format on StatusOr GetDiskType( @@ -258,7 +258,7 @@ class DiskTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disk_types.v1.ListDiskTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disk_types/v1/disk_types.proto#L168} - /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L34} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L34} /// // clang-format on StreamRange ListDiskTypes( @@ -298,7 +298,7 @@ class DiskTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disk_types.v1.ListDiskTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/disk_types/v1/disk_types.proto#L168} - /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L34} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L34} /// // clang-format on StreamRange ListDiskTypes( diff --git a/google/cloud/compute/disk_types/v1/disk_types_proto_export.h b/google/cloud/compute/disk_types/v1/disk_types_proto_export.h index 81c5c497d187d..1bc8a63f02fa9 100644 --- a/google/cloud/compute/disk_types/v1/disk_types_proto_export.h +++ b/google/cloud/compute/disk_types/v1/disk_types_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_DISK_TYPES_V1_DISK_TYPES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include +#include +#include #include -#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_DISK_TYPES_V1_DISK_TYPES_PROTO_EXPORT_H diff --git a/google/cloud/compute/disks/v1/disks_client.h b/google/cloud/compute/disks/v1/disks_client.h index 6f3950f8e042f..0d9561b26d16e 100644 --- a/google/cloud/compute/disks/v1/disks_client.h +++ b/google/cloud/compute/disks/v1/disks_client.h @@ -248,7 +248,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.AggregatedListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L320} - /// [google.cloud.cpp.compute.v1.DisksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L151} + /// [google.cloud.cpp.compute.v1.DisksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L151} /// // clang-format on StreamRange< @@ -291,7 +291,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.AggregatedListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L320} - /// [google.cloud.cpp.compute.v1.DisksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L151} + /// [google.cloud.cpp.compute.v1.DisksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_023.proto#L151} /// // clang-format on StreamRange< @@ -697,7 +697,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.GetDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L507} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L49} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} /// // clang-format on StatusOr GetDisk( @@ -729,7 +729,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.GetDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L507} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L49} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} /// // clang-format on StatusOr GetDisk( @@ -759,7 +759,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L520} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -792,7 +792,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L520} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -957,7 +957,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.ListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L574} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L49} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} /// // clang-format on StreamRange ListDisks( @@ -997,7 +997,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.ListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L574} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L49} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} /// // clang-format on StreamRange ListDisks( @@ -1282,7 +1282,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L718} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1318,7 +1318,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L718} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1856,7 +1856,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L877} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1892,7 +1892,7 @@ class DisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.disks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/disks/v1/disks.proto#L877} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/disks/v1/disks_proto_export.h b/google/cloud/compute/disks/v1/disks_proto_export.h index 6fa3ed3e84e91..79a12e76f7e11 100644 --- a/google/cloud/compute/disks/v1/disks_proto_export.h +++ b/google/cloud/compute/disks/v1/disks_proto_export.h @@ -26,16 +26,16 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_DISKS_V1_DISKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_DISKS_V1_DISKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways_client.h b/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways_client.h index 47e7249e0a95b..8d3ec6f45a679 100644 --- a/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways_client.h +++ b/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways_client.h @@ -234,7 +234,7 @@ class ExternalVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.external_vpn_gateways.v1.GetExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L145} - /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L31} + /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_032.proto#L31} /// // clang-format on StatusOr @@ -268,7 +268,7 @@ class ExternalVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.external_vpn_gateways.v1.GetExternalVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L145} - /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L31} + /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_032.proto#L31} /// // clang-format on StatusOr @@ -433,7 +433,7 @@ class ExternalVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.external_vpn_gateways.v1.ListExternalVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L184} - /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L31} + /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_032.proto#L31} /// // clang-format on StreamRange @@ -474,7 +474,7 @@ class ExternalVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.external_vpn_gateways.v1.ListExternalVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L184} - /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_033.proto#L31} + /// [google.cloud.cpp.compute.v1.ExternalVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_032.proto#L31} /// // clang-format on StreamRange @@ -629,7 +629,7 @@ class ExternalVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.external_vpn_gateways.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L271} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -664,7 +664,7 @@ class ExternalVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.external_vpn_gateways.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto#L271} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways_proto_export.h b/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways_proto_export.h index 9acdb94cdf75c..0a471c71d7b47 100644 --- a/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways_proto_export.h +++ b/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_EXTERNAL_VPN_GATEWAYS_V1_EXTERNAL_VPN_GATEWAYS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_EXTERNAL_VPN_GATEWAYS_V1_EXTERNAL_VPN_GATEWAYS_PROTO_EXPORT_H diff --git a/google/cloud/compute/firewall_policies/v1/firewall_policies_client.h b/google/cloud/compute/firewall_policies/v1/firewall_policies_client.h index 2c805ee571474..2111f2b9cb634 100644 --- a/google/cloud/compute/firewall_policies/v1/firewall_policies_client.h +++ b/google/cloud/compute/firewall_policies/v1/firewall_policies_client.h @@ -583,7 +583,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L357} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -614,7 +614,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L357} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -642,7 +642,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L347} - /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L111} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L111} /// // clang-format on StatusOr @@ -673,7 +673,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L347} - /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L111} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L111} /// // clang-format on StatusOr @@ -702,7 +702,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L364} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -734,7 +734,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L364} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -762,7 +762,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L375} - /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L26} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L26} /// // clang-format on StatusOr GetRule( @@ -793,7 +793,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L375} - /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L26} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L26} /// // clang-format on StatusOr GetRule( @@ -907,7 +907,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.ListFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L416} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} /// // clang-format on StreamRange @@ -940,7 +940,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.ListAssociationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L409} - /// [google.cloud.cpp.compute.v1.FirewallPoliciesListAssociationsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPoliciesListAssociationsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_036.proto#L27} /// // clang-format on StatusOr< @@ -1561,7 +1561,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L602} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1596,7 +1596,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L602} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1625,7 +1625,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L614} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1660,7 +1660,7 @@ class FirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewall_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewall_policies/v1/firewall_policies.proto#L614} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/firewall_policies/v1/firewall_policies_proto_export.h b/google/cloud/compute/firewall_policies/v1/firewall_policies_proto_export.h index aba2a447dcba3..7471fb55627e1 100644 --- a/google/cloud/compute/firewall_policies/v1/firewall_policies_proto_export.h +++ b/google/cloud/compute/firewall_policies/v1/firewall_policies_proto_export.h @@ -26,13 +26,13 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_FIREWALL_POLICIES_V1_FIREWALL_POLICIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include +#include #include #include -#include -#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_FIREWALL_POLICIES_V1_FIREWALL_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/firewall_policies/v1/internal/firewall_policies_rest_connection_impl.cc b/google/cloud/compute/firewall_policies/v1/internal/firewall_policies_rest_connection_impl.cc index 5e59ef3a82c70..b96dadb795e3e 100644 --- a/google/cloud/compute/firewall_policies/v1/internal/firewall_policies_rest_connection_impl.cc +++ b/google/cloud/compute/firewall_policies/v1/internal/firewall_policies_rest_connection_impl.cc @@ -94,10 +94,14 @@ FirewallPoliciesRestConnectionImpl::AddAssociation( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { r.set_operation(op); }, + v1::GetOperationRequest& r) { + r.set_operation(op); + }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { r.set_operation(op); }); + v1::DeleteOperationRequest& r) { + r.set_operation(op); + }); } StatusOr @@ -219,10 +223,14 @@ FirewallPoliciesRestConnectionImpl::AddRule( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { r.set_operation(op); }, + v1::GetOperationRequest& r) { + r.set_operation(op); + }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { r.set_operation(op); }); + v1::DeleteOperationRequest& r) { + r.set_operation(op); + }); } StatusOr @@ -345,10 +353,14 @@ FirewallPoliciesRestConnectionImpl::CloneRules( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { r.set_operation(op); }, + v1::GetOperationRequest& r) { + r.set_operation(op); + }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { r.set_operation(op); }); + v1::DeleteOperationRequest& r) { + r.set_operation(op); + }); } StatusOr @@ -471,10 +483,14 @@ FirewallPoliciesRestConnectionImpl::DeleteFirewallPolicy( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { r.set_operation(op); }, + v1::GetOperationRequest& r) { + r.set_operation(op); + }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { r.set_operation(op); }); + v1::DeleteOperationRequest& r) { + r.set_operation(op); + }); } StatusOr @@ -660,10 +676,14 @@ FirewallPoliciesRestConnectionImpl::InsertFirewallPolicy( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { r.set_operation(op); }, + v1::GetOperationRequest& r) { + r.set_operation(op); + }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { r.set_operation(op); }); + v1::DeleteOperationRequest& r) { + r.set_operation(op); + }); } StatusOr @@ -842,10 +862,14 @@ FirewallPoliciesRestConnectionImpl::Move( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { r.set_operation(op); }, + v1::GetOperationRequest& r) { + r.set_operation(op); + }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { r.set_operation(op); }); + v1::DeleteOperationRequest& r) { + r.set_operation(op); + }); } StatusOr @@ -967,10 +991,14 @@ FirewallPoliciesRestConnectionImpl::PatchFirewallPolicy( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { r.set_operation(op); }, + v1::GetOperationRequest& r) { + r.set_operation(op); + }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { r.set_operation(op); }); + v1::DeleteOperationRequest& r) { + r.set_operation(op); + }); } StatusOr @@ -1092,10 +1120,14 @@ FirewallPoliciesRestConnectionImpl::PatchRule( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { r.set_operation(op); }, + v1::GetOperationRequest& r) { + r.set_operation(op); + }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { r.set_operation(op); }); + v1::DeleteOperationRequest& r) { + r.set_operation(op); + }); } StatusOr @@ -1218,10 +1250,14 @@ FirewallPoliciesRestConnectionImpl::RemoveAssociation( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { r.set_operation(op); }, + v1::GetOperationRequest& r) { + r.set_operation(op); + }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { r.set_operation(op); }); + v1::DeleteOperationRequest& r) { + r.set_operation(op); + }); } StatusOr @@ -1343,10 +1379,14 @@ FirewallPoliciesRestConnectionImpl::RemoveRule( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { r.set_operation(op); }, + v1::GetOperationRequest& r) { + r.set_operation(op); + }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { r.set_operation(op); }); + v1::DeleteOperationRequest& r) { + r.set_operation(op); + }); } StatusOr diff --git a/google/cloud/compute/firewalls/v1/firewalls_client.h b/google/cloud/compute/firewalls/v1/firewalls_client.h index 32d762744e74d..96a3f8dabd418 100644 --- a/google/cloud/compute/firewalls/v1/firewalls_client.h +++ b/google/cloud/compute/firewalls/v1/firewalls_client.h @@ -224,7 +224,7 @@ class FirewallsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewalls.v1.GetFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L141} - /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_035.proto#L27} + /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L27} /// // clang-format on StatusOr GetFirewall( @@ -256,7 +256,7 @@ class FirewallsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewalls.v1.GetFirewallRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L141} - /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_035.proto#L27} + /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L27} /// // clang-format on StatusOr GetFirewall( @@ -415,7 +415,7 @@ class FirewallsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewalls.v1.ListFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L178} - /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_035.proto#L27} + /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L27} /// // clang-format on StreamRange ListFirewalls( @@ -455,7 +455,7 @@ class FirewallsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.firewalls.v1.ListFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/firewalls/v1/firewalls.proto#L178} - /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_035.proto#L27} + /// [google.cloud.cpp.compute.v1.Firewall]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_034.proto#L27} /// // clang-format on StreamRange ListFirewalls( diff --git a/google/cloud/compute/firewalls/v1/firewalls_proto_export.h b/google/cloud/compute/firewalls/v1/firewalls_proto_export.h index ab2e43601a91e..b261ba6349ff2 100644 --- a/google/cloud/compute/firewalls/v1/firewalls_proto_export.h +++ b/google/cloud/compute/firewalls/v1/firewalls_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_FIREWALLS_V1_FIREWALLS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include +#include +#include #include -#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_FIREWALLS_V1_FIREWALLS_PROTO_EXPORT_H diff --git a/google/cloud/compute/forwarding_rules/v1/forwarding_rules_client.h b/google/cloud/compute/forwarding_rules/v1/forwarding_rules_client.h index 92df954493321..5d1566d899fe1 100644 --- a/google/cloud/compute/forwarding_rules/v1/forwarding_rules_client.h +++ b/google/cloud/compute/forwarding_rules/v1/forwarding_rules_client.h @@ -119,7 +119,7 @@ class ForwardingRulesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.forwarding_rules.v1.AggregatedListForwardingRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L147} - /// [google.cloud.cpp.compute.v1.ForwardingRulesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_042.proto#L135} + /// [google.cloud.cpp.compute.v1.ForwardingRulesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L135} /// // clang-format on StreamRange GetForwardingRule( @@ -346,7 +346,7 @@ class ForwardingRulesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.forwarding_rules.v1.GetForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L262} - /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L36} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_040.proto#L36} /// // clang-format on StatusOr GetForwardingRule( @@ -511,7 +511,7 @@ class ForwardingRulesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.forwarding_rules.v1.ListForwardingRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L310} - /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L36} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_040.proto#L36} /// // clang-format on StreamRange @@ -553,7 +553,7 @@ class ForwardingRulesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.forwarding_rules.v1.ListForwardingRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto#L310} - /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L36} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_040.proto#L36} /// // clang-format on StreamRange diff --git a/google/cloud/compute/forwarding_rules/v1/forwarding_rules_proto_export.h b/google/cloud/compute/forwarding_rules/v1/forwarding_rules_proto_export.h index e74eaedc08812..953c066a74094 100644 --- a/google/cloud/compute/forwarding_rules/v1/forwarding_rules_proto_export.h +++ b/google/cloud/compute/forwarding_rules/v1/forwarding_rules_proto_export.h @@ -26,12 +26,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_FORWARDING_RULES_V1_FORWARDING_RULES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include +#include +#include #include -#include -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_FORWARDING_RULES_V1_FORWARDING_RULES_PROTO_EXPORT_H diff --git a/google/cloud/compute/future_reservations/v1/future_reservations_proto_export.h b/google/cloud/compute/future_reservations/v1/future_reservations_proto_export.h deleted file mode 100644 index 36e654d5870da..0000000000000 --- a/google/cloud/compute/future_reservations/v1/future_reservations_proto_export.h +++ /dev/null @@ -1,37 +0,0 @@ -// Copyright 2024 Google LLC -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// https://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. - -// Generated by the Codegen C++ plugin. -// If you make any local changes, they will be lost. - -// The contents of internal/common_xxx.proto files are subject to change, and it -// is not recommended to include their respective headers directly. Including -// the .pb.h file transitively provides all the necessary proto -// definitions. However, it is not IWYU friendly. Including this header file -// uses IWYU pragmas to export the internal/common_xxx.pb.h files as an -// IWYU-friendly alternative. - -#ifndef GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_FUTURE_RESERVATIONS_V1_FUTURE_RESERVATIONS_PROTO_EXPORT_H -#define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_FUTURE_RESERVATIONS_V1_FUTURE_RESERVATIONS_PROTO_EXPORT_H - -// IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include -// IWYU pragma: end_exports - -#endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_FUTURE_RESERVATIONS_V1_FUTURE_RESERVATIONS_PROTO_EXPORT_H diff --git a/google/cloud/compute/global_addresses/v1/global_addresses_proto_export.h b/google/cloud/compute/global_addresses/v1/global_addresses_proto_export.h index e454e23663bbb..7de5a8728dc51 100644 --- a/google/cloud/compute/global_addresses/v1/global_addresses_proto_export.h +++ b/google/cloud/compute/global_addresses/v1/global_addresses_proto_export.h @@ -27,9 +27,9 @@ // IWYU pragma: begin_exports #include -#include +#include +#include #include -#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_ADDRESSES_V1_GLOBAL_ADDRESSES_PROTO_EXPORT_H diff --git a/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules_client.h b/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules_client.h index 97948c564e92a..49468832c5b89 100644 --- a/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules_client.h +++ b/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules_client.h @@ -233,7 +233,7 @@ class GlobalForwardingRulesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_forwarding_rules.v1.GetForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L160} - /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L36} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_040.proto#L36} /// // clang-format on StatusOr GetForwardingRule( @@ -266,7 +266,7 @@ class GlobalForwardingRulesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_forwarding_rules.v1.GetForwardingRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L160} - /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L36} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_040.proto#L36} /// // clang-format on StatusOr GetForwardingRule( @@ -429,7 +429,7 @@ class GlobalForwardingRulesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_forwarding_rules.v1.ListGlobalForwardingRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L197} - /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L36} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_040.proto#L36} /// // clang-format on StreamRange @@ -470,7 +470,7 @@ class GlobalForwardingRulesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_forwarding_rules.v1.ListGlobalForwardingRulesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto#L197} - /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_041.proto#L36} + /// [google.cloud.cpp.compute.v1.ForwardingRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_040.proto#L36} /// // clang-format on StreamRange diff --git a/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules_proto_export.h b/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules_proto_export.h index 5ade964c760c1..6db403d8a1e15 100644 --- a/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules_proto_export.h +++ b/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules_proto_export.h @@ -26,11 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_FORWARDING_RULES_V1_GLOBAL_FORWARDING_RULES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_FORWARDING_RULES_V1_GLOBAL_FORWARDING_RULES_PROTO_EXPORT_H diff --git a/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups_client.h b/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups_client.h index 49781c7dacea0..4954fbb685f78 100644 --- a/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups_client.h +++ b/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups_client.h @@ -501,7 +501,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.GetNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L226} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L118} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L129} /// // clang-format on StatusOr @@ -534,7 +534,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.GetNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L226} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L118} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L129} /// // clang-format on StatusOr @@ -702,7 +702,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.ListGlobalNetworkEndpointGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L265} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L118} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L129} /// // clang-format on StreamRange @@ -744,7 +744,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.ListGlobalNetworkEndpointGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L265} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L118} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L129} /// // clang-format on StreamRange @@ -784,7 +784,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.ListNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L333} - /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L529} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L540} /// // clang-format on StreamRange @@ -826,7 +826,7 @@ class GlobalNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_network_endpoint_groups.v1.ListNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto#L333} - /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L529} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L540} /// // clang-format on StreamRange diff --git a/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups_proto_export.h b/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups_proto_export.h index 729fc70e5c467..1822b75c8d656 100644 --- a/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups_proto_export.h +++ b/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_NETWORK_ENDPOINT_GROUPS_V1_GLOBAL_NETWORK_ENDPOINT_GROUPS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_NETWORK_ENDPOINT_GROUPS_V1_GLOBAL_NETWORK_ENDPOINT_GROUPS_PROTO_EXPORT_H diff --git a/google/cloud/compute/global_operations/v1/global_operations_client.h b/google/cloud/compute/global_operations/v1/global_operations_client.h index 0e483df575622..959948173886c 100644 --- a/google/cloud/compute/global_operations/v1/global_operations_client.h +++ b/google/cloud/compute/global_operations/v1/global_operations_client.h @@ -118,7 +118,7 @@ class GlobalOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_operations.v1.AggregatedListGlobalOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L105} - /// [google.cloud.cpp.compute.v1.OperationsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L136} + /// [google.cloud.cpp.compute.v1.OperationsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_085.proto#L136} /// // clang-format on StreamRange GetOperation( @@ -278,7 +278,7 @@ class GlobalOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L199} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StatusOr GetOperation( @@ -316,7 +316,7 @@ class GlobalOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_operations.v1.ListGlobalOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L214} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StreamRange ListGlobalOperations( @@ -357,7 +357,7 @@ class GlobalOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_operations.v1.ListGlobalOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L214} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StreamRange ListGlobalOperations( @@ -397,7 +397,7 @@ class GlobalOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L282} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StatusOr Wait( @@ -439,7 +439,7 @@ class GlobalOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_operations/v1/global_operations.proto#L282} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StatusOr Wait( diff --git a/google/cloud/compute/global_operations/v1/global_operations_proto_export.h b/google/cloud/compute/global_operations/v1/global_operations_proto_export.h index 3fad366307ed8..fcf019acd3baf 100644 --- a/google/cloud/compute/global_operations/v1/global_operations_proto_export.h +++ b/google/cloud/compute/global_operations/v1/global_operations_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_OPERATIONS_V1_GLOBAL_OPERATIONS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_OPERATIONS_V1_GLOBAL_OPERATIONS_PROTO_EXPORT_H diff --git a/google/cloud/compute/global_organization_operations/v1/global_organization_operations_client.h b/google/cloud/compute/global_organization_operations/v1/global_organization_operations_client.h index 3fcdcbdd6e178..6f8fe3d380b6b 100644 --- a/google/cloud/compute/global_organization_operations/v1/global_organization_operations_client.h +++ b/google/cloud/compute/global_organization_operations/v1/global_organization_operations_client.h @@ -167,7 +167,7 @@ class GlobalOrganizationOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_organization_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_organization_operations/v1/global_organization_operations.proto#L84} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StatusOr GetOperation( @@ -199,7 +199,7 @@ class GlobalOrganizationOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_organization_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_organization_operations/v1/global_organization_operations.proto#L84} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StatusOr GetOperation( @@ -242,7 +242,7 @@ class GlobalOrganizationOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_organization_operations.v1.ListGlobalOrganizationOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_organization_operations/v1/global_organization_operations.proto#L95} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StreamRange diff --git a/google/cloud/compute/global_organization_operations/v1/global_organization_operations_proto_export.h b/google/cloud/compute/global_organization_operations/v1/global_organization_operations_proto_export.h index a15c4225a6585..930bf7e57039b 100644 --- a/google/cloud/compute/global_organization_operations/v1/global_organization_operations_proto_export.h +++ b/google/cloud/compute/global_organization_operations/v1/global_organization_operations_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_ORGANIZATION_OPERATIONS_V1_GLOBAL_ORGANIZATION_OPERATIONS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_ORGANIZATION_OPERATIONS_V1_GLOBAL_ORGANIZATION_OPERATIONS_PROTO_EXPORT_H diff --git a/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes_client.h b/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes_client.h index d74f47803ec8b..406d1371077c8 100644 --- a/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes_client.h +++ b/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes_client.h @@ -237,7 +237,7 @@ class GlobalPublicDelegatedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.GetPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L131} - /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_092.proto#L29} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L29} /// // clang-format on StatusOr @@ -270,7 +270,7 @@ class GlobalPublicDelegatedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.GetPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L131} - /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_092.proto#L29} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L29} /// // clang-format on StatusOr @@ -437,7 +437,7 @@ class GlobalPublicDelegatedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.ListGlobalPublicDelegatedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L170} - /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_092.proto#L29} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L29} /// // clang-format on StreamRange @@ -478,7 +478,7 @@ class GlobalPublicDelegatedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.global_public_delegated_prefixes.v1.ListGlobalPublicDelegatedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto#L170} - /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_092.proto#L29} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L29} /// // clang-format on StreamRange diff --git a/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes_proto_export.h b/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes_proto_export.h index f844864efe348..5c98317e4bee5 100644 --- a/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes_proto_export.h +++ b/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_PUBLIC_DELEGATED_PREFIXES_V1_GLOBAL_PUBLIC_DELEGATED_PREFIXES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_GLOBAL_PUBLIC_DELEGATED_PREFIXES_V1_GLOBAL_PUBLIC_DELEGATED_PREFIXES_PROTO_EXPORT_H diff --git a/google/cloud/compute/health_checks/v1/health_checks_client.h b/google/cloud/compute/health_checks/v1/health_checks_client.h index 1402a736f0e0d..a35cfa180299b 100644 --- a/google/cloud/compute/health_checks/v1/health_checks_client.h +++ b/google/cloud/compute/health_checks/v1/health_checks_client.h @@ -119,7 +119,7 @@ class HealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.health_checks.v1.AggregatedListHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L129} - /// [google.cloud.cpp.compute.v1.HealthChecksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_051.proto#L134} + /// [google.cloud.cpp.compute.v1.HealthChecksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_049.proto#L134} /// // clang-format on StreamRange GetHealthCheck( @@ -342,7 +342,7 @@ class HealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.health_checks.v1.GetHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L237} - /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_044.proto#L271} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_042.proto#L271} /// // clang-format on StatusOr GetHealthCheck( @@ -503,7 +503,7 @@ class HealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.health_checks.v1.ListHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L274} - /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_044.proto#L271} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_042.proto#L271} /// // clang-format on StreamRange ListHealthChecks( @@ -544,7 +544,7 @@ class HealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.health_checks.v1.ListHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/health_checks/v1/health_checks.proto#L274} - /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_044.proto#L271} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_042.proto#L271} /// // clang-format on StreamRange ListHealthChecks( diff --git a/google/cloud/compute/health_checks/v1/health_checks_proto_export.h b/google/cloud/compute/health_checks/v1/health_checks_proto_export.h index d41e2b28dad73..dec31316694dd 100644 --- a/google/cloud/compute/health_checks/v1/health_checks_proto_export.h +++ b/google/cloud/compute/health_checks/v1/health_checks_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HEALTH_CHECKS_V1_HEALTH_CHECKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HEALTH_CHECKS_V1_HEALTH_CHECKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/http_health_checks/v1/http_health_checks_client.h b/google/cloud/compute/http_health_checks/v1/http_health_checks_client.h index 66f40d1257ebc..726d0bc667a9d 100644 --- a/google/cloud/compute/http_health_checks/v1/http_health_checks_client.h +++ b/google/cloud/compute/http_health_checks/v1/http_health_checks_client.h @@ -229,7 +229,7 @@ class HttpHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.http_health_checks.v1.GetHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L142} - /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L29} + /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_051.proto#L29} /// // clang-format on StatusOr GetHttpHealthCheck( @@ -261,7 +261,7 @@ class HttpHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.http_health_checks.v1.GetHttpHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L142} - /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L29} + /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_051.proto#L29} /// // clang-format on StatusOr GetHttpHealthCheck( @@ -424,7 +424,7 @@ class HttpHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.http_health_checks.v1.ListHttpHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L179} - /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L29} + /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_051.proto#L29} /// // clang-format on StreamRange @@ -465,7 +465,7 @@ class HttpHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.http_health_checks.v1.ListHttpHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/http_health_checks/v1/http_health_checks.proto#L179} - /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L29} + /// [google.cloud.cpp.compute.v1.HttpHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_051.proto#L29} /// // clang-format on StreamRange diff --git a/google/cloud/compute/http_health_checks/v1/http_health_checks_proto_export.h b/google/cloud/compute/http_health_checks/v1/http_health_checks_proto_export.h index 84f58801cd3fa..29fa81aaf4936 100644 --- a/google/cloud/compute/http_health_checks/v1/http_health_checks_proto_export.h +++ b/google/cloud/compute/http_health_checks/v1/http_health_checks_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HTTP_HEALTH_CHECKS_V1_HTTP_HEALTH_CHECKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HTTP_HEALTH_CHECKS_V1_HTTP_HEALTH_CHECKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/https_health_checks/v1/https_health_checks_client.h b/google/cloud/compute/https_health_checks/v1/https_health_checks_client.h index 67e92cc2e24f4..9c8e120677ccb 100644 --- a/google/cloud/compute/https_health_checks/v1/https_health_checks_client.h +++ b/google/cloud/compute/https_health_checks/v1/https_health_checks_client.h @@ -229,7 +229,7 @@ class HttpsHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.https_health_checks.v1.GetHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L143} - /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_054.proto#L30} + /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_052.proto#L30} /// // clang-format on StatusOr @@ -261,7 +261,7 @@ class HttpsHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.https_health_checks.v1.GetHttpsHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L143} - /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_054.proto#L30} + /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_052.proto#L30} /// // clang-format on StatusOr @@ -425,7 +425,7 @@ class HttpsHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.https_health_checks.v1.ListHttpsHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L180} - /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_054.proto#L30} + /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_052.proto#L30} /// // clang-format on StreamRange @@ -466,7 +466,7 @@ class HttpsHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.https_health_checks.v1.ListHttpsHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/https_health_checks/v1/https_health_checks.proto#L180} - /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_054.proto#L30} + /// [google.cloud.cpp.compute.v1.HttpsHealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_052.proto#L30} /// // clang-format on StreamRange diff --git a/google/cloud/compute/https_health_checks/v1/https_health_checks_proto_export.h b/google/cloud/compute/https_health_checks/v1/https_health_checks_proto_export.h index c08dd22a5b322..c9e55dafdd6ae 100644 --- a/google/cloud/compute/https_health_checks/v1/https_health_checks_proto_export.h +++ b/google/cloud/compute/https_health_checks/v1/https_health_checks_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HTTPS_HEALTH_CHECKS_V1_HTTPS_HEALTH_CHECKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_HTTPS_HEALTH_CHECKS_V1_HTTPS_HEALTH_CHECKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/image_family_views/v1/image_family_views_client.h b/google/cloud/compute/image_family_views/v1/image_family_views_client.h index 4560129d0e3d6..37a49c63e0d37 100644 --- a/google/cloud/compute/image_family_views/v1/image_family_views_client.h +++ b/google/cloud/compute/image_family_views/v1/image_family_views_client.h @@ -110,7 +110,7 @@ class ImageFamilyViewsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.image_family_views.v1.GetImageFamilyViewRequest]: @cloud_cpp_reference_link{google/cloud/compute/image_family_views/v1/image_family_views.proto#L51} - /// [google.cloud.cpp.compute.v1.ImageFamilyView]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_056.proto#L26} + /// [google.cloud.cpp.compute.v1.ImageFamilyView]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_054.proto#L26} /// // clang-format on StatusOr GetImageFamilyView( @@ -143,7 +143,7 @@ class ImageFamilyViewsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.image_family_views.v1.GetImageFamilyViewRequest]: @cloud_cpp_reference_link{google/cloud/compute/image_family_views/v1/image_family_views.proto#L51} - /// [google.cloud.cpp.compute.v1.ImageFamilyView]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_056.proto#L26} + /// [google.cloud.cpp.compute.v1.ImageFamilyView]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_054.proto#L26} /// // clang-format on StatusOr GetImageFamilyView( diff --git a/google/cloud/compute/image_family_views/v1/image_family_views_proto_export.h b/google/cloud/compute/image_family_views/v1/image_family_views_proto_export.h index 81e1f6f438ca1..037fdac78da6d 100644 --- a/google/cloud/compute/image_family_views/v1/image_family_views_proto_export.h +++ b/google/cloud/compute/image_family_views/v1/image_family_views_proto_export.h @@ -26,11 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_IMAGE_FAMILY_VIEWS_V1_IMAGE_FAMILY_VIEWS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_IMAGE_FAMILY_VIEWS_V1_IMAGE_FAMILY_VIEWS_PROTO_EXPORT_H diff --git a/google/cloud/compute/images/v1/images_client.h b/google/cloud/compute/images/v1/images_client.h index fec312c84838e..42f0876a9696b 100644 --- a/google/cloud/compute/images/v1/images_client.h +++ b/google/cloud/compute/images/v1/images_client.h @@ -347,7 +347,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.GetImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L271} - /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_055.proto#L30} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L30} /// // clang-format on StatusOr GetImage( @@ -378,7 +378,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.GetImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L271} - /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_055.proto#L30} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L30} /// // clang-format on StatusOr GetImage( @@ -409,7 +409,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.GetFromFamilyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L244} - /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_055.proto#L30} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L30} /// // clang-format on StatusOr GetFromFamily( @@ -442,7 +442,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.GetFromFamilyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L244} - /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_055.proto#L30} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L30} /// // clang-format on StatusOr GetFromFamily( @@ -472,7 +472,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L256} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -505,7 +505,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L256} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -669,7 +669,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.ListImagesRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L311} - /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_055.proto#L30} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L30} /// // clang-format on StreamRange ListImages( @@ -714,7 +714,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.ListImagesRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L311} - /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_055.proto#L30} + /// [google.cloud.cpp.compute.v1.Image]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_053.proto#L30} /// // clang-format on StreamRange ListImages( @@ -865,7 +865,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L409} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -900,7 +900,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L409} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1053,7 +1053,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L444} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1088,7 +1088,7 @@ class ImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.images.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/images/v1/images.proto#L444} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/images/v1/images_proto_export.h b/google/cloud/compute/images/v1/images_proto_export.h index a70a07e48f384..e87442885a850 100644 --- a/google/cloud/compute/images/v1/images_proto_export.h +++ b/google/cloud/compute/images/v1/images_proto_export.h @@ -26,17 +26,17 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_IMAGES_V1_IMAGES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include +#include +#include #include -#include -#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_IMAGES_V1_IMAGES_PROTO_EXPORT_H diff --git a/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests_client.h b/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests_client.h index baca3f1e54a98..2da98435ae7c9 100644 --- a/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests_client.h +++ b/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests_client.h @@ -384,7 +384,7 @@ class InstanceGroupManagerResizeRequestsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.GetInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L197} - /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L31} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_060.proto#L31} /// // clang-format on StatusOr @@ -418,7 +418,7 @@ class InstanceGroupManagerResizeRequestsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.GetInstanceGroupManagerResizeRequestRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L197} - /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L31} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_060.proto#L31} /// // clang-format on StatusOr @@ -595,7 +595,7 @@ class InstanceGroupManagerResizeRequestsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.ListInstanceGroupManagerResizeRequestsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L262} - /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L31} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_060.proto#L31} /// // clang-format on StreamRange< @@ -639,7 +639,7 @@ class InstanceGroupManagerResizeRequestsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_manager_resize_requests.v1.ListInstanceGroupManagerResizeRequestsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto#L262} - /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L31} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagerResizeRequest]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_060.proto#L31} /// // clang-format on StreamRange< diff --git a/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests_proto_export.h b/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests_proto_export.h index 3bb34b1dad42f..d6121b169ad0f 100644 --- a/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests_proto_export.h +++ b/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_V1_INSTANCE_GROUP_MANAGER_RESIZE_REQUESTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/instance_group_managers/v1/instance_group_managers_client.h b/google/cloud/compute/instance_group_managers/v1/instance_group_managers_client.h index 4e4248fab3740..5571615b79661 100644 --- a/google/cloud/compute/instance_group_managers/v1/instance_group_managers_client.h +++ b/google/cloud/compute/instance_group_managers/v1/instance_group_managers_client.h @@ -273,7 +273,7 @@ class InstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_managers.v1.AggregatedListInstanceGroupManagersRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L426} - /// [google.cloud.cpp.compute.v1.InstanceGroupManagersScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_061.proto#L457} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagersScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L457} /// // clang-format on StreamRange @@ -1066,7 +1066,7 @@ class InstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_managers.v1.GetInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L684} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L67} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} /// // clang-format on StatusOr @@ -1247,7 +1247,7 @@ class InstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_managers.v1.ListInstanceGroupManagersRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L813} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L67} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} /// // clang-format on StreamRange @@ -1289,7 +1289,7 @@ class InstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_managers.v1.ListInstanceGroupManagersRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L813} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L67} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} /// // clang-format on StreamRange @@ -1333,7 +1333,7 @@ class InstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_managers.v1.ListErrorsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L733} - /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L495} + /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L520} /// // clang-format on StreamRange @@ -1375,7 +1375,7 @@ class InstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_managers.v1.ListErrorsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L733} - /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L495} + /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L520} /// // clang-format on StreamRange @@ -1412,7 +1412,7 @@ class InstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_managers.v1.ListManagedInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L884} - /// [google.cloud.cpp.compute.v1.InstanceGroupManagersListManagedInstancesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_061.proto#L334} + /// [google.cloud.cpp.compute.v1.InstanceGroupManagersListManagedInstancesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L334} /// // clang-format on StatusOr @@ -1538,7 +1538,7 @@ class InstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_group_managers.v1.ListPerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto#L961} - /// [google.cloud.cpp.compute.v1.PerInstanceConfig]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L750} + /// [google.cloud.cpp.compute.v1.PerInstanceConfig]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L786} /// // clang-format on StreamRange diff --git a/google/cloud/compute/instance_group_managers/v1/instance_group_managers_proto_export.h b/google/cloud/compute/instance_group_managers/v1/instance_group_managers_proto_export.h index 3eb1c24b302b1..0eb193838056b 100644 --- a/google/cloud/compute/instance_group_managers/v1/instance_group_managers_proto_export.h +++ b/google/cloud/compute/instance_group_managers/v1/instance_group_managers_proto_export.h @@ -26,11 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCE_GROUP_MANAGERS_V1_INSTANCE_GROUP_MANAGERS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCE_GROUP_MANAGERS_V1_INSTANCE_GROUP_MANAGERS_PROTO_EXPORT_H diff --git a/google/cloud/compute/instance_groups/v1/instance_groups_client.h b/google/cloud/compute/instance_groups/v1/instance_groups_client.h index fac94845de35b..13272c795da87 100644 --- a/google/cloud/compute/instance_groups/v1/instance_groups_client.h +++ b/google/cloud/compute/instance_groups/v1/instance_groups_client.h @@ -249,7 +249,7 @@ class InstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_groups.v1.AggregatedListInstanceGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L203} - /// [google.cloud.cpp.compute.v1.InstanceGroupsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_060.proto#L373} + /// [google.cloud.cpp.compute.v1.InstanceGroupsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L373} /// // clang-format on StreamRange GetInstanceGroup( @@ -486,7 +486,7 @@ class InstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_groups.v1.GetInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L318} - /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L34} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_057.proto#L34} /// // clang-format on StatusOr GetInstanceGroup( @@ -652,7 +652,7 @@ class InstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_groups.v1.ListInstanceGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L365} - /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L34} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_057.proto#L34} /// // clang-format on StreamRange @@ -695,7 +695,7 @@ class InstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_groups.v1.ListInstanceGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L365} - /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L34} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_057.proto#L34} /// // clang-format on StreamRange @@ -738,7 +738,7 @@ class InstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_groups.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L436} - /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L95} + /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_057.proto#L95} /// // clang-format on StreamRange @@ -785,7 +785,7 @@ class InstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_groups.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_groups/v1/instance_groups.proto#L436} - /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L95} + /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_057.proto#L95} /// // clang-format on StreamRange diff --git a/google/cloud/compute/instance_groups/v1/instance_groups_proto_export.h b/google/cloud/compute/instance_groups/v1/instance_groups_proto_export.h index aa4860e9bef85..bfd40f5493d12 100644 --- a/google/cloud/compute/instance_groups/v1/instance_groups_proto_export.h +++ b/google/cloud/compute/instance_groups/v1/instance_groups_proto_export.h @@ -26,11 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCE_GROUPS_V1_INSTANCE_GROUPS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCE_GROUPS_V1_INSTANCE_GROUPS_PROTO_EXPORT_H diff --git a/google/cloud/compute/instance_settings/v1/instance_settings_client.h b/google/cloud/compute/instance_settings/v1/instance_settings_client.h index 3052b9041a3a8..f1082c52e49a9 100644 --- a/google/cloud/compute/instance_settings/v1/instance_settings_client.h +++ b/google/cloud/compute/instance_settings/v1/instance_settings_client.h @@ -109,7 +109,7 @@ class InstanceSettingsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_settings.v1.GetInstanceSettingsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_settings/v1/instance_settings.proto#L65} - /// [google.cloud.cpp.compute.v1.InstanceSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L27} + /// [google.cloud.cpp.compute.v1.InstanceSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L27} /// // clang-format on StatusOr @@ -141,7 +141,7 @@ class InstanceSettingsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_settings.v1.GetInstanceSettingsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_settings/v1/instance_settings.proto#L65} - /// [google.cloud.cpp.compute.v1.InstanceSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L27} + /// [google.cloud.cpp.compute.v1.InstanceSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_062.proto#L27} /// // clang-format on StatusOr diff --git a/google/cloud/compute/instance_settings/v1/instance_settings_proto_export.h b/google/cloud/compute/instance_settings/v1/instance_settings_proto_export.h index ceecaaf09e6ce..edd5c0ec5fe83 100644 --- a/google/cloud/compute/instance_settings/v1/instance_settings_proto_export.h +++ b/google/cloud/compute/instance_settings/v1/instance_settings_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCE_SETTINGS_V1_INSTANCE_SETTINGS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCE_SETTINGS_V1_INSTANCE_SETTINGS_PROTO_EXPORT_H diff --git a/google/cloud/compute/instance_templates/v1/instance_templates_client.h b/google/cloud/compute/instance_templates/v1/instance_templates_client.h index 783495a25fde3..6ccf5e32cb64a 100644 --- a/google/cloud/compute/instance_templates/v1/instance_templates_client.h +++ b/google/cloud/compute/instance_templates/v1/instance_templates_client.h @@ -120,7 +120,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.AggregatedListInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L143} - /// [google.cloud.cpp.compute.v1.InstanceTemplatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_065.proto#L132} + /// [google.cloud.cpp.compute.v1.InstanceTemplatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_063.proto#L132} /// // clang-format on StreamRange< @@ -165,7 +165,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.AggregatedListInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L143} - /// [google.cloud.cpp.compute.v1.InstanceTemplatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_065.proto#L132} + /// [google.cloud.cpp.compute.v1.InstanceTemplatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_063.proto#L132} /// // clang-format on StreamRange< @@ -321,7 +321,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.GetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L266} - /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L85} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L85} /// // clang-format on StatusOr @@ -353,7 +353,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.GetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L266} - /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L85} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L85} /// // clang-format on StatusOr @@ -383,7 +383,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L251} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -416,7 +416,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L251} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -584,7 +584,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.ListInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L303} - /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L85} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L85} /// // clang-format on StreamRange @@ -625,7 +625,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.ListInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L303} - /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L85} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L85} /// // clang-format on StreamRange @@ -656,7 +656,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L371} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -691,7 +691,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L371} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -721,7 +721,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L387} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -756,7 +756,7 @@ class InstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instance_templates.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instance_templates/v1/instance_templates.proto#L387} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/instance_templates/v1/instance_templates_proto_export.h b/google/cloud/compute/instance_templates/v1/instance_templates_proto_export.h index e271dd887c205..26b1120d8ae7a 100644 --- a/google/cloud/compute/instance_templates/v1/instance_templates_proto_export.h +++ b/google/cloud/compute/instance_templates/v1/instance_templates_proto_export.h @@ -28,17 +28,17 @@ // IWYU pragma: begin_exports #include #include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCE_TEMPLATES_V1_INSTANCE_TEMPLATES_PROTO_EXPORT_H diff --git a/google/cloud/compute/instances/v1/instances_client.h b/google/cloud/compute/instances/v1/instances_client.h index 382c05ab11475..e52b030a82d39 100644 --- a/google/cloud/compute/instances/v1/instances_client.h +++ b/google/cloud/compute/instances/v1/instances_client.h @@ -379,7 +379,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.AggregatedListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L761} - /// [google.cloud.cpp.compute.v1.InstancesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L718} + /// [google.cloud.cpp.compute.v1.InstancesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L720} /// // clang-format on StreamRange GetInstance( @@ -1114,7 +1114,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1086} - /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L93} + /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L93} /// // clang-format on StatusOr GetInstance( @@ -1145,7 +1145,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetEffectiveFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1030} - /// [google.cloud.cpp.compute.v1.InstancesGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L675} + /// [google.cloud.cpp.compute.v1.InstancesGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L675} /// // clang-format on StatusOr< @@ -1180,7 +1180,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetEffectiveFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1030} - /// [google.cloud.cpp.compute.v1.InstancesGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L675} + /// [google.cloud.cpp.compute.v1.InstancesGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L675} /// // clang-format on StatusOr< @@ -1211,7 +1211,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetGuestAttributesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1048} - /// [google.cloud.cpp.compute.v1.GuestAttributes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L51} + /// [google.cloud.cpp.compute.v1.GuestAttributes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L51} /// // clang-format on StatusOr GetGuestAttributes( @@ -1243,7 +1243,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetGuestAttributesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1048} - /// [google.cloud.cpp.compute.v1.GuestAttributes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L51} + /// [google.cloud.cpp.compute.v1.GuestAttributes]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L51} /// // clang-format on StatusOr GetGuestAttributes( @@ -1274,7 +1274,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1068} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -1307,7 +1307,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1068} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -1337,7 +1337,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetScreenshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1100} - /// [google.cloud.cpp.compute.v1.Screenshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L911} + /// [google.cloud.cpp.compute.v1.Screenshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L913} /// // clang-format on StatusOr GetScreenshot( @@ -1369,7 +1369,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetScreenshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1100} - /// [google.cloud.cpp.compute.v1.Screenshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L911} + /// [google.cloud.cpp.compute.v1.Screenshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L913} /// // clang-format on StatusOr GetScreenshot( @@ -1399,7 +1399,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetSerialPortOutputRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1114} - /// [google.cloud.cpp.compute.v1.SerialPortOutput]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L921} + /// [google.cloud.cpp.compute.v1.SerialPortOutput]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L923} /// // clang-format on StatusOr @@ -1431,7 +1431,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetSerialPortOutputRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1114} - /// [google.cloud.cpp.compute.v1.SerialPortOutput]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L921} + /// [google.cloud.cpp.compute.v1.SerialPortOutput]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L923} /// // clang-format on StatusOr @@ -1461,7 +1461,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetShieldedInstanceIdentityRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1145} - /// [google.cloud.cpp.compute.v1.ShieldedInstanceIdentity]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L947} + /// [google.cloud.cpp.compute.v1.ShieldedInstanceIdentity]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L949} /// // clang-format on StatusOr @@ -1494,7 +1494,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.GetShieldedInstanceIdentityRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1145} - /// [google.cloud.cpp.compute.v1.ShieldedInstanceIdentity]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L947} + /// [google.cloud.cpp.compute.v1.ShieldedInstanceIdentity]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L949} /// // clang-format on StatusOr @@ -1656,7 +1656,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1211} - /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L93} + /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L93} /// // clang-format on StreamRange ListInstances( @@ -1696,7 +1696,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1211} - /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L93} + /// [google.cloud.cpp.compute.v1.Instance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L93} /// // clang-format on StreamRange ListInstances( @@ -1738,7 +1738,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.ListReferrersRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1282} - /// [google.cloud.cpp.compute.v1.Reference]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L874} + /// [google.cloud.cpp.compute.v1.Reference]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L876} /// // clang-format on StreamRange ListReferrers( @@ -1782,7 +1782,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.ListReferrersRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1282} - /// [google.cloud.cpp.compute.v1.Reference]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_022.proto#L874} + /// [google.cloud.cpp.compute.v1.Reference]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_021.proto#L876} /// // clang-format on StreamRange ListReferrers( @@ -2602,7 +2602,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1587} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -2638,7 +2638,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L1587} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -4716,7 +4716,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2206} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -4752,7 +4752,7 @@ class InstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instances.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instances/v1/instances.proto#L2206} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/instances/v1/instances_proto_export.h b/google/cloud/compute/instances/v1/instances_proto_export.h index fddd67d644506..89d382300df22 100644 --- a/google/cloud/compute/instances/v1/instances_proto_export.h +++ b/google/cloud/compute/instances/v1/instances_proto_export.h @@ -28,20 +28,20 @@ // IWYU pragma: begin_exports #include #include -#include +#include +#include #include -#include +#include #include -#include -#include -#include +#include +#include +#include #include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANCES_V1_INSTANCES_PROTO_EXPORT_H diff --git a/google/cloud/compute/instant_snapshots/v1/instant_snapshots_client.h b/google/cloud/compute/instant_snapshots/v1/instant_snapshots_client.h index 2a7e5e3adb048..00b475328c08b 100644 --- a/google/cloud/compute/instant_snapshots/v1/instant_snapshots_client.h +++ b/google/cloud/compute/instant_snapshots/v1/instant_snapshots_client.h @@ -120,7 +120,7 @@ class InstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instant_snapshots.v1.AggregatedListInstantSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L159} - /// [google.cloud.cpp.compute.v1.InstantSnapshotsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_067.proto#L136} + /// [google.cloud.cpp.compute.v1.InstantSnapshotsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_065.proto#L136} /// // clang-format on StreamRange GetInstantSnapshot( @@ -357,7 +357,7 @@ class InstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instant_snapshots.v1.GetInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L292} - /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L26} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L26} /// // clang-format on StatusOr GetInstantSnapshot( @@ -388,7 +388,7 @@ class InstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instant_snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L274} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -421,7 +421,7 @@ class InstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instant_snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L274} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -584,7 +584,7 @@ class InstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instant_snapshots.v1.ListInstantSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L339} - /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L26} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L26} /// // clang-format on StreamRange @@ -626,7 +626,7 @@ class InstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instant_snapshots.v1.ListInstantSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L339} - /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L26} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L26} /// // clang-format on StreamRange @@ -658,7 +658,7 @@ class InstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instant_snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L410} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -694,7 +694,7 @@ class InstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instant_snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L410} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -853,7 +853,7 @@ class InstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instant_snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L465} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -889,7 +889,7 @@ class InstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.instant_snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto#L465} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/instant_snapshots/v1/instant_snapshots_proto_export.h b/google/cloud/compute/instant_snapshots/v1/instant_snapshots_proto_export.h index ea71ff24f0586..44c34e61b74d9 100644 --- a/google/cloud/compute/instant_snapshots/v1/instant_snapshots_proto_export.h +++ b/google/cloud/compute/instant_snapshots/v1/instant_snapshots_proto_export.h @@ -26,14 +26,14 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOTS_V1_INSTANT_SNAPSHOTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INSTANT_SNAPSHOTS_V1_INSTANT_SNAPSHOTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments_client.h b/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments_client.h index f99c1b30f4e66..269e748256058 100644 --- a/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments_client.h +++ b/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments_client.h @@ -123,7 +123,7 @@ class InterconnectAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_attachments.v1.AggregatedListInterconnectAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L134} - /// [google.cloud.cpp.compute.v1.InterconnectAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L582} + /// [google.cloud.cpp.compute.v1.InterconnectAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_067.proto#L582} /// // clang-format on StreamRange @@ -359,7 +359,7 @@ class InterconnectAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_attachments.v1.GetInterconnectAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L251} - /// [google.cloud.cpp.compute.v1.InterconnectAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L30} + /// [google.cloud.cpp.compute.v1.InterconnectAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_067.proto#L30} /// // clang-format on StatusOr @@ -529,7 +529,7 @@ class InterconnectAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_attachments.v1.ListInterconnectAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L304} - /// [google.cloud.cpp.compute.v1.InterconnectAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L30} + /// [google.cloud.cpp.compute.v1.InterconnectAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_067.proto#L30} /// // clang-format on StreamRange @@ -571,7 +571,7 @@ class InterconnectAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_attachments.v1.ListInterconnectAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto#L304} - /// [google.cloud.cpp.compute.v1.InterconnectAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L30} + /// [google.cloud.cpp.compute.v1.InterconnectAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_067.proto#L30} /// // clang-format on StreamRange diff --git a/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments_proto_export.h b/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments_proto_export.h index d4d89d0f31175..a7d399681676c 100644 --- a/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments_proto_export.h +++ b/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECT_ATTACHMENTS_V1_INTERCONNECT_ATTACHMENTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECT_ATTACHMENTS_V1_INTERCONNECT_ATTACHMENTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/interconnect_locations/v1/interconnect_locations_client.h b/google/cloud/compute/interconnect_locations/v1/interconnect_locations_client.h index 2b9aea94e8cad..7e4de2ebc6170 100644 --- a/google/cloud/compute/interconnect_locations/v1/interconnect_locations_client.h +++ b/google/cloud/compute/interconnect_locations/v1/interconnect_locations_client.h @@ -112,7 +112,7 @@ class InterconnectLocationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_locations.v1.GetInterconnectLocationRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_locations/v1/interconnect_locations.proto#L62} - /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L28} + /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L28} /// // clang-format on StatusOr @@ -146,7 +146,7 @@ class InterconnectLocationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_locations.v1.GetInterconnectLocationRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_locations/v1/interconnect_locations.proto#L62} - /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L28} + /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L28} /// // clang-format on StatusOr @@ -184,7 +184,7 @@ class InterconnectLocationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_locations.v1.ListInterconnectLocationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_locations/v1/interconnect_locations.proto#L75} - /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L28} + /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L28} /// // clang-format on StreamRange @@ -225,7 +225,7 @@ class InterconnectLocationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_locations.v1.ListInterconnectLocationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_locations/v1/interconnect_locations.proto#L75} - /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L28} + /// [google.cloud.cpp.compute.v1.InterconnectLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_069.proto#L28} /// // clang-format on StreamRange diff --git a/google/cloud/compute/interconnect_locations/v1/interconnect_locations_proto_export.h b/google/cloud/compute/interconnect_locations/v1/interconnect_locations_proto_export.h index 933470e584d1e..0fc43c14b11ef 100644 --- a/google/cloud/compute/interconnect_locations/v1/interconnect_locations_proto_export.h +++ b/google/cloud/compute/interconnect_locations/v1/interconnect_locations_proto_export.h @@ -26,7 +26,7 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECT_LOCATIONS_V1_INTERCONNECT_LOCATIONS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECT_LOCATIONS_V1_INTERCONNECT_LOCATIONS_PROTO_EXPORT_H diff --git a/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations_client.h b/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations_client.h index 49a9f7aad3d1a..13216d361cf81 100644 --- a/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations_client.h +++ b/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations_client.h @@ -114,7 +114,7 @@ class InterconnectRemoteLocationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_remote_locations.v1.GetInterconnectRemoteLocationRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations.proto#L63} - /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L29} + /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_070.proto#L29} /// // clang-format on StatusOr @@ -148,7 +148,7 @@ class InterconnectRemoteLocationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_remote_locations.v1.GetInterconnectRemoteLocationRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations.proto#L63} - /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L29} + /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_070.proto#L29} /// // clang-format on StatusOr @@ -187,7 +187,7 @@ class InterconnectRemoteLocationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_remote_locations.v1.ListInterconnectRemoteLocationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations.proto#L76} - /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L29} + /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_070.proto#L29} /// // clang-format on StreamRange @@ -229,7 +229,7 @@ class InterconnectRemoteLocationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnect_remote_locations.v1.ListInterconnectRemoteLocationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations.proto#L76} - /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L29} + /// [google.cloud.cpp.compute.v1.InterconnectRemoteLocation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_070.proto#L29} /// // clang-format on StreamRange diff --git a/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations_proto_export.h b/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations_proto_export.h index e8b1a44e85a68..1a014fdf3a6e8 100644 --- a/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations_proto_export.h +++ b/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECT_REMOTE_LOCATIONS_V1_INTERCONNECT_REMOTE_LOCATIONS_PROTO_EXPORT_H // IWYU pragma: begin_exports +#include #include -#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECT_REMOTE_LOCATIONS_V1_INTERCONNECT_REMOTE_LOCATIONS_PROTO_EXPORT_H diff --git a/google/cloud/compute/interconnects/v1/interconnects_client.h b/google/cloud/compute/interconnects/v1/interconnects_client.h index ea35cd23e23d0..a3b397642627c 100644 --- a/google/cloud/compute/interconnects/v1/interconnects_client.h +++ b/google/cloud/compute/interconnects/v1/interconnects_client.h @@ -229,7 +229,7 @@ class InterconnectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnects.v1.GetInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L178} - /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L27} + /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L27} /// // clang-format on StatusOr GetInterconnect( @@ -262,7 +262,7 @@ class InterconnectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnects.v1.GetInterconnectRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L178} - /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L27} + /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L27} /// // clang-format on StatusOr GetInterconnect( @@ -295,7 +295,7 @@ class InterconnectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnects.v1.GetDiagnosticsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L167} - /// [google.cloud.cpp.compute.v1.InterconnectsGetDiagnosticsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L594} + /// [google.cloud.cpp.compute.v1.InterconnectsGetDiagnosticsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L594} /// // clang-format on StatusOr @@ -331,7 +331,7 @@ class InterconnectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnects.v1.GetDiagnosticsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L167} - /// [google.cloud.cpp.compute.v1.InterconnectsGetDiagnosticsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L594} + /// [google.cloud.cpp.compute.v1.InterconnectsGetDiagnosticsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L594} /// // clang-format on StatusOr @@ -360,7 +360,7 @@ class InterconnectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnects.v1.GetMacsecConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L189} - /// [google.cloud.cpp.compute.v1.InterconnectsGetMacsecConfigResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L599} + /// [google.cloud.cpp.compute.v1.InterconnectsGetMacsecConfigResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L599} /// // clang-format on StatusOr< @@ -393,7 +393,7 @@ class InterconnectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnects.v1.GetMacsecConfigRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L189} - /// [google.cloud.cpp.compute.v1.InterconnectsGetMacsecConfigResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L599} + /// [google.cloud.cpp.compute.v1.InterconnectsGetMacsecConfigResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L599} /// // clang-format on StatusOr< @@ -556,7 +556,7 @@ class InterconnectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnects.v1.ListInterconnectsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L226} - /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L27} + /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L27} /// // clang-format on StreamRange ListInterconnects( @@ -596,7 +596,7 @@ class InterconnectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.interconnects.v1.ListInterconnectsRequest]: @cloud_cpp_reference_link{google/cloud/compute/interconnects/v1/interconnects.proto#L226} - /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_068.proto#L27} + /// [google.cloud.cpp.compute.v1.Interconnect]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L27} /// // clang-format on StreamRange ListInterconnects( diff --git a/google/cloud/compute/interconnects/v1/interconnects_proto_export.h b/google/cloud/compute/interconnects/v1/interconnects_proto_export.h index 4b2e88145de9c..492f71896b29f 100644 --- a/google/cloud/compute/interconnects/v1/interconnects_proto_export.h +++ b/google/cloud/compute/interconnects/v1/interconnects_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECTS_V1_INTERCONNECTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_INTERCONNECTS_V1_INTERCONNECTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/license_codes/v1/license_codes_client.h b/google/cloud/compute/license_codes/v1/license_codes_client.h index 16824742d0510..93c0a2fe063ad 100644 --- a/google/cloud/compute/license_codes/v1/license_codes_client.h +++ b/google/cloud/compute/license_codes/v1/license_codes_client.h @@ -110,7 +110,7 @@ class LicenseCodesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.license_codes.v1.GetLicenseCodeRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L68} - /// [google.cloud.cpp.compute.v1.LicenseCode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_074.proto#L27} + /// [google.cloud.cpp.compute.v1.LicenseCode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L27} /// // clang-format on StatusOr GetLicenseCode( @@ -145,7 +145,7 @@ class LicenseCodesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.license_codes.v1.GetLicenseCodeRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L68} - /// [google.cloud.cpp.compute.v1.LicenseCode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_074.proto#L27} + /// [google.cloud.cpp.compute.v1.LicenseCode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_072.proto#L27} /// // clang-format on StatusOr GetLicenseCode( @@ -177,7 +177,7 @@ class LicenseCodesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.license_codes.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L79} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -214,7 +214,7 @@ class LicenseCodesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.license_codes.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/license_codes/v1/license_codes.proto#L79} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/license_codes/v1/license_codes_proto_export.h b/google/cloud/compute/license_codes/v1/license_codes_proto_export.h index f451ba0d989a4..b6811c684b7e2 100644 --- a/google/cloud/compute/license_codes/v1/license_codes_proto_export.h +++ b/google/cloud/compute/license_codes/v1/license_codes_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_LICENSE_CODES_V1_LICENSE_CODES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_LICENSE_CODES_V1_LICENSE_CODES_PROTO_EXPORT_H diff --git a/google/cloud/compute/licenses/v1/licenses_client.h b/google/cloud/compute/licenses/v1/licenses_client.h index 2d60e523b8a67..13ffd663c0f2a 100644 --- a/google/cloud/compute/licenses/v1/licenses_client.h +++ b/google/cloud/compute/licenses/v1/licenses_client.h @@ -228,7 +228,7 @@ class LicensesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.licenses.v1.GetLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L183} - /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L28} + /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L28} /// // clang-format on StatusOr GetLicense( @@ -262,7 +262,7 @@ class LicensesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.licenses.v1.GetLicenseRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L183} - /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L28} + /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L28} /// // clang-format on StatusOr GetLicense( @@ -293,7 +293,7 @@ class LicensesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.licenses.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L168} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -327,7 +327,7 @@ class LicensesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.licenses.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L168} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -494,7 +494,7 @@ class LicensesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.licenses.v1.ListLicensesRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L220} - /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L28} + /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L28} /// // clang-format on StreamRange ListLicenses( @@ -540,7 +540,7 @@ class LicensesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.licenses.v1.ListLicensesRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L220} - /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_073.proto#L28} + /// [google.cloud.cpp.compute.v1.License]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_071.proto#L28} /// // clang-format on StreamRange ListLicenses( @@ -571,7 +571,7 @@ class LicensesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.licenses.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L288} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -607,7 +607,7 @@ class LicensesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.licenses.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L288} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -639,7 +639,7 @@ class LicensesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.licenses.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L304} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -676,7 +676,7 @@ class LicensesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.licenses.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/licenses/v1/licenses.proto#L304} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/licenses/v1/licenses_proto_export.h b/google/cloud/compute/licenses/v1/licenses_proto_export.h index 3b79a00620f1d..9194f388b39fa 100644 --- a/google/cloud/compute/licenses/v1/licenses_proto_export.h +++ b/google/cloud/compute/licenses/v1/licenses_proto_export.h @@ -26,12 +26,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_LICENSES_V1_LICENSES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_LICENSES_V1_LICENSES_PROTO_EXPORT_H diff --git a/google/cloud/compute/machine_images/v1/machine_images_client.h b/google/cloud/compute/machine_images/v1/machine_images_client.h index 14ca4931404d5..85c1a30e9202e 100644 --- a/google/cloud/compute/machine_images/v1/machine_images_client.h +++ b/google/cloud/compute/machine_images/v1/machine_images_client.h @@ -229,7 +229,7 @@ class MachineImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_images.v1.GetMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L170} - /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} + /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_074.proto#L33} /// // clang-format on StatusOr GetMachineImage( @@ -261,7 +261,7 @@ class MachineImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_images.v1.GetMachineImageRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L170} - /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} + /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_074.proto#L33} /// // clang-format on StatusOr GetMachineImage( @@ -291,7 +291,7 @@ class MachineImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_images.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L155} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -324,7 +324,7 @@ class MachineImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_images.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L155} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -491,7 +491,7 @@ class MachineImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_images.v1.ListMachineImagesRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L210} - /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} + /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_074.proto#L33} /// // clang-format on StreamRange ListMachineImages( @@ -532,7 +532,7 @@ class MachineImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_images.v1.ListMachineImagesRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L210} - /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_076.proto#L33} + /// [google.cloud.cpp.compute.v1.MachineImage]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_074.proto#L33} /// // clang-format on StreamRange ListMachineImages( @@ -563,7 +563,7 @@ class MachineImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_images.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L278} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -598,7 +598,7 @@ class MachineImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_images.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L278} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -628,7 +628,7 @@ class MachineImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_images.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L294} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -663,7 +663,7 @@ class MachineImagesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_images.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_images/v1/machine_images.proto#L294} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/machine_images/v1/machine_images_proto_export.h b/google/cloud/compute/machine_images/v1/machine_images_proto_export.h index 0a8da9eabc120..8fb44372983cd 100644 --- a/google/cloud/compute/machine_images/v1/machine_images_proto_export.h +++ b/google/cloud/compute/machine_images/v1/machine_images_proto_export.h @@ -28,16 +28,16 @@ // IWYU pragma: begin_exports #include #include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include +#include #include -#include -#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_MACHINE_IMAGES_V1_MACHINE_IMAGES_PROTO_EXPORT_H diff --git a/google/cloud/compute/machine_types/v1/machine_types_client.h b/google/cloud/compute/machine_types/v1/machine_types_client.h index c5e047e05af5c..17876150cb6c3 100644 --- a/google/cloud/compute/machine_types/v1/machine_types_client.h +++ b/google/cloud/compute/machine_types/v1/machine_types_client.h @@ -117,7 +117,7 @@ class MachineTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_types.v1.AggregatedListMachineTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_types/v1/machine_types.proto#L71} - /// [google.cloud.cpp.compute.v1.MachineTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_077.proto#L327} + /// [google.cloud.cpp.compute.v1.MachineTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_075.proto#L327} /// // clang-format on StreamRange GetMachineType( @@ -222,7 +222,7 @@ class MachineTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_types.v1.GetMachineTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_types/v1/machine_types.proto#L153} - /// [google.cloud.cpp.compute.v1.MachineType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_077.proto#L29} + /// [google.cloud.cpp.compute.v1.MachineType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_075.proto#L29} /// // clang-format on StatusOr GetMachineType( @@ -260,7 +260,7 @@ class MachineTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_types.v1.ListMachineTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_types/v1/machine_types.proto#L167} - /// [google.cloud.cpp.compute.v1.MachineType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_077.proto#L29} + /// [google.cloud.cpp.compute.v1.MachineType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_075.proto#L29} /// // clang-format on StreamRange ListMachineTypes( @@ -300,7 +300,7 @@ class MachineTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.machine_types.v1.ListMachineTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/machine_types/v1/machine_types.proto#L167} - /// [google.cloud.cpp.compute.v1.MachineType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_077.proto#L29} + /// [google.cloud.cpp.compute.v1.MachineType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_075.proto#L29} /// // clang-format on StreamRange ListMachineTypes( diff --git a/google/cloud/compute/machine_types/v1/machine_types_proto_export.h b/google/cloud/compute/machine_types/v1/machine_types_proto_export.h index b20a3dd97f0a7..6b7465943341f 100644 --- a/google/cloud/compute/machine_types/v1/machine_types_proto_export.h +++ b/google/cloud/compute/machine_types/v1/machine_types_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_MACHINE_TYPES_V1_MACHINE_TYPES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_MACHINE_TYPES_V1_MACHINE_TYPES_PROTO_EXPORT_H diff --git a/google/cloud/compute/network_attachments/v1/network_attachments_client.h b/google/cloud/compute/network_attachments/v1/network_attachments_client.h index a45d11d8168f0..1d576292a81db 100644 --- a/google/cloud/compute/network_attachments/v1/network_attachments_client.h +++ b/google/cloud/compute/network_attachments/v1/network_attachments_client.h @@ -121,7 +121,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.AggregatedListNetworkAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L153} - /// [google.cloud.cpp.compute.v1.NetworkAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L348} + /// [google.cloud.cpp.compute.v1.NetworkAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_079.proto#L348} /// // clang-format on StreamRange< @@ -166,7 +166,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.AggregatedListNetworkAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L153} - /// [google.cloud.cpp.compute.v1.NetworkAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L348} + /// [google.cloud.cpp.compute.v1.NetworkAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_079.proto#L348} /// // clang-format on StreamRange< @@ -320,7 +320,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.GetNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L288} - /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L25} + /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_079.proto#L25} /// // clang-format on StatusOr @@ -353,7 +353,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.GetNetworkAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L288} - /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L25} + /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_079.proto#L25} /// // clang-format on StatusOr @@ -384,7 +384,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L269} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -417,7 +417,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L269} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -582,7 +582,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.ListNetworkAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L337} - /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L25} + /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_079.proto#L25} /// // clang-format on StreamRange @@ -623,7 +623,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.ListNetworkAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L337} - /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L25} + /// [google.cloud.cpp.compute.v1.NetworkAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_079.proto#L25} /// // clang-format on StreamRange @@ -787,7 +787,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L447} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -823,7 +823,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L447} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -854,7 +854,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L467} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -890,7 +890,7 @@ class NetworkAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_attachments.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_attachments/v1/network_attachments.proto#L467} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/network_attachments/v1/network_attachments_proto_export.h b/google/cloud/compute/network_attachments/v1/network_attachments_proto_export.h index b520e3dc713b0..97a70463c4d8a 100644 --- a/google/cloud/compute/network_attachments/v1/network_attachments_proto_export.h +++ b/google/cloud/compute/network_attachments/v1/network_attachments_proto_export.h @@ -26,12 +26,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORK_ATTACHMENTS_V1_NETWORK_ATTACHMENTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORK_ATTACHMENTS_V1_NETWORK_ATTACHMENTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services_client.h b/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services_client.h index 38ce1b48445f2..138543990c0a1 100644 --- a/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services_client.h +++ b/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services_client.h @@ -125,7 +125,7 @@ class NetworkEdgeSecurityServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_edge_security_services.v1.AggregatedListNetworkEdgeSecurityServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L106} - /// [google.cloud.cpp.compute.v1.NetworkEdgeSecurityServicesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_082.proto#L187} + /// [google.cloud.cpp.compute.v1.NetworkEdgeSecurityServicesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_080.proto#L187} /// // clang-format on StreamRange @@ -358,7 +358,7 @@ class NetworkEdgeSecurityServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_edge_security_services.v1.GetNetworkEdgeSecurityServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto#L223} - /// [google.cloud.cpp.compute.v1.NetworkEdgeSecurityService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_082.proto#L25} + /// [google.cloud.cpp.compute.v1.NetworkEdgeSecurityService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_080.proto#L25} /// // clang-format on StatusOr diff --git a/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services_proto_export.h b/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services_proto_export.h index 8a81cf5349529..9581cb7647207 100644 --- a/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services_proto_export.h +++ b/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORK_EDGE_SECURITY_SERVICES_V1_NETWORK_EDGE_SECURITY_SERVICES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORK_EDGE_SECURITY_SERVICES_V1_NETWORK_EDGE_SECURITY_SERVICES_PROTO_EXPORT_H diff --git a/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups_client.h b/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups_client.h index 70607b377bf0e..829a5fd89ff1b 100644 --- a/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups_client.h +++ b/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups_client.h @@ -123,7 +123,7 @@ class NetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_endpoint_groups.v1.AggregatedListNetworkEndpointGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L159} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroupsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L158} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroupsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_081.proto#L158} /// // clang-format on StreamRange @@ -633,7 +633,7 @@ class NetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_endpoint_groups.v1.GetNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L364} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L118} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L129} /// // clang-format on StatusOr @@ -804,7 +804,7 @@ class NetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_endpoint_groups.v1.ListNetworkEndpointGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L415} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L118} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L129} /// // clang-format on StreamRange @@ -846,7 +846,7 @@ class NetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_endpoint_groups.v1.ListNetworkEndpointGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L415} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L118} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L129} /// // clang-format on StreamRange @@ -889,7 +889,7 @@ class NetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_endpoint_groups.v1.ListNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L487} - /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L529} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L540} /// // clang-format on StreamRange @@ -935,7 +935,7 @@ class NetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_endpoint_groups.v1.ListNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L487} - /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L529} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L540} /// // clang-format on StreamRange @@ -966,7 +966,7 @@ class NetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_endpoint_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L571} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1002,7 +1002,7 @@ class NetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_endpoint_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto#L571} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups_proto_export.h b/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups_proto_export.h index 98a72e4bf9e80..e4499f211d4c4 100644 --- a/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups_proto_export.h +++ b/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups_proto_export.h @@ -26,11 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORK_ENDPOINT_GROUPS_V1_NETWORK_ENDPOINT_GROUPS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORK_ENDPOINT_GROUPS_V1_NETWORK_ENDPOINT_GROUPS_PROTO_EXPORT_H diff --git a/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies_client.h b/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies_client.h index 87760deab20bf..55604e7e77dd4 100644 --- a/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies_client.h +++ b/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies_client.h @@ -597,7 +597,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L378} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -629,7 +629,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L378} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -658,7 +658,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L364} - /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L111} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L111} /// // clang-format on StatusOr @@ -690,7 +690,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L364} - /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L111} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L111} /// // clang-format on StatusOr @@ -720,7 +720,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L389} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -753,7 +753,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L389} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -782,7 +782,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L404} - /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L26} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L26} /// // clang-format on StatusOr GetRule( @@ -814,7 +814,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L404} - /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L26} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L26} /// // clang-format on StatusOr GetRule( @@ -976,7 +976,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.ListNetworkFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L444} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} /// // clang-format on StreamRange @@ -1016,7 +1016,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.ListNetworkFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L444} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} /// // clang-format on StreamRange @@ -1534,7 +1534,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L633} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1569,7 +1569,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L633} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1599,7 +1599,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L649} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1634,7 +1634,7 @@ class NetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.network_firewall_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto#L649} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies_proto_export.h b/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies_proto_export.h index 0b2d34c204ae9..e5e588b05aeea 100644 --- a/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies_proto_export.h +++ b/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies_proto_export.h @@ -26,13 +26,13 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORK_FIREWALL_POLICIES_V1_NETWORK_FIREWALL_POLICIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include +#include #include -#include -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORK_FIREWALL_POLICIES_V1_NETWORK_FIREWALL_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/networks/v1/networks_client.h b/google/cloud/compute/networks/v1/networks_client.h index 3f88b5b6ae9ff..0ef55eae04a96 100644 --- a/google/cloud/compute/networks/v1/networks_client.h +++ b/google/cloud/compute/networks/v1/networks_client.h @@ -347,7 +347,7 @@ class NetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.networks.v1.GetNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L240} - /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L159} + /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L159} /// // clang-format on StatusOr GetNetwork( @@ -379,7 +379,7 @@ class NetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.networks.v1.GetNetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L240} - /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L159} + /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L159} /// // clang-format on StatusOr GetNetwork( @@ -408,7 +408,7 @@ class NetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.networks.v1.GetEffectiveFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L229} - /// [google.cloud.cpp.compute.v1.NetworksGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L473} + /// [google.cloud.cpp.compute.v1.NetworksGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L473} /// // clang-format on StatusOr< @@ -441,7 +441,7 @@ class NetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.networks.v1.GetEffectiveFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L229} - /// [google.cloud.cpp.compute.v1.NetworksGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L473} + /// [google.cloud.cpp.compute.v1.NetworksGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L473} /// // clang-format on StatusOr< @@ -601,7 +601,7 @@ class NetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.networks.v1.ListNetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L277} - /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L159} + /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L159} /// // clang-format on StreamRange ListNetworks( @@ -641,7 +641,7 @@ class NetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.networks.v1.ListNetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L277} - /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L159} + /// [google.cloud.cpp.compute.v1.Network]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L159} /// // clang-format on StreamRange ListNetworks( @@ -678,7 +678,7 @@ class NetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.networks.v1.ListPeeringRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L345} - /// [google.cloud.cpp.compute.v1.ExchangedPeeringRoute]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L27} + /// [google.cloud.cpp.compute.v1.ExchangedPeeringRoute]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L27} /// // clang-format on StreamRange @@ -719,7 +719,7 @@ class NetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.networks.v1.ListPeeringRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/networks/v1/networks.proto#L345} - /// [google.cloud.cpp.compute.v1.ExchangedPeeringRoute]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_031.proto#L27} + /// [google.cloud.cpp.compute.v1.ExchangedPeeringRoute]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_030.proto#L27} /// // clang-format on StreamRange diff --git a/google/cloud/compute/networks/v1/networks_proto_export.h b/google/cloud/compute/networks/v1/networks_proto_export.h index 67eeea625039a..f8d58d50ddc81 100644 --- a/google/cloud/compute/networks/v1/networks_proto_export.h +++ b/google/cloud/compute/networks/v1/networks_proto_export.h @@ -26,15 +26,15 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORKS_V1_NETWORKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include +#include #include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NETWORKS_V1_NETWORKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/node_groups/v1/node_groups_client.h b/google/cloud/compute/node_groups/v1/node_groups_client.h index f535ae06b1af2..acb331ce45e1d 100644 --- a/google/cloud/compute/node_groups/v1/node_groups_client.h +++ b/google/cloud/compute/node_groups/v1/node_groups_client.h @@ -243,7 +243,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.AggregatedListNodeGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L268} - /// [google.cloud.cpp.compute.v1.NodeGroupsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L580} + /// [google.cloud.cpp.compute.v1.NodeGroupsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_056.proto#L580} /// // clang-format on StreamRange GetNodeGroup( @@ -598,7 +598,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.GetNodeGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L439} - /// [google.cloud.cpp.compute.v1.NodeGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L59} + /// [google.cloud.cpp.compute.v1.NodeGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_056.proto#L59} /// // clang-format on StatusOr GetNodeGroup( @@ -629,7 +629,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L421} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -662,7 +662,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L421} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -827,7 +827,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.ListNodeGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L490} - /// [google.cloud.cpp.compute.v1.NodeGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L59} + /// [google.cloud.cpp.compute.v1.NodeGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_056.proto#L59} /// // clang-format on StreamRange ListNodeGroups( @@ -868,7 +868,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.ListNodeGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L490} - /// [google.cloud.cpp.compute.v1.NodeGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L59} + /// [google.cloud.cpp.compute.v1.NodeGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_056.proto#L59} /// // clang-format on StreamRange ListNodeGroups( @@ -907,7 +907,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.ListNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L561} - /// [google.cloud.cpp.compute.v1.NodeGroupNode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L400} + /// [google.cloud.cpp.compute.v1.NodeGroupNode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_056.proto#L400} /// // clang-format on StreamRange ListNodes( @@ -948,7 +948,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.ListNodesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L561} - /// [google.cloud.cpp.compute.v1.NodeGroupNode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_058.proto#L400} + /// [google.cloud.cpp.compute.v1.NodeGroupNode]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_056.proto#L400} /// // clang-format on StreamRange ListNodes( @@ -1232,7 +1232,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L711} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1268,7 +1268,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L711} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1556,7 +1556,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L806} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1592,7 +1592,7 @@ class NodeGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_groups.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_groups/v1/node_groups.proto#L806} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/node_groups/v1/node_groups_proto_export.h b/google/cloud/compute/node_groups/v1/node_groups_proto_export.h index 283644e66e906..1043d73ecf802 100644 --- a/google/cloud/compute/node_groups/v1/node_groups_proto_export.h +++ b/google/cloud/compute/node_groups/v1/node_groups_proto_export.h @@ -27,16 +27,16 @@ // IWYU pragma: begin_exports #include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NODE_GROUPS_V1_NODE_GROUPS_PROTO_EXPORT_H diff --git a/google/cloud/compute/node_templates/v1/node_templates_client.h b/google/cloud/compute/node_templates/v1/node_templates_client.h index 1014e2c0feb26..cf98ef1e0de71 100644 --- a/google/cloud/compute/node_templates/v1/node_templates_client.h +++ b/google/cloud/compute/node_templates/v1/node_templates_client.h @@ -118,7 +118,7 @@ class NodeTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_templates.v1.AggregatedListNodeTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L137} - /// [google.cloud.cpp.compute.v1.NodeTemplatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L326} + /// [google.cloud.cpp.compute.v1.NodeTemplatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_082.proto#L326} /// // clang-format on StreamRange GetNodeTemplate( @@ -343,7 +343,7 @@ class NodeTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_templates.v1.GetNodeTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L271} - /// [google.cloud.cpp.compute.v1.NodeTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L30} + /// [google.cloud.cpp.compute.v1.NodeTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_082.proto#L30} /// // clang-format on StatusOr GetNodeTemplate( @@ -374,7 +374,7 @@ class NodeTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_templates.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L252} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -407,7 +407,7 @@ class NodeTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_templates.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L252} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -571,7 +571,7 @@ class NodeTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_templates.v1.ListNodeTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L319} - /// [google.cloud.cpp.compute.v1.NodeTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L30} + /// [google.cloud.cpp.compute.v1.NodeTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_082.proto#L30} /// // clang-format on StreamRange ListNodeTemplates( @@ -611,7 +611,7 @@ class NodeTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_templates.v1.ListNodeTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L319} - /// [google.cloud.cpp.compute.v1.NodeTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L30} + /// [google.cloud.cpp.compute.v1.NodeTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_082.proto#L30} /// // clang-format on StreamRange ListNodeTemplates( @@ -643,7 +643,7 @@ class NodeTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_templates.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L391} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -679,7 +679,7 @@ class NodeTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_templates.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L391} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -710,7 +710,7 @@ class NodeTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_templates.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L411} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -746,7 +746,7 @@ class NodeTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_templates.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_templates/v1/node_templates.proto#L411} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/node_templates/v1/node_templates_proto_export.h b/google/cloud/compute/node_templates/v1/node_templates_proto_export.h index 258d743d69d54..f48104acff138 100644 --- a/google/cloud/compute/node_templates/v1/node_templates_proto_export.h +++ b/google/cloud/compute/node_templates/v1/node_templates_proto_export.h @@ -27,13 +27,13 @@ // IWYU pragma: begin_exports #include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NODE_TEMPLATES_V1_NODE_TEMPLATES_PROTO_EXPORT_H diff --git a/google/cloud/compute/node_types/v1/node_types_client.h b/google/cloud/compute/node_types/v1/node_types_client.h index 9b5a0aa74f653..89946a362a71a 100644 --- a/google/cloud/compute/node_types/v1/node_types_client.h +++ b/google/cloud/compute/node_types/v1/node_types_client.h @@ -115,7 +115,7 @@ class NodeTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_types.v1.AggregatedListNodeTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_types/v1/node_types.proto#L71} - /// [google.cloud.cpp.compute.v1.NodeTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_085.proto#L290} + /// [google.cloud.cpp.compute.v1.NodeTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L290} /// // clang-format on StreamRange GetNodeType( @@ -220,7 +220,7 @@ class NodeTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_types.v1.GetNodeTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_types/v1/node_types.proto#L153} - /// [google.cloud.cpp.compute.v1.NodeType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_085.proto#L31} + /// [google.cloud.cpp.compute.v1.NodeType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L31} /// // clang-format on StatusOr GetNodeType( @@ -258,7 +258,7 @@ class NodeTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_types.v1.ListNodeTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_types/v1/node_types.proto#L167} - /// [google.cloud.cpp.compute.v1.NodeType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_085.proto#L31} + /// [google.cloud.cpp.compute.v1.NodeType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L31} /// // clang-format on StreamRange ListNodeTypes( @@ -298,7 +298,7 @@ class NodeTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.node_types.v1.ListNodeTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/node_types/v1/node_types.proto#L167} - /// [google.cloud.cpp.compute.v1.NodeType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_085.proto#L31} + /// [google.cloud.cpp.compute.v1.NodeType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_083.proto#L31} /// // clang-format on StreamRange ListNodeTypes( diff --git a/google/cloud/compute/node_types/v1/node_types_proto_export.h b/google/cloud/compute/node_types/v1/node_types_proto_export.h index 80e83b681a068..d2fe129ca1193 100644 --- a/google/cloud/compute/node_types/v1/node_types_proto_export.h +++ b/google/cloud/compute/node_types/v1/node_types_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NODE_TYPES_V1_NODE_TYPES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_NODE_TYPES_V1_NODE_TYPES_PROTO_EXPORT_H diff --git a/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings_client.h b/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings_client.h index d305bfb1ebd07..afacbdc0b8423 100644 --- a/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings_client.h +++ b/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings_client.h @@ -120,7 +120,7 @@ class PacketMirroringsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.packet_mirrorings.v1.AggregatedListPacketMirroringsRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L128} - /// [google.cloud.cpp.compute.v1.PacketMirroringsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L388} + /// [google.cloud.cpp.compute.v1.PacketMirroringsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L388} /// // clang-format on StreamRange GetPacketMirroring( @@ -347,7 +347,7 @@ class PacketMirroringsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.packet_mirrorings.v1.GetPacketMirroringRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L243} - /// [google.cloud.cpp.compute.v1.PacketMirroring]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L29} + /// [google.cloud.cpp.compute.v1.PacketMirroring]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L29} /// // clang-format on StatusOr GetPacketMirroring( @@ -512,7 +512,7 @@ class PacketMirroringsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.packet_mirrorings.v1.ListPacketMirroringsRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L291} - /// [google.cloud.cpp.compute.v1.PacketMirroring]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L29} + /// [google.cloud.cpp.compute.v1.PacketMirroring]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L29} /// // clang-format on StreamRange @@ -554,7 +554,7 @@ class PacketMirroringsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.packet_mirrorings.v1.ListPacketMirroringsRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L291} - /// [google.cloud.cpp.compute.v1.PacketMirroring]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L29} + /// [google.cloud.cpp.compute.v1.PacketMirroring]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_087.proto#L29} /// // clang-format on StreamRange @@ -716,7 +716,7 @@ class PacketMirroringsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.packet_mirrorings.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L400} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -752,7 +752,7 @@ class PacketMirroringsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.packet_mirrorings.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto#L400} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings_proto_export.h b/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings_proto_export.h index 3dc64255fb3cd..388237bc2f15f 100644 --- a/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings_proto_export.h +++ b/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PACKET_MIRRORINGS_V1_PACKET_MIRRORINGS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PACKET_MIRRORINGS_V1_PACKET_MIRRORINGS_PROTO_EXPORT_H diff --git a/google/cloud/compute/projects/v1/projects_client.h b/google/cloud/compute/projects/v1/projects_client.h index f10be89f71a11..00aa38a8c06e7 100644 --- a/google/cloud/compute/projects/v1/projects_client.h +++ b/google/cloud/compute/projects/v1/projects_client.h @@ -595,7 +595,7 @@ class ProjectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.projects.v1.GetProjectRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L335} - /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L60} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L60} /// // clang-format on StatusOr GetProject( @@ -632,7 +632,7 @@ class ProjectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.projects.v1.GetProjectRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L335} - /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L60} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L60} /// // clang-format on StatusOr GetProject( @@ -661,7 +661,7 @@ class ProjectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.projects.v1.GetXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L342} - /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L60} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L60} /// // clang-format on StatusOr GetXpnHost( @@ -693,7 +693,7 @@ class ProjectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.projects.v1.GetXpnHostRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L342} - /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L60} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L60} /// // clang-format on StatusOr GetXpnHost( @@ -722,7 +722,7 @@ class ProjectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.projects.v1.GetXpnResourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L349} - /// [google.cloud.cpp.compute.v1.ProjectsGetXpnResources]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L148} + /// [google.cloud.cpp.compute.v1.ProjectsGetXpnResources]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L148} /// // clang-format on StatusOr @@ -754,7 +754,7 @@ class ProjectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.projects.v1.GetXpnResourcesRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L349} - /// [google.cloud.cpp.compute.v1.ProjectsGetXpnResources]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L148} + /// [google.cloud.cpp.compute.v1.ProjectsGetXpnResources]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L148} /// // clang-format on StatusOr @@ -793,7 +793,7 @@ class ProjectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.projects.v1.ListXpnHostsRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L417} - /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L60} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L60} /// // clang-format on StreamRange ListXpnHosts( @@ -836,7 +836,7 @@ class ProjectsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.projects.v1.ListXpnHostsRequest]: @cloud_cpp_reference_link{google/cloud/compute/projects/v1/projects.proto#L417} - /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L60} + /// [google.cloud.cpp.compute.v1.Project]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L60} /// // clang-format on StreamRange ListXpnHosts( diff --git a/google/cloud/compute/projects/v1/projects_proto_export.h b/google/cloud/compute/projects/v1/projects_proto_export.h index 7c25d4da20c06..418abb9669bef 100644 --- a/google/cloud/compute/projects/v1/projects_proto_export.h +++ b/google/cloud/compute/projects/v1/projects_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PROJECTS_V1_PROJECTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PROJECTS_V1_PROJECTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes_client.h b/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes_client.h index 8fd51650b688e..a6f961ea240ab 100644 --- a/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes_client.h +++ b/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes_client.h @@ -354,7 +354,7 @@ class PublicAdvertisedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.GetPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L182} - /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_091.proto#L27} + /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L27} /// // clang-format on StatusOr @@ -387,7 +387,7 @@ class PublicAdvertisedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.GetPublicAdvertisedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L182} - /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_091.proto#L27} + /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L27} /// // clang-format on StatusOr @@ -554,7 +554,7 @@ class PublicAdvertisedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.ListPublicAdvertisedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L221} - /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_091.proto#L27} + /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L27} /// // clang-format on StreamRange @@ -594,7 +594,7 @@ class PublicAdvertisedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.public_advertised_prefixes.v1.ListPublicAdvertisedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto#L221} - /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_091.proto#L27} + /// [google.cloud.cpp.compute.v1.PublicAdvertisedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_089.proto#L27} /// // clang-format on StreamRange diff --git a/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes_proto_export.h b/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes_proto_export.h index 2ca557d10984f..2344cf7146232 100644 --- a/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes_proto_export.h +++ b/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PUBLIC_ADVERTISED_PREFIXES_V1_PUBLIC_ADVERTISED_PREFIXES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PUBLIC_ADVERTISED_PREFIXES_V1_PUBLIC_ADVERTISED_PREFIXES_PROTO_EXPORT_H diff --git a/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes_client.h b/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes_client.h index d363717e45b7e..c1073d945e9b1 100644 --- a/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes_client.h +++ b/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes_client.h @@ -123,7 +123,7 @@ class PublicDelegatedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.AggregatedListPublicDelegatedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L145} - /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefixesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_093.proto#L137} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefixesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_091.proto#L137} /// // clang-format on StreamRange @@ -479,7 +479,7 @@ class PublicDelegatedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.GetPublicDelegatedPrefixRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L298} - /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_092.proto#L29} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L29} /// // clang-format on StatusOr @@ -648,7 +648,7 @@ class PublicDelegatedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.ListPublicDelegatedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L348} - /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_092.proto#L29} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L29} /// // clang-format on StreamRange @@ -689,7 +689,7 @@ class PublicDelegatedPrefixesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.public_delegated_prefixes.v1.ListPublicDelegatedPrefixesRequest]: @cloud_cpp_reference_link{google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto#L348} - /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_092.proto#L29} + /// [google.cloud.cpp.compute.v1.PublicDelegatedPrefix]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L29} /// // clang-format on StreamRange diff --git a/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes_proto_export.h b/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes_proto_export.h index 70dd0fd800020..8672a655615cd 100644 --- a/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes_proto_export.h +++ b/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PUBLIC_DELEGATED_PREFIXES_V1_PUBLIC_DELEGATED_PREFIXES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_PUBLIC_DELEGATED_PREFIXES_V1_PUBLIC_DELEGATED_PREFIXES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_client.h b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_client.h index 4ab1985f18045..69dd3d3410b15 100644 --- a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_client.h +++ b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_client.h @@ -230,7 +230,7 @@ class RegionAutoscalersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_autoscalers.v1.GetAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L147} - /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L34} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L34} /// // clang-format on StatusOr GetAutoscaler( @@ -262,7 +262,7 @@ class RegionAutoscalersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_autoscalers.v1.GetAutoscalerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L147} - /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L34} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L34} /// // clang-format on StatusOr GetAutoscaler( @@ -423,7 +423,7 @@ class RegionAutoscalersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_autoscalers.v1.ListRegionAutoscalersRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L195} - /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L34} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L34} /// // clang-format on StreamRange @@ -464,7 +464,7 @@ class RegionAutoscalersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_autoscalers.v1.ListRegionAutoscalersRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto#L195} - /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_009.proto#L34} + /// [google.cloud.cpp.compute.v1.Autoscaler]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L34} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_proto_export.h b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_proto_export.h index 81523bb19f93a..80b044b1bca2e 100644 --- a/google/cloud/compute/region_autoscalers/v1/region_autoscalers_proto_export.h +++ b/google/cloud/compute/region_autoscalers/v1/region_autoscalers_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_AUTOSCALERS_V1_REGION_AUTOSCALERS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_AUTOSCALERS_V1_REGION_AUTOSCALERS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_backend_services/v1/region_backend_services_client.h b/google/cloud/compute/region_backend_services/v1/region_backend_services_client.h index b0623455d5a15..7852860a3e009 100644 --- a/google/cloud/compute/region_backend_services/v1/region_backend_services_client.h +++ b/google/cloud/compute/region_backend_services/v1/region_backend_services_client.h @@ -279,7 +279,7 @@ class RegionBackendServicesClient { /// Gets the most recent health check results for this regional BackendService. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/getHealth /// - /// @param project + /// @param project /// @param region Name of the region scoping this request. /// @param backend_service Name of the BackendService resource for which to get health. /// @param resource_group_reference_resource The ResourceGroupReference for this request. @@ -297,7 +297,7 @@ class RegionBackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_backend_services.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L245} - /// [google.cloud.cpp.compute.v1.BackendServiceGroupHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L772} + /// [google.cloud.cpp.compute.v1.BackendServiceGroupHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L814} /// // clang-format on StatusOr @@ -332,7 +332,7 @@ class RegionBackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_backend_services.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L245} - /// [google.cloud.cpp.compute.v1.BackendServiceGroupHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L772} + /// [google.cloud.cpp.compute.v1.BackendServiceGroupHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_000.proto#L814} /// // clang-format on StatusOr @@ -363,7 +363,7 @@ class RegionBackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_backend_services.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L263} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -396,7 +396,7 @@ class RegionBackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_backend_services.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L263} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -852,7 +852,7 @@ class RegionBackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_backend_services.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L497} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -888,7 +888,7 @@ class RegionBackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_backend_services.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L497} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1049,7 +1049,7 @@ class RegionBackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_backend_services.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L556} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1085,7 +1085,7 @@ class RegionBackendServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_backend_services.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_backend_services/v1/region_backend_services.proto#L556} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/region_backend_services/v1/region_backend_services_proto_export.h b/google/cloud/compute/region_backend_services/v1/region_backend_services_proto_export.h index 7a45885def7fc..65075940e7035 100644 --- a/google/cloud/compute/region_backend_services/v1/region_backend_services_proto_export.h +++ b/google/cloud/compute/region_backend_services/v1/region_backend_services_proto_export.h @@ -27,14 +27,14 @@ // IWYU pragma: begin_exports #include -#include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_BACKEND_SERVICES_V1_REGION_BACKEND_SERVICES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_commitments/v1/region_commitments_client.h b/google/cloud/compute/region_commitments/v1/region_commitments_client.h index 48c9a6faad139..1b157edab0022 100644 --- a/google/cloud/compute/region_commitments/v1/region_commitments_client.h +++ b/google/cloud/compute/region_commitments/v1/region_commitments_client.h @@ -120,7 +120,7 @@ class RegionCommitmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_commitments.v1.AggregatedListRegionCommitmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L102} - /// [google.cloud.cpp.compute.v1.CommitmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L378} + /// [google.cloud.cpp.compute.v1.CommitmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_018.proto#L396} /// // clang-format on StreamRange GetCommitment( @@ -228,7 +228,7 @@ class RegionCommitmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_commitments.v1.GetCommitmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L184} - /// [google.cloud.cpp.compute.v1.Commitment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L31} + /// [google.cloud.cpp.compute.v1.Commitment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_018.proto#L31} /// // clang-format on StatusOr GetCommitment( @@ -389,7 +389,7 @@ class RegionCommitmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_commitments.v1.ListRegionCommitmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L232} - /// [google.cloud.cpp.compute.v1.Commitment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L31} + /// [google.cloud.cpp.compute.v1.Commitment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_018.proto#L31} /// // clang-format on StreamRange @@ -430,7 +430,7 @@ class RegionCommitmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_commitments.v1.ListRegionCommitmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_commitments/v1/region_commitments.proto#L232} - /// [google.cloud.cpp.compute.v1.Commitment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L31} + /// [google.cloud.cpp.compute.v1.Commitment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_018.proto#L31} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_commitments/v1/region_commitments_proto_export.h b/google/cloud/compute/region_commitments/v1/region_commitments_proto_export.h index 19d8382afd5c5..4dbc6b13816f9 100644 --- a/google/cloud/compute/region_commitments/v1/region_commitments_proto_export.h +++ b/google/cloud/compute/region_commitments/v1/region_commitments_proto_export.h @@ -28,10 +28,9 @@ // IWYU pragma: begin_exports #include #include -#include -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_COMMITMENTS_V1_REGION_COMMITMENTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_disk_types/v1/region_disk_types_client.h b/google/cloud/compute/region_disk_types/v1/region_disk_types_client.h index 15b97d1a9bf69..22558d0d8f816 100644 --- a/google/cloud/compute/region_disk_types/v1/region_disk_types_client.h +++ b/google/cloud/compute/region_disk_types/v1/region_disk_types_client.h @@ -108,7 +108,7 @@ class RegionDiskTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disk_types.v1.GetDiskTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disk_types/v1/region_disk_types.proto#L61} - /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L34} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L34} /// // clang-format on StatusOr GetDiskType( @@ -140,7 +140,7 @@ class RegionDiskTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disk_types.v1.GetDiskTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disk_types/v1/region_disk_types.proto#L61} - /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L34} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L34} /// // clang-format on StatusOr GetDiskType( @@ -178,7 +178,7 @@ class RegionDiskTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disk_types.v1.ListRegionDiskTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disk_types/v1/region_disk_types.proto#L76} - /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L34} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L34} /// // clang-format on StreamRange ListRegionDiskTypes( @@ -218,7 +218,7 @@ class RegionDiskTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disk_types.v1.ListRegionDiskTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disk_types/v1/region_disk_types.proto#L76} - /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_027.proto#L34} + /// [google.cloud.cpp.compute.v1.DiskType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_026.proto#L34} /// // clang-format on StreamRange ListRegionDiskTypes( diff --git a/google/cloud/compute/region_disk_types/v1/region_disk_types_proto_export.h b/google/cloud/compute/region_disk_types/v1/region_disk_types_proto_export.h index 35755cfd10562..41fe0b9844841 100644 --- a/google/cloud/compute/region_disk_types/v1/region_disk_types_proto_export.h +++ b/google/cloud/compute/region_disk_types/v1/region_disk_types_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_DISK_TYPES_V1_REGION_DISK_TYPES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_DISK_TYPES_V1_REGION_DISK_TYPES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_disks/v1/region_disks_client.h b/google/cloud/compute/region_disks/v1/region_disks_client.h index 75052018289d8..d33b55200ded1 100644 --- a/google/cloud/compute/region_disks/v1/region_disks_client.h +++ b/google/cloud/compute/region_disks/v1/region_disks_client.h @@ -620,7 +620,7 @@ class RegionDisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disks.v1.GetDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L405} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L49} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} /// // clang-format on StatusOr GetDisk( @@ -652,7 +652,7 @@ class RegionDisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disks.v1.GetDiskRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L405} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L49} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} /// // clang-format on StatusOr GetDisk( @@ -683,7 +683,7 @@ class RegionDisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L419} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -716,7 +716,7 @@ class RegionDisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L419} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -878,7 +878,7 @@ class RegionDisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disks.v1.ListRegionDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L474} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L49} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} /// // clang-format on StreamRange ListRegionDisks( @@ -919,7 +919,7 @@ class RegionDisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disks.v1.ListRegionDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L474} - /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_015.proto#L49} + /// [google.cloud.cpp.compute.v1.Disk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L49} /// // clang-format on StreamRange ListRegionDisks( @@ -1207,7 +1207,7 @@ class RegionDisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L620} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1243,7 +1243,7 @@ class RegionDisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L620} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1783,7 +1783,7 @@ class RegionDisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L782} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1819,7 +1819,7 @@ class RegionDisksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_disks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_disks/v1/region_disks.proto#L782} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/region_disks/v1/region_disks_proto_export.h b/google/cloud/compute/region_disks/v1/region_disks_proto_export.h index cb23218c5056b..cb835325c9438 100644 --- a/google/cloud/compute/region_disks/v1/region_disks_proto_export.h +++ b/google/cloud/compute/region_disks/v1/region_disks_proto_export.h @@ -26,16 +26,16 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_DISKS_V1_REGION_DISKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_DISKS_V1_REGION_DISKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_client.h b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_client.h index c57e09f5d637d..30b1c7571ac5b 100644 --- a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_client.h +++ b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_client.h @@ -239,7 +239,7 @@ class RegionHealthCheckServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_health_check_services.v1.GetHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L141} - /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L25} + /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L25} /// // clang-format on StatusOr @@ -272,7 +272,7 @@ class RegionHealthCheckServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_health_check_services.v1.GetHealthCheckServiceRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L141} - /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L25} + /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L25} /// // clang-format on StatusOr @@ -440,7 +440,7 @@ class RegionHealthCheckServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_health_check_services.v1.ListRegionHealthCheckServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L192} - /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L25} + /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L25} /// // clang-format on StreamRange @@ -482,7 +482,7 @@ class RegionHealthCheckServicesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_health_check_services.v1.ListRegionHealthCheckServicesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto#L192} - /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_050.proto#L25} + /// [google.cloud.cpp.compute.v1.HealthCheckService]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_048.proto#L25} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_proto_export.h b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_proto_export.h index 8b437019d74bf..d4b12799af1ae 100644 --- a/google/cloud/compute/region_health_check_services/v1/region_health_check_services_proto_export.h +++ b/google/cloud/compute/region_health_check_services/v1/region_health_check_services_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_CHECK_SERVICES_V1_REGION_HEALTH_CHECK_SERVICES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_CHECK_SERVICES_V1_REGION_HEALTH_CHECK_SERVICES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_health_checks/v1/region_health_checks_client.h b/google/cloud/compute/region_health_checks/v1/region_health_checks_client.h index cd04926a3fe6a..1037efa2ac251 100644 --- a/google/cloud/compute/region_health_checks/v1/region_health_checks_client.h +++ b/google/cloud/compute/region_health_checks/v1/region_health_checks_client.h @@ -231,7 +231,7 @@ class RegionHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_health_checks.v1.GetHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L150} - /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_044.proto#L271} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_042.proto#L271} /// // clang-format on StatusOr GetHealthCheck( @@ -263,7 +263,7 @@ class RegionHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_health_checks.v1.GetHealthCheckRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L150} - /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_044.proto#L271} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_042.proto#L271} /// // clang-format on StatusOr GetHealthCheck( @@ -426,7 +426,7 @@ class RegionHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_health_checks.v1.ListRegionHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L198} - /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_044.proto#L271} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_042.proto#L271} /// // clang-format on StreamRange @@ -468,7 +468,7 @@ class RegionHealthChecksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_health_checks.v1.ListRegionHealthChecksRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_health_checks/v1/region_health_checks.proto#L198} - /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_044.proto#L271} + /// [google.cloud.cpp.compute.v1.HealthCheck]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_042.proto#L271} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_health_checks/v1/region_health_checks_proto_export.h b/google/cloud/compute/region_health_checks/v1/region_health_checks_proto_export.h index 93117fd612412..886dd22971f89 100644 --- a/google/cloud/compute/region_health_checks/v1/region_health_checks_proto_export.h +++ b/google/cloud/compute/region_health_checks/v1/region_health_checks_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_CHECKS_V1_REGION_HEALTH_CHECKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_HEALTH_CHECKS_V1_REGION_HEALTH_CHECKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers_client.h b/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers_client.h index 9808cc7104f22..68232d353ebef 100644 --- a/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers_client.h +++ b/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers_client.h @@ -946,7 +946,7 @@ class RegionInstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_group_managers.v1.GetInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L574} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L67} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} /// // clang-format on StatusOr @@ -979,7 +979,7 @@ class RegionInstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_group_managers.v1.GetInstanceGroupManagerRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L574} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L67} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} /// // clang-format on StatusOr @@ -1159,7 +1159,7 @@ class RegionInstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ListRegionInstanceGroupManagersRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L860} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L67} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} /// // clang-format on StreamRange @@ -1201,7 +1201,7 @@ class RegionInstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ListRegionInstanceGroupManagersRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L860} - /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L67} + /// [google.cloud.cpp.compute.v1.InstanceGroupManager]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L67} /// // clang-format on StreamRange @@ -1245,7 +1245,7 @@ class RegionInstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ListErrorsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L624} - /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L495} + /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L520} /// // clang-format on StreamRange @@ -1288,7 +1288,7 @@ class RegionInstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ListErrorsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L624} - /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L495} + /// [google.cloud.cpp.compute.v1.InstanceManagedByIgmError]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L520} /// // clang-format on StreamRange @@ -1322,7 +1322,7 @@ class RegionInstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ListManagedInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L704} - /// [google.cloud.cpp.compute.v1.RegionInstanceGroupManagersListInstancesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_100.proto#L335} + /// [google.cloud.cpp.compute.v1.RegionInstanceGroupManagersListInstancesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_098.proto#L335} /// // clang-format on StatusOr @@ -1445,7 +1445,7 @@ class RegionInstanceGroupManagersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_group_managers.v1.ListPerInstanceConfigsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto#L782} - /// [google.cloud.cpp.compute.v1.PerInstanceConfig]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_029.proto#L750} + /// [google.cloud.cpp.compute.v1.PerInstanceConfig]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_028.proto#L786} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers_proto_export.h b/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers_proto_export.h index e3561a0c0f075..5fa83491275fc 100644 --- a/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers_proto_export.h +++ b/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers_proto_export.h @@ -26,11 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGERS_V1_REGION_INSTANCE_GROUP_MANAGERS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUP_MANAGERS_V1_REGION_INSTANCE_GROUP_MANAGERS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_client.h b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_client.h index 128d76c74ea32..2afad108b56b2 100644 --- a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_client.h +++ b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_client.h @@ -112,7 +112,7 @@ class RegionInstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_groups.v1.GetInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L92} - /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L34} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_057.proto#L34} /// // clang-format on StatusOr GetInstanceGroup( @@ -144,7 +144,7 @@ class RegionInstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_groups.v1.GetInstanceGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L92} - /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L34} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_057.proto#L34} /// // clang-format on StatusOr GetInstanceGroup( @@ -183,7 +183,7 @@ class RegionInstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_groups.v1.ListRegionInstanceGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L189} - /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L34} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_057.proto#L34} /// // clang-format on StreamRange @@ -225,7 +225,7 @@ class RegionInstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_groups.v1.ListRegionInstanceGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L189} - /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L34} + /// [google.cloud.cpp.compute.v1.InstanceGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_057.proto#L34} /// // clang-format on StreamRange @@ -269,7 +269,7 @@ class RegionInstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_groups.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L107} - /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L95} + /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_057.proto#L95} /// // clang-format on StreamRange @@ -317,7 +317,7 @@ class RegionInstanceGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_groups.v1.ListInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto#L107} - /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_059.proto#L95} + /// [google.cloud.cpp.compute.v1.InstanceWithNamedPorts]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_057.proto#L95} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_proto_export.h b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_proto_export.h index 4407dcf150d05..7759296ae9da5 100644 --- a/google/cloud/compute/region_instance_groups/v1/region_instance_groups_proto_export.h +++ b/google/cloud/compute/region_instance_groups/v1/region_instance_groups_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUPS_V1_REGION_INSTANCE_GROUPS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_GROUPS_V1_REGION_INSTANCE_GROUPS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_instance_templates/v1/region_instance_templates_client.h b/google/cloud/compute/region_instance_templates/v1/region_instance_templates_client.h index e9aa451bb4600..3b5d214272878 100644 --- a/google/cloud/compute/region_instance_templates/v1/region_instance_templates_client.h +++ b/google/cloud/compute/region_instance_templates/v1/region_instance_templates_client.h @@ -237,7 +237,7 @@ class RegionInstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_templates.v1.GetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L122} - /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L85} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L85} /// // clang-format on StatusOr @@ -269,7 +269,7 @@ class RegionInstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_templates.v1.GetInstanceTemplateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L122} - /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L85} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L85} /// // clang-format on StatusOr @@ -436,7 +436,7 @@ class RegionInstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_templates.v1.ListRegionInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L170} - /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L85} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L85} /// // clang-format on StreamRange @@ -478,7 +478,7 @@ class RegionInstanceTemplatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instance_templates.v1.ListRegionInstanceTemplatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto#L170} - /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_025.proto#L85} + /// [google.cloud.cpp.compute.v1.InstanceTemplate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_024.proto#L85} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_instance_templates/v1/region_instance_templates_proto_export.h b/google/cloud/compute/region_instance_templates/v1/region_instance_templates_proto_export.h index c97404fff0362..c323206b9ce6c 100644 --- a/google/cloud/compute/region_instance_templates/v1/region_instance_templates_proto_export.h +++ b/google/cloud/compute/region_instance_templates/v1/region_instance_templates_proto_export.h @@ -28,12 +28,12 @@ // IWYU pragma: begin_exports #include #include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCE_TEMPLATES_V1_REGION_INSTANCE_TEMPLATES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_instances/v1/region_instances_proto_export.h b/google/cloud/compute/region_instances/v1/region_instances_proto_export.h index 6291daeea8f35..90279e75fa2ed 100644 --- a/google/cloud/compute/region_instances/v1/region_instances_proto_export.h +++ b/google/cloud/compute/region_instances/v1/region_instances_proto_export.h @@ -28,12 +28,12 @@ // IWYU pragma: begin_exports #include #include +#include #include -#include -#include -#include -#include -#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANCES_V1_REGION_INSTANCES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots_client.h b/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots_client.h index 5f66173d7be56..86849c3f0318c 100644 --- a/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots_client.h +++ b/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots_client.h @@ -244,7 +244,7 @@ class RegionInstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instant_snapshots.v1.GetInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L198} - /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L26} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L26} /// // clang-format on StatusOr GetInstantSnapshot( @@ -276,7 +276,7 @@ class RegionInstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instant_snapshots.v1.GetInstantSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L198} - /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L26} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L26} /// // clang-format on StatusOr GetInstantSnapshot( @@ -307,7 +307,7 @@ class RegionInstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instant_snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L179} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -340,7 +340,7 @@ class RegionInstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instant_snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L179} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -503,7 +503,7 @@ class RegionInstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instant_snapshots.v1.ListRegionInstantSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L246} - /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L26} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L26} /// // clang-format on StreamRange @@ -545,7 +545,7 @@ class RegionInstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instant_snapshots.v1.ListRegionInstantSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L246} - /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_066.proto#L26} + /// [google.cloud.cpp.compute.v1.InstantSnapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_064.proto#L26} /// // clang-format on StreamRange @@ -578,7 +578,7 @@ class RegionInstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instant_snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L318} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -614,7 +614,7 @@ class RegionInstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instant_snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L318} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -773,7 +773,7 @@ class RegionInstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instant_snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L376} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -809,7 +809,7 @@ class RegionInstantSnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_instant_snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto#L376} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots_proto_export.h b/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots_proto_export.h index dda08a67dcb3a..7fe03fd7f6894 100644 --- a/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots_proto_export.h +++ b/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots_proto_export.h @@ -26,13 +26,13 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOTS_V1_REGION_INSTANT_SNAPSHOTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_INSTANT_SNAPSHOTS_V1_REGION_INSTANT_SNAPSHOTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups_client.h b/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups_client.h index c67ad9f0b5e08..12db2a8fe09b7 100644 --- a/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups_client.h +++ b/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups_client.h @@ -513,7 +513,7 @@ class RegionNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.GetNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L254} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L118} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L129} /// // clang-format on StatusOr @@ -546,7 +546,7 @@ class RegionNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.GetNetworkEndpointGroupRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L254} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L118} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L129} /// // clang-format on StatusOr @@ -718,7 +718,7 @@ class RegionNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.ListRegionNetworkEndpointGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L386} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L118} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L129} /// // clang-format on StreamRange @@ -760,7 +760,7 @@ class RegionNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.ListRegionNetworkEndpointGroupsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L386} - /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L118} + /// [google.cloud.cpp.compute.v1.NetworkEndpointGroup]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L129} /// // clang-format on StreamRange @@ -802,7 +802,7 @@ class RegionNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.ListNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L306} - /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L529} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L540} /// // clang-format on StreamRange @@ -844,7 +844,7 @@ class RegionNetworkEndpointGroupsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_endpoint_groups.v1.ListNetworkEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto#L306} - /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L529} + /// [google.cloud.cpp.compute.v1.NetworkEndpointWithHealthStatus]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_012.proto#L540} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups_proto_export.h b/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups_proto_export.h index c6c0c6ae9527b..53f5b66a8f8c7 100644 --- a/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups_proto_export.h +++ b/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_NETWORK_ENDPOINT_GROUPS_V1_REGION_NETWORK_ENDPOINT_GROUPS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_NETWORK_ENDPOINT_GROUPS_V1_REGION_NETWORK_ENDPOINT_GROUPS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies_client.h b/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies_client.h index 422585a1b4938..d4873e133f460 100644 --- a/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies_client.h +++ b/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies_client.h @@ -607,7 +607,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L439} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -639,7 +639,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.GetFirewallPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L439} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} /// // clang-format on StatusOr GetFirewallPolicy( @@ -669,7 +669,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L406} - /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L111} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L111} /// // clang-format on StatusOr @@ -701,7 +701,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.GetAssociationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L406} - /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L111} + /// [google.cloud.cpp.compute.v1.FirewallPolicyAssociation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L111} /// // clang-format on StatusOr @@ -731,7 +731,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.GetEffectiveFirewallsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L424} - /// [google.cloud.cpp.compute.v1.RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_102.proto#L27} + /// [google.cloud.cpp.compute.v1.RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_100.proto#L27} /// // clang-format on StatusOr GetIamPolicy( @@ -830,7 +830,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L454} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -860,7 +860,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L473} - /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L26} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L26} /// // clang-format on StatusOr GetRule( @@ -892,7 +892,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L473} - /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_039.proto#L26} + /// [google.cloud.cpp.compute.v1.FirewallPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L26} /// // clang-format on StatusOr GetRule( @@ -1056,7 +1056,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.ListRegionNetworkFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L524} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} /// // clang-format on StreamRange @@ -1099,7 +1099,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.ListRegionNetworkFirewallPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L524} - /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_038.proto#L27} + /// [google.cloud.cpp.compute.v1.FirewallPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_037.proto#L27} /// // clang-format on StreamRange @@ -1625,7 +1625,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L745} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1661,7 +1661,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L745} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1692,7 +1692,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L765} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1728,7 +1728,7 @@ class RegionNetworkFirewallPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_network_firewall_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto#L765} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies_proto_export.h b/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies_proto_export.h index d385054131eea..4a8b59f6b02f3 100644 --- a/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies_proto_export.h +++ b/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies_proto_export.h @@ -26,15 +26,15 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_NETWORK_FIREWALL_POLICIES_V1_REGION_NETWORK_FIREWALL_POLICIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include +#include +#include +#include +#include +#include #include -#include +#include #include -#include -#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_NETWORK_FIREWALL_POLICIES_V1_REGION_NETWORK_FIREWALL_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_client.h b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_client.h index 9bb0a34f78807..4b684ed3cd74c 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_client.h +++ b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_client.h @@ -241,7 +241,7 @@ class RegionNotificationEndpointsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_notification_endpoints.v1.GetNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L124} - /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_086.proto#L30} + /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L30} /// // clang-format on StatusOr @@ -274,7 +274,7 @@ class RegionNotificationEndpointsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_notification_endpoints.v1.GetNotificationEndpointRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L124} - /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_086.proto#L30} + /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L30} /// // clang-format on StatusOr @@ -443,7 +443,7 @@ class RegionNotificationEndpointsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_notification_endpoints.v1.ListRegionNotificationEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L174} - /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_086.proto#L30} + /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L30} /// // clang-format on StreamRange @@ -484,7 +484,7 @@ class RegionNotificationEndpointsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_notification_endpoints.v1.ListRegionNotificationEndpointsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto#L174} - /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_086.proto#L30} + /// [google.cloud.cpp.compute.v1.NotificationEndpoint]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_084.proto#L30} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_proto_export.h b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_proto_export.h index 24e451306a64e..6b0d8d2b6f75f 100644 --- a/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_proto_export.h +++ b/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_NOTIFICATION_ENDPOINTS_V1_REGION_NOTIFICATION_ENDPOINTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_NOTIFICATION_ENDPOINTS_V1_REGION_NOTIFICATION_ENDPOINTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_operations/v1/region_operations_client.h b/google/cloud/compute/region_operations/v1/region_operations_client.h index 2a87d77defc36..e5955c0b26689 100644 --- a/google/cloud/compute/region_operations/v1/region_operations_client.h +++ b/google/cloud/compute/region_operations/v1/region_operations_client.h @@ -165,7 +165,7 @@ class RegionOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L109} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StatusOr GetOperation( @@ -197,7 +197,7 @@ class RegionOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L109} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StatusOr GetOperation( @@ -236,7 +236,7 @@ class RegionOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_operations.v1.ListRegionOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L131} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StreamRange ListRegionOperations( @@ -277,7 +277,7 @@ class RegionOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_operations.v1.ListRegionOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L131} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StreamRange ListRegionOperations( @@ -318,7 +318,7 @@ class RegionOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L203} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StatusOr Wait( @@ -360,7 +360,7 @@ class RegionOperationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_operations/v1/region_operations.proto#L203} - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// // clang-format on StatusOr Wait( diff --git a/google/cloud/compute/region_operations/v1/region_operations_proto_export.h b/google/cloud/compute/region_operations/v1/region_operations_proto_export.h index 81cab62ebc0ce..aaf2fda93d554 100644 --- a/google/cloud/compute/region_operations/v1/region_operations_proto_export.h +++ b/google/cloud/compute/region_operations/v1/region_operations_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_OPERATIONS_V1_REGION_OPERATIONS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_OPERATIONS_V1_REGION_OPERATIONS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_security_policies/v1/region_security_policies_client.h b/google/cloud/compute/region_security_policies/v1/region_security_policies_client.h index a1e9400f107d6..58c508740d4a8 100644 --- a/google/cloud/compute/region_security_policies/v1/region_security_policies_client.h +++ b/google/cloud/compute/region_security_policies/v1/region_security_policies_client.h @@ -360,7 +360,7 @@ class RegionSecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_security_policies.v1.GetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L232} - /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L29} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L29} /// // clang-format on StatusOr GetSecurityPolicy( @@ -392,7 +392,7 @@ class RegionSecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_security_policies.v1.GetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L232} - /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L29} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L29} /// // clang-format on StatusOr GetSecurityPolicy( @@ -422,7 +422,7 @@ class RegionSecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_security_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L214} - /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L368} + /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L368} /// // clang-format on StatusOr GetRule( @@ -454,7 +454,7 @@ class RegionSecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_security_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L214} - /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L368} + /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L368} /// // clang-format on StatusOr GetRule( @@ -619,7 +619,7 @@ class RegionSecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_security_policies.v1.ListRegionSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L283} - /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L29} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L29} /// // clang-format on StreamRange @@ -661,7 +661,7 @@ class RegionSecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_security_policies.v1.ListRegionSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_security_policies/v1/region_security_policies.proto#L283} - /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L29} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L29} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_security_policies/v1/region_security_policies_proto_export.h b/google/cloud/compute/region_security_policies/v1/region_security_policies_proto_export.h index c8117f9eb31a1..fb5ecb6431239 100644 --- a/google/cloud/compute/region_security_policies/v1/region_security_policies_proto_export.h +++ b/google/cloud/compute/region_security_policies/v1/region_security_policies_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SECURITY_POLICIES_V1_REGION_SECURITY_POLICIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SECURITY_POLICIES_V1_REGION_SECURITY_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates_client.h b/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates_client.h index 43faa7a5bd51e..0e93e28ef61ee 100644 --- a/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates_client.h +++ b/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates_client.h @@ -234,7 +234,7 @@ class RegionSslCertificatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_ssl_certificates.v1.GetSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L122} - /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_119.proto#L39} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L39} /// // clang-format on StatusOr GetSslCertificate( @@ -267,7 +267,7 @@ class RegionSslCertificatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_ssl_certificates.v1.GetSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L122} - /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_119.proto#L39} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L39} /// // clang-format on StatusOr GetSslCertificate( @@ -432,7 +432,7 @@ class RegionSslCertificatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_ssl_certificates.v1.ListRegionSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L170} - /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_119.proto#L39} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L39} /// // clang-format on StreamRange @@ -474,7 +474,7 @@ class RegionSslCertificatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_ssl_certificates.v1.ListRegionSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto#L170} - /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_119.proto#L39} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L39} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates_proto_export.h b/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates_proto_export.h index 58caee5852f6d..97b06cbcc2294 100644 --- a/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates_proto_export.h +++ b/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SSL_CERTIFICATES_V1_REGION_SSL_CERTIFICATES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SSL_CERTIFICATES_V1_REGION_SSL_CERTIFICATES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies_client.h b/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies_client.h index 865216e82f82f..1d7d4f4d281ab 100644 --- a/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies_client.h +++ b/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies_client.h @@ -235,7 +235,7 @@ class RegionSslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_ssl_policies.v1.GetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L147} - /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L138} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L138} /// // clang-format on StatusOr GetSslPolicy( @@ -267,7 +267,7 @@ class RegionSslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_ssl_policies.v1.GetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L147} - /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L138} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L138} /// // clang-format on StatusOr GetSslPolicy( @@ -429,7 +429,7 @@ class RegionSslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_ssl_policies.v1.ListRegionSslPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L268} - /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L138} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L138} /// // clang-format on StreamRange ListRegionSslPolicies( @@ -470,7 +470,7 @@ class RegionSslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_ssl_policies.v1.ListRegionSslPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L268} - /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L138} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L138} /// // clang-format on StreamRange ListRegionSslPolicies( @@ -500,7 +500,7 @@ class RegionSslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_ssl_policies.v1.ListAvailableFeaturesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L196} - /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L130} + /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L130} /// // clang-format on StatusOr< @@ -534,7 +534,7 @@ class RegionSslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_ssl_policies.v1.ListAvailableFeaturesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto#L196} - /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L130} + /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L130} /// // clang-format on StatusOr< diff --git a/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies_proto_export.h b/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies_proto_export.h index 4f57596fc1965..56ba6d48e15eb 100644 --- a/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies_proto_export.h +++ b/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SSL_POLICIES_V1_REGION_SSL_POLICIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_SSL_POLICIES_V1_REGION_SSL_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies_client.h b/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies_client.h index 404e21ddee336..e31730b85bc00 100644 --- a/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies_client.h +++ b/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies_client.h @@ -235,7 +235,7 @@ class RegionTargetHttpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_http_proxies.v1.GetTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L135} - /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L36} /// // clang-format on StatusOr GetTargetHttpProxy( @@ -267,7 +267,7 @@ class RegionTargetHttpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_http_proxies.v1.GetTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L135} - /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L36} /// // clang-format on StatusOr GetTargetHttpProxy( @@ -433,7 +433,7 @@ class RegionTargetHttpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_http_proxies.v1.ListRegionTargetHttpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L183} - /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L36} /// // clang-format on StreamRange @@ -475,7 +475,7 @@ class RegionTargetHttpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_http_proxies.v1.ListRegionTargetHttpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto#L183} - /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L36} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies_proto_export.h b/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies_proto_export.h index 04b374108face..dc4708cea6d19 100644 --- a/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies_proto_export.h +++ b/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_TARGET_HTTP_PROXIES_V1_REGION_TARGET_HTTP_PROXIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_TARGET_HTTP_PROXIES_V1_REGION_TARGET_HTTP_PROXIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies_client.h b/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies_client.h index 75bf0744bb13a..5b07b5427319c 100644 --- a/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies_client.h +++ b/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies_client.h @@ -236,7 +236,7 @@ class RegionTargetHttpsProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_https_proxies.v1.GetTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L164} - /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} /// // clang-format on StatusOr @@ -268,7 +268,7 @@ class RegionTargetHttpsProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_https_proxies.v1.GetTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L164} - /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} /// // clang-format on StatusOr @@ -435,7 +435,7 @@ class RegionTargetHttpsProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_https_proxies.v1.ListRegionTargetHttpsProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L212} - /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} /// // clang-format on StreamRange @@ -477,7 +477,7 @@ class RegionTargetHttpsProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_https_proxies.v1.ListRegionTargetHttpsProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto#L212} - /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies_proto_export.h b/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies_proto_export.h index 2a6698e632e12..e3118afd6a27b 100644 --- a/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies_proto_export.h +++ b/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_TARGET_HTTPS_PROXIES_V1_REGION_TARGET_HTTPS_PROXIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_TARGET_HTTPS_PROXIES_V1_REGION_TARGET_HTTPS_PROXIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies_client.h b/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies_client.h index 93ba5c048c515..7a2bb356864cc 100644 --- a/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies_client.h +++ b/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies_client.h @@ -233,7 +233,7 @@ class RegionTargetTcpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_tcp_proxies.v1.GetTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto#L121} - /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L28} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L28} /// // clang-format on StatusOr GetTargetTcpProxy( @@ -265,7 +265,7 @@ class RegionTargetTcpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_tcp_proxies.v1.GetTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto#L121} - /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L28} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L28} /// // clang-format on StatusOr GetTargetTcpProxy( @@ -430,7 +430,7 @@ class RegionTargetTcpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_tcp_proxies.v1.ListRegionTargetTcpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto#L169} - /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L28} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L28} /// // clang-format on StreamRange @@ -472,7 +472,7 @@ class RegionTargetTcpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_target_tcp_proxies.v1.ListRegionTargetTcpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto#L169} - /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L28} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L28} /// // clang-format on StreamRange diff --git a/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies_proto_export.h b/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies_proto_export.h index a1fde35ca633c..eab4b6eb65eb4 100644 --- a/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies_proto_export.h +++ b/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_TARGET_TCP_PROXIES_V1_REGION_TARGET_TCP_PROXIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_TARGET_TCP_PROXIES_V1_REGION_TARGET_TCP_PROXIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_url_maps/v1/region_url_maps_client.h b/google/cloud/compute/region_url_maps/v1/region_url_maps_client.h index 37ad72bb6a031..48362d730115d 100644 --- a/google/cloud/compute/region_url_maps/v1/region_url_maps_client.h +++ b/google/cloud/compute/region_url_maps/v1/region_url_maps_client.h @@ -228,7 +228,7 @@ class RegionUrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_url_maps.v1.GetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L155} - /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L867} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L867} /// // clang-format on StatusOr GetUrlMap( @@ -260,7 +260,7 @@ class RegionUrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_url_maps.v1.GetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L155} - /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L867} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L867} /// // clang-format on StatusOr GetUrlMap( @@ -422,7 +422,7 @@ class RegionUrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_url_maps.v1.ListRegionUrlMapsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L195} - /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L867} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L867} /// // clang-format on StreamRange ListRegionUrlMaps( @@ -463,7 +463,7 @@ class RegionUrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_url_maps.v1.ListRegionUrlMapsRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L195} - /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L867} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L867} /// // clang-format on StreamRange ListRegionUrlMaps( @@ -750,7 +750,7 @@ class RegionUrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_url_maps.v1.ValidateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L325} - /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L1163} + /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L1163} /// // clang-format on StatusOr Validate( @@ -787,7 +787,7 @@ class RegionUrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_url_maps.v1.ValidateRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_url_maps/v1/region_url_maps.proto#L325} - /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L1163} + /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L1163} /// // clang-format on StatusOr Validate( diff --git a/google/cloud/compute/region_url_maps/v1/region_url_maps_proto_export.h b/google/cloud/compute/region_url_maps/v1/region_url_maps_proto_export.h index c1a6f20aa8f14..dac332e92275f 100644 --- a/google/cloud/compute/region_url_maps/v1/region_url_maps_proto_export.h +++ b/google/cloud/compute/region_url_maps/v1/region_url_maps_proto_export.h @@ -26,11 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_URL_MAPS_V1_REGION_URL_MAPS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_URL_MAPS_V1_REGION_URL_MAPS_PROTO_EXPORT_H diff --git a/google/cloud/compute/region_zones/v1/region_zones_client.h b/google/cloud/compute/region_zones/v1/region_zones_client.h index 4e6ab6060f688..bacc6557b8947 100644 --- a/google/cloud/compute/region_zones/v1/region_zones_client.h +++ b/google/cloud/compute/region_zones/v1/region_zones_client.h @@ -117,7 +117,7 @@ class RegionZonesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_zones.v1.ListRegionZonesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_zones/v1/region_zones.proto#L51} - /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_144.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L29} /// // clang-format on StreamRange ListRegionZones( @@ -158,7 +158,7 @@ class RegionZonesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.region_zones.v1.ListRegionZonesRequest]: @cloud_cpp_reference_link{google/cloud/compute/region_zones/v1/region_zones.proto#L51} - /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_144.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L29} /// // clang-format on StreamRange ListRegionZones( diff --git a/google/cloud/compute/region_zones/v1/region_zones_proto_export.h b/google/cloud/compute/region_zones/v1/region_zones_proto_export.h index 5295fa2dce6ce..9bd702f5c6b45 100644 --- a/google/cloud/compute/region_zones/v1/region_zones_proto_export.h +++ b/google/cloud/compute/region_zones/v1/region_zones_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_ZONES_V1_REGION_ZONES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGION_ZONES_V1_REGION_ZONES_PROTO_EXPORT_H diff --git a/google/cloud/compute/regions/v1/regions_client.h b/google/cloud/compute/regions/v1/regions_client.h index e5ee86544a8d1..ac10c796e354b 100644 --- a/google/cloud/compute/regions/v1/regions_client.h +++ b/google/cloud/compute/regions/v1/regions_client.h @@ -117,7 +117,7 @@ class RegionsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.regions.v1.GetRegionRequest]: @cloud_cpp_reference_link{google/cloud/compute/regions/v1/regions.proto#L84} - /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_095.proto#L29} + /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_093.proto#L29} /// // clang-format on StatusOr GetRegion( @@ -160,7 +160,7 @@ class RegionsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.regions.v1.GetRegionRequest]: @cloud_cpp_reference_link{google/cloud/compute/regions/v1/regions.proto#L84} - /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_095.proto#L29} + /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_093.proto#L29} /// // clang-format on StatusOr GetRegion( @@ -209,7 +209,7 @@ class RegionsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.regions.v1.ListRegionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/regions/v1/regions.proto#L95} - /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_095.proto#L29} + /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_093.proto#L29} /// // clang-format on StreamRange ListRegions( @@ -262,7 +262,7 @@ class RegionsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.regions.v1.ListRegionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/regions/v1/regions.proto#L95} - /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_095.proto#L29} + /// [google.cloud.cpp.compute.v1.Region]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_093.proto#L29} /// // clang-format on StreamRange ListRegions( diff --git a/google/cloud/compute/regions/v1/regions_proto_export.h b/google/cloud/compute/regions/v1/regions_proto_export.h index 9f26f18b1495a..f5adb3ce2aea6 100644 --- a/google/cloud/compute/regions/v1/regions_proto_export.h +++ b/google/cloud/compute/regions/v1/regions_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGIONS_V1_REGIONS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_REGIONS_V1_REGIONS_PROTO_EXPORT_H diff --git a/google/cloud/compute/reservations/v1/reservations_client.h b/google/cloud/compute/reservations/v1/reservations_client.h index 927e551f218e7..ad46c9dade880 100644 --- a/google/cloud/compute/reservations/v1/reservations_client.h +++ b/google/cloud/compute/reservations/v1/reservations_client.h @@ -118,7 +118,7 @@ class ReservationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.reservations.v1.AggregatedListReservationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L164} - /// [google.cloud.cpp.compute.v1.ReservationsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_107.proto#L248} + /// [google.cloud.cpp.compute.v1.ReservationsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_105.proto#L248} /// // clang-format on StreamRange GetReservation( @@ -342,7 +342,7 @@ class ReservationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.reservations.v1.GetReservationRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L297} - /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_006.proto#L116} + /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_006.proto#L153} /// // clang-format on StatusOr GetReservation( @@ -373,7 +373,7 @@ class ReservationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.reservations.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L279} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -406,7 +406,7 @@ class ReservationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.reservations.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L279} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -569,7 +569,7 @@ class ReservationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.reservations.v1.ListReservationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L344} - /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_006.proto#L116} + /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_006.proto#L153} /// // clang-format on StreamRange ListReservations( @@ -610,7 +610,7 @@ class ReservationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.reservations.v1.ListReservationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L344} - /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_006.proto#L116} + /// [google.cloud.cpp.compute.v1.Reservation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_006.proto#L153} /// // clang-format on StreamRange ListReservations( @@ -770,7 +770,7 @@ class ReservationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.reservations.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L453} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -806,7 +806,7 @@ class ReservationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.reservations.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L453} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -837,7 +837,7 @@ class ReservationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.reservations.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L471} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -873,7 +873,7 @@ class ReservationsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.reservations.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/reservations/v1/reservations.proto#L471} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/reservations/v1/reservations_proto_export.h b/google/cloud/compute/reservations/v1/reservations_proto_export.h index 315bf96cd8660..dfbe880310f7a 100644 --- a/google/cloud/compute/reservations/v1/reservations_proto_export.h +++ b/google/cloud/compute/reservations/v1/reservations_proto_export.h @@ -29,13 +29,12 @@ #include #include #include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESERVATIONS_V1_RESERVATIONS_PROTO_EXPORT_H diff --git a/google/cloud/compute/resource_policies/v1/resource_policies_client.h b/google/cloud/compute/resource_policies/v1/resource_policies_client.h index 2571b07064c50..ed833aa1e84b3 100644 --- a/google/cloud/compute/resource_policies/v1/resource_policies_client.h +++ b/google/cloud/compute/resource_policies/v1/resource_policies_client.h @@ -120,7 +120,7 @@ class ResourcePoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.resource_policies.v1.AggregatedListResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L151} - /// [google.cloud.cpp.compute.v1.ResourcePoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_108.proto#L24} + /// [google.cloud.cpp.compute.v1.ResourcePoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_106.proto#L24} /// // clang-format on StreamRange GetResourcePolicy( @@ -347,7 +347,7 @@ class ResourcePoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.resource_policies.v1.GetResourcePolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L285} - /// [google.cloud.cpp.compute.v1.ResourcePolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_108.proto#L118} + /// [google.cloud.cpp.compute.v1.ResourcePolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_106.proto#L118} /// // clang-format on StatusOr GetResourcePolicy( @@ -378,7 +378,7 @@ class ResourcePoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.resource_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L266} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -411,7 +411,7 @@ class ResourcePoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.resource_policies.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L266} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -574,7 +574,7 @@ class ResourcePoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.resource_policies.v1.ListResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L333} - /// [google.cloud.cpp.compute.v1.ResourcePolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_108.proto#L118} + /// [google.cloud.cpp.compute.v1.ResourcePolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_106.proto#L118} /// // clang-format on StreamRange @@ -616,7 +616,7 @@ class ResourcePoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.resource_policies.v1.ListResourcePoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L333} - /// [google.cloud.cpp.compute.v1.ResourcePolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_108.proto#L118} + /// [google.cloud.cpp.compute.v1.ResourcePolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_106.proto#L118} /// // clang-format on StreamRange @@ -777,7 +777,7 @@ class ResourcePoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.resource_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L445} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -813,7 +813,7 @@ class ResourcePoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.resource_policies.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L445} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -844,7 +844,7 @@ class ResourcePoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.resource_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L465} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -880,7 +880,7 @@ class ResourcePoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.resource_policies.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/resource_policies/v1/resource_policies.proto#L465} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/resource_policies/v1/resource_policies_proto_export.h b/google/cloud/compute/resource_policies/v1/resource_policies_proto_export.h index d8116b6618b33..9c66f696bf913 100644 --- a/google/cloud/compute/resource_policies/v1/resource_policies_proto_export.h +++ b/google/cloud/compute/resource_policies/v1/resource_policies_proto_export.h @@ -26,12 +26,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESOURCE_POLICIES_V1_RESOURCE_POLICIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_RESOURCE_POLICIES_V1_RESOURCE_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/routers/v1/routers_client.h b/google/cloud/compute/routers/v1/routers_client.h index c040ff182e394..e7e0072111c1b 100644 --- a/google/cloud/compute/routers/v1/routers_client.h +++ b/google/cloud/compute/routers/v1/routers_client.h @@ -116,7 +116,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.AggregatedListRoutersRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L170} - /// [google.cloud.cpp.compute.v1.RoutersScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L1256} + /// [google.cloud.cpp.compute.v1.RoutersScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1256} /// // clang-format on StreamRange GetRouter( @@ -341,7 +341,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.GetRouterRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L387} - /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L255} + /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L255} /// // clang-format on StatusOr GetRouter( @@ -371,7 +371,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.GetNatIpInfoRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L285} - /// [google.cloud.cpp.compute.v1.NatIpInfoResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L218} + /// [google.cloud.cpp.compute.v1.NatIpInfoResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L218} /// // clang-format on StatusOr GetNatIpInfo( @@ -403,7 +403,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.GetNatIpInfoRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L285} - /// [google.cloud.cpp.compute.v1.NatIpInfoResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L218} + /// [google.cloud.cpp.compute.v1.NatIpInfoResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L218} /// // clang-format on StatusOr GetNatIpInfo( @@ -434,7 +434,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.GetNatMappingInfoRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L305} - /// [google.cloud.cpp.compute.v1.VmEndpointNatMappingsList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L1421} + /// [google.cloud.cpp.compute.v1.VmEndpointNatMappingsList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1421} /// // clang-format on StatusOr @@ -466,7 +466,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.GetNatMappingInfoRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L305} - /// [google.cloud.cpp.compute.v1.VmEndpointNatMappingsList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L1421} + /// [google.cloud.cpp.compute.v1.VmEndpointNatMappingsList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1421} /// // clang-format on StatusOr @@ -497,7 +497,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.GetRouterStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L402} - /// [google.cloud.cpp.compute.v1.RouterStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L1244} + /// [google.cloud.cpp.compute.v1.RouterStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1244} /// // clang-format on StatusOr @@ -529,7 +529,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.GetRouterStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L402} - /// [google.cloud.cpp.compute.v1.RouterStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L1244} + /// [google.cloud.cpp.compute.v1.RouterStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1244} /// // clang-format on StatusOr @@ -691,7 +691,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.ListRoutersRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L450} - /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L255} + /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L255} /// // clang-format on StreamRange ListRouters( @@ -731,7 +731,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.ListRoutersRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L450} - /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L255} + /// [google.cloud.cpp.compute.v1.Router]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L255} /// // clang-format on StreamRange ListRouters( @@ -890,7 +890,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.PreviewRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L559} - /// [google.cloud.cpp.compute.v1.RoutersPreviewResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L1251} + /// [google.cloud.cpp.compute.v1.RoutersPreviewResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1251} /// // clang-format on StatusOr Preview( @@ -925,7 +925,7 @@ class RoutersClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routers.v1.PreviewRequest]: @cloud_cpp_reference_link{google/cloud/compute/routers/v1/routers.proto#L559} - /// [google.cloud.cpp.compute.v1.RoutersPreviewResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_014.proto#L1251} + /// [google.cloud.cpp.compute.v1.RoutersPreviewResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_013.proto#L1251} /// // clang-format on StatusOr Preview( diff --git a/google/cloud/compute/routers/v1/routers_proto_export.h b/google/cloud/compute/routers/v1/routers_proto_export.h index f348d491a2f63..98b1a41f76bad 100644 --- a/google/cloud/compute/routers/v1/routers_proto_export.h +++ b/google/cloud/compute/routers/v1/routers_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROUTERS_V1_ROUTERS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROUTERS_V1_ROUTERS_PROTO_EXPORT_H diff --git a/google/cloud/compute/routes/v1/routes_client.h b/google/cloud/compute/routes/v1/routes_client.h index 02ba14bb2894d..f05789daa3a5f 100644 --- a/google/cloud/compute/routes/v1/routes_client.h +++ b/google/cloud/compute/routes/v1/routes_client.h @@ -223,7 +223,7 @@ class RoutesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routes.v1.GetRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L112} - /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L27} + /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_107.proto#L27} /// // clang-format on StatusOr GetRoute( @@ -254,7 +254,7 @@ class RoutesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routes.v1.GetRouteRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L112} - /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L27} + /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_107.proto#L27} /// // clang-format on StatusOr GetRoute( @@ -412,7 +412,7 @@ class RoutesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routes.v1.ListRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L149} - /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L27} + /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_107.proto#L27} /// // clang-format on StreamRange ListRoutes( @@ -452,7 +452,7 @@ class RoutesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.routes.v1.ListRoutesRequest]: @cloud_cpp_reference_link{google/cloud/compute/routes/v1/routes.proto#L149} - /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L27} + /// [google.cloud.cpp.compute.v1.Route]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_107.proto#L27} /// // clang-format on StreamRange ListRoutes( diff --git a/google/cloud/compute/routes/v1/routes_proto_export.h b/google/cloud/compute/routes/v1/routes_proto_export.h index e0d3a4765d3fb..e56759c5f34f7 100644 --- a/google/cloud/compute/routes/v1/routes_proto_export.h +++ b/google/cloud/compute/routes/v1/routes_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROUTES_V1_ROUTES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ROUTES_V1_ROUTES_PROTO_EXPORT_H diff --git a/google/cloud/compute/security_policies/v1/security_policies_client.h b/google/cloud/compute/security_policies/v1/security_policies_client.h index 87d457ecfb857..9056ca15a36ce 100644 --- a/google/cloud/compute/security_policies/v1/security_policies_client.h +++ b/google/cloud/compute/security_policies/v1/security_policies_client.h @@ -244,7 +244,7 @@ class SecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.security_policies.v1.AggregatedListSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L212} - /// [google.cloud.cpp.compute.v1.SecurityPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L147} + /// [google.cloud.cpp.compute.v1.SecurityPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_088.proto#L147} /// // clang-format on StreamRange GetSecurityPolicy( @@ -469,7 +469,7 @@ class SecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.security_policies.v1.GetSecurityPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L334} - /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L29} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L29} /// // clang-format on StatusOr GetSecurityPolicy( @@ -498,7 +498,7 @@ class SecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.security_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L320} - /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L368} + /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L368} /// // clang-format on StatusOr GetRule( @@ -530,7 +530,7 @@ class SecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.security_policies.v1.GetRuleRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L320} - /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L368} + /// [google.cloud.cpp.compute.v1.SecurityPolicyRule]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L368} /// // clang-format on StatusOr GetRule( @@ -692,7 +692,7 @@ class SecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.security_policies.v1.ListSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L442} - /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L29} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L29} /// // clang-format on StreamRange @@ -732,7 +732,7 @@ class SecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.security_policies.v1.ListSecurityPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L442} - /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L29} + /// [google.cloud.cpp.compute.v1.SecurityPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_109.proto#L29} /// // clang-format on StreamRange @@ -761,7 +761,7 @@ class SecurityPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.security_policies.v1.ListPreconfiguredExpressionSetsRequest]: @cloud_cpp_reference_link{google/cloud/compute/security_policies/v1/security_policies.proto#L374} - /// [google.cloud.cpp.compute.v1.SecurityPoliciesListPreconfiguredExpressionSetsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_090.proto#L142} + /// [google.cloud.cpp.compute.v1.SecurityPoliciesListPreconfiguredExpressionSetsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_088.proto#L142} /// // clang-format on StatusOr -#include -#include -#include -#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SECURITY_POLICIES_V1_SECURITY_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/service_attachments/v1/service_attachments_client.h b/google/cloud/compute/service_attachments/v1/service_attachments_client.h index 0fe565218b4b1..7bb0abee09257 100644 --- a/google/cloud/compute/service_attachments/v1/service_attachments_client.h +++ b/google/cloud/compute/service_attachments/v1/service_attachments_client.h @@ -121,7 +121,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.AggregatedListServiceAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L153} - /// [google.cloud.cpp.compute.v1.ServiceAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L389} + /// [google.cloud.cpp.compute.v1.ServiceAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L407} /// // clang-format on StreamRange< @@ -166,7 +166,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.AggregatedListServiceAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L153} - /// [google.cloud.cpp.compute.v1.ServiceAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L389} + /// [google.cloud.cpp.compute.v1.ServiceAttachmentsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L407} /// // clang-format on StreamRange< @@ -320,7 +320,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.GetServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L287} - /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L28} + /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L28} /// // clang-format on StatusOr @@ -353,7 +353,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.GetServiceAttachmentRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L287} - /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L28} + /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L28} /// // clang-format on StatusOr @@ -384,7 +384,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L268} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -417,7 +417,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L268} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -582,7 +582,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.ListServiceAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L335} - /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L28} + /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L28} /// // clang-format on StreamRange @@ -623,7 +623,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.ListServiceAttachmentsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L335} - /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_113.proto#L28} + /// [google.cloud.cpp.compute.v1.ServiceAttachment]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_111.proto#L28} /// // clang-format on StreamRange @@ -788,7 +788,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L445} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -824,7 +824,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L445} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -855,7 +855,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L465} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -891,7 +891,7 @@ class ServiceAttachmentsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.service_attachments.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/service_attachments/v1/service_attachments.proto#L465} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/service_attachments/v1/service_attachments_proto_export.h b/google/cloud/compute/service_attachments/v1/service_attachments_proto_export.h index 7e5c50e428fc9..15e0ad0026882 100644 --- a/google/cloud/compute/service_attachments/v1/service_attachments_proto_export.h +++ b/google/cloud/compute/service_attachments/v1/service_attachments_proto_export.h @@ -26,12 +26,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SERVICE_ATTACHMENTS_V1_SERVICE_ATTACHMENTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SERVICE_ATTACHMENTS_V1_SERVICE_ATTACHMENTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/snapshot_settings/v1/snapshot_settings_client.h b/google/cloud/compute/snapshot_settings/v1/snapshot_settings_client.h index c9970d97c4518..1aa953db5664c 100644 --- a/google/cloud/compute/snapshot_settings/v1/snapshot_settings_client.h +++ b/google/cloud/compute/snapshot_settings/v1/snapshot_settings_client.h @@ -108,7 +108,7 @@ class SnapshotSettingsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshot_settings.v1.GetSnapshotSettingsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshot_settings/v1/snapshot_settings.proto#L65} - /// [google.cloud.cpp.compute.v1.SnapshotSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_118.proto#L24} + /// [google.cloud.cpp.compute.v1.SnapshotSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_116.proto#L24} /// // clang-format on StatusOr @@ -139,7 +139,7 @@ class SnapshotSettingsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshot_settings.v1.GetSnapshotSettingsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshot_settings/v1/snapshot_settings.proto#L65} - /// [google.cloud.cpp.compute.v1.SnapshotSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_118.proto#L24} + /// [google.cloud.cpp.compute.v1.SnapshotSettings]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_116.proto#L24} /// // clang-format on StatusOr diff --git a/google/cloud/compute/snapshot_settings/v1/snapshot_settings_proto_export.h b/google/cloud/compute/snapshot_settings/v1/snapshot_settings_proto_export.h index 2bce40672e565..25c44eba1a513 100644 --- a/google/cloud/compute/snapshot_settings/v1/snapshot_settings_proto_export.h +++ b/google/cloud/compute/snapshot_settings/v1/snapshot_settings_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SNAPSHOT_SETTINGS_V1_SNAPSHOT_SETTINGS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SNAPSHOT_SETTINGS_V1_SNAPSHOT_SETTINGS_PROTO_EXPORT_H diff --git a/google/cloud/compute/snapshots/v1/snapshots_client.h b/google/cloud/compute/snapshots/v1/snapshots_client.h index 8d301d94a8d90..7dde8aef707cb 100644 --- a/google/cloud/compute/snapshots/v1/snapshots_client.h +++ b/google/cloud/compute/snapshots/v1/snapshots_client.h @@ -233,7 +233,7 @@ class SnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshots.v1.GetSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L189} - /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_116.proto#L29} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_114.proto#L29} /// // clang-format on StatusOr GetSnapshot( @@ -265,7 +265,7 @@ class SnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshots.v1.GetSnapshotRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L189} - /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_116.proto#L29} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_114.proto#L29} /// // clang-format on StatusOr GetSnapshot( @@ -295,7 +295,7 @@ class SnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L174} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -328,7 +328,7 @@ class SnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshots.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L174} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -492,7 +492,7 @@ class SnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshots.v1.ListSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L226} - /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_116.proto#L29} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_114.proto#L29} /// // clang-format on StreamRange ListSnapshots( @@ -533,7 +533,7 @@ class SnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshots.v1.ListSnapshotsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L226} - /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_116.proto#L29} + /// [google.cloud.cpp.compute.v1.Snapshot]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_114.proto#L29} /// // clang-format on StreamRange ListSnapshots( @@ -563,7 +563,7 @@ class SnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L294} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -598,7 +598,7 @@ class SnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshots.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L294} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -753,7 +753,7 @@ class SnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L329} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -788,7 +788,7 @@ class SnapshotsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.snapshots.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/snapshots/v1/snapshots.proto#L329} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/snapshots/v1/snapshots_proto_export.h b/google/cloud/compute/snapshots/v1/snapshots_proto_export.h index 3038552d904e0..038f05e7b21ed 100644 --- a/google/cloud/compute/snapshots/v1/snapshots_proto_export.h +++ b/google/cloud/compute/snapshots/v1/snapshots_proto_export.h @@ -26,15 +26,15 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SNAPSHOTS_V1_SNAPSHOTS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SNAPSHOTS_V1_SNAPSHOTS_PROTO_EXPORT_H diff --git a/google/cloud/compute/ssl_certificates/v1/ssl_certificates_client.h b/google/cloud/compute/ssl_certificates/v1/ssl_certificates_client.h index ddf233cdd82da..42236f54331e7 100644 --- a/google/cloud/compute/ssl_certificates/v1/ssl_certificates_client.h +++ b/google/cloud/compute/ssl_certificates/v1/ssl_certificates_client.h @@ -119,7 +119,7 @@ class SslCertificatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.ssl_certificates.v1.AggregatedListSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L100} - /// [google.cloud.cpp.compute.v1.SslCertificatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L135} + /// [google.cloud.cpp.compute.v1.SslCertificatesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_118.proto#L135} /// // clang-format on StreamRange GetSslCertificate( @@ -344,7 +344,7 @@ class SslCertificatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.ssl_certificates.v1.GetSslCertificateRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L208} - /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_119.proto#L39} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L39} /// // clang-format on StatusOr GetSslCertificate( @@ -507,7 +507,7 @@ class SslCertificatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.ssl_certificates.v1.ListSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L245} - /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_119.proto#L39} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L39} /// // clang-format on StreamRange @@ -548,7 +548,7 @@ class SslCertificatesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.ssl_certificates.v1.ListSslCertificatesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto#L245} - /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_119.proto#L39} + /// [google.cloud.cpp.compute.v1.SslCertificate]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_117.proto#L39} /// // clang-format on StreamRange diff --git a/google/cloud/compute/ssl_certificates/v1/ssl_certificates_proto_export.h b/google/cloud/compute/ssl_certificates/v1/ssl_certificates_proto_export.h index ef216f419bde3..7ecec129dcdf8 100644 --- a/google/cloud/compute/ssl_certificates/v1/ssl_certificates_proto_export.h +++ b/google/cloud/compute/ssl_certificates/v1/ssl_certificates_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SSL_CERTIFICATES_V1_SSL_CERTIFICATES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SSL_CERTIFICATES_V1_SSL_CERTIFICATES_PROTO_EXPORT_H diff --git a/google/cloud/compute/ssl_policies/v1/ssl_policies_client.h b/google/cloud/compute/ssl_policies/v1/ssl_policies_client.h index 0de95a07190f1..96b81b54cff94 100644 --- a/google/cloud/compute/ssl_policies/v1/ssl_policies_client.h +++ b/google/cloud/compute/ssl_policies/v1/ssl_policies_client.h @@ -119,7 +119,7 @@ class SslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.ssl_policies.v1.AggregatedListSslPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L125} - /// [google.cloud.cpp.compute.v1.SslPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_121.proto#L137} + /// [google.cloud.cpp.compute.v1.SslPoliciesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_119.proto#L137} /// // clang-format on StreamRange GetSslPolicy( @@ -348,7 +348,7 @@ class SslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.ssl_policies.v1.GetSslPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L234} - /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L138} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L138} /// // clang-format on StatusOr GetSslPolicy( @@ -506,7 +506,7 @@ class SslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.ssl_policies.v1.ListSslPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L340} - /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L138} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L138} /// // clang-format on StreamRange ListSslPolicies( @@ -547,7 +547,7 @@ class SslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.ssl_policies.v1.ListSslPoliciesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L340} - /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L138} + /// [google.cloud.cpp.compute.v1.SslPolicy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L138} /// // clang-format on StreamRange ListSslPolicies( @@ -576,7 +576,7 @@ class SslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.ssl_policies.v1.ListAvailableFeaturesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L272} - /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L130} + /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L130} /// // clang-format on StatusOr< @@ -609,7 +609,7 @@ class SslPoliciesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.ssl_policies.v1.ListAvailableFeaturesRequest]: @cloud_cpp_reference_link{google/cloud/compute/ssl_policies/v1/ssl_policies.proto#L272} - /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L130} + /// [google.cloud.cpp.compute.v1.SslPoliciesListAvailableFeaturesResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_120.proto#L130} /// // clang-format on StatusOr< diff --git a/google/cloud/compute/ssl_policies/v1/ssl_policies_proto_export.h b/google/cloud/compute/ssl_policies/v1/ssl_policies_proto_export.h index acf6a19ef8451..f0ffcafdfdade 100644 --- a/google/cloud/compute/ssl_policies/v1/ssl_policies_proto_export.h +++ b/google/cloud/compute/ssl_policies/v1/ssl_policies_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SSL_POLICIES_V1_SSL_POLICIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SSL_POLICIES_V1_SSL_POLICIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/storage_pool_types/v1/storage_pool_types_client.h b/google/cloud/compute/storage_pool_types/v1/storage_pool_types_client.h index 8e528146c93fa..0d81dbdc3e77b 100644 --- a/google/cloud/compute/storage_pool_types/v1/storage_pool_types_client.h +++ b/google/cloud/compute/storage_pool_types/v1/storage_pool_types_client.h @@ -119,7 +119,7 @@ class StoragePoolTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pool_types.v1.AggregatedListStoragePoolTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto#L72} - /// [google.cloud.cpp.compute.v1.StoragePoolTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_125.proto#L304} + /// [google.cloud.cpp.compute.v1.StoragePoolTypesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_123.proto#L304} /// // clang-format on StreamRange GetStoragePoolType( @@ -226,7 +226,7 @@ class StoragePoolTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pool_types.v1.GetStoragePoolTypeRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto#L154} - /// [google.cloud.cpp.compute.v1.StoragePoolType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_125.proto#L26} + /// [google.cloud.cpp.compute.v1.StoragePoolType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_123.proto#L26} /// // clang-format on StatusOr GetStoragePoolType( @@ -264,7 +264,7 @@ class StoragePoolTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pool_types.v1.ListStoragePoolTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto#L168} - /// [google.cloud.cpp.compute.v1.StoragePoolType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_125.proto#L26} + /// [google.cloud.cpp.compute.v1.StoragePoolType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_123.proto#L26} /// // clang-format on StreamRange @@ -305,7 +305,7 @@ class StoragePoolTypesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pool_types.v1.ListStoragePoolTypesRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto#L168} - /// [google.cloud.cpp.compute.v1.StoragePoolType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_125.proto#L26} + /// [google.cloud.cpp.compute.v1.StoragePoolType]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_123.proto#L26} /// // clang-format on StreamRange diff --git a/google/cloud/compute/storage_pool_types/v1/storage_pool_types_proto_export.h b/google/cloud/compute/storage_pool_types/v1/storage_pool_types_proto_export.h index 2a5dca132e5a0..d6fa6c2f94f24 100644 --- a/google/cloud/compute/storage_pool_types/v1/storage_pool_types_proto_export.h +++ b/google/cloud/compute/storage_pool_types/v1/storage_pool_types_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_STORAGE_POOL_TYPES_V1_STORAGE_POOL_TYPES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_STORAGE_POOL_TYPES_V1_STORAGE_POOL_TYPES_PROTO_EXPORT_H diff --git a/google/cloud/compute/storage_pools/v1/storage_pools_client.h b/google/cloud/compute/storage_pools/v1/storage_pools_client.h index b1fc9e65ccdcb..6bb0f96151606 100644 --- a/google/cloud/compute/storage_pools/v1/storage_pools_client.h +++ b/google/cloud/compute/storage_pools/v1/storage_pools_client.h @@ -118,7 +118,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.AggregatedListStoragePoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L167} - /// [google.cloud.cpp.compute.v1.StoragePoolsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L554} + /// [google.cloud.cpp.compute.v1.StoragePoolsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L554} /// // clang-format on StreamRange GetStoragePool( @@ -350,7 +350,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.GetStoragePoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L300} - /// [google.cloud.cpp.compute.v1.StoragePool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L25} + /// [google.cloud.cpp.compute.v1.StoragePool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L25} /// // clang-format on StatusOr GetStoragePool( @@ -381,7 +381,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L282} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -414,7 +414,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L282} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -576,7 +576,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.ListStoragePoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L422} - /// [google.cloud.cpp.compute.v1.StoragePool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L25} + /// [google.cloud.cpp.compute.v1.StoragePool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L25} /// // clang-format on StreamRange ListStoragePools( @@ -616,7 +616,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.ListStoragePoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L422} - /// [google.cloud.cpp.compute.v1.StoragePool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L25} + /// [google.cloud.cpp.compute.v1.StoragePool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L25} /// // clang-format on StreamRange ListStoragePools( @@ -655,7 +655,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.ListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L347} - /// [google.cloud.cpp.compute.v1.StoragePoolDisk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L237} + /// [google.cloud.cpp.compute.v1.StoragePoolDisk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L237} /// // clang-format on StreamRange ListDisks( @@ -696,7 +696,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.ListDisksRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L347} - /// [google.cloud.cpp.compute.v1.StoragePoolDisk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L237} + /// [google.cloud.cpp.compute.v1.StoragePoolDisk]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_122.proto#L237} /// // clang-format on StreamRange ListDisks( @@ -727,7 +727,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L493} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -763,7 +763,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L493} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -794,7 +794,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L511} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -830,7 +830,7 @@ class StoragePoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.storage_pools.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/storage_pools/v1/storage_pools.proto#L511} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/storage_pools/v1/storage_pools_proto_export.h b/google/cloud/compute/storage_pools/v1/storage_pools_proto_export.h index 58c436bd8935a..ab5a807bb29ea 100644 --- a/google/cloud/compute/storage_pools/v1/storage_pools_proto_export.h +++ b/google/cloud/compute/storage_pools/v1/storage_pools_proto_export.h @@ -26,12 +26,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_STORAGE_POOLS_V1_STORAGE_POOLS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_STORAGE_POOLS_V1_STORAGE_POOLS_PROTO_EXPORT_H diff --git a/google/cloud/compute/subnetworks/v1/subnetworks_client.h b/google/cloud/compute/subnetworks/v1/subnetworks_client.h index 7abf8da11500d..8ff315bcaade7 100644 --- a/google/cloud/compute/subnetworks/v1/subnetworks_client.h +++ b/google/cloud/compute/subnetworks/v1/subnetworks_client.h @@ -118,7 +118,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.AggregatedListSubnetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L189} - /// [google.cloud.cpp.compute.v1.SubnetworksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_126.proto#L486} + /// [google.cloud.cpp.compute.v1.SubnetworksScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L487} /// // clang-format on StreamRange GetSubnetwork( @@ -470,7 +470,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.GetSubnetworkRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L361} - /// [google.cloud.cpp.compute.v1.Subnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_126.proto#L28} + /// [google.cloud.cpp.compute.v1.Subnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L28} /// // clang-format on StatusOr GetSubnetwork( @@ -501,7 +501,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L342} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -534,7 +534,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.GetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L342} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr GetIamPolicy( @@ -695,7 +695,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.ListSubnetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L409} - /// [google.cloud.cpp.compute.v1.Subnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_126.proto#L28} + /// [google.cloud.cpp.compute.v1.Subnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L28} /// // clang-format on StreamRange ListSubnetworks( @@ -735,7 +735,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.ListSubnetworksRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L409} - /// [google.cloud.cpp.compute.v1.Subnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_126.proto#L28} + /// [google.cloud.cpp.compute.v1.Subnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L28} /// // clang-format on StreamRange ListSubnetworks( @@ -772,7 +772,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L481} - /// [google.cloud.cpp.compute.v1.UsableSubnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_126.proto#L581} + /// [google.cloud.cpp.compute.v1.UsableSubnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L582} /// // clang-format on StreamRange ListUsable( @@ -812,7 +812,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.ListUsableRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L481} - /// [google.cloud.cpp.compute.v1.UsableSubnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_126.proto#L581} + /// [google.cloud.cpp.compute.v1.UsableSubnetwork]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_124.proto#L582} /// // clang-format on StreamRange ListUsable( @@ -973,7 +973,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L596} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1009,7 +1009,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.SetIamPolicyRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L596} - /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_008.proto#L276} + /// [google.cloud.cpp.compute.v1.Policy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_007.proto#L178} /// // clang-format on StatusOr SetIamPolicy( @@ -1172,7 +1172,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L655} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr @@ -1208,7 +1208,7 @@ class SubnetworksClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.subnetworks.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/subnetworks/v1/subnetworks.proto#L655} - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// // clang-format on StatusOr diff --git a/google/cloud/compute/subnetworks/v1/subnetworks_proto_export.h b/google/cloud/compute/subnetworks/v1/subnetworks_proto_export.h index 62f2fc04f1132..6716ec1cbf53b 100644 --- a/google/cloud/compute/subnetworks/v1/subnetworks_proto_export.h +++ b/google/cloud/compute/subnetworks/v1/subnetworks_proto_export.h @@ -26,12 +26,12 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SUBNETWORKS_V1_SUBNETWORKS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_SUBNETWORKS_V1_SUBNETWORKS_PROTO_EXPORT_H diff --git a/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies_client.h b/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies_client.h index b21c6c0e2bda9..df3e159fc7220 100644 --- a/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies_client.h +++ b/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies_client.h @@ -229,7 +229,7 @@ class TargetGrpcProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_grpc_proxies.v1.GetTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L127} - /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L29} + /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_125.proto#L29} /// // clang-format on StatusOr GetTargetGrpcProxy( @@ -261,7 +261,7 @@ class TargetGrpcProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_grpc_proxies.v1.GetTargetGrpcProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L127} - /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L29} + /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_125.proto#L29} /// // clang-format on StatusOr GetTargetGrpcProxy( @@ -423,7 +423,7 @@ class TargetGrpcProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_grpc_proxies.v1.ListTargetGrpcProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L164} - /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L29} + /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_125.proto#L29} /// // clang-format on StreamRange @@ -463,7 +463,7 @@ class TargetGrpcProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_grpc_proxies.v1.ListTargetGrpcProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto#L164} - /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L29} + /// [google.cloud.cpp.compute.v1.TargetGrpcProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_125.proto#L29} /// // clang-format on StreamRange diff --git a/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies_proto_export.h b/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies_proto_export.h index 4b258bc65a40d..3081080a30aa3 100644 --- a/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies_proto_export.h +++ b/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_GRPC_PROXIES_V1_TARGET_GRPC_PROXIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_GRPC_PROXIES_V1_TARGET_GRPC_PROXIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/target_http_proxies/v1/target_http_proxies_client.h b/google/cloud/compute/target_http_proxies/v1/target_http_proxies_client.h index ddafef91c029d..341b3dfa6a9ec 100644 --- a/google/cloud/compute/target_http_proxies/v1/target_http_proxies_client.h +++ b/google/cloud/compute/target_http_proxies/v1/target_http_proxies_client.h @@ -120,7 +120,7 @@ class TargetHttpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_http_proxies.v1.AggregatedListTargetHttpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L129} - /// [google.cloud.cpp.compute.v1.TargetHttpProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_128.proto#L26} + /// [google.cloud.cpp.compute.v1.TargetHttpProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_126.proto#L26} /// // clang-format on StreamRange< @@ -165,7 +165,7 @@ class TargetHttpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_http_proxies.v1.AggregatedListTargetHttpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L129} - /// [google.cloud.cpp.compute.v1.TargetHttpProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_128.proto#L26} + /// [google.cloud.cpp.compute.v1.TargetHttpProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_126.proto#L26} /// // clang-format on StreamRange< @@ -317,7 +317,7 @@ class TargetHttpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_http_proxies.v1.GetTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L237} - /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L36} /// // clang-format on StatusOr GetTargetHttpProxy( @@ -349,7 +349,7 @@ class TargetHttpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_http_proxies.v1.GetTargetHttpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L237} - /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L36} /// // clang-format on StatusOr GetTargetHttpProxy( @@ -512,7 +512,7 @@ class TargetHttpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_http_proxies.v1.ListTargetHttpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L274} - /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L36} /// // clang-format on StreamRange @@ -553,7 +553,7 @@ class TargetHttpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_http_proxies.v1.ListTargetHttpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto#L274} - /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_127.proto#L36} /// // clang-format on StreamRange diff --git a/google/cloud/compute/target_http_proxies/v1/target_http_proxies_proto_export.h b/google/cloud/compute/target_http_proxies/v1/target_http_proxies_proto_export.h index 57ce116f8d670..1ece11e84def6 100644 --- a/google/cloud/compute/target_http_proxies/v1/target_http_proxies_proto_export.h +++ b/google/cloud/compute/target_http_proxies/v1/target_http_proxies_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_HTTP_PROXIES_V1_TARGET_HTTP_PROXIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_HTTP_PROXIES_V1_TARGET_HTTP_PROXIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/target_https_proxies/v1/target_https_proxies_client.h b/google/cloud/compute/target_https_proxies/v1/target_https_proxies_client.h index 1f1a551280c98..61c78dfd59102 100644 --- a/google/cloud/compute/target_https_proxies/v1/target_https_proxies_client.h +++ b/google/cloud/compute/target_https_proxies/v1/target_https_proxies_client.h @@ -122,7 +122,7 @@ class TargetHttpsProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_https_proxies.v1.AggregatedListTargetHttpsProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L186} - /// [google.cloud.cpp.compute.v1.TargetHttpsProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_130.proto#L26} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_128.proto#L26} /// // clang-format on StreamRange< @@ -167,7 +167,7 @@ class TargetHttpsProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_https_proxies.v1.AggregatedListTargetHttpsProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L186} - /// [google.cloud.cpp.compute.v1.TargetHttpsProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_130.proto#L26} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_128.proto#L26} /// // clang-format on StreamRange< @@ -319,7 +319,7 @@ class TargetHttpsProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_https_proxies.v1.GetTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L294} - /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} /// // clang-format on StatusOr @@ -351,7 +351,7 @@ class TargetHttpsProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_https_proxies.v1.GetTargetHttpsProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L294} - /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} /// // clang-format on StatusOr @@ -515,7 +515,7 @@ class TargetHttpsProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_https_proxies.v1.ListTargetHttpsProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L331} - /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} /// // clang-format on StreamRange @@ -556,7 +556,7 @@ class TargetHttpsProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_https_proxies.v1.ListTargetHttpsProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto#L331} - /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L36} + /// [google.cloud.cpp.compute.v1.TargetHttpsProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_129.proto#L36} /// // clang-format on StreamRange diff --git a/google/cloud/compute/target_https_proxies/v1/target_https_proxies_proto_export.h b/google/cloud/compute/target_https_proxies/v1/target_https_proxies_proto_export.h index d9c96cd7c97fe..5f9a053589548 100644 --- a/google/cloud/compute/target_https_proxies/v1/target_https_proxies_proto_export.h +++ b/google/cloud/compute/target_https_proxies/v1/target_https_proxies_proto_export.h @@ -26,11 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_HTTPS_PROXIES_V1_TARGET_HTTPS_PROXIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_HTTPS_PROXIES_V1_TARGET_HTTPS_PROXIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/target_instances/v1/target_instances_client.h b/google/cloud/compute/target_instances/v1/target_instances_client.h index 2c2fd6181df00..aa32f26c6cb64 100644 --- a/google/cloud/compute/target_instances/v1/target_instances_client.h +++ b/google/cloud/compute/target_instances/v1/target_instances_client.h @@ -119,7 +119,7 @@ class TargetInstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_instances.v1.AggregatedListTargetInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L115} - /// [google.cloud.cpp.compute.v1.TargetInstancesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_132.proto#L300} + /// [google.cloud.cpp.compute.v1.TargetInstancesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_130.proto#L300} /// // clang-format on StreamRange GetTargetInstance( @@ -346,7 +346,7 @@ class TargetInstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_instances.v1.GetTargetInstanceRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L230} - /// [google.cloud.cpp.compute.v1.TargetInstance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_132.proto#L28} + /// [google.cloud.cpp.compute.v1.TargetInstance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_130.proto#L28} /// // clang-format on StatusOr GetTargetInstance( @@ -511,7 +511,7 @@ class TargetInstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_instances.v1.ListTargetInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L277} - /// [google.cloud.cpp.compute.v1.TargetInstance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_132.proto#L28} + /// [google.cloud.cpp.compute.v1.TargetInstance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_130.proto#L28} /// // clang-format on StreamRange @@ -553,7 +553,7 @@ class TargetInstancesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_instances.v1.ListTargetInstancesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_instances/v1/target_instances.proto#L277} - /// [google.cloud.cpp.compute.v1.TargetInstance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_132.proto#L28} + /// [google.cloud.cpp.compute.v1.TargetInstance]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_130.proto#L28} /// // clang-format on StreamRange diff --git a/google/cloud/compute/target_instances/v1/target_instances_proto_export.h b/google/cloud/compute/target_instances/v1/target_instances_proto_export.h index 48a00b33f4e86..f10b24ad52bdd 100644 --- a/google/cloud/compute/target_instances/v1/target_instances_proto_export.h +++ b/google/cloud/compute/target_instances/v1/target_instances_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_INSTANCES_V1_TARGET_INSTANCES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_INSTANCES_V1_TARGET_INSTANCES_PROTO_EXPORT_H diff --git a/google/cloud/compute/target_pools/v1/target_pools_client.h b/google/cloud/compute/target_pools/v1/target_pools_client.h index 72ebdcbaa8477..cd7fe1440e1b4 100644 --- a/google/cloud/compute/target_pools/v1/target_pools_client.h +++ b/google/cloud/compute/target_pools/v1/target_pools_client.h @@ -370,7 +370,7 @@ class TargetPoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_pools.v1.AggregatedListTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L270} - /// [google.cloud.cpp.compute.v1.TargetPoolsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L391} + /// [google.cloud.cpp.compute.v1.TargetPoolsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L394} /// // clang-format on StreamRange GetTargetPool( @@ -594,7 +594,7 @@ class TargetPoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_pools.v1.GetTargetPoolRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L404} - /// [google.cloud.cpp.compute.v1.TargetPool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L32} + /// [google.cloud.cpp.compute.v1.TargetPool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L32} /// // clang-format on StatusOr GetTargetPool( @@ -626,7 +626,7 @@ class TargetPoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_pools.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L385} - /// [google.cloud.cpp.compute.v1.TargetPoolInstanceHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L246} + /// [google.cloud.cpp.compute.v1.TargetPoolInstanceHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L249} /// // clang-format on StatusOr GetHealth( @@ -662,7 +662,7 @@ class TargetPoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_pools.v1.GetHealthRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L385} - /// [google.cloud.cpp.compute.v1.TargetPoolInstanceHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L246} + /// [google.cloud.cpp.compute.v1.TargetPoolInstanceHealth]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L249} /// // clang-format on StatusOr GetHealth( @@ -824,7 +824,7 @@ class TargetPoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_pools.v1.ListTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L452} - /// [google.cloud.cpp.compute.v1.TargetPool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L32} + /// [google.cloud.cpp.compute.v1.TargetPool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L32} /// // clang-format on StreamRange ListTargetPools( @@ -865,7 +865,7 @@ class TargetPoolsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_pools.v1.ListTargetPoolsRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_pools/v1/target_pools.proto#L452} - /// [google.cloud.cpp.compute.v1.TargetPool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L32} + /// [google.cloud.cpp.compute.v1.TargetPool]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_131.proto#L32} /// // clang-format on StreamRange ListTargetPools( diff --git a/google/cloud/compute/target_pools/v1/target_pools_proto_export.h b/google/cloud/compute/target_pools/v1/target_pools_proto_export.h index a2527403a47fa..33be145f0c263 100644 --- a/google/cloud/compute/target_pools/v1/target_pools_proto_export.h +++ b/google/cloud/compute/target_pools/v1/target_pools_proto_export.h @@ -26,13 +26,13 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_POOLS_V1_TARGET_POOLS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include -#include -#include -#include +#include +#include +#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_POOLS_V1_TARGET_POOLS_PROTO_EXPORT_H diff --git a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_client.h b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_client.h index ddb2509ab7320..25fef714ff8f6 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_client.h +++ b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_client.h @@ -228,7 +228,7 @@ class TargetSslProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_ssl_proxies.v1.GetTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L182} - /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L55} + /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L55} /// // clang-format on StatusOr GetTargetSslProxy( @@ -260,7 +260,7 @@ class TargetSslProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_ssl_proxies.v1.GetTargetSslProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L182} - /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L55} + /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L55} /// // clang-format on StatusOr GetTargetSslProxy( @@ -423,7 +423,7 @@ class TargetSslProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_ssl_proxies.v1.ListTargetSslProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L219} - /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L55} + /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L55} /// // clang-format on StreamRange @@ -464,7 +464,7 @@ class TargetSslProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_ssl_proxies.v1.ListTargetSslProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto#L219} - /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L55} + /// [google.cloud.cpp.compute.v1.TargetSslProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_133.proto#L55} /// // clang-format on StreamRange diff --git a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_proto_export.h b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_proto_export.h index ee6b4d007a4b4..2eb06a95d127b 100644 --- a/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_proto_export.h +++ b/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_SSL_PROXIES_V1_TARGET_SSL_PROXIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_SSL_PROXIES_V1_TARGET_SSL_PROXIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_client.h b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_client.h index f8eb33c861a17..60753a43ce759 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_client.h +++ b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_client.h @@ -120,7 +120,7 @@ class TargetTcpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_tcp_proxies.v1.AggregatedListTargetTcpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L126} - /// [google.cloud.cpp.compute.v1.TargetTcpProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_136.proto#L26} + /// [google.cloud.cpp.compute.v1.TargetTcpProxiesScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_134.proto#L26} /// // clang-format on StreamRange GetTargetTcpProxy( @@ -345,7 +345,7 @@ class TargetTcpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_tcp_proxies.v1.GetTargetTcpProxyRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L234} - /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L28} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L28} /// // clang-format on StatusOr GetTargetTcpProxy( @@ -508,7 +508,7 @@ class TargetTcpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_tcp_proxies.v1.ListTargetTcpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L271} - /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L28} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L28} /// // clang-format on StreamRange @@ -549,7 +549,7 @@ class TargetTcpProxiesClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_tcp_proxies.v1.ListTargetTcpProxiesRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto#L271} - /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L28} + /// [google.cloud.cpp.compute.v1.TargetTcpProxy]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_135.proto#L28} /// // clang-format on StreamRange diff --git a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_proto_export.h b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_proto_export.h index 1e4a3385ac4ca..c69599a7ae70d 100644 --- a/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_proto_export.h +++ b/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_TCP_PROXIES_V1_TARGET_TCP_PROXIES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_TCP_PROXIES_V1_TARGET_TCP_PROXIES_PROTO_EXPORT_H diff --git a/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways_client.h b/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways_client.h index c2204bd73cac3..dfb4d0d4bbada 100644 --- a/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways_client.h +++ b/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways_client.h @@ -120,7 +120,7 @@ class TargetVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_vpn_gateways.v1.AggregatedListTargetVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L115} - /// [google.cloud.cpp.compute.v1.TargetVpnGatewaysScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_138.proto#L313} + /// [google.cloud.cpp.compute.v1.TargetVpnGatewaysScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_136.proto#L313} /// // clang-format on StreamRange< @@ -165,7 +165,7 @@ class TargetVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_vpn_gateways.v1.AggregatedListTargetVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L115} - /// [google.cloud.cpp.compute.v1.TargetVpnGatewaysScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_138.proto#L313} + /// [google.cloud.cpp.compute.v1.TargetVpnGatewaysScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_136.proto#L313} /// // clang-format on StreamRange< @@ -319,7 +319,7 @@ class TargetVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_vpn_gateways.v1.GetTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L230} - /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_138.proto#L27} + /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_136.proto#L27} /// // clang-format on StatusOr @@ -351,7 +351,7 @@ class TargetVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_vpn_gateways.v1.GetTargetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L230} - /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_138.proto#L27} + /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_136.proto#L27} /// // clang-format on StatusOr @@ -517,7 +517,7 @@ class TargetVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_vpn_gateways.v1.ListTargetVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L278} - /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_138.proto#L27} + /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_136.proto#L27} /// // clang-format on StreamRange @@ -559,7 +559,7 @@ class TargetVpnGatewaysClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.target_vpn_gateways.v1.ListTargetVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto#L278} - /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_138.proto#L27} + /// [google.cloud.cpp.compute.v1.TargetVpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_136.proto#L27} /// // clang-format on StreamRange diff --git a/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways_proto_export.h b/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways_proto_export.h index b58c7c23d3c4f..d4a0d7d3e4e9c 100644 --- a/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways_proto_export.h +++ b/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_VPN_GATEWAYS_V1_TARGET_VPN_GATEWAYS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_TARGET_VPN_GATEWAYS_V1_TARGET_VPN_GATEWAYS_PROTO_EXPORT_H diff --git a/google/cloud/compute/url_maps/v1/url_maps_client.h b/google/cloud/compute/url_maps/v1/url_maps_client.h index d193f37f3f90d..2c15a4a428fb5 100644 --- a/google/cloud/compute/url_maps/v1/url_maps_client.h +++ b/google/cloud/compute/url_maps/v1/url_maps_client.h @@ -117,7 +117,7 @@ class UrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.url_maps.v1.AggregatedListUrlMapsRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L154} - /// [google.cloud.cpp.compute.v1.UrlMapsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_018.proto#L142} + /// [google.cloud.cpp.compute.v1.UrlMapsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L142} /// // clang-format on StreamRange GetUrlMap( @@ -341,7 +341,7 @@ class UrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.url_maps.v1.GetUrlMapRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L262} - /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L867} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L867} /// // clang-format on StatusOr GetUrlMap( @@ -627,7 +627,7 @@ class UrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.url_maps.v1.ListUrlMapsRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L329} - /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L867} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L867} /// // clang-format on StreamRange ListUrlMaps( @@ -667,7 +667,7 @@ class UrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.url_maps.v1.ListUrlMapsRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L329} - /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L867} + /// [google.cloud.cpp.compute.v1.UrlMap]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L867} /// // clang-format on StreamRange ListUrlMaps( @@ -946,7 +946,7 @@ class UrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.url_maps.v1.ValidateRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L457} - /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L1163} + /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L1163} /// // clang-format on StatusOr Validate( @@ -982,7 +982,7 @@ class UrlMapsClient { /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status /// [google.cloud.cpp.compute.url_maps.v1.ValidateRequest]: @cloud_cpp_reference_link{google/cloud/compute/url_maps/v1/url_maps.proto#L457} - /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_020.proto#L1163} + /// [google.cloud.cpp.compute.v1.UrlMapsValidateResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_019.proto#L1163} /// // clang-format on StatusOr Validate( diff --git a/google/cloud/compute/url_maps/v1/url_maps_proto_export.h b/google/cloud/compute/url_maps/v1/url_maps_proto_export.h index 0475d063574fa..c06baa06a1fa9 100644 --- a/google/cloud/compute/url_maps/v1/url_maps_proto_export.h +++ b/google/cloud/compute/url_maps/v1/url_maps_proto_export.h @@ -26,11 +26,11 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_URL_MAPS_V1_URL_MAPS_PROTO_EXPORT_H // IWYU pragma: begin_exports +#include #include -#include -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_URL_MAPS_V1_URL_MAPS_PROTO_EXPORT_H diff --git a/google/cloud/compute/vpn_gateways/v1/vpn_gateways_client.h b/google/cloud/compute/vpn_gateways/v1/vpn_gateways_client.h index 0b86c70707b04..aed4ba2b74954 100644 --- a/google/cloud/compute/vpn_gateways/v1/vpn_gateways_client.h +++ b/google/cloud/compute/vpn_gateways/v1/vpn_gateways_client.h @@ -117,7 +117,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnGatewaysScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L412} + /// [google.cloud.cpp.compute.v1.VpnGatewaysScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_140.proto#L412} /// [google.cloud.cpp.compute.vpn_gateways.v1.AggregatedListVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L137} /// // clang-format on @@ -159,7 +159,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnGatewaysScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L412} + /// [google.cloud.cpp.compute.v1.VpnGatewaysScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_140.proto#L412} /// [google.cloud.cpp.compute.vpn_gateways.v1.AggregatedListVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L137} /// // clang-format on @@ -309,7 +309,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L29} + /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_140.proto#L29} /// [google.cloud.cpp.compute.vpn_gateways.v1.GetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L267} /// // clang-format on @@ -341,7 +341,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L29} + /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_140.proto#L29} /// [google.cloud.cpp.compute.vpn_gateways.v1.GetVpnGatewayRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L267} /// // clang-format on @@ -371,7 +371,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnGatewaysGetStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L408} + /// [google.cloud.cpp.compute.v1.VpnGatewaysGetStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_140.proto#L408} /// [google.cloud.cpp.compute.vpn_gateways.v1.GetStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L252} /// // clang-format on @@ -403,7 +403,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnGatewaysGetStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L408} + /// [google.cloud.cpp.compute.v1.VpnGatewaysGetStatusResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_140.proto#L408} /// [google.cloud.cpp.compute.vpn_gateways.v1.GetStatusRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L252} /// // clang-format on @@ -566,7 +566,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L29} + /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_140.proto#L29} /// [google.cloud.cpp.compute.vpn_gateways.v1.ListVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L315} /// // clang-format on @@ -607,7 +607,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L29} + /// [google.cloud.cpp.compute.v1.VpnGateway]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_140.proto#L29} /// [google.cloud.cpp.compute.vpn_gateways.v1.ListVpnGatewaysRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L315} /// // clang-format on @@ -766,7 +766,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// [google.cloud.cpp.compute.vpn_gateways.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L425} /// // clang-format on @@ -802,7 +802,7 @@ class VpnGatewaysClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_139.proto#L30} + /// [google.cloud.cpp.compute.v1.TestPermissionsResponse]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_137.proto#L30} /// [google.cloud.cpp.compute.vpn_gateways.v1.TestIamPermissionsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto#L425} /// // clang-format on diff --git a/google/cloud/compute/vpn_gateways/v1/vpn_gateways_proto_export.h b/google/cloud/compute/vpn_gateways/v1/vpn_gateways_proto_export.h index 5d9fa20dcb6eb..2e2d201206819 100644 --- a/google/cloud/compute/vpn_gateways/v1/vpn_gateways_proto_export.h +++ b/google/cloud/compute/vpn_gateways/v1/vpn_gateways_proto_export.h @@ -26,10 +26,10 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_VPN_GATEWAYS_V1_VPN_GATEWAYS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include -#include +#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_VPN_GATEWAYS_V1_VPN_GATEWAYS_PROTO_EXPORT_H diff --git a/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels_client.h b/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels_client.h index c1969266b1562..d7f4e40aa6a90 100644 --- a/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels_client.h +++ b/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels_client.h @@ -115,7 +115,7 @@ class VpnTunnelsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnTunnelsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L394} + /// [google.cloud.cpp.compute.v1.VpnTunnelsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L394} /// [google.cloud.cpp.compute.vpn_tunnels.v1.AggregatedListVpnTunnelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L113} /// // clang-format on @@ -157,7 +157,7 @@ class VpnTunnelsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnTunnelsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L394} + /// [google.cloud.cpp.compute.v1.VpnTunnelsScopedList]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L394} /// [google.cloud.cpp.compute.vpn_tunnels.v1.AggregatedListVpnTunnelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L113} /// // clang-format on @@ -307,7 +307,7 @@ class VpnTunnelsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L26} + /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L26} /// [google.cloud.cpp.compute.vpn_tunnels.v1.GetVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L228} /// // clang-format on @@ -339,7 +339,7 @@ class VpnTunnelsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L26} + /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L26} /// [google.cloud.cpp.compute.vpn_tunnels.v1.GetVpnTunnelRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L228} /// // clang-format on @@ -501,7 +501,7 @@ class VpnTunnelsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L26} + /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L26} /// [google.cloud.cpp.compute.vpn_tunnels.v1.ListVpnTunnelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L276} /// // clang-format on @@ -542,7 +542,7 @@ class VpnTunnelsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_143.proto#L26} + /// [google.cloud.cpp.compute.v1.VpnTunnel]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_141.proto#L26} /// [google.cloud.cpp.compute.vpn_tunnels.v1.ListVpnTunnelsRequest]: @cloud_cpp_reference_link{google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto#L276} /// // clang-format on diff --git a/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels_proto_export.h b/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels_proto_export.h index 2412a24159fde..8a54302e56d62 100644 --- a/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels_proto_export.h +++ b/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels_proto_export.h @@ -26,9 +26,9 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_VPN_TUNNELS_V1_VPN_TUNNELS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include -#include +#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_VPN_TUNNELS_V1_VPN_TUNNELS_PROTO_EXPORT_H diff --git a/google/cloud/compute/zone_operations/v1/zone_operations_client.h b/google/cloud/compute/zone_operations/v1/zone_operations_client.h index 31a649c4174a9..dffa75af5408c 100644 --- a/google/cloud/compute/zone_operations/v1/zone_operations_client.h +++ b/google/cloud/compute/zone_operations/v1/zone_operations_client.h @@ -163,7 +163,7 @@ class ZoneOperationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// [google.cloud.cpp.compute.zone_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L107} /// // clang-format on @@ -195,7 +195,7 @@ class ZoneOperationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// [google.cloud.cpp.compute.zone_operations.v1.GetOperationRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L107} /// // clang-format on @@ -234,7 +234,7 @@ class ZoneOperationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// [google.cloud.cpp.compute.zone_operations.v1.ListZoneOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L129} /// // clang-format on @@ -275,7 +275,7 @@ class ZoneOperationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// [google.cloud.cpp.compute.zone_operations.v1.ListZoneOperationsRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L129} /// // clang-format on @@ -315,7 +315,7 @@ class ZoneOperationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// [google.cloud.cpp.compute.zone_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L200} /// // clang-format on @@ -356,7 +356,7 @@ class ZoneOperationsClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_017.proto#L131} + /// [google.cloud.cpp.compute.v1.Operation]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_016.proto#L131} /// [google.cloud.cpp.compute.zone_operations.v1.WaitRequest]: @cloud_cpp_reference_link{google/cloud/compute/zone_operations/v1/zone_operations.proto#L200} /// // clang-format on diff --git a/google/cloud/compute/zone_operations/v1/zone_operations_proto_export.h b/google/cloud/compute/zone_operations/v1/zone_operations_proto_export.h index 05a7ee48629d1..bed50ed4ca5b6 100644 --- a/google/cloud/compute/zone_operations/v1/zone_operations_proto_export.h +++ b/google/cloud/compute/zone_operations/v1/zone_operations_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_OPERATIONS_V1_ZONE_OPERATIONS_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONE_OPERATIONS_V1_ZONE_OPERATIONS_PROTO_EXPORT_H diff --git a/google/cloud/compute/zones/v1/zones_client.h b/google/cloud/compute/zones/v1/zones_client.h index eb4b861701023..d74cb70837b79 100644 --- a/google/cloud/compute/zones/v1/zones_client.h +++ b/google/cloud/compute/zones/v1/zones_client.h @@ -104,7 +104,7 @@ class ZonesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_144.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L29} /// [google.cloud.cpp.compute.zones.v1.GetZoneRequest]: @cloud_cpp_reference_link{google/cloud/compute/zones/v1/zones.proto#L59} /// // clang-format on @@ -135,7 +135,7 @@ class ZonesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_144.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L29} /// [google.cloud.cpp.compute.zones.v1.GetZoneRequest]: @cloud_cpp_reference_link{google/cloud/compute/zones/v1/zones.proto#L59} /// // clang-format on @@ -171,7 +171,7 @@ class ZonesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_144.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L29} /// [google.cloud.cpp.compute.zones.v1.ListZonesRequest]: @cloud_cpp_reference_link{google/cloud/compute/zones/v1/zones.proto#L69} /// // clang-format on @@ -211,7 +211,7 @@ class ZonesClient { /// [`future`]: @ref google::cloud::future /// [`StatusOr`]: @ref google::cloud::StatusOr /// [`Status`]: @ref google::cloud::Status - /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_144.proto#L29} + /// [google.cloud.cpp.compute.v1.Zone]: @cloud_cpp_reference_link{google/cloud/compute/v1/internal/common_142.proto#L29} /// [google.cloud.cpp.compute.zones.v1.ListZonesRequest]: @cloud_cpp_reference_link{google/cloud/compute/zones/v1/zones.proto#L69} /// // clang-format on diff --git a/google/cloud/compute/zones/v1/zones_proto_export.h b/google/cloud/compute/zones/v1/zones_proto_export.h index 7593b0b72939e..f24a85bd3852d 100644 --- a/google/cloud/compute/zones/v1/zones_proto_export.h +++ b/google/cloud/compute/zones/v1/zones_proto_export.h @@ -26,8 +26,8 @@ #define GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONES_V1_ZONES_PROTO_EXPORT_H // IWYU pragma: begin_exports -#include -#include +#include +#include // IWYU pragma: end_exports #endif // GOOGLE_CLOUD_CPP_GOOGLE_CLOUD_COMPUTE_ZONES_V1_ZONES_PROTO_EXPORT_H diff --git a/google/cloud/securesourcemanager/v1/secure_source_manager_client.h b/google/cloud/securesourcemanager/v1/secure_source_manager_client.h index 143f931a7e542..8e1067d90a76f 100644 --- a/google/cloud/securesourcemanager/v1/secure_source_manager_client.h +++ b/google/cloud/securesourcemanager/v1/secure_source_manager_client.h @@ -1047,9 +1047,9 @@ class SecureSourceManagerClient { /// /// CreateBranchRule creates a branch rule in a given repository. /// - /// @param parent - /// @param branch_rule - /// @param branch_rule_id + /// @param parent + /// @param branch_rule + /// @param branch_rule_id /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return A [`future`] that becomes satisfied when the LRO @@ -1170,7 +1170,7 @@ class SecureSourceManagerClient { /// /// ListBranchRules lists branch rules in a given repository. /// - /// @param parent + /// @param parent /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return a [StreamRange](@ref google::cloud::StreamRange) @@ -1304,7 +1304,7 @@ class SecureSourceManagerClient { /// /// UpdateBranchRule updates a branch rule. /// - /// @param branch_rule + /// @param branch_rule /// @param update_mask Required. Field mask is used to specify the fields to be overwritten in the /// branchRule resource by the update. /// The fields specified in the update_mask are relative to the resource, not @@ -1429,7 +1429,7 @@ class SecureSourceManagerClient { /// /// DeleteBranchRule deletes a branch rule. /// - /// @param name + /// @param name /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return A [`future`] that becomes satisfied when the LRO diff --git a/protos/google/cloud/compute/accelerator_types/v1/accelerator_types.proto b/protos/google/cloud/compute/accelerator_types/v1/accelerator_types.proto index a2844d21a1877..4556bd7fc753d 100644 --- a/protos/google/cloud/compute/accelerator_types/v1/accelerator_types.proto +++ b/protos/google/cloud/compute/accelerator_types/v1/accelerator_types.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; diff --git a/protos/google/cloud/compute/addresses/v1/addresses.proto b/protos/google/cloud/compute/addresses/v1/addresses.proto index 9ed39c6db87bf..24dea55a2e39a 100644 --- a/protos/google/cloud/compute/addresses/v1/addresses.proto +++ b/protos/google/cloud/compute/addresses/v1/addresses.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -26,8 +26,8 @@ import "google/api/client.proto"; import "google/api/field_behavior.proto"; import "google/cloud/compute/v1/internal/common_004.proto"; import "google/cloud/compute/v1/internal/common_005.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_103.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_101.proto"; import "google/cloud/extended_operations.proto"; // Service for the addresses resource. diff --git a/protos/google/cloud/compute/autoscalers/v1/autoscalers.proto b/protos/google/cloud/compute/autoscalers/v1/autoscalers.proto index d11d1ec814dfe..ab216e637ec8e 100644 --- a/protos/google/cloud/compute/autoscalers/v1/autoscalers.proto +++ b/protos/google/cloud/compute/autoscalers/v1/autoscalers.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.autoscalers.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_008.proto"; import "google/cloud/compute/v1/internal/common_009.proto"; -import "google/cloud/compute/v1/internal/common_010.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; import "google/cloud/extended_operations.proto"; // Service for the autoscalers resource. diff --git a/protos/google/cloud/compute/backend_buckets/v1/backend_buckets.proto b/protos/google/cloud/compute/backend_buckets/v1/backend_buckets.proto index 41fbdffa7f77f..75d030a1cd862 100644 --- a/protos/google/cloud/compute/backend_buckets/v1/backend_buckets.proto +++ b/protos/google/cloud/compute/backend_buckets/v1/backend_buckets.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,13 +24,13 @@ package google.cloud.cpp.compute.backend_buckets.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_011.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_048.proto"; -import "google/cloud/compute/v1/internal/common_112.proto"; -import "google/cloud/compute/v1/internal/common_115.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_010.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_046.proto"; +import "google/cloud/compute/v1/internal/common_110.proto"; +import "google/cloud/compute/v1/internal/common_113.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the backendBuckets resource. diff --git a/protos/google/cloud/compute/backend_services/v1/backend_services.proto b/protos/google/cloud/compute/backend_services/v1/backend_services.proto index 120fc90c7985e..4ec9f3f586fa7 100644 --- a/protos/google/cloud/compute/backend_services/v1/backend_services.proto +++ b/protos/google/cloud/compute/backend_services/v1/backend_services.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -25,13 +25,13 @@ import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; import "google/cloud/compute/v1/internal/common_000.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_012.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_048.proto"; -import "google/cloud/compute/v1/internal/common_112.proto"; -import "google/cloud/compute/v1/internal/common_115.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_011.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_046.proto"; +import "google/cloud/compute/v1/internal/common_110.proto"; +import "google/cloud/compute/v1/internal/common_113.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the backendServices resource. diff --git a/protos/google/cloud/compute/disk_types/v1/disk_types.proto b/protos/google/cloud/compute/disk_types/v1/disk_types.proto index 10826e10213a4..925f0b297cb4c 100644 --- a/protos/google/cloud/compute/disk_types/v1/disk_types.proto +++ b/protos/google/cloud/compute/disk_types/v1/disk_types.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.disk_types.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_026.proto"; import "google/cloud/compute/v1/internal/common_027.proto"; -import "google/cloud/compute/v1/internal/common_028.proto"; // Service for the diskTypes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/diskTypes diff --git a/protos/google/cloud/compute/disks/v1/disks.proto b/protos/google/cloud/compute/disks/v1/disks.proto index 9e8bc39402e4f..dd88e49dc6ab1 100644 --- a/protos/google/cloud/compute/disks/v1/disks.proto +++ b/protos/google/cloud/compute/disks/v1/disks.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,14 +24,14 @@ package google.cloud.cpp.compute.disks.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_015.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_024.proto"; -import "google/cloud/compute/v1/internal/common_116.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; -import "google/cloud/compute/v1/internal/common_146.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_014.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_023.proto"; +import "google/cloud/compute/v1/internal/common_114.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; +import "google/cloud/compute/v1/internal/common_143.proto"; +import "google/cloud/compute/v1/internal/common_144.proto"; import "google/cloud/extended_operations.proto"; // Service for the disks resource. diff --git a/protos/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto b/protos/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto index d34a1af0498a9..b6a1531f1bca0 100644 --- a/protos/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto +++ b/protos/google/cloud/compute/external_vpn_gateways/v1/external_vpn_gateways.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,10 +24,10 @@ package google.cloud.cpp.compute.external_vpn_gateways.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_033.proto"; -import "google/cloud/compute/v1/internal/common_047.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_032.proto"; +import "google/cloud/compute/v1/internal/common_045.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the externalVpnGateways resource. diff --git a/protos/google/cloud/compute/firewall_policies/v1/firewall_policies.proto b/protos/google/cloud/compute/firewall_policies/v1/firewall_policies.proto index b92b2a973db5e..8e8328f7a5af6 100644 --- a/protos/google/cloud/compute/firewall_policies/v1/firewall_policies.proto +++ b/protos/google/cloud/compute/firewall_policies/v1/firewall_policies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,12 +24,12 @@ package google.cloud.cpp.compute.firewall_policies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_036.proto"; import "google/cloud/compute/v1/internal/common_037.proto"; import "google/cloud/compute/v1/internal/common_038.proto"; -import "google/cloud/compute/v1/internal/common_039.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the firewallPolicies resource. diff --git a/protos/google/cloud/compute/firewalls/v1/firewalls.proto b/protos/google/cloud/compute/firewalls/v1/firewalls.proto index 8245e070f4649..4cd9045beeb0f 100644 --- a/protos/google/cloud/compute/firewalls/v1/firewalls.proto +++ b/protos/google/cloud/compute/firewalls/v1/firewalls.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.firewalls.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_034.proto"; import "google/cloud/compute/v1/internal/common_035.proto"; -import "google/cloud/compute/v1/internal/common_036.proto"; import "google/cloud/extended_operations.proto"; // Service for the firewalls resource. diff --git a/protos/google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto b/protos/google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto index 90851fd8ab38c..8a948cb1dcc26 100644 --- a/protos/google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto +++ b/protos/google/cloud/compute/forwarding_rules/v1/forwarding_rules.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.forwarding_rules.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_040.proto"; import "google/cloud/compute/v1/internal/common_041.proto"; -import "google/cloud/compute/v1/internal/common_042.proto"; -import "google/cloud/compute/v1/internal/common_103.proto"; -import "google/cloud/compute/v1/internal/common_134.proto"; +import "google/cloud/compute/v1/internal/common_101.proto"; +import "google/cloud/compute/v1/internal/common_132.proto"; import "google/cloud/extended_operations.proto"; // Service for the forwardingRules resource. diff --git a/protos/google/cloud/compute/global_addresses/v1/global_addresses.proto b/protos/google/cloud/compute/global_addresses/v1/global_addresses.proto index 20510013d318e..451672d96bec8 100644 --- a/protos/google/cloud/compute/global_addresses/v1/global_addresses.proto +++ b/protos/google/cloud/compute/global_addresses/v1/global_addresses.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -25,9 +25,9 @@ import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; import "google/cloud/compute/v1/internal/common_004.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_043.proto"; import "google/cloud/compute/v1/internal/common_045.proto"; -import "google/cloud/compute/v1/internal/common_047.proto"; import "google/cloud/extended_operations.proto"; // Service for the globalAddresses resource. diff --git a/protos/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto b/protos/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto index 0a080fa933889..d98b2110359aa 100644 --- a/protos/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto +++ b/protos/google/cloud/compute/global_forwarding_rules/v1/global_forwarding_rules.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,10 +24,10 @@ package google.cloud.cpp.compute.global_forwarding_rules.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_041.proto"; -import "google/cloud/compute/v1/internal/common_047.proto"; -import "google/cloud/compute/v1/internal/common_134.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_040.proto"; +import "google/cloud/compute/v1/internal/common_045.proto"; +import "google/cloud/compute/v1/internal/common_132.proto"; import "google/cloud/extended_operations.proto"; // Service for the globalForwardingRules resource. diff --git a/protos/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto b/protos/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto index a4e796e615cf3..6603a65517a9c 100644 --- a/protos/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto +++ b/protos/google/cloud/compute/global_network_endpoint_groups/v1/global_network_endpoint_groups.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.global_network_endpoint_groups.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_013.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_046.proto"; +import "google/cloud/compute/v1/internal/common_012.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_044.proto"; import "google/cloud/extended_operations.proto"; // Service for the globalNetworkEndpointGroups resource. diff --git a/protos/google/cloud/compute/global_operations/v1/global_operations.proto b/protos/google/cloud/compute/global_operations/v1/global_operations.proto index 3e67b00871901..fa1a9fd828f0f 100644 --- a/protos/google/cloud/compute/global_operations/v1/global_operations.proto +++ b/protos/google/cloud/compute/global_operations/v1/global_operations.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.global_operations.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_087.proto"; -import "google/cloud/compute/v1/internal/common_088.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_085.proto"; +import "google/cloud/compute/v1/internal/common_086.proto"; import "google/cloud/extended_operations.proto"; import "google/protobuf/empty.proto"; diff --git a/protos/google/cloud/compute/global_organization_operations/v1/global_organization_operations.proto b/protos/google/cloud/compute/global_organization_operations/v1/global_organization_operations.proto index dcde8d656ae21..923e1c2232591 100644 --- a/protos/google/cloud/compute/global_organization_operations/v1/global_organization_operations.proto +++ b/protos/google/cloud/compute/global_organization_operations/v1/global_organization_operations.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.global_organization_operations.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_088.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_086.proto"; import "google/cloud/extended_operations.proto"; import "google/protobuf/empty.proto"; diff --git a/protos/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto b/protos/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto index a18a6b0f7d04e..7925bdb83abb0 100644 --- a/protos/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto +++ b/protos/google/cloud/compute/global_public_delegated_prefixes/v1/global_public_delegated_prefixes.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.global_public_delegated_prefixes.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_092.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_090.proto"; import "google/cloud/extended_operations.proto"; // Service for the globalPublicDelegatedPrefixes resource. diff --git a/protos/google/cloud/compute/health_checks/v1/health_checks.proto b/protos/google/cloud/compute/health_checks/v1/health_checks.proto index 84da71b79ecaf..a571083b2dc44 100644 --- a/protos/google/cloud/compute/health_checks/v1/health_checks.proto +++ b/protos/google/cloud/compute/health_checks/v1/health_checks.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.health_checks.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_044.proto"; -import "google/cloud/compute/v1/internal/common_051.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_042.proto"; +import "google/cloud/compute/v1/internal/common_049.proto"; import "google/cloud/extended_operations.proto"; // Service for the healthChecks resource. diff --git a/protos/google/cloud/compute/http_health_checks/v1/http_health_checks.proto b/protos/google/cloud/compute/http_health_checks/v1/http_health_checks.proto index 3b3b50d15d730..3797749e08e05 100644 --- a/protos/google/cloud/compute/http_health_checks/v1/http_health_checks.proto +++ b/protos/google/cloud/compute/http_health_checks/v1/http_health_checks.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.http_health_checks.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_053.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_051.proto"; import "google/cloud/extended_operations.proto"; // Service for the httpHealthChecks resource. diff --git a/protos/google/cloud/compute/https_health_checks/v1/https_health_checks.proto b/protos/google/cloud/compute/https_health_checks/v1/https_health_checks.proto index 50c85b27a94dc..b9dc882870f96 100644 --- a/protos/google/cloud/compute/https_health_checks/v1/https_health_checks.proto +++ b/protos/google/cloud/compute/https_health_checks/v1/https_health_checks.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.https_health_checks.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_054.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_052.proto"; import "google/cloud/extended_operations.proto"; // Service for the httpsHealthChecks resource. diff --git a/protos/google/cloud/compute/image_family_views/v1/image_family_views.proto b/protos/google/cloud/compute/image_family_views/v1/image_family_views.proto index 43a9b6a964dfa..cfe5999bfccca 100644 --- a/protos/google/cloud/compute/image_family_views/v1/image_family_views.proto +++ b/protos/google/cloud/compute/image_family_views/v1/image_family_views.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,7 +24,7 @@ package google.cloud.cpp.compute.image_family_views.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_056.proto"; +import "google/cloud/compute/v1/internal/common_054.proto"; // Service for the imageFamilyViews resource. // https://cloud.google.com/compute/docs/reference/rest/v1/imageFamilyViews diff --git a/protos/google/cloud/compute/images/v1/images.proto b/protos/google/cloud/compute/images/v1/images.proto index 9f42be143403c..4eceb29c58c55 100644 --- a/protos/google/cloud/compute/images/v1/images.proto +++ b/protos/google/cloud/compute/images/v1/images.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,14 +24,14 @@ package google.cloud.cpp.compute.images.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_023.proto"; -import "google/cloud/compute/v1/internal/common_047.proto"; -import "google/cloud/compute/v1/internal/common_048.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_022.proto"; +import "google/cloud/compute/v1/internal/common_045.proto"; +import "google/cloud/compute/v1/internal/common_046.proto"; +import "google/cloud/compute/v1/internal/common_053.proto"; import "google/cloud/compute/v1/internal/common_055.proto"; -import "google/cloud/compute/v1/internal/common_057.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the images resource. diff --git a/protos/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto b/protos/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto index c58d7b1eb4bc9..ecb1dc2a5887e 100644 --- a/protos/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto +++ b/protos/google/cloud/compute/instance_group_manager_resize_requests/v1/instance_group_manager_resize_requests.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.instance_group_manager_resize_requests.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_062.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_060.proto"; import "google/cloud/extended_operations.proto"; // Service for the instanceGroupManagerResizeRequests resource. diff --git a/protos/google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto b/protos/google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto index 48c125cfa8cce..5a8be5f80d97c 100644 --- a/protos/google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto +++ b/protos/google/cloud/compute/instance_group_managers/v1/instance_group_managers.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.instance_group_managers.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_029.proto"; -import "google/cloud/compute/v1/internal/common_061.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_028.proto"; +import "google/cloud/compute/v1/internal/common_059.proto"; import "google/cloud/extended_operations.proto"; // Service for the instanceGroupManagers resource. diff --git a/protos/google/cloud/compute/instance_groups/v1/instance_groups.proto b/protos/google/cloud/compute/instance_groups/v1/instance_groups.proto index 2d6190c92dfa7..3dabced9affe7 100644 --- a/protos/google/cloud/compute/instance_groups/v1/instance_groups.proto +++ b/protos/google/cloud/compute/instance_groups/v1/instance_groups.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.instance_groups.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_059.proto"; -import "google/cloud/compute/v1/internal/common_060.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_058.proto"; import "google/cloud/extended_operations.proto"; // Service for the instanceGroups resource. diff --git a/protos/google/cloud/compute/instance_settings/v1/instance_settings.proto b/protos/google/cloud/compute/instance_settings/v1/instance_settings.proto index 3453fbeddddc2..5e8d0b7e799a2 100644 --- a/protos/google/cloud/compute/instance_settings/v1/instance_settings.proto +++ b/protos/google/cloud/compute/instance_settings/v1/instance_settings.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.instance_settings.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_064.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_062.proto"; import "google/cloud/extended_operations.proto"; // Service for the instanceSettings resource. diff --git a/protos/google/cloud/compute/instance_templates/v1/instance_templates.proto b/protos/google/cloud/compute/instance_templates/v1/instance_templates.proto index 40824c952407a..12d12702d0c42 100644 --- a/protos/google/cloud/compute/instance_templates/v1/instance_templates.proto +++ b/protos/google/cloud/compute/instance_templates/v1/instance_templates.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,12 +24,12 @@ package google.cloud.cpp.compute.instance_templates.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_025.proto"; -import "google/cloud/compute/v1/internal/common_048.proto"; -import "google/cloud/compute/v1/internal/common_065.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_024.proto"; +import "google/cloud/compute/v1/internal/common_046.proto"; +import "google/cloud/compute/v1/internal/common_063.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the instanceTemplates resource. diff --git a/protos/google/cloud/compute/instances/v1/instances.proto b/protos/google/cloud/compute/instances/v1/instances.proto index 9f47fbfb4a3e4..2d155a0f3f9d8 100644 --- a/protos/google/cloud/compute/instances/v1/instances.proto +++ b/protos/google/cloud/compute/instances/v1/instances.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -25,13 +25,13 @@ import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; import "google/cloud/compute/v1/internal/common_003.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_015.proto"; import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_022.proto"; -import "google/cloud/compute/v1/internal/common_078.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; -import "google/cloud/compute/v1/internal/common_146.proto"; +import "google/cloud/compute/v1/internal/common_021.proto"; +import "google/cloud/compute/v1/internal/common_076.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; +import "google/cloud/compute/v1/internal/common_144.proto"; import "google/cloud/extended_operations.proto"; import "google/protobuf/empty.proto"; diff --git a/protos/google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto b/protos/google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto index 0e6802d94923a..a24e950875baf 100644 --- a/protos/google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto +++ b/protos/google/cloud/compute/instant_snapshots/v1/instant_snapshots.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,13 +24,13 @@ package google.cloud.cpp.compute.instant_snapshots.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_066.proto"; -import "google/cloud/compute/v1/internal/common_067.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; -import "google/cloud/compute/v1/internal/common_145.proto"; -import "google/cloud/compute/v1/internal/common_146.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_064.proto"; +import "google/cloud/compute/v1/internal/common_065.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; +import "google/cloud/compute/v1/internal/common_143.proto"; +import "google/cloud/compute/v1/internal/common_144.proto"; import "google/cloud/extended_operations.proto"; // Service for the instantSnapshots resource. diff --git a/protos/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto b/protos/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto index 9f9a08f67c32c..49e434a18b2c0 100644 --- a/protos/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto +++ b/protos/google/cloud/compute/interconnect_attachments/v1/interconnect_attachments.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.interconnect_attachments.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_069.proto"; -import "google/cloud/compute/v1/internal/common_103.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_067.proto"; +import "google/cloud/compute/v1/internal/common_101.proto"; import "google/cloud/extended_operations.proto"; // Service for the interconnectAttachments resource. diff --git a/protos/google/cloud/compute/interconnect_locations/v1/interconnect_locations.proto b/protos/google/cloud/compute/interconnect_locations/v1/interconnect_locations.proto index 83fa73d91940b..2943c6b92b0ab 100644 --- a/protos/google/cloud/compute/interconnect_locations/v1/interconnect_locations.proto +++ b/protos/google/cloud/compute/interconnect_locations/v1/interconnect_locations.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,7 +24,7 @@ package google.cloud.cpp.compute.interconnect_locations.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_071.proto"; +import "google/cloud/compute/v1/internal/common_069.proto"; // Service for the interconnectLocations resource. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectLocations diff --git a/protos/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations.proto b/protos/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations.proto index 1f6930133f4bb..5d8cacc5eee98 100644 --- a/protos/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations.proto +++ b/protos/google/cloud/compute/interconnect_remote_locations/v1/interconnect_remote_locations.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,7 +24,7 @@ package google.cloud.cpp.compute.interconnect_remote_locations.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_072.proto"; +import "google/cloud/compute/v1/internal/common_070.proto"; // Service for the interconnectRemoteLocations resource. // https://cloud.google.com/compute/docs/reference/rest/v1/interconnectRemoteLocations diff --git a/protos/google/cloud/compute/interconnects/v1/interconnects.proto b/protos/google/cloud/compute/interconnects/v1/interconnects.proto index 149f9a0445ff2..0b7ed19f13f16 100644 --- a/protos/google/cloud/compute/interconnects/v1/interconnects.proto +++ b/protos/google/cloud/compute/interconnects/v1/interconnects.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.interconnects.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_047.proto"; -import "google/cloud/compute/v1/internal/common_068.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_045.proto"; +import "google/cloud/compute/v1/internal/common_066.proto"; import "google/cloud/extended_operations.proto"; // Service for the interconnects resource. diff --git a/protos/google/cloud/compute/license_codes/v1/license_codes.proto b/protos/google/cloud/compute/license_codes/v1/license_codes.proto index 77dba5c71486f..e86c28c052f7f 100644 --- a/protos/google/cloud/compute/license_codes/v1/license_codes.proto +++ b/protos/google/cloud/compute/license_codes/v1/license_codes.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.license_codes.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_074.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_072.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; // Service for the licenseCodes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes diff --git a/protos/google/cloud/compute/licenses/v1/licenses.proto b/protos/google/cloud/compute/licenses/v1/licenses.proto index 6c9e24b2aaafb..64137a8cc9b2d 100644 --- a/protos/google/cloud/compute/licenses/v1/licenses.proto +++ b/protos/google/cloud/compute/licenses/v1/licenses.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.licenses.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_048.proto"; -import "google/cloud/compute/v1/internal/common_073.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_046.proto"; +import "google/cloud/compute/v1/internal/common_071.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the licenses resource. diff --git a/protos/google/cloud/compute/machine_images/v1/machine_images.proto b/protos/google/cloud/compute/machine_images/v1/machine_images.proto index 6b060107f21dc..662f55642b839 100644 --- a/protos/google/cloud/compute/machine_images/v1/machine_images.proto +++ b/protos/google/cloud/compute/machine_images/v1/machine_images.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.machine_images.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_048.proto"; -import "google/cloud/compute/v1/internal/common_076.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_046.proto"; +import "google/cloud/compute/v1/internal/common_074.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the machineImages resource. diff --git a/protos/google/cloud/compute/machine_types/v1/machine_types.proto b/protos/google/cloud/compute/machine_types/v1/machine_types.proto index 98e2d9447d607..d87212c96a36d 100644 --- a/protos/google/cloud/compute/machine_types/v1/machine_types.proto +++ b/protos/google/cloud/compute/machine_types/v1/machine_types.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,7 +24,7 @@ package google.cloud.cpp.compute.machine_types.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_077.proto"; +import "google/cloud/compute/v1/internal/common_075.proto"; // Service for the machineTypes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/machineTypes diff --git a/protos/google/cloud/compute/network_attachments/v1/network_attachments.proto b/protos/google/cloud/compute/network_attachments/v1/network_attachments.proto index a880f494270bd..648efd3a49a62 100644 --- a/protos/google/cloud/compute/network_attachments/v1/network_attachments.proto +++ b/protos/google/cloud/compute/network_attachments/v1/network_attachments.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.network_attachments.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_081.proto"; -import "google/cloud/compute/v1/internal/common_104.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_079.proto"; +import "google/cloud/compute/v1/internal/common_102.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the networkAttachments resource. diff --git a/protos/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto b/protos/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto index aefd43856d977..c0b1d0db943c8 100644 --- a/protos/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto +++ b/protos/google/cloud/compute/network_edge_security_services/v1/network_edge_security_services.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.network_edge_security_services.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_082.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_080.proto"; import "google/cloud/extended_operations.proto"; // Service for the networkEdgeSecurityServices resource. diff --git a/protos/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto b/protos/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto index d365f1ecdd734..fa1ab9d88d4b6 100644 --- a/protos/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto +++ b/protos/google/cloud/compute/network_endpoint_groups/v1/network_endpoint_groups.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,10 +24,10 @@ package google.cloud.cpp.compute.network_endpoint_groups.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_013.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_083.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_012.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_081.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the networkEndpointGroups resource. diff --git a/protos/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto b/protos/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto index 4578aa1a84238..22dd998206292 100644 --- a/protos/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto +++ b/protos/google/cloud/compute/network_firewall_policies/v1/network_firewall_policies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,12 +24,12 @@ package google.cloud.cpp.compute.network_firewall_policies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_037.proto"; import "google/cloud/compute/v1/internal/common_038.proto"; -import "google/cloud/compute/v1/internal/common_039.proto"; -import "google/cloud/compute/v1/internal/common_048.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_046.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the networkFirewallPolicies resource. diff --git a/protos/google/cloud/compute/networks/v1/networks.proto b/protos/google/cloud/compute/networks/v1/networks.proto index d913ed0c7a09b..207664255c9f5 100644 --- a/protos/google/cloud/compute/networks/v1/networks.proto +++ b/protos/google/cloud/compute/networks/v1/networks.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.networks.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_031.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_030.proto"; import "google/cloud/extended_operations.proto"; // Service for the networks resource. diff --git a/protos/google/cloud/compute/node_groups/v1/node_groups.proto b/protos/google/cloud/compute/node_groups/v1/node_groups.proto index 9e3b0ab2d3391..15729896df075 100644 --- a/protos/google/cloud/compute/node_groups/v1/node_groups.proto +++ b/protos/google/cloud/compute/node_groups/v1/node_groups.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.node_groups.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_058.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; -import "google/cloud/compute/v1/internal/common_146.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_056.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; +import "google/cloud/compute/v1/internal/common_144.proto"; import "google/cloud/extended_operations.proto"; // Service for the nodeGroups resource. diff --git a/protos/google/cloud/compute/node_templates/v1/node_templates.proto b/protos/google/cloud/compute/node_templates/v1/node_templates.proto index 0b5d614a60e28..857b7e0e6fd23 100644 --- a/protos/google/cloud/compute/node_templates/v1/node_templates.proto +++ b/protos/google/cloud/compute/node_templates/v1/node_templates.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.node_templates.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_084.proto"; -import "google/cloud/compute/v1/internal/common_104.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_082.proto"; +import "google/cloud/compute/v1/internal/common_102.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the nodeTemplates resource. diff --git a/protos/google/cloud/compute/node_types/v1/node_types.proto b/protos/google/cloud/compute/node_types/v1/node_types.proto index 4794914f11fd6..ee6c48822bf10 100644 --- a/protos/google/cloud/compute/node_types/v1/node_types.proto +++ b/protos/google/cloud/compute/node_types/v1/node_types.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,7 +24,7 @@ package google.cloud.cpp.compute.node_types.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_085.proto"; +import "google/cloud/compute/v1/internal/common_083.proto"; // Service for the nodeTypes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/nodeTypes diff --git a/protos/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto b/protos/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto index a6c6df39f2043..212581398e361 100644 --- a/protos/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto +++ b/protos/google/cloud/compute/packet_mirrorings/v1/packet_mirrorings.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.packet_mirrorings.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_089.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_087.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the packetMirrorings resource. diff --git a/protos/google/cloud/compute/projects/v1/projects.proto b/protos/google/cloud/compute/projects/v1/projects.proto index 8386c56d0999d..ceaf1bfbf8c4a 100644 --- a/protos/google/cloud/compute/projects/v1/projects.proto +++ b/protos/google/cloud/compute/projects/v1/projects.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.projects.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_026.proto"; -import "google/cloud/compute/v1/internal/common_078.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_025.proto"; +import "google/cloud/compute/v1/internal/common_076.proto"; import "google/cloud/extended_operations.proto"; // Service for the projects resource. diff --git a/protos/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto b/protos/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto index 357d0361fd3b4..055f71eee972d 100644 --- a/protos/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto +++ b/protos/google/cloud/compute/public_advertised_prefixes/v1/public_advertised_prefixes.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.public_advertised_prefixes.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_091.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_089.proto"; import "google/cloud/extended_operations.proto"; // Service for the publicAdvertisedPrefixes resource. diff --git a/protos/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto b/protos/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto index 0971ade8d966a..28e18b6506aef 100644 --- a/protos/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto +++ b/protos/google/cloud/compute/public_delegated_prefixes/v1/public_delegated_prefixes.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.public_delegated_prefixes.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_092.proto"; -import "google/cloud/compute/v1/internal/common_093.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_090.proto"; +import "google/cloud/compute/v1/internal/common_091.proto"; import "google/cloud/extended_operations.proto"; // Service for the publicDelegatedPrefixes resource. diff --git a/protos/google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto b/protos/google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto index c9bf3175a04a4..0d5b65a6b4e8c 100644 --- a/protos/google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto +++ b/protos/google/cloud/compute/region_autoscalers/v1/region_autoscalers.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.region_autoscalers.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_009.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_096.proto"; +import "google/cloud/compute/v1/internal/common_008.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_094.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionAutoscalers resource. diff --git a/protos/google/cloud/compute/region_backend_services/v1/region_backend_services.proto b/protos/google/cloud/compute/region_backend_services/v1/region_backend_services.proto index f76e682c6f699..242aa2bd945df 100644 --- a/protos/google/cloud/compute/region_backend_services/v1/region_backend_services.proto +++ b/protos/google/cloud/compute/region_backend_services/v1/region_backend_services.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -25,11 +25,11 @@ import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; import "google/cloud/compute/v1/internal/common_000.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_104.proto"; -import "google/cloud/compute/v1/internal/common_112.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_102.proto"; +import "google/cloud/compute/v1/internal/common_110.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionBackendServices resource. diff --git a/protos/google/cloud/compute/region_commitments/v1/region_commitments.proto b/protos/google/cloud/compute/region_commitments/v1/region_commitments.proto index d2223ec869c42..bf3d3feab5e56 100644 --- a/protos/google/cloud/compute/region_commitments/v1/region_commitments.proto +++ b/protos/google/cloud/compute/region_commitments/v1/region_commitments.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_commitments.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_018.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionCommitments resource. diff --git a/protos/google/cloud/compute/region_disk_types/v1/region_disk_types.proto b/protos/google/cloud/compute/region_disk_types/v1/region_disk_types.proto index 3052a1554e573..6937f34a0fab8 100644 --- a/protos/google/cloud/compute/region_disk_types/v1/region_disk_types.proto +++ b/protos/google/cloud/compute/region_disk_types/v1/region_disk_types.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_disk_types.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_027.proto"; -import "google/cloud/compute/v1/internal/common_097.proto"; +import "google/cloud/compute/v1/internal/common_026.proto"; +import "google/cloud/compute/v1/internal/common_095.proto"; // Service for the regionDiskTypes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/regionDiskTypes diff --git a/protos/google/cloud/compute/region_disks/v1/region_disks.proto b/protos/google/cloud/compute/region_disks/v1/region_disks.proto index 1499365d6d4d4..0fe4e5bbf1604 100644 --- a/protos/google/cloud/compute/region_disks/v1/region_disks.proto +++ b/protos/google/cloud/compute/region_disks/v1/region_disks.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,14 +24,14 @@ package google.cloud.cpp.compute.region_disks.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_015.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_098.proto"; -import "google/cloud/compute/v1/internal/common_103.proto"; -import "google/cloud/compute/v1/internal/common_104.proto"; -import "google/cloud/compute/v1/internal/common_116.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_014.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_096.proto"; +import "google/cloud/compute/v1/internal/common_101.proto"; +import "google/cloud/compute/v1/internal/common_102.proto"; +import "google/cloud/compute/v1/internal/common_114.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionDisks resource. diff --git a/protos/google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto b/protos/google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto index 5af26c1ed5e72..91d95c57551d3 100644 --- a/protos/google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto +++ b/protos/google/cloud/compute/region_health_check_services/v1/region_health_check_services.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_health_check_services.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_050.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_048.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionHealthCheckServices resource. diff --git a/protos/google/cloud/compute/region_health_checks/v1/region_health_checks.proto b/protos/google/cloud/compute/region_health_checks/v1/region_health_checks.proto index a555feec2878c..d7c89c3ede926 100644 --- a/protos/google/cloud/compute/region_health_checks/v1/region_health_checks.proto +++ b/protos/google/cloud/compute/region_health_checks/v1/region_health_checks.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_health_checks.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_044.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_042.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionHealthChecks resource. diff --git a/protos/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto b/protos/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto index 1684103d101a9..8330305b005c2 100644 --- a/protos/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto +++ b/protos/google/cloud/compute/region_instance_group_managers/v1/region_instance_group_managers.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.region_instance_group_managers.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_029.proto"; -import "google/cloud/compute/v1/internal/common_100.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_028.proto"; +import "google/cloud/compute/v1/internal/common_098.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionInstanceGroupManagers resource. diff --git a/protos/google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto b/protos/google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto index e38f1518f1cef..05fa67753c6e1 100644 --- a/protos/google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto +++ b/protos/google/cloud/compute/region_instance_groups/v1/region_instance_groups.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.region_instance_groups.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_059.proto"; -import "google/cloud/compute/v1/internal/common_099.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_097.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionInstanceGroups resource. diff --git a/protos/google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto b/protos/google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto index de8035436ea7a..9c7c462538bd9 100644 --- a/protos/google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto +++ b/protos/google/cloud/compute/region_instance_templates/v1/region_instance_templates.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_instance_templates.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_025.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_024.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionInstanceTemplates resource. diff --git a/protos/google/cloud/compute/region_instances/v1/region_instances.proto b/protos/google/cloud/compute/region_instances/v1/region_instances.proto index d3478fcc38ef6..de5ac8c650d09 100644 --- a/protos/google/cloud/compute/region_instances/v1/region_instances.proto +++ b/protos/google/cloud/compute/region_instances/v1/region_instances.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_instances.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_015.proto"; import "google/cloud/compute/v1/internal/common_016.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionInstances resource. diff --git a/protos/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto b/protos/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto index 8bc1a13e64938..9f31beac00987 100644 --- a/protos/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto +++ b/protos/google/cloud/compute/region_instant_snapshots/v1/region_instant_snapshots.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,12 +24,12 @@ package google.cloud.cpp.compute.region_instant_snapshots.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_066.proto"; -import "google/cloud/compute/v1/internal/common_103.proto"; -import "google/cloud/compute/v1/internal/common_104.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_064.proto"; +import "google/cloud/compute/v1/internal/common_101.proto"; +import "google/cloud/compute/v1/internal/common_102.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionInstantSnapshots resource. diff --git a/protos/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto b/protos/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto index 758f00d9eaea3..78b46281ef69e 100644 --- a/protos/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto +++ b/protos/google/cloud/compute/region_network_endpoint_groups/v1/region_network_endpoint_groups.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.region_network_endpoint_groups.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_013.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_101.proto"; +import "google/cloud/compute/v1/internal/common_012.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_099.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionNetworkEndpointGroups resource. diff --git a/protos/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto b/protos/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto index d2852c0276c8d..7e23b8b5ef581 100644 --- a/protos/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto +++ b/protos/google/cloud/compute/region_network_firewall_policies/v1/region_network_firewall_policies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,13 +24,13 @@ package google.cloud.cpp.compute.region_network_firewall_policies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_037.proto"; import "google/cloud/compute/v1/internal/common_038.proto"; -import "google/cloud/compute/v1/internal/common_039.proto"; +import "google/cloud/compute/v1/internal/common_100.proto"; import "google/cloud/compute/v1/internal/common_102.proto"; -import "google/cloud/compute/v1/internal/common_104.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionNetworkFirewallPolicies resource. diff --git a/protos/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto b/protos/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto index 04f7ca83bbfb3..14c332ce89c3e 100644 --- a/protos/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto +++ b/protos/google/cloud/compute/region_notification_endpoints/v1/region_notification_endpoints.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_notification_endpoints.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_086.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_084.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionNotificationEndpoints resource. diff --git a/protos/google/cloud/compute/region_operations/v1/region_operations.proto b/protos/google/cloud/compute/region_operations/v1/region_operations.proto index 6bea0e009e441..e0f9638be4a65 100644 --- a/protos/google/cloud/compute/region_operations/v1/region_operations.proto +++ b/protos/google/cloud/compute/region_operations/v1/region_operations.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_operations.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_088.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_086.proto"; import "google/cloud/extended_operations.proto"; import "google/protobuf/empty.proto"; diff --git a/protos/google/cloud/compute/region_security_policies/v1/region_security_policies.proto b/protos/google/cloud/compute/region_security_policies/v1/region_security_policies.proto index d87c5dbd4a75c..4c7e333454f48 100644 --- a/protos/google/cloud/compute/region_security_policies/v1/region_security_policies.proto +++ b/protos/google/cloud/compute/region_security_policies/v1/region_security_policies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_security_policies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_111.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_109.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionSecurityPolicies resource. diff --git a/protos/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto b/protos/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto index ee1330c62202c..901d841eaac93 100644 --- a/protos/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto +++ b/protos/google/cloud/compute/region_ssl_certificates/v1/region_ssl_certificates.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_ssl_certificates.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_119.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_117.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionSslCertificates resource. diff --git a/protos/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto b/protos/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto index 4975706ef1ec4..3364db89895b6 100644 --- a/protos/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto +++ b/protos/google/cloud/compute/region_ssl_policies/v1/region_ssl_policies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_ssl_policies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_122.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_120.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionSslPolicies resource. diff --git a/protos/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto b/protos/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto index d274a635ece95..9ce4afd2df3c3 100644 --- a/protos/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto +++ b/protos/google/cloud/compute/region_target_http_proxies/v1/region_target_http_proxies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.region_target_http_proxies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_129.proto"; -import "google/cloud/compute/v1/internal/common_141.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_127.proto"; +import "google/cloud/compute/v1/internal/common_139.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionTargetHttpProxies resource. diff --git a/protos/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto b/protos/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto index f081625dd8db6..3c51d31b81ef5 100644 --- a/protos/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto +++ b/protos/google/cloud/compute/region_target_https_proxies/v1/region_target_https_proxies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,10 +24,10 @@ package google.cloud.cpp.compute.region_target_https_proxies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_105.proto"; -import "google/cloud/compute/v1/internal/common_131.proto"; -import "google/cloud/compute/v1/internal/common_141.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_103.proto"; +import "google/cloud/compute/v1/internal/common_129.proto"; +import "google/cloud/compute/v1/internal/common_139.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionTargetHttpsProxies resource. diff --git a/protos/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto b/protos/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto index bf9a747699faa..257daa7a7397e 100644 --- a/protos/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto +++ b/protos/google/cloud/compute/region_target_tcp_proxies/v1/region_target_tcp_proxies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.region_target_tcp_proxies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_137.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_135.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionTargetTcpProxies resource. diff --git a/protos/google/cloud/compute/region_url_maps/v1/region_url_maps.proto b/protos/google/cloud/compute/region_url_maps/v1/region_url_maps.proto index 04d74c2c28fa1..05d429e9736b4 100644 --- a/protos/google/cloud/compute/region_url_maps/v1/region_url_maps.proto +++ b/protos/google/cloud/compute/region_url_maps/v1/region_url_maps.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.region_url_maps.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_020.proto"; -import "google/cloud/compute/v1/internal/common_106.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; +import "google/cloud/compute/v1/internal/common_104.proto"; import "google/cloud/extended_operations.proto"; // Service for the regionUrlMaps resource. diff --git a/protos/google/cloud/compute/region_zones/v1/region_zones.proto b/protos/google/cloud/compute/region_zones/v1/region_zones.proto index 4205d122fee11..647b87b190435 100644 --- a/protos/google/cloud/compute/region_zones/v1/region_zones.proto +++ b/protos/google/cloud/compute/region_zones/v1/region_zones.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,7 +24,7 @@ package google.cloud.cpp.compute.region_zones.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_144.proto"; +import "google/cloud/compute/v1/internal/common_142.proto"; // Service for the regionZones resource. // https://cloud.google.com/compute/docs/reference/rest/v1/regionZones diff --git a/protos/google/cloud/compute/regions/v1/regions.proto b/protos/google/cloud/compute/regions/v1/regions.proto index 9e090600e2851..045aad9e299a0 100644 --- a/protos/google/cloud/compute/regions/v1/regions.proto +++ b/protos/google/cloud/compute/regions/v1/regions.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,7 +24,7 @@ package google.cloud.cpp.compute.regions.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_095.proto"; +import "google/cloud/compute/v1/internal/common_093.proto"; // Service for the regions resource. // https://cloud.google.com/compute/docs/reference/rest/v1/regions diff --git a/protos/google/cloud/compute/reservations/v1/reservations.proto b/protos/google/cloud/compute/reservations/v1/reservations.proto index 607ad59661cca..9b5494f27deaa 100644 --- a/protos/google/cloud/compute/reservations/v1/reservations.proto +++ b/protos/google/cloud/compute/reservations/v1/reservations.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -25,11 +25,11 @@ import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; import "google/cloud/compute/v1/internal/common_006.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_107.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; -import "google/cloud/compute/v1/internal/common_146.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_105.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; +import "google/cloud/compute/v1/internal/common_144.proto"; import "google/cloud/extended_operations.proto"; // Service for the reservations resource. diff --git a/protos/google/cloud/compute/resource_policies/v1/resource_policies.proto b/protos/google/cloud/compute/resource_policies/v1/resource_policies.proto index 03698c0c904ff..eb07c9a53895e 100644 --- a/protos/google/cloud/compute/resource_policies/v1/resource_policies.proto +++ b/protos/google/cloud/compute/resource_policies/v1/resource_policies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.resource_policies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_104.proto"; -import "google/cloud/compute/v1/internal/common_108.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_102.proto"; +import "google/cloud/compute/v1/internal/common_106.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the resourcePolicies resource. diff --git a/protos/google/cloud/compute/routers/v1/routers.proto b/protos/google/cloud/compute/routers/v1/routers.proto index b3b30b58aa7f3..24c6b949af5f9 100644 --- a/protos/google/cloud/compute/routers/v1/routers.proto +++ b/protos/google/cloud/compute/routers/v1/routers.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.routers.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_014.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; +import "google/cloud/compute/v1/internal/common_013.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; import "google/cloud/extended_operations.proto"; // Service for the routers resource. diff --git a/protos/google/cloud/compute/routes/v1/routes.proto b/protos/google/cloud/compute/routes/v1/routes.proto index 0158fc39146ca..f0fe094535fad 100644 --- a/protos/google/cloud/compute/routes/v1/routes.proto +++ b/protos/google/cloud/compute/routes/v1/routes.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.routes.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_109.proto"; -import "google/cloud/compute/v1/internal/common_110.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_107.proto"; +import "google/cloud/compute/v1/internal/common_108.proto"; import "google/cloud/extended_operations.proto"; // Service for the routes resource. diff --git a/protos/google/cloud/compute/security_policies/v1/security_policies.proto b/protos/google/cloud/compute/security_policies/v1/security_policies.proto index 62d11ed0277d5..1e8f196c534c2 100644 --- a/protos/google/cloud/compute/security_policies/v1/security_policies.proto +++ b/protos/google/cloud/compute/security_policies/v1/security_policies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,10 +24,10 @@ package google.cloud.cpp.compute.security_policies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_047.proto"; -import "google/cloud/compute/v1/internal/common_090.proto"; -import "google/cloud/compute/v1/internal/common_111.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_045.proto"; +import "google/cloud/compute/v1/internal/common_088.proto"; +import "google/cloud/compute/v1/internal/common_109.proto"; import "google/cloud/extended_operations.proto"; // Service for the securityPolicies resource. diff --git a/protos/google/cloud/compute/service_attachments/v1/service_attachments.proto b/protos/google/cloud/compute/service_attachments/v1/service_attachments.proto index ec94dffb6c47d..9c3601c8ca43d 100644 --- a/protos/google/cloud/compute/service_attachments/v1/service_attachments.proto +++ b/protos/google/cloud/compute/service_attachments/v1/service_attachments.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.service_attachments.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_104.proto"; -import "google/cloud/compute/v1/internal/common_113.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_102.proto"; +import "google/cloud/compute/v1/internal/common_111.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the serviceAttachments resource. diff --git a/protos/google/cloud/compute/snapshot_settings/v1/snapshot_settings.proto b/protos/google/cloud/compute/snapshot_settings/v1/snapshot_settings.proto index 5c1fbb533d674..e0ac0f81efde7 100644 --- a/protos/google/cloud/compute/snapshot_settings/v1/snapshot_settings.proto +++ b/protos/google/cloud/compute/snapshot_settings/v1/snapshot_settings.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.snapshot_settings.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_118.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_116.proto"; import "google/cloud/extended_operations.proto"; // Service for the snapshotSettings resource. diff --git a/protos/google/cloud/compute/snapshots/v1/snapshots.proto b/protos/google/cloud/compute/snapshots/v1/snapshots.proto index 3e25706177a5c..5f3b818b11cca 100644 --- a/protos/google/cloud/compute/snapshots/v1/snapshots.proto +++ b/protos/google/cloud/compute/snapshots/v1/snapshots.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,13 +24,13 @@ package google.cloud.cpp.compute.snapshots.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_047.proto"; -import "google/cloud/compute/v1/internal/common_048.proto"; -import "google/cloud/compute/v1/internal/common_116.proto"; -import "google/cloud/compute/v1/internal/common_117.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_045.proto"; +import "google/cloud/compute/v1/internal/common_046.proto"; +import "google/cloud/compute/v1/internal/common_114.proto"; +import "google/cloud/compute/v1/internal/common_115.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the snapshots resource. diff --git a/protos/google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto b/protos/google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto index ed62cea4dbef4..3ed08ef88aa25 100644 --- a/protos/google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto +++ b/protos/google/cloud/compute/ssl_certificates/v1/ssl_certificates.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.ssl_certificates.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_119.proto"; -import "google/cloud/compute/v1/internal/common_120.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_117.proto"; +import "google/cloud/compute/v1/internal/common_118.proto"; import "google/cloud/extended_operations.proto"; // Service for the sslCertificates resource. diff --git a/protos/google/cloud/compute/ssl_policies/v1/ssl_policies.proto b/protos/google/cloud/compute/ssl_policies/v1/ssl_policies.proto index 559a9c4dd0c10..e716f464daded 100644 --- a/protos/google/cloud/compute/ssl_policies/v1/ssl_policies.proto +++ b/protos/google/cloud/compute/ssl_policies/v1/ssl_policies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.ssl_policies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_121.proto"; -import "google/cloud/compute/v1/internal/common_122.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_119.proto"; +import "google/cloud/compute/v1/internal/common_120.proto"; import "google/cloud/extended_operations.proto"; // Service for the sslPolicies resource. diff --git a/protos/google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto b/protos/google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto index e8965891448f0..feb9addb80a13 100644 --- a/protos/google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto +++ b/protos/google/cloud/compute/storage_pool_types/v1/storage_pool_types.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,7 +24,7 @@ package google.cloud.cpp.compute.storage_pool_types.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_125.proto"; +import "google/cloud/compute/v1/internal/common_123.proto"; // Service for the storagePoolTypes resource. // https://cloud.google.com/compute/docs/reference/rest/v1/storagePoolTypes diff --git a/protos/google/cloud/compute/storage_pools/v1/storage_pools.proto b/protos/google/cloud/compute/storage_pools/v1/storage_pools.proto index 28ae2bef6ba45..f6b5453855e0f 100644 --- a/protos/google/cloud/compute/storage_pools/v1/storage_pools.proto +++ b/protos/google/cloud/compute/storage_pools/v1/storage_pools.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.storage_pools.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_124.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; -import "google/cloud/compute/v1/internal/common_146.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_122.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; +import "google/cloud/compute/v1/internal/common_144.proto"; import "google/cloud/extended_operations.proto"; // Service for the storagePools resource. diff --git a/protos/google/cloud/compute/subnetworks/v1/subnetworks.proto b/protos/google/cloud/compute/subnetworks/v1/subnetworks.proto index 9ec0a4ae5575b..0ef5a3dc3e68a 100644 --- a/protos/google/cloud/compute/subnetworks/v1/subnetworks.proto +++ b/protos/google/cloud/compute/subnetworks/v1/subnetworks.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.subnetworks.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_008.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_104.proto"; -import "google/cloud/compute/v1/internal/common_126.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_102.proto"; +import "google/cloud/compute/v1/internal/common_124.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; import "google/cloud/extended_operations.proto"; // Service for the subnetworks resource. diff --git a/protos/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto b/protos/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto index d0f01e0e43a8c..faca6332a2f16 100644 --- a/protos/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto +++ b/protos/google/cloud/compute/target_grpc_proxies/v1/target_grpc_proxies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.target_grpc_proxies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_127.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_125.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetGrpcProxies resource. diff --git a/protos/google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto b/protos/google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto index 3f35a1ac5de96..44438771fcf6e 100644 --- a/protos/google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto +++ b/protos/google/cloud/compute/target_http_proxies/v1/target_http_proxies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,10 +24,10 @@ package google.cloud.cpp.compute.target_http_proxies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_128.proto"; -import "google/cloud/compute/v1/internal/common_129.proto"; -import "google/cloud/compute/v1/internal/common_141.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_126.proto"; +import "google/cloud/compute/v1/internal/common_127.proto"; +import "google/cloud/compute/v1/internal/common_139.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetHttpProxies resource. diff --git a/protos/google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto b/protos/google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto index 6e7f2586257f8..11f0ccefea224 100644 --- a/protos/google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto +++ b/protos/google/cloud/compute/target_https_proxies/v1/target_https_proxies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.target_https_proxies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_123.proto"; -import "google/cloud/compute/v1/internal/common_130.proto"; -import "google/cloud/compute/v1/internal/common_131.proto"; -import "google/cloud/compute/v1/internal/common_141.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_121.proto"; +import "google/cloud/compute/v1/internal/common_128.proto"; +import "google/cloud/compute/v1/internal/common_129.proto"; +import "google/cloud/compute/v1/internal/common_139.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetHttpsProxies resource. diff --git a/protos/google/cloud/compute/target_instances/v1/target_instances.proto b/protos/google/cloud/compute/target_instances/v1/target_instances.proto index ee4f6fb0af4d1..f5e91a2a2c5ec 100644 --- a/protos/google/cloud/compute/target_instances/v1/target_instances.proto +++ b/protos/google/cloud/compute/target_instances/v1/target_instances.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.target_instances.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_112.proto"; -import "google/cloud/compute/v1/internal/common_132.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_110.proto"; +import "google/cloud/compute/v1/internal/common_130.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetInstances resource. diff --git a/protos/google/cloud/compute/target_pools/v1/target_pools.proto b/protos/google/cloud/compute/target_pools/v1/target_pools.proto index 988103338b25c..1f82c3da1f044 100644 --- a/protos/google/cloud/compute/target_pools/v1/target_pools.proto +++ b/protos/google/cloud/compute/target_pools/v1/target_pools.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,11 +24,11 @@ package google.cloud.cpp.compute.target_pools.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_063.proto"; -import "google/cloud/compute/v1/internal/common_112.proto"; -import "google/cloud/compute/v1/internal/common_133.proto"; -import "google/cloud/compute/v1/internal/common_134.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_061.proto"; +import "google/cloud/compute/v1/internal/common_110.proto"; +import "google/cloud/compute/v1/internal/common_131.proto"; +import "google/cloud/compute/v1/internal/common_132.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetPools resource. diff --git a/protos/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto b/protos/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto index a5760325bc90d..f6d521cd32e2a 100644 --- a/protos/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto +++ b/protos/google/cloud/compute/target_ssl_proxies/v1/target_ssl_proxies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.target_ssl_proxies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_123.proto"; -import "google/cloud/compute/v1/internal/common_135.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_121.proto"; +import "google/cloud/compute/v1/internal/common_133.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetSslProxies resource. diff --git a/protos/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto b/protos/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto index 6baed4c48faaf..8841e11bd81cf 100644 --- a/protos/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto +++ b/protos/google/cloud/compute/target_tcp_proxies/v1/target_tcp_proxies.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.target_tcp_proxies.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_136.proto"; -import "google/cloud/compute/v1/internal/common_137.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_134.proto"; +import "google/cloud/compute/v1/internal/common_135.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetTcpProxies resource. diff --git a/protos/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto b/protos/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto index 621c77cc1663a..f256dd64044c2 100644 --- a/protos/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto +++ b/protos/google/cloud/compute/target_vpn_gateways/v1/target_vpn_gateways.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.target_vpn_gateways.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_103.proto"; -import "google/cloud/compute/v1/internal/common_138.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_101.proto"; +import "google/cloud/compute/v1/internal/common_136.proto"; import "google/cloud/extended_operations.proto"; // Service for the targetVpnGateways resource. diff --git a/protos/google/cloud/compute/url_maps/v1/url_maps.proto b/protos/google/cloud/compute/url_maps/v1/url_maps.proto index 3dad13e553107..19e93fab98f40 100644 --- a/protos/google/cloud/compute/url_maps/v1/url_maps.proto +++ b/protos/google/cloud/compute/url_maps/v1/url_maps.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.url_maps.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_018.proto"; -import "google/cloud/compute/v1/internal/common_020.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; import "google/cloud/extended_operations.proto"; // Service for the urlMaps resource. diff --git a/protos/google/cloud/compute/v1/internal/common_000.proto b/protos/google/cloud/compute/v1/internal/common_000.proto index 2dabb8c7ddd2b..e4a037bd50de9 100644 --- a/protos/google/cloud/compute/v1/internal/common_000.proto +++ b/protos/google/cloud/compute/v1/internal/common_000.proto @@ -15,14 +15,14 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_030.proto"; -import "google/cloud/compute/v1/internal/common_052.proto"; +import "google/cloud/compute/v1/internal/common_029.proto"; +import "google/cloud/compute/v1/internal/common_050.proto"; // Contains the configurations necessary to generate a signature for access to // private storage buckets that support Signature Version 4 for authentication. @@ -269,6 +269,39 @@ message BackendService { // defined by the server. optional string id = 19 [json_name = "id"]; + // Specifies a preference for traffic sent from the proxy to the backend (or + // from the client to the backend for proxyless gRPC). The possible values + // are: - IPV4_ONLY: Only send IPv4 traffic to the backends of the backend + // service (Instance Group, Managed Instance Group, Network Endpoint Group), + // regardless of traffic from the client to the proxy. Only IPv4 health checks + // are used to check the health of the backends. This is the default setting. + // - PREFER_IPV6: Prioritize the connection to the endpoint's IPv6 address + // over its IPv4 address (provided there is a healthy IPv6 address). - + // IPV6_ONLY: Only send IPv6 traffic to the backends of the backend service + // (Instance Group, Managed Instance Group, Network Endpoint Group), + // regardless of traffic from the client to the proxy. Only IPv6 health checks + // are used to check the health of the backends. This field is applicable to + // either: - Advanced global external Application Load Balancer (load + // balancing scheme EXTERNAL_MANAGED), - Regional external Application Load + // Balancer, - Internal proxy Network Load Balancer (load balancing scheme + // INTERNAL_MANAGED), - Regional internal Application Load Balancer (load + // balancing scheme INTERNAL_MANAGED), - Traffic Director with Envoy proxies + // and proxyless gRPC (load balancing scheme INTERNAL_SELF_MANAGED). + // IPV4_ONLY: Only send IPv4 traffic to the backends of the Backend Service + // (Instance Group, Managed Instance Group, Network Endpoint Group) regardless + // of traffic from the client to the proxy. Only IPv4 health-checks are used + // to check the health of the backends. This is the default setting. + // IPV6_ONLY: Only send IPv6 traffic to the backends of the Backend Service + // (Instance Group, Managed Instance Group, Network Endpoint Group) regardless + // of traffic from the client to the proxy. Only IPv6 health-checks are used + // to check the health of the backends. + // IP_ADDRESS_SELECTION_POLICY_UNSPECIFIED: Unspecified IP address selection + // policy. + // PREFER_IPV6: Prioritize the connection to the endpoints IPv6 address over + // its IPv4 address (provided there is a healthy IPv6 address). + optional string ip_address_selection_policy = 43 + [json_name = "ipAddressSelectionPolicy"]; + // [Output Only] Type of resource. Always compute#backendService for backend // services. optional string kind = 20 [json_name = "kind"]; @@ -509,8 +542,17 @@ message BackendService { // HTTP_COOKIE: The hash is based on a user provided cookie. // NONE: No session affinity. Connections from the same client IP may go to // any instance in the pool. + // STRONG_COOKIE_AFFINITY: Strong cookie-based affinity. Connections bearing + // the same cookie will be served by the same backend VM while that VM remains + // healthy, as long as the cookie has not expired. optional string session_affinity = 37 [json_name = "sessionAffinity"]; + // Describes the HTTP cookie used for stateful session affinity. This field is + // applicable and required if the sessionAffinity is set to + // STRONG_COOKIE_AFFINITY. + optional BackendServiceHttpCookie strong_session_affinity_cookie = 44 + [json_name = "strongSessionAffinityCookie"]; + optional Subsetting subsetting = 38 [json_name = "subsetting"]; // The backend service timeout has a different meaning depending on the type @@ -782,6 +824,18 @@ message BackendServiceGroupHealth { optional string kind = 3 [json_name = "kind"]; } +// The HTTP cookie used for stateful session affinity. +message BackendServiceHttpCookie { + // Name of the cookie. + optional string name = 1 [json_name = "name"]; + + // Path to set for the cookie. + optional string path = 2 [json_name = "path"]; + + // Lifetime of the cookie. + optional Duration ttl = 3 [json_name = "ttl"]; +} + // Identity-Aware Proxy message BackendServiceIAP { // Whether the serving infrastructure will authenticate and authorize all diff --git a/protos/google/cloud/compute/v1/internal/common_001.proto b/protos/google/cloud/compute/v1/internal/common_001.proto index 8a6d9cac7e11c..37ec47e5d88a2 100644 --- a/protos/google/cloud/compute/v1/internal/common_001.proto +++ b/protos/google/cloud/compute/v1/internal/common_001.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; diff --git a/protos/google/cloud/compute/v1/internal/common_002.proto b/protos/google/cloud/compute/v1/internal/common_002.proto index 1ca72184bc413..0da10b03d6efe 100644 --- a/protos/google/cloud/compute/v1/internal/common_002.proto +++ b/protos/google/cloud/compute/v1/internal/common_002.proto @@ -15,13 +15,13 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; +import "google/cloud/compute/v1/internal/common_022.proto"; // Represents an Accelerator Type resource. Google Cloud Platform provides // graphics processing units (accelerators) that you can add to VM instances to diff --git a/protos/google/cloud/compute/v1/internal/common_003.proto b/protos/google/cloud/compute/v1/internal/common_003.proto index f3d86b594c858..46275542b39bf 100644 --- a/protos/google/cloud/compute/v1/internal/common_003.proto +++ b/protos/google/cloud/compute/v1/internal/common_003.proto @@ -15,17 +15,17 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; import "google/cloud/compute/v1/internal/common_001.proto"; -import "google/cloud/compute/v1/internal/common_021.proto"; -import "google/cloud/compute/v1/internal/common_030.proto"; -import "google/cloud/compute/v1/internal/common_034.proto"; -import "google/cloud/compute/v1/internal/common_078.proto"; +import "google/cloud/compute/v1/internal/common_020.proto"; +import "google/cloud/compute/v1/internal/common_029.proto"; +import "google/cloud/compute/v1/internal/common_033.proto"; +import "google/cloud/compute/v1/internal/common_076.proto"; // An access configuration attached to an instance's network interface. Only one // access config per instance is supported. @@ -416,6 +416,7 @@ message ConfidentialInstanceConfig { // value. // SEV: AMD Secure Encrypted Virtualization. // SEV_SNP: AMD Secure Encrypted Virtualization - Secure Nested Paging. + // TDX: Intel Trust Domain eXtension. optional string confidential_instance_type = 2 [json_name = "confidentialInstanceType"]; @@ -641,7 +642,8 @@ message NetworkInterface { // not specified, IPV4_ONLY is used. This field can be both set at instance // creation and update network interface operations. // IPV4_IPV6: The network interface can have both IPv4 and IPv6 addresses. - // IPV4_ONLY: The network interface will be assigned IPv4 address. + // IPV4_ONLY: The network interface will only be assigned IPv4 addresses. + // IPV6_ONLY: The network interface will only be assigned IPv6 addresses. optional string stack_type = 15 [json_name = "stackType"]; // The URL of the Subnetwork resource for this instance. If the network diff --git a/protos/google/cloud/compute/v1/internal/common_004.proto b/protos/google/cloud/compute/v1/internal/common_004.proto index 80253e9394bce..707e1afda13c7 100644 --- a/protos/google/cloud/compute/v1/internal/common_004.proto +++ b/protos/google/cloud/compute/v1/internal/common_004.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; diff --git a/protos/google/cloud/compute/v1/internal/common_005.proto b/protos/google/cloud/compute/v1/internal/common_005.proto index c2cde164f12c6..153ed2398e059 100644 --- a/protos/google/cloud/compute/v1/internal/common_005.proto +++ b/protos/google/cloud/compute/v1/internal/common_005.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; diff --git a/protos/google/cloud/compute/v1/internal/common_006.proto b/protos/google/cloud/compute/v1/internal/common_006.proto index d9b6ef9c8cf9b..cc130dc5f219b 100644 --- a/protos/google/cloud/compute/v1/internal/common_006.proto +++ b/protos/google/cloud/compute/v1/internal/common_006.proto @@ -15,14 +15,14 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_007.proto"; -import "google/cloud/compute/v1/internal/common_114.proto"; +import "google/cloud/compute/v1/internal/common_001.proto"; +import "google/cloud/compute/v1/internal/common_112.proto"; // This reservation type is specified by total resource amounts (e.g. total // count of CPUs) and can account for multiple instance SKUs. In other words, @@ -83,6 +83,43 @@ message AllocationResourceStatusSpecificSKUAllocation { [json_name = "sourceInstanceTemplateId"]; } +message AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk { + // Specifies the size of the disk in base-2 GB. + optional string disk_size_gb = 1 [json_name = "diskSizeGb"]; + + // Specifies the disk interface to use for attaching this disk, which is + // either SCSI or NVME. The default is SCSI. For performance characteristics + // of SCSI over NVMe, see Local SSD performance. + // NVME: + // SCSI: + optional string interface = 2 [json_name = "interface"]; +} + +// Properties of the SKU instances being reserved. Next ID: 9 +message AllocationSpecificSKUAllocationReservedInstanceProperties { + // Specifies accelerator type and count. + repeated AcceleratorConfig guest_accelerators = 1 + [json_name = "guestAccelerators"]; + + // Specifies amount of local ssd to reserve with each instance. The type of + // disk is local-ssd. + repeated + AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk + local_ssds = 2 [json_name = "localSsds"]; + + // An opaque location hint used to place the allocation close to other + // resources. This field is for use by internal tools that use the public API. + optional string location_hint = 3 [json_name = "locationHint"]; + + // Specifies type of machine (name only) which has fixed number of vCPUs and + // fixed amount of memory. This also includes specifying custom machine type + // following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. + optional string machine_type = 4 [json_name = "machineType"]; + + // Minimum cpu platform the reservation. + optional string min_cpu_platform = 5 [json_name = "minCpuPlatform"]; +} + // This reservation type allows to pre allocate specific instance configuration. message AllocationSpecificSKUReservation { // [Output Only] Indicates how many instances are actually usable currently. @@ -176,12 +213,16 @@ message Reservation { optional bool specific_reservation_required = 13 [json_name = "specificReservationRequired"]; - // [Output Only] The status of the reservation. - // CREATING: Resources are being allocated for the reservation. - // DELETING: Reservation is currently being deleted. + // [Output Only] The status of the reservation. - CREATING: Reservation + // resources are being allocated. - READY: Reservation resources have been + // allocated, and the reservation is ready for use. - DELETING: Reservation + // deletion is in progress. - UPDATING: Reservation update is in progress. + // CREATING: Reservation resources are being allocated. + // DELETING: Reservation deletion is in progress. // INVALID: - // READY: Reservation has allocated all its resources. - // UPDATING: Reservation is currently being resized. + // READY: Reservation resources have been allocated, and the reservation is + // ready for use. + // UPDATING: Reservation update is in progress. optional string status = 14 [json_name = "status"]; // Zone in which the reservation resides. A zone must be provided if the diff --git a/protos/google/cloud/compute/v1/internal/common_007.proto b/protos/google/cloud/compute/v1/internal/common_007.proto index 4d2f0aa6a1316..9ec94ace18916 100644 --- a/protos/google/cloud/compute/v1/internal/common_007.proto +++ b/protos/google/cloud/compute/v1/internal/common_007.proto @@ -15,47 +15,209 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_001.proto"; +import "google/cloud/compute/v1/internal/common_031.proto"; -message AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk { - // Specifies the size of the disk in base-2 GB. - optional string disk_size_gb = 1 [json_name = "diskSizeGb"]; +// Specifies the audit configuration for a service. The configuration determines +// which permission types are logged, and what identities, if any, are exempted +// from logging. An AuditConfig must have one or more AuditLogConfigs. If there +// are AuditConfigs for both `allServices` and a specific service, the union of +// the two AuditConfigs is used for that service: the log_types specified in +// each AuditConfig are enabled, and the exempted_members in each AuditLogConfig +// are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ +// { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", +// "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" +// }, { "log_type": "ADMIN_READ" } ] }, { "service": +// "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": +// "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ +// "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables +// DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts +// `jose@example.com` from DATA_READ logging, and `aliya@example.com` from +// DATA_WRITE logging. +message AuditConfig { + reserved 2; + // The configuration for logging of each type of permission. + repeated AuditLogConfig audit_log_configs = 1 [json_name = "auditLogConfigs"]; - // Specifies the disk interface to use for attaching this disk, which is - // either SCSI or NVME. The default is SCSI. For performance characteristics - // of SCSI over NVMe, see Local SSD performance. - // NVME: - // SCSI: - optional string interface = 2 [json_name = "interface"]; + // Specifies a service that will be enabled for audit logging. For example, + // `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a + // special value that covers all services. + optional string service = 3 [json_name = "service"]; } -// Properties of the SKU instances being reserved. Next ID: 9 -message AllocationSpecificSKUAllocationReservedInstanceProperties { - // Specifies accelerator type and count. - repeated AcceleratorConfig guest_accelerators = 1 - [json_name = "guestAccelerators"]; - - // Specifies amount of local ssd to reserve with each instance. The type of - // disk is local-ssd. - repeated - AllocationSpecificSKUAllocationAllocatedInstancePropertiesReservedDisk - local_ssds = 2 [json_name = "localSsds"]; - - // An opaque location hint used to place the allocation close to other - // resources. This field is for use by internal tools that use the public API. - optional string location_hint = 3 [json_name = "locationHint"]; - - // Specifies type of machine (name only) which has fixed number of vCPUs and - // fixed amount of memory. This also includes specifying custom machine type - // following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern. - optional string machine_type = 4 [json_name = "machineType"]; - - // Minimum cpu platform the reservation. - optional string min_cpu_platform = 5 [json_name = "minCpuPlatform"]; +// Provides the configuration for logging a type of permissions. Example: { +// "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ +// "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables +// 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from +// DATA_READ logging. +message AuditLogConfig { + reserved 2; + // Specifies the identities that do not cause logging for this type of + // permission. Follows the same format of Binding.members. + repeated string exempted_members = 1 [json_name = "exemptedMembers"]; + + // The log type that this config enables. + // ADMIN_READ: Admin reads. Example: CloudIAM getIamPolicy + // DATA_READ: Data reads. Example: CloudSQL Users list + // DATA_WRITE: Data writes. Example: CloudSQL Users create + // LOG_TYPE_UNSPECIFIED: Default case. Should never be this. + optional string log_type = 3 [json_name = "logType"]; +} + +// Associates `members`, or principals, with a `role`. +message Binding { + reserved 1; + // The condition that is associated with this binding. If the condition + // evaluates to `true`, then this binding applies to the current request. If + // the condition evaluates to `false`, then this binding does not apply to the + // current request. However, a different role binding might grant the same + // role to one or more of the principals in this binding. To learn which + // resources support conditions in their IAM policies, see the [IAM + // documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + optional Expr condition = 2 [json_name = "condition"]; + + // Specifies the principals requesting access for a Google Cloud resource. + // `members` can have the following values: * `allUsers`: A special identifier + // that represents anyone who is on the internet; with or without a Google + // account. * `allAuthenticatedUsers`: A special identifier that represents + // anyone who is authenticated with a Google account or a service account. + // Does not include identities that come from external identity providers + // (IdPs) through identity federation. * `user:{emailid}`: An email address + // that represents a specific Google account. For example, `alice@example.com` + // . * `serviceAccount:{emailid}`: An email address that represents a Google + // service account. For example, `my-other-app@appspot.gserviceaccount.com`. * + // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An + // identifier for a [Kubernetes service + // account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). + // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * + // `group:{emailid}`: An email address that represents a Google group. For + // example, `admins@example.com`. * `domain:{domain}`: The G Suite domain + // (primary) that represents all the users of that domain. For example, + // `google.com` or `example.com`. * + // `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: + // A single identity in a workforce identity pool. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: + // All workforce identities in a group. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: + // All workforce identities with a specific attribute value. * + // `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: + // All identities in a workforce identity pool. * + // `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: + // A single identity in a workload identity pool. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: + // A workload identity pool group. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: + // All identities in a workload identity pool with a certain attribute. * + // `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: + // All identities in a workload identity pool. * + // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique + // identifier) representing a user that has been recently deleted. For + // example, `alice@example.com?uid=123456789012345678901`. If the user is + // recovered, this value reverts to `user:{emailid}` and the recovered user + // retains the role in the binding. * + // `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus + // unique identifier) representing a service account that has been recently + // deleted. For example, + // `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If + // the service account is undeleted, this value reverts to + // `serviceAccount:{emailid}` and the undeleted service account retains the + // role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email + // address (plus unique identifier) representing a Google group that has been + // recently deleted. For example, + // `admins@example.com?uid=123456789012345678901`. If the group is recovered, + // this value reverts to `group:{emailid}` and the recovered group retains the + // role in the binding. * + // `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: + // Deleted single identity in a workforce identity pool. For example, + // `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`. + repeated string members = 3 [json_name = "members"]; + + // Role that is assigned to the list of `members`, or principals. For example, + // `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the + // IAM roles and permissions, see the [IAM + // documentation](https://cloud.google.com/iam/docs/roles-overview). For a + // list of the available pre-defined roles, see + // [here](https://cloud.google.com/iam/docs/understanding-roles). + optional string role = 4 [json_name = "role"]; +} + +// An Identity and Access Management (IAM) policy, which specifies access +// controls for Google Cloud resources. A `Policy` is a collection of +// `bindings`. A `binding` binds one or more `members`, or principals, to a +// single `role`. Principals can be user accounts, service accounts, Google +// groups, and domains (such as G Suite). A `role` is a named list of +// permissions; each `role` can be an IAM predefined role or a user-created +// custom role. For some types of Google Cloud resources, a `binding` can also +// specify a `condition`, which is a logical expression that allows access to a +// resource only if the expression evaluates to `true`. A condition can add +// constraints based on attributes of the request, the resource, or both. To +// learn which resources support conditions in their IAM policies, see the [IAM +// documentation](https://cloud.google.com/iam/help/conditions/resource-policies). +// **JSON example:** ``` { "bindings": [ { "role": +// "roles/resourcemanager.organizationAdmin", "members": [ +// "user:mike@example.com", "group:admins@example.com", "domain:google.com", +// "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": +// "roles/resourcemanager.organizationViewer", "members": [ +// "user:eve@example.com" ], "condition": { "title": "expirable access", +// "description": "Does not grant access after Sep 2020", "expression": +// "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": +// "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: +// - user:mike@example.com - group:admins@example.com - domain:google.com - +// serviceAccount:my-project-id@appspot.gserviceaccount.com role: +// roles/resourcemanager.organizationAdmin - members: - user:eve@example.com +// role: roles/resourcemanager.organizationViewer condition: title: expirable +// access description: Does not grant access after Sep 2020 expression: +// request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= +// version: 3 ``` For a description of IAM and its features, see the [IAM +// documentation](https://cloud.google.com/iam/docs/). +message Policy { + reserved 4; + // Specifies cloud audit logging configuration for this policy. + repeated AuditConfig audit_configs = 1 [json_name = "auditConfigs"]; + + // Associates a list of `members`, or principals, with a `role`. Optionally, + // may specify a `condition` that determines how and when the `bindings` are + // applied. Each of the `bindings` must contain at least one principal. The + // `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of + // these principals can be Google groups. Each occurrence of a principal + // counts towards these limits. For example, if the `bindings` grant 50 + // different roles to `user:alice@example.com`, and not to any other + // principal, then you can add another 1,450 principals to the `bindings` in + // the `Policy`. + repeated Binding bindings = 2 [json_name = "bindings"]; + + // `etag` is used for optimistic concurrency control as a way to help prevent + // simultaneous updates of a policy from overwriting each other. It is + // strongly suggested that systems make use of the `etag` in the + // read-modify-write cycle to perform policy updates in order to avoid race + // conditions: An `etag` is returned in the response to `getIamPolicy`, and + // systems are expected to put that etag in the request to `setIamPolicy` to + // ensure that their change will be applied to the same version of the policy. + // **Important:** If you use IAM Conditions, you must include the `etag` field + // whenever you call `setIamPolicy`. If you omit this field, then IAM allows + // you to overwrite a version `3` policy with a version `1` policy, and all of + // the conditions in the version `3` policy are lost. + optional string etag = 3 [json_name = "etag"]; + + // Specifies the format of the policy. Valid values are `0`, `1`, and `3`. + // Requests that specify an invalid value are rejected. Any operation that + // affects conditional role bindings must specify version `3`. This + // requirement applies to the following operations: * Getting a policy that + // includes a conditional role binding * Adding a conditional role binding to + // a policy * Changing a conditional role binding in a policy * Removing any + // role binding, with or without a condition, from a policy that includes + // conditions **Important:** If you use IAM Conditions, you must include the + // `etag` field whenever you call `setIamPolicy`. If you omit this field, then + // IAM allows you to overwrite a version `3` policy with a version `1` policy, + // and all of the conditions in the version `3` policy are lost. If a policy + // does not include any conditions, operations on that policy may specify any + // valid version or leave the field unset. To learn which resources support + // conditions in their IAM policies, see the [IAM + // documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + optional int32 version = 5 [json_name = "version"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_008.proto b/protos/google/cloud/compute/v1/internal/common_008.proto index a9db308ecfe68..04bc24c06d1e8 100644 --- a/protos/google/cloud/compute/v1/internal/common_008.proto +++ b/protos/google/cloud/compute/v1/internal/common_008.proto @@ -15,339 +15,419 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_032.proto"; - -// Specifies the audit configuration for a service. The configuration determines -// which permission types are logged, and what identities, if any, are exempted -// from logging. An AuditConfig must have one or more AuditLogConfigs. If there -// are AuditConfigs for both `allServices` and a specific service, the union of -// the two AuditConfigs is used for that service: the log_types specified in -// each AuditConfig are enabled, and the exempted_members in each AuditLogConfig -// are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ -// { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", -// "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" -// }, { "log_type": "ADMIN_READ" } ] }, { "service": -// "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": -// "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ -// "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables -// DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts -// jose@example.com from DATA_READ logging, and aliya@example.com from -// DATA_WRITE logging. -message AuditConfig { - // The configuration for logging of each type of permission. - repeated AuditLogConfig audit_log_configs = 1 [json_name = "auditLogConfigs"]; - - // This is deprecated and has no effect. Do not use. - repeated string exempted_members = 2 [json_name = "exemptedMembers"]; - - // Specifies a service that will be enabled for audit logging. For example, - // `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a - // special value that covers all services. - optional string service = 3 [json_name = "service"]; -} +import "google/cloud/compute/v1/internal/common_039.proto"; + +// Represents an Autoscaler resource. Google Compute Engine has two Autoscaler +// resources: * [Zonal](/compute/docs/reference/rest/v1/autoscalers) * +// [Regional](/compute/docs/reference/rest/v1/regionAutoscalers) Use autoscalers +// to automatically add or delete instances from a managed instance group +// according to your defined autoscaling policy. For more information, read +// Autoscaling Groups of Instances. For zonal managed instance groups resource, +// use the autoscaler resource. For regional managed instance groups, use the +// regionAutoscalers resource. +message Autoscaler { + // The configuration parameters for the autoscaling algorithm. You can define + // one or more signals for an autoscaler: cpuUtilization, + // customMetricUtilizations, and loadBalancingUtilization. If none of these + // are specified, the default will be to autoscale based on cpuUtilization to + // 0.6 or 60%. + optional AutoscalingPolicy autoscaling_policy = 1 + [json_name = "autoscalingPolicy"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; -// Provides the configuration for logging a type of permissions. Example: { -// "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ -// "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables -// 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from -// DATA_READ logging. -message AuditLogConfig { - // Specifies the identities that do not cause logging for this type of - // permission. Follows the same format of Binding.members. - repeated string exempted_members = 1 [json_name = "exemptedMembers"]; - - // This is deprecated and has no effect. Do not use. - optional bool ignore_child_exemptions = 2 - [json_name = "ignoreChildExemptions"]; - - // The log type that this config enables. - // ADMIN_READ: Admin reads. Example: CloudIAM getIamPolicy - // DATA_READ: Data reads. Example: CloudSQL Users list - // DATA_WRITE: Data writes. Example: CloudSQL Users create - // LOG_TYPE_UNSPECIFIED: Default case. Should never be this. - optional string log_type = 3 [json_name = "logType"]; + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#autoscaler for + // autoscalers. + optional string kind = 5 [json_name = "kind"]; + + // 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. + optional string name = 6 [json_name = "name"]; + + // [Output Only] Target recommended MIG size (number of instances) computed by + // autoscaler. Autoscaler calculates the recommended MIG size even when the + // autoscaling policy mode is different from ON. This field is empty when + // autoscaler is not connected to an existing managed instance group or + // autoscaler did not generate its prediction. + optional int32 recommended_size = 7 [json_name = "recommendedSize"]; + + // [Output Only] URL of the region where the instance group resides (for + // autoscalers living in regional scope). + optional string region = 8 [json_name = "region"]; + + // [Output Only] Status information of existing scaling schedules. + map scaling_schedule_status = 9 + [json_name = "scalingScheduleStatus"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 10 [json_name = "selfLink"]; + + // [Output Only] The status of the autoscaler configuration. Current set of + // possible values: - PENDING: Autoscaler backend hasn't read new/updated + // configuration. - DELETING: Configuration is being deleted. - ACTIVE: + // Configuration is acknowledged to be effective. Some warnings might be + // present in the statusDetails field. - ERROR: Configuration has errors. + // Actionable for users. Details are present in the statusDetails field. New + // values might be added in the future. + // ACTIVE: Configuration is acknowledged to be effective + // DELETING: Configuration is being deleted + // ERROR: Configuration has errors. Actionable for users. + // PENDING: Autoscaler backend hasn't read new/updated configuration + optional string status = 11 [json_name = "status"]; + + // [Output Only] Human-readable details about the current state of the + // autoscaler. Read the documentation for Commonly returned status messages + // for examples of status messages you might encounter. + repeated AutoscalerStatusDetails status_details = 12 + [json_name = "statusDetails"]; + + // URL of the managed instance group that this autoscaler will scale. This + // field is required when creating an autoscaler. + optional string target = 13 [json_name = "target"]; + + // [Output Only] URL of the zone where the instance group resides (for + // autoscalers living in zonal scope). + optional string zone = 14 [json_name = "zone"]; } -// Associates `members`, or principals, with a `role`. -message Binding { - // This is deprecated and has no effect. Do not use. - optional string binding_id = 1 [json_name = "bindingId"]; - - // The condition that is associated with this binding. If the condition - // evaluates to `true`, then this binding applies to the current request. If - // the condition evaluates to `false`, then this binding does not apply to the - // current request. However, a different role binding might grant the same - // role to one or more of the principals in this binding. To learn which - // resources support conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-policies). - optional Expr condition = 2 [json_name = "condition"]; - - // Specifies the principals requesting access for a Google Cloud resource. - // `members` can have the following values: * `allUsers`: A special identifier - // that represents anyone who is on the internet; with or without a Google - // account. * `allAuthenticatedUsers`: A special identifier that represents - // anyone who is authenticated with a Google account or a service account. - // Does not include identities that come from external identity providers - // (IdPs) through identity federation. * `user:{emailid}`: An email address - // that represents a specific Google account. For example, `alice@example.com` - // . * `serviceAccount:{emailid}`: An email address that represents a Google - // service account. For example, `my-other-app@appspot.gserviceaccount.com`. * - // `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An - // identifier for a [Kubernetes service - // account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). - // For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * - // `group:{emailid}`: An email address that represents a Google group. For - // example, `admins@example.com`. * `domain:{domain}`: The G Suite domain - // (primary) that represents all the users of that domain. For example, - // `google.com` or `example.com`. * - // `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: - // A single identity in a workforce identity pool. * - // `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: - // All workforce identities in a group. * - // `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: - // All workforce identities with a specific attribute value. * - // `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: - // All identities in a workforce identity pool. * - // `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: - // A single identity in a workload identity pool. * - // `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: - // A workload identity pool group. * - // `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: - // All identities in a workload identity pool with a certain attribute. * - // `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: - // All identities in a workload identity pool. * - // `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique - // identifier) representing a user that has been recently deleted. For - // example, `alice@example.com?uid=123456789012345678901`. If the user is - // recovered, this value reverts to `user:{emailid}` and the recovered user - // retains the role in the binding. * - // `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus - // unique identifier) representing a service account that has been recently - // deleted. For example, - // `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If - // the service account is undeleted, this value reverts to - // `serviceAccount:{emailid}` and the undeleted service account retains the - // role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email - // address (plus unique identifier) representing a Google group that has been - // recently deleted. For example, - // `admins@example.com?uid=123456789012345678901`. If the group is recovered, - // this value reverts to `group:{emailid}` and the recovered group retains the - // role in the binding. * - // `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: - // Deleted single identity in a workforce identity pool. For example, - // `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`. - repeated string members = 3 [json_name = "members"]; - - // Role that is assigned to the list of `members`, or principals. For example, - // `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the - // IAM roles and permissions, see the [IAM - // documentation](https://cloud.google.com/iam/docs/roles-overview). For a - // list of the available pre-defined roles, see - // [here](https://cloud.google.com/iam/docs/understanding-roles). - optional string role = 4 [json_name = "role"]; +message AutoscalerStatusDetails { + // The status message. + optional string message = 1 [json_name = "message"]; + + // The type of error, warning, or notice returned. Current set of possible + // values: - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance + // group are unhealthy (not in RUNNING state). - + // BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend service + // attached to the instance group. - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): + // Autoscaler recommends a size greater than maxNumReplicas. - + // CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric samples + // are not exported often enough to be a credible base for autoscaling. - + // CUSTOM_METRIC_INVALID (ERROR): The custom metric that was specified does + // not exist or does not have the necessary labels. - MIN_EQUALS_MAX + // (WARNING): The minNumReplicas is equal to maxNumReplicas. This means the + // autoscaler cannot add or remove instances from the instance group. - + // MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not receive + // any data from the custom metric configured for autoscaling. - + // MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is configured + // to scale based on a load balancing signal but the instance group has not + // received any requests from the load balancer. - MODE_OFF (WARNING): + // Autoscaling is turned off. The number of instances in the group won't + // change automatically. The autoscaling configuration is preserved. - + // MODE_ONLY_UP (WARNING): Autoscaling is in the "Autoscale only out" mode. + // The autoscaler can add instances but not remove any. - + // MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot be + // autoscaled because it has more than one backend service attached to it. - + // NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient quota for the + // necessary resources, such as CPU or number of instances. - + // REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional autoscalers: + // there is a resource stockout in the chosen region. - + // SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled does not + // exist. - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): + // Autoscaling does not work with an HTTP/S load balancer that has been + // configured for maxRate. - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal + // autoscalers: there is a resource stockout in the chosen zone. For regional + // autoscalers: in at least one of the zones you're using there is a resource + // stockout. New values might be added in the future. Some of the values might + // not be available in all API versions. + // ALL_INSTANCES_UNHEALTHY: All instances in the instance group are unhealthy + // (not in RUNNING state). + // BACKEND_SERVICE_DOES_NOT_EXIST: There is no backend service attached to the + // instance group. + // CAPPED_AT_MAX_NUM_REPLICAS: Autoscaler recommends a size greater than + // maxNumReplicas. + // CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE: The custom metric samples are not + // exported often enough to be a credible base for autoscaling. + // CUSTOM_METRIC_INVALID: The custom metric that was specified does not exist + // or does not have the necessary labels. + // MIN_EQUALS_MAX: The minNumReplicas is equal to maxNumReplicas. This means + // the autoscaler cannot add or remove instances from the instance group. + // MISSING_CUSTOM_METRIC_DATA_POINTS: The autoscaler did not receive any data + // from the custom metric configured for autoscaling. + // MISSING_LOAD_BALANCING_DATA_POINTS: The autoscaler is configured to scale + // based on a load balancing signal but the instance group has not received + // any requests from the load balancer. + // MODE_OFF: Autoscaling is turned off. The number of instances in the group + // won't change automatically. The autoscaling configuration is preserved. + // MODE_ONLY_SCALE_OUT: Autoscaling is in the "Autoscale only scale out" mode. + // Instances in the group will be only added. + // MODE_ONLY_UP: Autoscaling is in the "Autoscale only out" mode. Instances in + // the group will be only added. + // MORE_THAN_ONE_BACKEND_SERVICE: The instance group cannot be autoscaled + // because it has more than one backend service attached to it. + // NOT_ENOUGH_QUOTA_AVAILABLE: There is insufficient quota for the necessary + // resources, such as CPU or number of instances. + // REGION_RESOURCE_STOCKOUT: Showed only for regional autoscalers: there is a + // resource stockout in the chosen region. + // SCALING_TARGET_DOES_NOT_EXIST: The target to be scaled does not exist. + // SCHEDULED_INSTANCES_GREATER_THAN_AUTOSCALER_MAX: For some scaling schedules + // minRequiredReplicas is greater than maxNumReplicas. Autoscaler always + // recommends at most maxNumReplicas instances. + // SCHEDULED_INSTANCES_LESS_THAN_AUTOSCALER_MIN: For some scaling schedules + // minRequiredReplicas is less than minNumReplicas. Autoscaler always + // recommends at least minNumReplicas instances. + // UNKNOWN: + // UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION: Autoscaling does not + // work with an HTTP/S load balancer that has been configured for maxRate. + // ZONE_RESOURCE_STOCKOUT: For zonal autoscalers: there is a resource stockout + // in the chosen zone. For regional autoscalers: in at least one of the zones + // you're using there is a resource stockout. + optional string type = 2 [json_name = "type"]; } -// This is deprecated and has no effect. Do not use. -message Condition { - // This is deprecated and has no effect. Do not use. - // APPROVER: This is deprecated and has no effect. Do not use. - // ATTRIBUTION: This is deprecated and has no effect. Do not use. - // AUTHORITY: This is deprecated and has no effect. Do not use. - // CREDENTIALS_TYPE: This is deprecated and has no effect. Do not use. - // CREDS_ASSERTION: This is deprecated and has no effect. Do not use. - // JUSTIFICATION_TYPE: This is deprecated and has no effect. Do not use. - // NO_ATTR: This is deprecated and has no effect. Do not use. - // SECURITY_REALM: This is deprecated and has no effect. Do not use. - optional string iam = 1 [json_name = "iam"]; - - // This is deprecated and has no effect. Do not use. - // DISCHARGED: This is deprecated and has no effect. Do not use. - // EQUALS: This is deprecated and has no effect. Do not use. - // IN: This is deprecated and has no effect. Do not use. - // NOT_EQUALS: This is deprecated and has no effect. Do not use. - // NOT_IN: This is deprecated and has no effect. Do not use. - // NO_OP: This is deprecated and has no effect. Do not use. - optional string op = 2 [json_name = "op"]; - - // This is deprecated and has no effect. Do not use. - optional string svc = 3 [json_name = "svc"]; - - // This is deprecated and has no effect. Do not use. - // IP: This is deprecated and has no effect. Do not use. - // NAME: This is deprecated and has no effect. Do not use. - // NO_ATTR: This is deprecated and has no effect. Do not use. - // REGION: This is deprecated and has no effect. Do not use. - // SERVICE: This is deprecated and has no effect. Do not use. - optional string sys = 4 [json_name = "sys"]; - - // This is deprecated and has no effect. Do not use. - repeated string values = 5 [json_name = "values"]; +// Cloud Autoscaler policy. +message AutoscalingPolicy { + // The number of seconds that your application takes to initialize on a VM + // instance. This is referred to as the [initialization + // period](/compute/docs/autoscaler#cool_down_period). Specifying an accurate + // initialization period improves autoscaler decisions. For example, when + // scaling out, the autoscaler ignores data from VMs that are still + // initializing because those VMs might not yet represent normal usage of your + // application. The default initialization period is 60 seconds. + // Initialization periods might vary because of numerous factors. We recommend + // that you test how long your application takes to initialize. To do this, + // create a VM and time your application's startup process. + optional int32 cool_down_period_sec = 1 [json_name = "coolDownPeriodSec"]; + + // Defines the CPU utilization policy that allows the autoscaler to scale + // based on the average CPU utilization of a managed instance group. + optional AutoscalingPolicyCpuUtilization cpu_utilization = 2 + [json_name = "cpuUtilization"]; + + // Configuration parameters of autoscaling based on a custom metric. + repeated AutoscalingPolicyCustomMetricUtilization custom_metric_utilizations = + 3 [json_name = "customMetricUtilizations"]; + + // Configuration parameters of autoscaling based on load balancer. + optional AutoscalingPolicyLoadBalancingUtilization + load_balancing_utilization = 4 [json_name = "loadBalancingUtilization"]; + + // The maximum number of instances that the autoscaler can scale out to. This + // is required when creating or updating an autoscaler. The maximum number of + // replicas must not be lower than minimal number of replicas. + optional int32 max_num_replicas = 5 [json_name = "maxNumReplicas"]; + + // The minimum number of replicas that the autoscaler can scale in to. This + // cannot be less than 0. If not provided, autoscaler chooses a default value + // depending on maximum number of instances allowed. + optional int32 min_num_replicas = 6 [json_name = "minNumReplicas"]; + + // Defines the operating mode for this policy. The following modes are + // available: - OFF: Disables the autoscaler but maintains its configuration. + // - ONLY_SCALE_OUT: Restricts the autoscaler to add VM instances only. - ON: + // Enables all autoscaler activities according to its policy. For more + // information, see "Turning off or restricting an autoscaler" + // OFF: Do not automatically scale the MIG in or out. The recommended_size + // field contains the size of MIG that would be set if the actuation mode was + // enabled. + // ON: Automatically scale the MIG in and out according to the policy. + // ONLY_SCALE_OUT: Automatically create VMs according to the policy, but do + // not scale the MIG in. + // ONLY_UP: Automatically create VMs according to the policy, but do not scale + // the MIG in. + optional string mode = 7 [json_name = "mode"]; + + optional AutoscalingPolicyScaleInControl scale_in_control = 8 + [json_name = "scaleInControl"]; + + // Scaling schedules defined for an autoscaler. Multiple schedules can be set + // on an autoscaler, and they can overlap. During overlapping periods the + // greatest min_required_replicas of all scaling schedules is applied. Up to + // 128 scaling schedules are allowed. + map scaling_schedules = 9 + [json_name = "scalingSchedules"]; } -// This is deprecated and has no effect. Do not use. -message LogConfig { - // This is deprecated and has no effect. Do not use. - optional LogConfigCloudAuditOptions cloud_audit = 1 - [json_name = "cloudAudit"]; - - // This is deprecated and has no effect. Do not use. - optional LogConfigCounterOptions counter = 2 [json_name = "counter"]; - - // This is deprecated and has no effect. Do not use. - optional LogConfigDataAccessOptions data_access = 3 - [json_name = "dataAccess"]; +// CPU utilization policy. +message AutoscalingPolicyCpuUtilization { + // Indicates whether predictive autoscaling based on CPU metric is enabled. + // Valid values are: * NONE (default). No predictive method is used. The + // autoscaler scales the group to meet current demand based on real-time + // metrics. * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves + // availability by monitoring daily and weekly load patterns and scaling out + // ahead of anticipated demand. + // NONE: No predictive method is used. The autoscaler scales the group to meet + // current demand based on real-time metrics + // OPTIMIZE_AVAILABILITY: Predictive autoscaling improves availability by + // monitoring daily and weekly load patterns and scaling out ahead of + // anticipated demand. + optional string predictive_method = 1 [json_name = "predictiveMethod"]; + + // The target CPU utilization that the autoscaler maintains. Must be a float + // value in the range (0, 1]. If not specified, the default is 0.6. If the CPU + // level is below the target utilization, the autoscaler scales in the number + // of instances until it reaches the minimum number of instances you specified + // or until the average CPU of your instances reaches the target utilization. + // If the average CPU is above the target utilization, the autoscaler scales + // out until it reaches the maximum number of instances you specified or until + // the average utilization reaches the target utilization. + optional double utilization_target = 2 [json_name = "utilizationTarget"]; } -// This is deprecated and has no effect. Do not use. -message LogConfigCloudAuditOptions { - reserved 1; - // This is deprecated and has no effect. Do not use. - // ADMIN_ACTIVITY: This is deprecated and has no effect. Do not use. - // DATA_ACCESS: This is deprecated and has no effect. Do not use. - // UNSPECIFIED_LOG_NAME: This is deprecated and has no effect. Do not use. - optional string log_name = 2 [json_name = "logName"]; -} - -// This is deprecated and has no effect. Do not use. -message LogConfigCounterOptions { - // This is deprecated and has no effect. Do not use. - repeated LogConfigCounterOptionsCustomField custom_fields = 1 - [json_name = "customFields"]; - - // This is deprecated and has no effect. Do not use. - optional string field = 2 [json_name = "field"]; - - // This is deprecated and has no effect. Do not use. - optional string metric = 3 [json_name = "metric"]; +// Custom utilization metric policy. +message AutoscalingPolicyCustomMetricUtilization { + // A filter string, compatible with a Stackdriver Monitoring filter string for + // TimeSeries.list API call. This filter is used to select a specific + // TimeSeries for the purpose of autoscaling and to determine whether the + // metric is exporting per-instance or per-group data. For the filter to be + // valid for autoscaling purposes, the following rules apply: - You can only + // use the AND operator for joining selectors. - You can only use direct + // equality comparison operator (=) without any functions for each selector. - + // You can specify the metric in both the filter string and in the metric + // field. However, if specified in both places, the metric must be identical. + // - The monitored resource type determines what kind of values are expected + // for the metric. If it is a gce_instance, the autoscaler expects the metric + // to include a separate TimeSeries for each instance in a group. In such a + // case, you cannot filter on resource labels. If the resource type is any + // other value, the autoscaler expects this metric to contain values that + // apply to the entire autoscaled instance group and resource label filtering + // can be performed to point autoscaler at the correct TimeSeries to scale + // upon. This is called a *per-group metric* for the purpose of autoscaling. + // If not specified, the type defaults to gce_instance. Try to provide a + // filter that is selective enough to pick just one TimeSeries for the + // autoscaled group or for each of the instances (if you are using + // gce_instance resource type). If multiple TimeSeries are returned upon the + // query execution, the autoscaler will sum their respective values to obtain + // its scaling value. + optional string filter = 1 [json_name = "filter"]; + + // The identifier (type) of the Stackdriver Monitoring metric. The metric + // cannot have negative values. The metric must have a value type of INT64 or + // DOUBLE. + optional string metric = 2 [json_name = "metric"]; + + // If scaling is based on a per-group metric value that represents the total + // amount of work to be done or resource usage, set this value to an amount + // assigned for a single instance of the scaled group. Autoscaler keeps the + // number of instances proportional to the value of this metric. The metric + // itself does not change value due to group resizing. A good metric to use + // with the target is for example + // pubsub.googleapis.com/subscription/num_undelivered_messages or a custom + // metric exporting the total number of requests coming to your instances. A + // bad example would be a metric exporting an average or median latency, since + // this value can't include a chunk assignable to a single instance, it could + // be better used with utilization_target instead. + optional double single_instance_assignment = 3 + [json_name = "singleInstanceAssignment"]; + + // The target value of the metric that autoscaler maintains. This must be a + // positive value. A utilization metric scales number of virtual machines + // handling requests to increase or decrease proportionally to the metric. For + // example, a good metric to use as a utilization_target is + // https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. + // The autoscaler works to keep this value constant for each of the instances. + optional double utilization_target = 4 [json_name = "utilizationTarget"]; + + // Defines how target utilization value is expressed for a Stackdriver + // Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. + // DELTA_PER_MINUTE: Sets the utilization target value for a cumulative or + // delta metric, expressed as the rate of growth per minute. + // DELTA_PER_SECOND: Sets the utilization target value for a cumulative or + // delta metric, expressed as the rate of growth per second. + // GAUGE: Sets the utilization target value for a gauge metric. The autoscaler + // will collect the average utilization of the virtual machines from the last + // couple of minutes, and compare the value to the utilization target value to + // perform autoscaling. + optional string utilization_target_type = 5 + [json_name = "utilizationTargetType"]; } -// This is deprecated and has no effect. Do not use. -message LogConfigCounterOptionsCustomField { - // This is deprecated and has no effect. Do not use. - optional string name = 1 [json_name = "name"]; - - // This is deprecated and has no effect. Do not use. - optional string value = 2 [json_name = "value"]; +// Configuration parameters of autoscaling based on load balancing. +message AutoscalingPolicyLoadBalancingUtilization { + // Fraction of backend capacity utilization (set in HTTP(S) load balancing + // configuration) that the autoscaler maintains. Must be a positive float + // value. If not defined, the default is 0.8. + optional double utilization_target = 1 [json_name = "utilizationTarget"]; } -// This is deprecated and has no effect. Do not use. -message LogConfigDataAccessOptions { - // This is deprecated and has no effect. Do not use. - // LOG_FAIL_CLOSED: This is deprecated and has no effect. Do not use. - // LOG_MODE_UNSPECIFIED: This is deprecated and has no effect. Do not use. - optional string log_mode = 1 [json_name = "logMode"]; +// Configuration that allows for slower scale in so that even if Autoscaler +// recommends an abrupt scale in of a MIG, it will be throttled as specified by +// the parameters below. +message AutoscalingPolicyScaleInControl { + // Maximum allowed number (or %) of VMs that can be deducted from the peak + // recommendation during the window autoscaler looks at when computing + // recommendations. Possibly all these VMs can be deleted at once so user + // service needs to be prepared to lose that many VMs in one step. + optional FixedOrPercent max_scaled_in_replicas = 1 + [json_name = "maxScaledInReplicas"]; + + // How far back autoscaling looks when computing recommendations to include + // directives regarding slower scale in, as described above. + optional int32 time_window_sec = 2 [json_name = "timeWindowSec"]; } -// An Identity and Access Management (IAM) policy, which specifies access -// controls for Google Cloud resources. A `Policy` is a collection of -// `bindings`. A `binding` binds one or more `members`, or principals, to a -// single `role`. Principals can be user accounts, service accounts, Google -// groups, and domains (such as G Suite). A `role` is a named list of -// permissions; each `role` can be an IAM predefined role or a user-created -// custom role. For some types of Google Cloud resources, a `binding` can also -// specify a `condition`, which is a logical expression that allows access to a -// resource only if the expression evaluates to `true`. A condition can add -// constraints based on attributes of the request, the resource, or both. To -// learn which resources support conditions in their IAM policies, see the [IAM -// documentation](https://cloud.google.com/iam/help/conditions/resource-policies). -// **JSON example:** ``` { "bindings": [ { "role": -// "roles/resourcemanager.organizationAdmin", "members": [ -// "user:mike@example.com", "group:admins@example.com", "domain:google.com", -// "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": -// "roles/resourcemanager.organizationViewer", "members": [ -// "user:eve@example.com" ], "condition": { "title": "expirable access", -// "description": "Does not grant access after Sep 2020", "expression": -// "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": -// "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: -// - user:mike@example.com - group:admins@example.com - domain:google.com - -// serviceAccount:my-project-id@appspot.gserviceaccount.com role: -// roles/resourcemanager.organizationAdmin - members: - user:eve@example.com -// role: roles/resourcemanager.organizationViewer condition: title: expirable -// access description: Does not grant access after Sep 2020 expression: -// request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= -// version: 3 ``` For a description of IAM and its features, see the [IAM -// documentation](https://cloud.google.com/iam/docs/). -message Policy { - // Specifies cloud audit logging configuration for this policy. - repeated AuditConfig audit_configs = 1 [json_name = "auditConfigs"]; - - // Associates a list of `members`, or principals, with a `role`. Optionally, - // may specify a `condition` that determines how and when the `bindings` are - // applied. Each of the `bindings` must contain at least one principal. The - // `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of - // these principals can be Google groups. Each occurrence of a principal - // counts towards these limits. For example, if the `bindings` grant 50 - // different roles to `user:alice@example.com`, and not to any other - // principal, then you can add another 1,450 principals to the `bindings` in - // the `Policy`. - repeated Binding bindings = 2 [json_name = "bindings"]; - - // `etag` is used for optimistic concurrency control as a way to help prevent - // simultaneous updates of a policy from overwriting each other. It is - // strongly suggested that systems make use of the `etag` in the - // read-modify-write cycle to perform policy updates in order to avoid race - // conditions: An `etag` is returned in the response to `getIamPolicy`, and - // systems are expected to put that etag in the request to `setIamPolicy` to - // ensure that their change will be applied to the same version of the policy. - // **Important:** If you use IAM Conditions, you must include the `etag` field - // whenever you call `setIamPolicy`. If you omit this field, then IAM allows - // you to overwrite a version `3` policy with a version `1` policy, and all of - // the conditions in the version `3` policy are lost. - optional string etag = 3 [json_name = "etag"]; - - // This is deprecated and has no effect. Do not use. - repeated Rule rules = 4 [json_name = "rules"]; - - // Specifies the format of the policy. Valid values are `0`, `1`, and `3`. - // Requests that specify an invalid value are rejected. Any operation that - // affects conditional role bindings must specify version `3`. This - // requirement applies to the following operations: * Getting a policy that - // includes a conditional role binding * Adding a conditional role binding to - // a policy * Changing a conditional role binding in a policy * Removing any - // role binding, with or without a condition, from a policy that includes - // conditions **Important:** If you use IAM Conditions, you must include the - // `etag` field whenever you call `setIamPolicy`. If you omit this field, then - // IAM allows you to overwrite a version `3` policy with a version `1` policy, - // and all of the conditions in the version `3` policy are lost. If a policy - // does not include any conditions, operations on that policy may specify any - // valid version or leave the field unset. To learn which resources support - // conditions in their IAM policies, see the [IAM - // documentation](https://cloud.google.com/iam/help/conditions/resource-policies). - optional int32 version = 5 [json_name = "version"]; +// Scaling based on user-defined schedule. The message describes a single +// scaling schedule. A scaling schedule changes the minimum number of VM +// instances an autoscaler can recommend, which can trigger scaling out. +message AutoscalingPolicyScalingSchedule { + // A description of a scaling schedule. + optional string description = 1 [json_name = "description"]; + + // A boolean value that specifies whether a scaling schedule can influence + // autoscaler recommendations. If set to true, then a scaling schedule has no + // effect. This field is optional, and its value is false by default. + optional bool disabled = 2 [json_name = "disabled"]; + + // The duration of time intervals, in seconds, for which this scaling schedule + // is to run. The minimum allowed value is 300. This field is required. + optional int32 duration_sec = 3 [json_name = "durationSec"]; + + // The minimum number of VM instances that the autoscaler will recommend in + // time intervals starting according to schedule. This field is required. + optional int32 min_required_replicas = 4 [json_name = "minRequiredReplicas"]; + + // The start timestamps of time intervals when this scaling schedule is to + // provide a scaling signal. This field uses the extended cron format (with an + // optional year field). The expression can describe a single timestamp if the + // optional year is set, in which case the scaling schedule runs once. The + // schedule is interpreted with respect to time_zone. This field is required. + // Note: These timestamps only describe when autoscaler starts providing the + // scaling signal. The VMs need additional time to become serving. + optional string schedule = 5 [json_name = "schedule"]; + + // The time zone to use when interpreting the schedule. The value of this + // field must be a time zone name from the tz database: + // https://en.wikipedia.org/wiki/Tz_database. This field is assigned a default + // value of "UTC" if left empty. + optional string time_zone = 6 [json_name = "timeZone"]; } -// This is deprecated and has no effect. Do not use. -message Rule { - // This is deprecated and has no effect. Do not use. - // ALLOW: This is deprecated and has no effect. Do not use. - // ALLOW_WITH_LOG: This is deprecated and has no effect. Do not use. - // DENY: This is deprecated and has no effect. Do not use. - // DENY_WITH_LOG: This is deprecated and has no effect. Do not use. - // LOG: This is deprecated and has no effect. Do not use. - // NO_ACTION: This is deprecated and has no effect. Do not use. - optional string action = 1 [json_name = "action"]; - - // This is deprecated and has no effect. Do not use. - repeated Condition conditions = 2 [json_name = "conditions"]; - - // This is deprecated and has no effect. Do not use. - optional string description = 3 [json_name = "description"]; - - // This is deprecated and has no effect. Do not use. - repeated string ins = 4 [json_name = "ins"]; - - // This is deprecated and has no effect. Do not use. - repeated LogConfig log_configs = 5 [json_name = "logConfigs"]; - - // This is deprecated and has no effect. Do not use. - repeated string not_ins = 6 [json_name = "notIns"]; - - // This is deprecated and has no effect. Do not use. - repeated string permissions = 7 [json_name = "permissions"]; +message ScalingScheduleStatus { + // [Output Only] The last time the scaling schedule became active. Note: this + // is a timestamp when a schedule actually became active, not when it was + // planned to do so. The timestamp is in RFC3339 text format. + optional string last_start_time = 1 [json_name = "lastStartTime"]; + + // [Output Only] The next time the scaling schedule is to become active. Note: + // this is a timestamp when a schedule is planned to run, but the actual time + // might be slightly different. The timestamp is in RFC3339 text format. + optional string next_start_time = 2 [json_name = "nextStartTime"]; + + // [Output Only] The current state of a scaling schedule. + // ACTIVE: The current autoscaling recommendation is influenced by this + // scaling schedule. + // DISABLED: This scaling schedule has been disabled by the user. + // OBSOLETE: This scaling schedule will never become active again. + // READY: The current autoscaling recommendation is not influenced by this + // scaling schedule. + optional string state = 3 [json_name = "state"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_009.proto b/protos/google/cloud/compute/v1/internal/common_009.proto index 2c3ef4abd4e55..cfd9daf210aee 100644 --- a/protos/google/cloud/compute/v1/internal/common_009.proto +++ b/protos/google/cloud/compute/v1/internal/common_009.proto @@ -15,419 +15,317 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_040.proto"; - -// Represents an Autoscaler resource. Google Compute Engine has two Autoscaler -// resources: * [Zonal](/compute/docs/reference/rest/v1/autoscalers) * -// [Regional](/compute/docs/reference/rest/v1/regionAutoscalers) Use autoscalers -// to automatically add or delete instances from a managed instance group -// according to your defined autoscaling policy. For more information, read -// Autoscaling Groups of Instances. For zonal managed instance groups resource, -// use the autoscaler resource. For regional managed instance groups, use the -// regionAutoscalers resource. -message Autoscaler { - // The configuration parameters for the autoscaling algorithm. You can define - // one or more signals for an autoscaler: cpuUtilization, - // customMetricUtilizations, and loadBalancingUtilization. If none of these - // are specified, the default will be to autoscale based on cpuUtilization to - // 0.6 or 60%. - optional AutoscalingPolicy autoscaling_policy = 1 - [json_name = "autoscalingPolicy"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 4 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#autoscaler for - // autoscalers. - optional string kind = 5 [json_name = "kind"]; - - // 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. - optional string name = 6 [json_name = "name"]; - - // [Output Only] Target recommended MIG size (number of instances) computed by - // autoscaler. Autoscaler calculates the recommended MIG size even when the - // autoscaling policy mode is different from ON. This field is empty when - // autoscaler is not connected to an existing managed instance group or - // autoscaler did not generate its prediction. - optional int32 recommended_size = 7 [json_name = "recommendedSize"]; - - // [Output Only] URL of the region where the instance group resides (for - // autoscalers living in regional scope). - optional string region = 8 [json_name = "region"]; - - // [Output Only] Status information of existing scaling schedules. - map scaling_schedule_status = 9 - [json_name = "scalingScheduleStatus"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 10 [json_name = "selfLink"]; - - // [Output Only] The status of the autoscaler configuration. Current set of - // possible values: - PENDING: Autoscaler backend hasn't read new/updated - // configuration. - DELETING: Configuration is being deleted. - ACTIVE: - // Configuration is acknowledged to be effective. Some warnings might be - // present in the statusDetails field. - ERROR: Configuration has errors. - // Actionable for users. Details are present in the statusDetails field. New - // values might be added in the future. - // ACTIVE: Configuration is acknowledged to be effective - // DELETING: Configuration is being deleted - // ERROR: Configuration has errors. Actionable for users. - // PENDING: Autoscaler backend hasn't read new/updated configuration - optional string status = 11 [json_name = "status"]; - - // [Output Only] Human-readable details about the current state of the - // autoscaler. Read the documentation for Commonly returned status messages - // for examples of status messages you might encounter. - repeated AutoscalerStatusDetails status_details = 12 - [json_name = "statusDetails"]; - - // URL of the managed instance group that this autoscaler will scale. This - // field is required when creating an autoscaler. - optional string target = 13 [json_name = "target"]; - - // [Output Only] URL of the zone where the instance group resides (for - // autoscalers living in zonal scope). - optional string zone = 14 [json_name = "zone"]; -} - -message AutoscalerStatusDetails { - // The status message. - optional string message = 1 [json_name = "message"]; - - // The type of error, warning, or notice returned. Current set of possible - // values: - ALL_INSTANCES_UNHEALTHY (WARNING): All instances in the instance - // group are unhealthy (not in RUNNING state). - - // BACKEND_SERVICE_DOES_NOT_EXIST (ERROR): There is no backend service - // attached to the instance group. - CAPPED_AT_MAX_NUM_REPLICAS (WARNING): - // Autoscaler recommends a size greater than maxNumReplicas. - - // CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE (WARNING): The custom metric samples - // are not exported often enough to be a credible base for autoscaling. - - // CUSTOM_METRIC_INVALID (ERROR): The custom metric that was specified does - // not exist or does not have the necessary labels. - MIN_EQUALS_MAX - // (WARNING): The minNumReplicas is equal to maxNumReplicas. This means the - // autoscaler cannot add or remove instances from the instance group. - - // MISSING_CUSTOM_METRIC_DATA_POINTS (WARNING): The autoscaler did not receive - // any data from the custom metric configured for autoscaling. - - // MISSING_LOAD_BALANCING_DATA_POINTS (WARNING): The autoscaler is configured - // to scale based on a load balancing signal but the instance group has not - // received any requests from the load balancer. - MODE_OFF (WARNING): - // Autoscaling is turned off. The number of instances in the group won't - // change automatically. The autoscaling configuration is preserved. - - // MODE_ONLY_UP (WARNING): Autoscaling is in the "Autoscale only out" mode. - // The autoscaler can add instances but not remove any. - - // MORE_THAN_ONE_BACKEND_SERVICE (ERROR): The instance group cannot be - // autoscaled because it has more than one backend service attached to it. - - // NOT_ENOUGH_QUOTA_AVAILABLE (ERROR): There is insufficient quota for the - // necessary resources, such as CPU or number of instances. - - // REGION_RESOURCE_STOCKOUT (ERROR): Shown only for regional autoscalers: - // there is a resource stockout in the chosen region. - - // SCALING_TARGET_DOES_NOT_EXIST (ERROR): The target to be scaled does not - // exist. - UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION (ERROR): - // Autoscaling does not work with an HTTP/S load balancer that has been - // configured for maxRate. - ZONE_RESOURCE_STOCKOUT (ERROR): For zonal - // autoscalers: there is a resource stockout in the chosen zone. For regional - // autoscalers: in at least one of the zones you're using there is a resource - // stockout. New values might be added in the future. Some of the values might - // not be available in all API versions. - // ALL_INSTANCES_UNHEALTHY: All instances in the instance group are unhealthy - // (not in RUNNING state). - // BACKEND_SERVICE_DOES_NOT_EXIST: There is no backend service attached to the - // instance group. - // CAPPED_AT_MAX_NUM_REPLICAS: Autoscaler recommends a size greater than - // maxNumReplicas. - // CUSTOM_METRIC_DATA_POINTS_TOO_SPARSE: The custom metric samples are not - // exported often enough to be a credible base for autoscaling. - // CUSTOM_METRIC_INVALID: The custom metric that was specified does not exist - // or does not have the necessary labels. - // MIN_EQUALS_MAX: The minNumReplicas is equal to maxNumReplicas. This means - // the autoscaler cannot add or remove instances from the instance group. - // MISSING_CUSTOM_METRIC_DATA_POINTS: The autoscaler did not receive any data - // from the custom metric configured for autoscaling. - // MISSING_LOAD_BALANCING_DATA_POINTS: The autoscaler is configured to scale - // based on a load balancing signal but the instance group has not received - // any requests from the load balancer. - // MODE_OFF: Autoscaling is turned off. The number of instances in the group - // won't change automatically. The autoscaling configuration is preserved. - // MODE_ONLY_SCALE_OUT: Autoscaling is in the "Autoscale only scale out" mode. - // Instances in the group will be only added. - // MODE_ONLY_UP: Autoscaling is in the "Autoscale only out" mode. Instances in - // the group will be only added. - // MORE_THAN_ONE_BACKEND_SERVICE: The instance group cannot be autoscaled - // because it has more than one backend service attached to it. - // NOT_ENOUGH_QUOTA_AVAILABLE: There is insufficient quota for the necessary - // resources, such as CPU or number of instances. - // REGION_RESOURCE_STOCKOUT: Showed only for regional autoscalers: there is a - // resource stockout in the chosen region. - // SCALING_TARGET_DOES_NOT_EXIST: The target to be scaled does not exist. - // SCHEDULED_INSTANCES_GREATER_THAN_AUTOSCALER_MAX: For some scaling schedules - // minRequiredReplicas is greater than maxNumReplicas. Autoscaler always - // recommends at most maxNumReplicas instances. - // SCHEDULED_INSTANCES_LESS_THAN_AUTOSCALER_MIN: For some scaling schedules - // minRequiredReplicas is less than minNumReplicas. Autoscaler always - // recommends at least minNumReplicas instances. - // UNKNOWN: - // UNSUPPORTED_MAX_RATE_LOAD_BALANCING_CONFIGURATION: Autoscaling does not - // work with an HTTP/S load balancer that has been configured for maxRate. - // ZONE_RESOURCE_STOCKOUT: For zonal autoscalers: there is a resource stockout - // in the chosen zone. For regional autoscalers: in at least one of the zones - // you're using there is a resource stockout. - optional string type = 2 [json_name = "type"]; -} - -// Cloud Autoscaler policy. -message AutoscalingPolicy { - // The number of seconds that your application takes to initialize on a VM - // instance. This is referred to as the [initialization - // period](/compute/docs/autoscaler#cool_down_period). Specifying an accurate - // initialization period improves autoscaler decisions. For example, when - // scaling out, the autoscaler ignores data from VMs that are still - // initializing because those VMs might not yet represent normal usage of your - // application. The default initialization period is 60 seconds. - // Initialization periods might vary because of numerous factors. We recommend - // that you test how long your application takes to initialize. To do this, - // create a VM and time your application's startup process. - optional int32 cool_down_period_sec = 1 [json_name = "coolDownPeriodSec"]; - - // Defines the CPU utilization policy that allows the autoscaler to scale - // based on the average CPU utilization of a managed instance group. - optional AutoscalingPolicyCpuUtilization cpu_utilization = 2 - [json_name = "cpuUtilization"]; - - // Configuration parameters of autoscaling based on a custom metric. - repeated AutoscalingPolicyCustomMetricUtilization custom_metric_utilizations = - 3 [json_name = "customMetricUtilizations"]; - - // Configuration parameters of autoscaling based on load balancer. - optional AutoscalingPolicyLoadBalancingUtilization - load_balancing_utilization = 4 [json_name = "loadBalancingUtilization"]; - - // The maximum number of instances that the autoscaler can scale out to. This - // is required when creating or updating an autoscaler. The maximum number of - // replicas must not be lower than minimal number of replicas. - optional int32 max_num_replicas = 5 [json_name = "maxNumReplicas"]; - - // The minimum number of replicas that the autoscaler can scale in to. This - // cannot be less than 0. If not provided, autoscaler chooses a default value - // depending on maximum number of instances allowed. - optional int32 min_num_replicas = 6 [json_name = "minNumReplicas"]; - - // Defines the operating mode for this policy. The following modes are - // available: - OFF: Disables the autoscaler but maintains its configuration. - // - ONLY_SCALE_OUT: Restricts the autoscaler to add VM instances only. - ON: - // Enables all autoscaler activities according to its policy. For more - // information, see "Turning off or restricting an autoscaler" - // OFF: Do not automatically scale the MIG in or out. The recommended_size - // field contains the size of MIG that would be set if the actuation mode was - // enabled. - // ON: Automatically scale the MIG in and out according to the policy. - // ONLY_SCALE_OUT: Automatically create VMs according to the policy, but do - // not scale the MIG in. - // ONLY_UP: Automatically create VMs according to the policy, but do not scale - // the MIG in. - optional string mode = 7 [json_name = "mode"]; - - optional AutoscalingPolicyScaleInControl scale_in_control = 8 - [json_name = "scaleInControl"]; - - // Scaling schedules defined for an autoscaler. Multiple schedules can be set - // on an autoscaler, and they can overlap. During overlapping periods the - // greatest min_required_replicas of all scaling schedules is applied. Up to - // 128 scaling schedules are allowed. - map scaling_schedules = 9 - [json_name = "scalingSchedules"]; -} - -// CPU utilization policy. -message AutoscalingPolicyCpuUtilization { - // Indicates whether predictive autoscaling based on CPU metric is enabled. - // Valid values are: * NONE (default). No predictive method is used. The - // autoscaler scales the group to meet current demand based on real-time - // metrics. * OPTIMIZE_AVAILABILITY. Predictive autoscaling improves - // availability by monitoring daily and weekly load patterns and scaling out - // ahead of anticipated demand. - // NONE: No predictive method is used. The autoscaler scales the group to meet - // current demand based on real-time metrics - // OPTIMIZE_AVAILABILITY: Predictive autoscaling improves availability by - // monitoring daily and weekly load patterns and scaling out ahead of - // anticipated demand. - optional string predictive_method = 1 [json_name = "predictiveMethod"]; - - // The target CPU utilization that the autoscaler maintains. Must be a float - // value in the range (0, 1]. If not specified, the default is 0.6. If the CPU - // level is below the target utilization, the autoscaler scales in the number - // of instances until it reaches the minimum number of instances you specified - // or until the average CPU of your instances reaches the target utilization. - // If the average CPU is above the target utilization, the autoscaler scales - // out until it reaches the maximum number of instances you specified or until - // the average utilization reaches the target utilization. - optional double utilization_target = 2 [json_name = "utilizationTarget"]; -} - -// Custom utilization metric policy. -message AutoscalingPolicyCustomMetricUtilization { - // A filter string, compatible with a Stackdriver Monitoring filter string for - // TimeSeries.list API call. This filter is used to select a specific - // TimeSeries for the purpose of autoscaling and to determine whether the - // metric is exporting per-instance or per-group data. For the filter to be - // valid for autoscaling purposes, the following rules apply: - You can only - // use the AND operator for joining selectors. - You can only use direct - // equality comparison operator (=) without any functions for each selector. - - // You can specify the metric in both the filter string and in the metric - // field. However, if specified in both places, the metric must be identical. - // - The monitored resource type determines what kind of values are expected - // for the metric. If it is a gce_instance, the autoscaler expects the metric - // to include a separate TimeSeries for each instance in a group. In such a - // case, you cannot filter on resource labels. If the resource type is any - // other value, the autoscaler expects this metric to contain values that - // apply to the entire autoscaled instance group and resource label filtering - // can be performed to point autoscaler at the correct TimeSeries to scale - // upon. This is called a *per-group metric* for the purpose of autoscaling. - // If not specified, the type defaults to gce_instance. Try to provide a - // filter that is selective enough to pick just one TimeSeries for the - // autoscaled group or for each of the instances (if you are using - // gce_instance resource type). If multiple TimeSeries are returned upon the - // query execution, the autoscaler will sum their respective values to obtain - // its scaling value. - optional string filter = 1 [json_name = "filter"]; - - // The identifier (type) of the Stackdriver Monitoring metric. The metric - // cannot have negative values. The metric must have a value type of INT64 or - // DOUBLE. - optional string metric = 2 [json_name = "metric"]; - - // If scaling is based on a per-group metric value that represents the total - // amount of work to be done or resource usage, set this value to an amount - // assigned for a single instance of the scaled group. Autoscaler keeps the - // number of instances proportional to the value of this metric. The metric - // itself does not change value due to group resizing. A good metric to use - // with the target is for example - // pubsub.googleapis.com/subscription/num_undelivered_messages or a custom - // metric exporting the total number of requests coming to your instances. A - // bad example would be a metric exporting an average or median latency, since - // this value can't include a chunk assignable to a single instance, it could - // be better used with utilization_target instead. - optional double single_instance_assignment = 3 - [json_name = "singleInstanceAssignment"]; - - // The target value of the metric that autoscaler maintains. This must be a - // positive value. A utilization metric scales number of virtual machines - // handling requests to increase or decrease proportionally to the metric. For - // example, a good metric to use as a utilization_target is - // https://www.googleapis.com/compute/v1/instance/network/received_bytes_count. - // The autoscaler works to keep this value constant for each of the instances. - optional double utilization_target = 4 [json_name = "utilizationTarget"]; - - // Defines how target utilization value is expressed for a Stackdriver - // Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. - // DELTA_PER_MINUTE: Sets the utilization target value for a cumulative or - // delta metric, expressed as the rate of growth per minute. - // DELTA_PER_SECOND: Sets the utilization target value for a cumulative or - // delta metric, expressed as the rate of growth per second. - // GAUGE: Sets the utilization target value for a gauge metric. The autoscaler - // will collect the average utilization of the virtual machines from the last - // couple of minutes, and compare the value to the utilization target value to - // perform autoscaling. - optional string utilization_target_type = 5 - [json_name = "utilizationTargetType"]; +import "google/cloud/compute/v1/internal/common_008.proto"; + +message AutoscalerAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of AutoscalersScopedList resources. + map items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#autoscalerAggregatedList for + // aggregated lists of autoscalers. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. end_interface: + // MixerListResponseWithEtagBuilder + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; } -// Configuration parameters of autoscaling based on load balancing. -message AutoscalingPolicyLoadBalancingUtilization { - // Fraction of backend capacity utilization (set in HTTP(S) load balancing - // configuration) that the autoscaler maintains. Must be a positive float - // value. If not defined, the default is 0.8. - optional double utilization_target = 1 [json_name = "utilizationTarget"]; -} +// Contains a list of Autoscaler resources. +message AutoscalerList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; -// Configuration that allows for slower scale in so that even if Autoscaler -// recommends an abrupt scale in of a MIG, it will be throttled as specified by -// the parameters below. -message AutoscalingPolicyScaleInControl { - // Maximum allowed number (or %) of VMs that can be deducted from the peak - // recommendation during the window autoscaler looks at when computing - // recommendations. Possibly all these VMs can be deleted at once so user - // service needs to be prepared to lose that many VMs in one step. - optional FixedOrPercent max_scaled_in_replicas = 1 - [json_name = "maxScaledInReplicas"]; - - // How far back autoscaling looks when computing recommendations to include - // directives regarding slower scale in, as described above. - optional int32 time_window_sec = 2 [json_name = "timeWindowSec"]; -} + // A list of Autoscaler resources. + repeated Autoscaler items = 2 [json_name = "items"]; -// Scaling based on user-defined schedule. The message describes a single -// scaling schedule. A scaling schedule changes the minimum number of VM -// instances an autoscaler can recommend, which can trigger scaling out. -message AutoscalingPolicyScalingSchedule { - // A description of a scaling schedule. - optional string description = 1 [json_name = "description"]; - - // A boolean value that specifies whether a scaling schedule can influence - // autoscaler recommendations. If set to true, then a scaling schedule has no - // effect. This field is optional, and its value is false by default. - optional bool disabled = 2 [json_name = "disabled"]; - - // The duration of time intervals, in seconds, for which this scaling schedule - // is to run. The minimum allowed value is 300. This field is required. - optional int32 duration_sec = 3 [json_name = "durationSec"]; - - // The minimum number of VM instances that the autoscaler will recommend in - // time intervals starting according to schedule. This field is required. - optional int32 min_required_replicas = 4 [json_name = "minRequiredReplicas"]; - - // The start timestamps of time intervals when this scaling schedule is to - // provide a scaling signal. This field uses the extended cron format (with an - // optional year field). The expression can describe a single timestamp if the - // optional year is set, in which case the scaling schedule runs once. The - // schedule is interpreted with respect to time_zone. This field is required. - // Note: These timestamps only describe when autoscaler starts providing the - // scaling signal. The VMs need additional time to become serving. - optional string schedule = 5 [json_name = "schedule"]; - - // The time zone to use when interpreting the schedule. The value of this - // field must be a time zone name from the tz database: - // https://en.wikipedia.org/wiki/Tz_database. This field is assigned a default - // value of "UTC" if left empty. - optional string time_zone = 6 [json_name = "timeZone"]; + // [Output Only] Type of resource. Always compute#autoscalerList for lists of + // autoscalers. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } -message ScalingScheduleStatus { - // [Output Only] The last time the scaling schedule became active. Note: this - // is a timestamp when a schedule actually became active, not when it was - // planned to do so. The timestamp is in RFC3339 text format. - optional string last_start_time = 1 [json_name = "lastStartTime"]; - - // [Output Only] The next time the scaling schedule is to become active. Note: - // this is a timestamp when a schedule is planned to run, but the actual time - // might be slightly different. The timestamp is in RFC3339 text format. - optional string next_start_time = 2 [json_name = "nextStartTime"]; - - // [Output Only] The current state of a scaling schedule. - // ACTIVE: The current autoscaling recommendation is influenced by this - // scaling schedule. - // DISABLED: This scaling schedule has been disabled by the user. - // OBSOLETE: This scaling schedule will never become active again. - // READY: The current autoscaling recommendation is not influenced by this - // scaling schedule. - optional string state = 3 [json_name = "state"]; +message AutoscalersScopedList { + // [Output Only] A list of autoscalers contained in this scope. + repeated Autoscaler autoscalers = 1 [json_name = "autoscalers"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning which replaces the list of autoscalers + // when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_010.proto b/protos/google/cloud/compute/v1/internal/common_010.proto index 6e5e355d71219..754a81e6733ef 100644 --- a/protos/google/cloud/compute/v1/internal/common_010.proto +++ b/protos/google/cloud/compute/v1/internal/common_010.proto @@ -15,134 +15,242 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_009.proto"; +// Represents a Cloud Storage Bucket resource. This Cloud Storage bucket +// resource is referenced by a URL map of a load balancer. For more information, +// read Backend Buckets. +message BackendBucket { + // Cloud Storage bucket name. + optional string bucket_name = 1 [json_name = "bucketName"]; -message AutoscalerAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; + // Cloud CDN configuration for this BackendBucket. + optional BackendBucketCdnPolicy cdn_policy = 2 [json_name = "cdnPolicy"]; - // A list of AutoscalersScopedList resources. - map items = 2 [json_name = "items"]; + // Compress text responses using Brotli or gzip compression, based on the + // client's Accept-Encoding header. + // AUTOMATIC: Automatically uses the best compression based on the + // Accept-Encoding header sent by the client. + // DISABLED: Disables compression. Existing compressed responses cached by + // Cloud CDN will not be served to clients. + optional string compression_mode = 3 [json_name = "compressionMode"]; - // [Output Only] Type of resource. Always compute#autoscalerAggregatedList for - // aggregated lists of autoscalers. - optional string kind = 3 [json_name = "kind"]; + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 4 [json_name = "creationTimestamp"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; + // Headers that the Application Load Balancer should add to proxied responses. + repeated string custom_response_headers = 5 + [json_name = "customResponseHeaders"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // An optional textual description of the resource; provided by the client + // when the resource is created. + optional string description = 6 [json_name = "description"]; - // [Output Only] Unreachable resources. end_interface: - // MixerListResponseWithEtagBuilder - repeated string unreachables = 6 [json_name = "unreachables"]; + // [Output Only] The resource URL for the edge security policy associated with + // this backend bucket. + optional string edge_security_policy = 7 [json_name = "edgeSecurityPolicy"]; - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; + // If true, enable Cloud CDN for this BackendBucket. + optional bool enable_cdn = 8 [json_name = "enableCdn"]; - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 9 [json_name = "id"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // Type of the resource. + optional string kind = 10 [json_name = "kind"]; - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; + // 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. + optional string name = 11 [json_name = "name"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // [Output Only] Server-defined URL for the resource. + optional string self_link = 12 [json_name = "selfLink"]; - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + // [Output Only] List of resources referencing that backend bucket. + repeated BackendBucketUsedBy used_by = 13 [json_name = "usedBy"]; } -// Contains a list of Autoscaler resources. -message AutoscalerList { +// Message containing Cloud CDN configuration for a backend bucket. +message BackendBucketCdnPolicy { + // Bypass the cache when the specified request headers are matched - e.g. + // Pragma or Authorization headers. Up to 5 headers can be specified. The + // cache is bypassed for all cdnPolicy.cacheMode settings. + repeated BackendBucketCdnPolicyBypassCacheOnRequestHeader + bypass_cache_on_request_headers = 1 + [json_name = "bypassCacheOnRequestHeaders"]; + + // The CacheKeyPolicy for this CdnPolicy. + optional BackendBucketCdnPolicyCacheKeyPolicy cache_key_policy = 2 + [json_name = "cacheKeyPolicy"]; + + // Specifies the cache setting for all responses from this backend. The + // possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid + // caching headers to cache content. Responses without these headers will not + // be cached at Google's edge, and will require a full trip to the origin on + // every request, potentially impacting performance and increasing load on the + // origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", + // "no-store" or "no-cache" directives in Cache-Control response headers. + // Warning: this may result in Cloud CDN caching private, per-user (user + // identifiable) content. CACHE_ALL_STATIC Automatically cache static content, + // including common image formats, media (video and audio), and web assets + // (JavaScript and CSS). Requests and responses that are marked as + // uncacheable, as well as dynamic content (including HTML), will not be + // cached. + // CACHE_ALL_STATIC: Automatically cache static content, including common + // image formats, media (video and audio), and web assets (JavaScript and + // CSS). Requests and responses that are marked as uncacheable, as well as + // dynamic content (including HTML), will not be cached. + // FORCE_CACHE_ALL: Cache all content, ignoring any "private", "no-store" or + // "no-cache" directives in Cache-Control response headers. Warning: this may + // result in Cloud CDN caching private, per-user (user identifiable) content. + // INVALID_CACHE_MODE: + // USE_ORIGIN_HEADERS: Requires the origin to set valid caching headers to + // cache content. Responses without these headers will not be cached at + // Google's edge, and will require a full trip to the origin on every request, + // potentially impacting performance and increasing load on the origin server. + optional string cache_mode = 3 [json_name = "cacheMode"]; + + // Specifies a separate client (e.g. browser client) maximum TTL. This is used + // to clamp the max-age (or Expires) value sent to the client. With + // FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the + // response max-age directive, along with a "public" directive. For cacheable + // content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the + // origin (if specified), or else sets the response max-age directive to the + // lesser of the client_ttl and default_ttl, and also ensures a "public" + // cache-control directive is present. If a client TTL is not specified, a + // default value (1 hour) will be used. The maximum allowed value is + // 31,622,400s (1 year). + optional int32 client_ttl = 4 [json_name = "clientTtl"]; + + // Specifies the default TTL for cached content served by this origin for + // responses that do not have an existing valid TTL (max-age or s-max-age). + // Setting a TTL of "0" means "always revalidate". The value of defaultTTL + // cannot be set to a value greater than that of maxTTL, but can be equal. + // When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite + // the TTL set in all responses. The maximum allowed value is 31,622,400s (1 + // year), noting that infrequently accessed objects may be evicted from the + // cache before the defined TTL. + optional int32 default_ttl = 5 [json_name = "defaultTtl"]; + + // Specifies the maximum allowed TTL for cached content served by this origin. + // Cache directives that attempt to set a max-age or s-maxage higher than + // this, or an Expires header more than maxTTL seconds in the future will be + // capped at the value of maxTTL, as if it were the value of an s-maxage + // Cache-Control directive. Headers sent to the client will not be modified. + // Setting a TTL of "0" means "always revalidate". The maximum allowed value + // is 31,622,400s (1 year), noting that infrequently accessed objects may be + // evicted from the cache before the defined TTL. + optional int32 max_ttl = 6 [json_name = "maxTtl"]; + + // Negative caching allows per-status code TTLs to be set, in order to apply + // fine-grained caching for common errors or redirects. This can reduce the + // load on your origin and improve end-user experience by reducing response + // latency. When the cache mode is set to CACHE_ALL_STATIC or + // USE_ORIGIN_HEADERS, negative caching applies to responses with the + // specified response code that lack any Cache-Control, Expires, or Pragma: + // no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, + // negative caching applies to all responses with the specified response code, + // and override any caching headers. By default, Cloud CDN will apply the + // following default TTLs to these status codes: HTTP 300 (Multiple Choice), + // 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 + // (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 421 + // (Misdirected Request), 501 (Not Implemented): 60s. These defaults can be + // overridden in negative_caching_policy. + optional bool negative_caching = 7 [json_name = "negativeCaching"]; + + // Sets a cache TTL for the specified HTTP status code. negative_caching must + // be enabled to configure negative_caching_policy. Omitting the policy and + // leaving negative_caching enabled will use Cloud CDN's default cache TTLs. + // Note that when specifying an explicit negative_caching_policy, you should + // take care to specify a cache TTL for all response codes that you wish to + // cache. Cloud CDN will not apply any default negative caching when a policy + // exists. + repeated BackendBucketCdnPolicyNegativeCachingPolicy negative_caching_policy = + 8 [json_name = "negativeCachingPolicy"]; + + // If true then Cloud CDN will combine multiple concurrent cache fill requests + // into a small number of requests to the origin. + optional bool request_coalescing = 9 [json_name = "requestCoalescing"]; + + // Serve existing content from the cache (if available) when revalidating + // content with the origin, or when an error is encountered when refreshing + // the cache. This setting defines the default "max-stale" duration for any + // cached responses that do not specify a max-stale directive. Stale responses + // that exceed the TTL configured here will not be served. The default limit + // (max-stale) is 86400s (1 day), which will allow stale content to be served + // up to this limit beyond the max-age (or s-max-age) of a cached response. + // The maximum allowed value is 604800 (1 week). Set this to zero (0) to + // disable serve-while-stale. + optional int32 serve_while_stale = 10 [json_name = "serveWhileStale"]; + + // Maximum number of seconds the response to a signed URL request will be + // considered fresh. After this time period, the response will be revalidated + // before being served. Defaults to 1hr (3600s). When serving responses to + // signed URL requests, Cloud CDN will internally behave as though all + // responses from this backend had a "Cache-Control: public, max-age=[TTL]" + // header, regardless of any existing Cache-Control header. The actual headers + // served in responses will not be altered. + optional string signed_url_cache_max_age_sec = 11 + [json_name = "signedUrlCacheMaxAgeSec"]; + + // [Output Only] Names of the keys for signing request URLs. + repeated string signed_url_key_names = 12 [json_name = "signedUrlKeyNames"]; +} + +// Bypass the cache when the specified request headers are present, e.g. Pragma +// or Authorization headers. Values are case insensitive. The presence of such a +// header overrides the cache_mode setting. +message BackendBucketCdnPolicyBypassCacheOnRequestHeader { + // The header field name to match on when bypassing cache. Values are + // case-insensitive. + optional string header_name = 1 [json_name = "headerName"]; +} + +// Message containing what to include in the cache key for a request for Cloud +// CDN. +message BackendBucketCdnPolicyCacheKeyPolicy { + // Allows HTTP request headers (by name) to be used in the cache key. + repeated string include_http_headers = 1 [json_name = "includeHttpHeaders"]; + + // Names of query string parameters to include in cache keys. Default + // parameters are always included. '&' and '=' will be percent encoded and not + // treated as delimiters. + repeated string query_string_whitelist = 2 + [json_name = "queryStringWhitelist"]; +} + +// Specify CDN TTLs for response error codes. +message BackendBucketCdnPolicyNegativeCachingPolicy { + // The HTTP status code to define a TTL against. Only HTTP status codes 300, + // 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as + // values, and you cannot specify a status code more than once. + optional int32 code = 1 [json_name = "code"]; + + // The TTL (in seconds) for which to cache responses with the corresponding + // status code. The maximum allowed value is 1800s (30 minutes), noting that + // infrequently accessed objects may be evicted from the cache before the + // defined TTL. + optional int32 ttl = 2 [json_name = "ttl"]; +} + +// Contains a list of BackendBucket resources. +message BackendBucketList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of Autoscaler resources. - repeated Autoscaler items = 2 [json_name = "items"]; + // A list of BackendBucket resources. + repeated BackendBucket items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#autoscalerList for lists of - // autoscalers. + // Type of resource. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -240,92 +348,8 @@ message AutoscalerList { optional Warning warning = 6 [json_name = "warning"]; } -message AutoscalersScopedList { - // [Output Only] A list of autoscalers contained in this scope. - repeated Autoscaler autoscalers = 1 [json_name = "autoscalers"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning which replaces the list of autoscalers - // when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; +message BackendBucketUsedBy { + // [Output Only] Server-defined URL for UrlMaps referencing that + // BackendBucket. + optional string reference = 1 [json_name = "reference"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_011.proto b/protos/google/cloud/compute/v1/internal/common_011.proto index 2e54ee8f1b17a..616a31b65fdb9 100644 --- a/protos/google/cloud/compute/v1/internal/common_011.proto +++ b/protos/google/cloud/compute/v1/internal/common_011.proto @@ -15,240 +15,21 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Cloud Storage Bucket resource. This Cloud Storage bucket -// resource is referenced by a URL map of a load balancer. For more information, -// read Backend Buckets. -message BackendBucket { - // Cloud Storage bucket name. - optional string bucket_name = 1 [json_name = "bucketName"]; - - // Cloud CDN configuration for this BackendBucket. - optional BackendBucketCdnPolicy cdn_policy = 2 [json_name = "cdnPolicy"]; - - // Compress text responses using Brotli or gzip compression, based on the - // client's Accept-Encoding header. - // AUTOMATIC: Automatically uses the best compression based on the - // Accept-Encoding header sent by the client. - // DISABLED: Disables compression. Existing compressed responses cached by - // Cloud CDN will not be served to clients. - optional string compression_mode = 3 [json_name = "compressionMode"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 4 [json_name = "creationTimestamp"]; - - // Headers that the Application Load Balancer should add to proxied responses. - repeated string custom_response_headers = 5 - [json_name = "customResponseHeaders"]; - - // An optional textual description of the resource; provided by the client - // when the resource is created. - optional string description = 6 [json_name = "description"]; - - // [Output Only] The resource URL for the edge security policy associated with - // this backend bucket. - optional string edge_security_policy = 7 [json_name = "edgeSecurityPolicy"]; - - // If true, enable Cloud CDN for this BackendBucket. - optional bool enable_cdn = 8 [json_name = "enableCdn"]; +import "google/cloud/compute/v1/internal/common_000.proto"; - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 9 [json_name = "id"]; - - // Type of the resource. - optional string kind = 10 [json_name = "kind"]; - - // 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. - optional string name = 11 [json_name = "name"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 12 [json_name = "selfLink"]; - - // [Output Only] List of resources referencing that backend bucket. - repeated BackendBucketUsedBy used_by = 13 [json_name = "usedBy"]; -} - -// Message containing Cloud CDN configuration for a backend bucket. -message BackendBucketCdnPolicy { - // Bypass the cache when the specified request headers are matched - e.g. - // Pragma or Authorization headers. Up to 5 headers can be specified. The - // cache is bypassed for all cdnPolicy.cacheMode settings. - repeated BackendBucketCdnPolicyBypassCacheOnRequestHeader - bypass_cache_on_request_headers = 1 - [json_name = "bypassCacheOnRequestHeaders"]; - - // The CacheKeyPolicy for this CdnPolicy. - optional BackendBucketCdnPolicyCacheKeyPolicy cache_key_policy = 2 - [json_name = "cacheKeyPolicy"]; - - // Specifies the cache setting for all responses from this backend. The - // possible values are: USE_ORIGIN_HEADERS Requires the origin to set valid - // caching headers to cache content. Responses without these headers will not - // be cached at Google's edge, and will require a full trip to the origin on - // every request, potentially impacting performance and increasing load on the - // origin server. FORCE_CACHE_ALL Cache all content, ignoring any "private", - // "no-store" or "no-cache" directives in Cache-Control response headers. - // Warning: this may result in Cloud CDN caching private, per-user (user - // identifiable) content. CACHE_ALL_STATIC Automatically cache static content, - // including common image formats, media (video and audio), and web assets - // (JavaScript and CSS). Requests and responses that are marked as - // uncacheable, as well as dynamic content (including HTML), will not be - // cached. - // CACHE_ALL_STATIC: Automatically cache static content, including common - // image formats, media (video and audio), and web assets (JavaScript and - // CSS). Requests and responses that are marked as uncacheable, as well as - // dynamic content (including HTML), will not be cached. - // FORCE_CACHE_ALL: Cache all content, ignoring any "private", "no-store" or - // "no-cache" directives in Cache-Control response headers. Warning: this may - // result in Cloud CDN caching private, per-user (user identifiable) content. - // INVALID_CACHE_MODE: - // USE_ORIGIN_HEADERS: Requires the origin to set valid caching headers to - // cache content. Responses without these headers will not be cached at - // Google's edge, and will require a full trip to the origin on every request, - // potentially impacting performance and increasing load on the origin server. - optional string cache_mode = 3 [json_name = "cacheMode"]; - - // Specifies a separate client (e.g. browser client) maximum TTL. This is used - // to clamp the max-age (or Expires) value sent to the client. With - // FORCE_CACHE_ALL, the lesser of client_ttl and default_ttl is used for the - // response max-age directive, along with a "public" directive. For cacheable - // content in CACHE_ALL_STATIC mode, client_ttl clamps the max-age from the - // origin (if specified), or else sets the response max-age directive to the - // lesser of the client_ttl and default_ttl, and also ensures a "public" - // cache-control directive is present. If a client TTL is not specified, a - // default value (1 hour) will be used. The maximum allowed value is - // 31,622,400s (1 year). - optional int32 client_ttl = 4 [json_name = "clientTtl"]; - - // Specifies the default TTL for cached content served by this origin for - // responses that do not have an existing valid TTL (max-age or s-max-age). - // Setting a TTL of "0" means "always revalidate". The value of defaultTTL - // cannot be set to a value greater than that of maxTTL, but can be equal. - // When the cacheMode is set to FORCE_CACHE_ALL, the defaultTTL will overwrite - // the TTL set in all responses. The maximum allowed value is 31,622,400s (1 - // year), noting that infrequently accessed objects may be evicted from the - // cache before the defined TTL. - optional int32 default_ttl = 5 [json_name = "defaultTtl"]; - - // Specifies the maximum allowed TTL for cached content served by this origin. - // Cache directives that attempt to set a max-age or s-maxage higher than - // this, or an Expires header more than maxTTL seconds in the future will be - // capped at the value of maxTTL, as if it were the value of an s-maxage - // Cache-Control directive. Headers sent to the client will not be modified. - // Setting a TTL of "0" means "always revalidate". The maximum allowed value - // is 31,622,400s (1 year), noting that infrequently accessed objects may be - // evicted from the cache before the defined TTL. - optional int32 max_ttl = 6 [json_name = "maxTtl"]; - - // Negative caching allows per-status code TTLs to be set, in order to apply - // fine-grained caching for common errors or redirects. This can reduce the - // load on your origin and improve end-user experience by reducing response - // latency. When the cache mode is set to CACHE_ALL_STATIC or - // USE_ORIGIN_HEADERS, negative caching applies to responses with the - // specified response code that lack any Cache-Control, Expires, or Pragma: - // no-cache directives. When the cache mode is set to FORCE_CACHE_ALL, - // negative caching applies to all responses with the specified response code, - // and override any caching headers. By default, Cloud CDN will apply the - // following default TTLs to these status codes: HTTP 300 (Multiple Choice), - // 301, 308 (Permanent Redirects): 10m HTTP 404 (Not Found), 410 (Gone), 451 - // (Unavailable For Legal Reasons): 120s HTTP 405 (Method Not Found), 421 - // (Misdirected Request), 501 (Not Implemented): 60s. These defaults can be - // overridden in negative_caching_policy. - optional bool negative_caching = 7 [json_name = "negativeCaching"]; - - // Sets a cache TTL for the specified HTTP status code. negative_caching must - // be enabled to configure negative_caching_policy. Omitting the policy and - // leaving negative_caching enabled will use Cloud CDN's default cache TTLs. - // Note that when specifying an explicit negative_caching_policy, you should - // take care to specify a cache TTL for all response codes that you wish to - // cache. Cloud CDN will not apply any default negative caching when a policy - // exists. - repeated BackendBucketCdnPolicyNegativeCachingPolicy negative_caching_policy = - 8 [json_name = "negativeCachingPolicy"]; - - // If true then Cloud CDN will combine multiple concurrent cache fill requests - // into a small number of requests to the origin. - optional bool request_coalescing = 9 [json_name = "requestCoalescing"]; - - // Serve existing content from the cache (if available) when revalidating - // content with the origin, or when an error is encountered when refreshing - // the cache. This setting defines the default "max-stale" duration for any - // cached responses that do not specify a max-stale directive. Stale responses - // that exceed the TTL configured here will not be served. The default limit - // (max-stale) is 86400s (1 day), which will allow stale content to be served - // up to this limit beyond the max-age (or s-max-age) of a cached response. - // The maximum allowed value is 604800 (1 week). Set this to zero (0) to - // disable serve-while-stale. - optional int32 serve_while_stale = 10 [json_name = "serveWhileStale"]; - - // Maximum number of seconds the response to a signed URL request will be - // considered fresh. After this time period, the response will be revalidated - // before being served. Defaults to 1hr (3600s). When serving responses to - // signed URL requests, Cloud CDN will internally behave as though all - // responses from this backend had a "Cache-Control: public, max-age=[TTL]" - // header, regardless of any existing Cache-Control header. The actual headers - // served in responses will not be altered. - optional string signed_url_cache_max_age_sec = 11 - [json_name = "signedUrlCacheMaxAgeSec"]; - - // [Output Only] Names of the keys for signing request URLs. - repeated string signed_url_key_names = 12 [json_name = "signedUrlKeyNames"]; -} - -// Bypass the cache when the specified request headers are present, e.g. Pragma -// or Authorization headers. Values are case insensitive. The presence of such a -// header overrides the cache_mode setting. -message BackendBucketCdnPolicyBypassCacheOnRequestHeader { - // The header field name to match on when bypassing cache. Values are - // case-insensitive. - optional string header_name = 1 [json_name = "headerName"]; -} - -// Message containing what to include in the cache key for a request for Cloud -// CDN. -message BackendBucketCdnPolicyCacheKeyPolicy { - // Allows HTTP request headers (by name) to be used in the cache key. - repeated string include_http_headers = 1 [json_name = "includeHttpHeaders"]; - - // Names of query string parameters to include in cache keys. Default - // parameters are always included. '&' and '=' will be percent encoded and not - // treated as delimiters. - repeated string query_string_whitelist = 2 - [json_name = "queryStringWhitelist"]; -} - -// Specify CDN TTLs for response error codes. -message BackendBucketCdnPolicyNegativeCachingPolicy { - // The HTTP status code to define a TTL against. Only HTTP status codes 300, - // 301, 302, 307, 308, 404, 405, 410, 421, 451 and 501 are can be specified as - // values, and you cannot specify a status code more than once. - optional int32 code = 1 [json_name = "code"]; - - // The TTL (in seconds) for which to cache responses with the corresponding - // status code. The maximum allowed value is 1800s (30 minutes), noting that - // infrequently accessed objects may be evicted from the cache before the - // defined TTL. - optional int32 ttl = 2 [json_name = "ttl"]; -} - -// Contains a list of BackendBucket resources. -message BackendBucketList { +// Contains a list of BackendServicesScopedList. +message BackendServiceAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of BackendBucket resources. - repeated BackendBucket items = 2 [json_name = "items"]; + // A list of BackendServicesScopedList resources. + map items = 2 [json_name = "items"]; // Type of resource. optional string kind = 3 [json_name = "kind"]; @@ -263,6 +44,9 @@ message BackendBucketList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -345,11 +129,95 @@ message BackendBucketList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; } -message BackendBucketUsedBy { - // [Output Only] Server-defined URL for UrlMaps referencing that - // BackendBucket. - optional string reference = 1 [json_name = "reference"]; +message BackendServicesScopedList { + // A list of BackendServices contained in this scope. + repeated BackendService backend_services = 1 [json_name = "backendServices"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of backend services when the + // list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_012.proto b/protos/google/cloud/compute/v1/internal/common_012.proto index 0bd0ac4de6723..368e7f6cd3420 100644 --- a/protos/google/cloud/compute/v1/internal/common_012.proto +++ b/protos/google/cloud/compute/v1/internal/common_012.proto @@ -15,23 +15,297 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_000.proto"; +import "google/cloud/compute/v1/internal/common_047.proto"; -// Contains a list of BackendServicesScopedList. -message BackendServiceAggregatedList { +message BackendServiceReference { + optional string backend_service = 1 [json_name = "backendService"]; +} + +message ForwardingRuleReference { + optional string forwarding_rule = 1 [json_name = "forwardingRule"]; +} + +// A full or valid partial URL to a health check service. For example, the +// following are valid URLs: - +// https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service +// - +// projects/project-id/regions/us-west1/healthCheckServices/health-check-service +// - regions/us-west1/healthCheckServices/health-check-service +message HealthCheckServiceReference { + optional string health_check_service = 1 [json_name = "healthCheckService"]; +} + +message HealthStatusForNetworkEndpoint { + // URL of the backend service associated with the health state of the network + // endpoint. + optional BackendServiceReference backend_service = 1 + [json_name = "backendService"]; + + // URL of the forwarding rule associated with the health state of the network + // endpoint. + optional ForwardingRuleReference forwarding_rule = 2 + [json_name = "forwardingRule"]; + + // URL of the health check associated with the health state of the network + // endpoint. + optional HealthCheckReference health_check = 3 [json_name = "healthCheck"]; + + // URL of the health check service associated with the health state of the + // network endpoint. + optional HealthCheckServiceReference health_check_service = 4 + [json_name = "healthCheckService"]; + + // Health state of the network endpoint determined based on the health checks + // configured. + // DRAINING: Endpoint is being drained. + // HEALTHY: Endpoint is healthy. + // UNHEALTHY: Endpoint is unhealthy. + // UNKNOWN: Health status of the endpoint is unknown. + optional string health_state = 5 [json_name = "healthState"]; + + // Health state of the ipv6 network endpoint determined based on the health + // checks configured. + // DRAINING: Endpoint is being drained. + // HEALTHY: Endpoint is healthy. + // UNHEALTHY: Endpoint is unhealthy. + // UNKNOWN: Health status of the endpoint is unknown. + optional string ipv6_health_state = 6 [json_name = "ipv6HealthState"]; +} + +// The network endpoint. +message NetworkEndpoint { + // Metadata defined as annotations on the network endpoint. + map annotations = 1 [json_name = "annotations"]; + + // Represents the port number to which PSC consumer sends packets. Only valid + // for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type. + optional int32 client_destination_port = 6 + [json_name = "clientDestinationPort"]; + + // Optional fully qualified domain name of network endpoint. This can only be + // specified when NetworkEndpointGroup.network_endpoint_type is + // NON_GCP_FQDN_PORT. + optional string fqdn = 2 [json_name = "fqdn"]; + + // The name or a URL of VM instance of this network endpoint. This field is + // required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The + // instance must be in the same zone of network endpoint group (for zonal + // NEGs) or in the zone within the region of the NEG (for regional NEGs). If + // the ipAddress is specified, it must belongs to the VM instance. The name + // must be 1-63 characters long, and comply with RFC1035 or be a valid URL + // pointing to an existing instance. + optional string instance = 3 [json_name = "instance"]; + + // Optional IPv4 address of network endpoint. The IP address must belong to a + // VM in Compute Engine (either the primary IP or as part of an aliased IP + // range). If the IP address is not specified, then the primary IP address for + // the VM instance in the network that the network endpoint group belongs to + // will be used. This field is redundant and need not be set for network + // endpoints of type GCE_VM_IP. If set, it must be set to the primary internal + // IP address of the attached VM instance that matches the subnetwork of the + // NEG. The primary internal IP address from any NIC of a multi-NIC VM + // instance can be added to a NEG as long as it matches the NEG subnetwork. + optional string ip_address = 4 [json_name = "ipAddress"]; + + // Optional IPv6 address of network endpoint. + optional string ipv6_address = 7 [json_name = "ipv6Address"]; + + // Optional port number of network endpoint. If not specified, the defaultPort + // for the network endpoint group will be used. This field can not be set for + // network endpoints of type GCE_VM_IP. + optional int32 port = 5 [json_name = "port"]; +} + +// Represents a collection of network endpoints. A network endpoint group (NEG) +// defines how a set of endpoints should be reached, whether they are reachable, +// and where they are located. For more information about using NEGs for +// different use cases, see Network endpoint groups overview. +message NetworkEndpointGroup { + // Metadata defined as annotations on the network endpoint group. + map annotations = 1 [json_name = "annotations"]; + + // Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, + // appEngine or cloudFunction may be set. + optional NetworkEndpointGroupAppEngine app_engine = 2 + [json_name = "appEngine"]; + + // Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, + // appEngine or cloudFunction may be set. + optional NetworkEndpointGroupCloudFunction cloud_function = 3 + [json_name = "cloudFunction"]; + + // Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, + // appEngine or cloudFunction may be set. + optional NetworkEndpointGroupCloudRun cloud_run = 4 [json_name = "cloudRun"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 5 [json_name = "creationTimestamp"]; + + // The default port used if the port number is not specified in the network + // endpoint. If the network endpoint type is either GCE_VM_IP, SERVERLESS or + // PRIVATE_SERVICE_CONNECT, this field must not be specified. + optional int32 default_port = 6 [json_name = "defaultPort"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 7 [json_name = "description"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 8 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#networkEndpointGroup for + // network endpoint group. + optional string kind = 9 [json_name = "kind"]; + + // 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. + optional string name = 10 [json_name = "name"]; + + // The URL of the network to which all network endpoints in the NEG belong. + // Uses default project network if unspecified. + optional string network = 11 [json_name = "network"]; + + // Type of network endpoints in this network endpoint group. Can be one of + // GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, + // INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. + // GCE_VM_IP: The network endpoint is represented by an IP address. + // GCE_VM_IP_PORT: The network endpoint is represented by IP address and port + // pair. + // GCE_VM_IP_PORTMAP: The network endpoint is represented by an IP, Port and + // Client Destination Port. + // INTERNET_FQDN_PORT: The network endpoint is represented by fully qualified + // domain name and port. + // INTERNET_IP_PORT: The network endpoint is represented by an internet IP + // address and port. + // NON_GCP_PRIVATE_IP_PORT: The network endpoint is represented by an IP + // address and port. The endpoint belongs to a VM or pod running in a + // customer's on-premises. + // PRIVATE_SERVICE_CONNECT: The network endpoint is either public Google APIs + // or services exposed by other GCP Project with a Service Attachment. The + // connection is set up by private service connect + // SERVERLESS: The network endpoint is handled by specified serverless + // infrastructure. + optional string network_endpoint_type = 12 + [json_name = "networkEndpointType"]; + + optional NetworkEndpointGroupPscData psc_data = 13 [json_name = "pscData"]; + + // The target service url used to set up private service connection to a + // Google API or a PSC Producer Service Attachment. An example value is: + // asia-northeast3-cloudkms.googleapis.com + optional string psc_target_service = 14 [json_name = "pscTargetService"]; + + // [Output Only] The URL of the region where the network endpoint group is + // located. + optional string region = 15 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 16 [json_name = "selfLink"]; + + // [Output only] Number of network endpoints in the network endpoint group. + optional int32 size = 17 [json_name = "size"]; + + // Optional URL of the subnetwork to which all network endpoints in the NEG + // belong. + optional string subnetwork = 18 [json_name = "subnetwork"]; + + // [Output Only] The URL of the zone where the network endpoint group is + // located. + optional string zone = 19 [json_name = "zone"]; +} + +// Configuration for an App Engine network endpoint group (NEG). The service is +// optional, may be provided explicitly or in the URL mask. The version is +// optional and can only be provided explicitly or in the URL mask when service +// is present. Note: App Engine service must be in the same project and located +// in the same region as the Serverless NEG. +message NetworkEndpointGroupAppEngine { + // Optional serving service. The service name is case-sensitive and must be + // 1-63 characters long. Example value: default, my-service. + optional string service = 1 [json_name = "service"]; + + // An URL mask is one of the main components of the Cloud Function. 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. For 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. + optional string url_mask = 2 [json_name = "urlMask"]; + + // Optional serving version. The version name is case-sensitive and must be + // 1-100 characters long. Example value: v1, v2. + optional string version = 3 [json_name = "version"]; +} + +// Configuration for a Cloud Function network endpoint group (NEG). The function +// must be provided explicitly or in the URL mask. Note: Cloud Function must be +// in the same project and located in the same region as the Serverless NEG. +message NetworkEndpointGroupCloudFunction { + // A user-defined name of the Cloud Function. The function name is + // case-sensitive and must be 1-63 characters long. Example value: func1. + optional string function = 1 [json_name = "function"]; + + // An URL mask is one of the main components of the Cloud Function. A template + // to parse function field from a request URL. URL mask allows for routing to + // multiple Cloud Functions without having to create multiple Network Endpoint + // Groups and backend services. For example, request URLs + // mydomain.com/function1 and mydomain.com/function2 can be backed by the same + // Serverless NEG with URL mask /. The URL mask will parse them to { + // function = "function1" } and { function = "function2" } respectively. + optional string url_mask = 2 [json_name = "urlMask"]; +} + +// Configuration for a Cloud Run network endpoint group (NEG). The service must +// be provided explicitly or in the URL mask. The tag is optional, may be +// provided explicitly or in the URL mask. Note: Cloud Run service must be in +// the same project and located in the same region as the Serverless NEG. +message NetworkEndpointGroupCloudRun { + // Cloud Run service is the main resource of Cloud Run. The service must be + // 1-63 characters long, and comply with RFC1035. Example value: + // "run-service". + optional string service = 1 [json_name = "service"]; + + // Optional Cloud Run tag represents the "named-revision" to provide + // additional fine-grained traffic routing information. The tag must be 1-63 + // characters long, and comply with RFC1035. Example value: "revision-0010". + optional string tag = 2 [json_name = "tag"]; + + // An URL mask is one of the main components of the Cloud Function. A template + // to parse and fields from a request URL. URL mask allows for + // routing to multiple Run services without having to create multiple network + // endpoint groups and backend services. For example, request URLs + // foo1.domain.com/bar1 and foo1.domain.com/bar2 can be backed by the same + // Serverless Network Endpoint Group (NEG) with URL mask + // .domain.com/. The URL mask will parse them to { + // service="bar1", tag="foo1" } and { service="bar2", tag="foo2" } + // respectively. + optional string url_mask = 3 [json_name = "urlMask"]; +} + +message NetworkEndpointGroupList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of BackendServicesScopedList resources. - map items = 2 [json_name = "items"]; + // A list of NetworkEndpointGroup resources. + repeated NetworkEndpointGroup items = 2 [json_name = "items"]; - // Type of resource. + // [Output Only] The resource type, which is always + // compute#networkEndpointGroupList for network endpoint group lists. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -44,9 +318,6 @@ message BackendServiceAggregatedList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -129,12 +400,57 @@ message BackendServiceAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + optional Warning warning = 6 [json_name = "warning"]; } -message BackendServicesScopedList { - // A list of BackendServices contained in this scope. - repeated BackendService backend_services = 1 [json_name = "backendServices"]; +// All data that is specifically relevant to only network endpoint groups of +// type PRIVATE_SERVICE_CONNECT. +message NetworkEndpointGroupPscData { + // [Output Only] Address allocated from given subnetwork for PSC. This IP + // address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in + // L7 PSC-XLB. + optional string consumer_psc_address = 1 [json_name = "consumerPscAddress"]; + + // The psc producer port is used to connect PSC NEG with specific port on the + // PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG + // type + optional int32 producer_port = 4 [json_name = "producerPort"]; + + // [Output Only] The PSC connection id of the PSC Network Endpoint Group + // Consumer. + optional string psc_connection_id = 2 [json_name = "pscConnectionId"]; + + // [Output Only] The connection status of the PSC Forwarding Rule. + // ACCEPTED: The connection has been accepted by the producer. + // CLOSED: The connection has been closed by the producer and will not serve + // traffic going forward. + // NEEDS_ATTENTION: The connection has been accepted by the producer, but the + // producer needs to take further action before the forwarding rule can serve + // traffic. + // PENDING: The connection is pending acceptance by the producer. + // REJECTED: The connection has been rejected by the producer. + // STATUS_UNSPECIFIED: + optional string psc_connection_status = 3 [json_name = "pscConnectionStatus"]; +} + +message NetworkEndpointGroupsListNetworkEndpoints { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of NetworkEndpointWithHealthStatus resources. + repeated NetworkEndpointWithHealthStatus items = 2 [json_name = "items"]; + + // [Output Only] The resource type, which is always + // compute#networkEndpointGroupsListNetworkEndpoints for the list of network + // endpoints in the specified network endpoint group. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -217,7 +533,14 @@ message BackendServicesScopedList { optional string message = 3 [json_name = "message"]; } - // Informational warning which replaces the list of backend services when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // [Output Only] Informational warning message. + optional Warning warning = 5 [json_name = "warning"]; +} + +message NetworkEndpointWithHealthStatus { + // [Output only] The health status of network endpoint; + repeated HealthStatusForNetworkEndpoint healths = 1 [json_name = "healths"]; + + // [Output only] The network endpoint; + optional NetworkEndpoint network_endpoint = 2 [json_name = "networkEndpoint"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_013.proto b/protos/google/cloud/compute/v1/internal/common_013.proto index 9f86c6f03fb43..9498cd3cf5e90 100644 --- a/protos/google/cloud/compute/v1/internal/common_013.proto +++ b/protos/google/cloud/compute/v1/internal/common_013.proto @@ -15,145 +15,283 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_049.proto"; - -message BackendServiceReference { - optional string backend_service = 1 [json_name = "backendService"]; -} - -message ForwardingRuleReference { - optional string forwarding_rule = 1 [json_name = "forwardingRule"]; -} - -// A full or valid partial URL to a health check service. For example, the -// following are valid URLs: - -// https://www.googleapis.com/compute/beta/projects/project-id/regions/us-west1/healthCheckServices/health-check-service -// - -// projects/project-id/regions/us-west1/healthCheckServices/health-check-service -// - regions/us-west1/healthCheckServices/health-check-service -message HealthCheckServiceReference { - optional string health_check_service = 1 [json_name = "healthCheckService"]; -} - -message HealthStatusForNetworkEndpoint { - // URL of the backend service associated with the health state of the network - // endpoint. - optional BackendServiceReference backend_service = 1 - [json_name = "backendService"]; - - // URL of the forwarding rule associated with the health state of the network - // endpoint. - optional ForwardingRuleReference forwarding_rule = 2 - [json_name = "forwardingRule"]; - - // URL of the health check associated with the health state of the network - // endpoint. - optional HealthCheckReference health_check = 3 [json_name = "healthCheck"]; - - // URL of the health check service associated with the health state of the - // network endpoint. - optional HealthCheckServiceReference health_check_service = 4 - [json_name = "healthCheckService"]; - - // Health state of the network endpoint determined based on the health checks - // configured. - // DRAINING: Endpoint is being drained. - // HEALTHY: Endpoint is healthy. - // UNHEALTHY: Endpoint is unhealthy. - // UNKNOWN: Health status of the endpoint is unknown. - optional string health_state = 5 [json_name = "healthState"]; -} - -// The network endpoint. -message NetworkEndpoint { - // Metadata defined as annotations on the network endpoint. - map annotations = 1 [json_name = "annotations"]; - - // Represents the port number to which PSC consumer sends packets. Only valid - // for network endpoint groups created with GCE_VM_IP_PORTMAP endpoint type. - optional int32 client_destination_port = 6 - [json_name = "clientDestinationPort"]; - - // Optional fully qualified domain name of network endpoint. This can only be - // specified when NetworkEndpointGroup.network_endpoint_type is - // NON_GCP_FQDN_PORT. - optional string fqdn = 2 [json_name = "fqdn"]; - - // The name or a URL of VM instance of this network endpoint. This field is - // required for network endpoints of type GCE_VM_IP and GCE_VM_IP_PORT. The - // instance must be in the same zone of network endpoint group (for zonal - // NEGs) or in the zone within the region of the NEG (for regional NEGs). If - // the ipAddress is specified, it must belongs to the VM instance. The name - // must be 1-63 characters long, and comply with RFC1035 or be a valid URL - // pointing to an existing instance. - optional string instance = 3 [json_name = "instance"]; - - // Optional IPv4 address of network endpoint. The IP address must belong to a - // VM in Compute Engine (either the primary IP or as part of an aliased IP - // range). If the IP address is not specified, then the primary IP address for - // the VM instance in the network that the network endpoint group belongs to - // will be used. This field is redundant and need not be set for network - // endpoints of type GCE_VM_IP. If set, it must be set to the primary internal - // IP address of the attached VM instance that matches the subnetwork of the - // NEG. The primary internal IP address from any NIC of a multi-NIC VM - // instance can be added to a NEG as long as it matches the NEG subnetwork. - optional string ip_address = 4 [json_name = "ipAddress"]; +import "google/cloud/compute/v1/internal/common_107.proto"; + +message BfdPacket { + // The Authentication Present bit of the BFD packet. This is specified in + // section 4.1 of RFC5880 + optional bool authentication_present = 1 + [json_name = "authenticationPresent"]; + + // The Control Plane Independent bit of the BFD packet. This is specified in + // section 4.1 of RFC5880 + optional bool control_plane_independent = 2 + [json_name = "controlPlaneIndependent"]; + + // The demand bit of the BFD packet. This is specified in section 4.1 of + // RFC5880 + optional bool demand = 3 [json_name = "demand"]; + + // The diagnostic code specifies the local system's reason for the last change + // in session state. This allows remote systems to determine the reason that + // the previous session failed, for example. These diagnostic codes are + // specified in section 4.1 of RFC5880 + // ADMINISTRATIVELY_DOWN: + // CONCATENATED_PATH_DOWN: + // CONTROL_DETECTION_TIME_EXPIRED: + // DIAGNOSTIC_UNSPECIFIED: + // ECHO_FUNCTION_FAILED: + // FORWARDING_PLANE_RESET: + // NEIGHBOR_SIGNALED_SESSION_DOWN: + // NO_DIAGNOSTIC: + // PATH_DOWN: + // REVERSE_CONCATENATED_PATH_DOWN: + optional string diagnostic = 4 [json_name = "diagnostic"]; + + // The Final bit of the BFD packet. This is specified in section 4.1 of + // RFC5880 + optional bool final = 5 [json_name = "final"]; + + // The length of the BFD Control packet in bytes. This is specified in section + // 4.1 of RFC5880 + optional uint32 length = 6 [json_name = "length"]; + + // The Required Min Echo RX Interval value in the BFD packet. This is + // specified in section 4.1 of RFC5880 + optional uint32 min_echo_rx_interval_ms = 7 + [json_name = "minEchoRxIntervalMs"]; + + // The Required Min RX Interval value in the BFD packet. This is specified in + // section 4.1 of RFC5880 + optional uint32 min_rx_interval_ms = 8 [json_name = "minRxIntervalMs"]; + + // The Desired Min TX Interval value in the BFD packet. This is specified in + // section 4.1 of RFC5880 + optional uint32 min_tx_interval_ms = 9 [json_name = "minTxIntervalMs"]; + + // The detection time multiplier of the BFD packet. This is specified in + // section 4.1 of RFC5880 + optional uint32 multiplier = 10 [json_name = "multiplier"]; + + // The multipoint bit of the BFD packet. This is specified in section 4.1 of + // RFC5880 + optional bool multipoint = 11 [json_name = "multipoint"]; + + // The My Discriminator value in the BFD packet. This is specified in section + // 4.1 of RFC5880 + optional uint32 my_discriminator = 12 [json_name = "myDiscriminator"]; + + // The Poll bit of the BFD packet. This is specified in section 4.1 of RFC5880 + optional bool poll = 13 [json_name = "poll"]; + + // The current BFD session state as seen by the transmitting system. These + // states are specified in section 4.1 of RFC5880 + // ADMIN_DOWN: + // DOWN: + // INIT: + // STATE_UNSPECIFIED: + // UP: + optional string state = 14 [json_name = "state"]; + + // The version number of the BFD protocol, as specified in section 4.1 of + // RFC5880. + optional uint32 version = 15 [json_name = "version"]; + + // The Your Discriminator value in the BFD packet. This is specified in + // section 4.1 of RFC5880 + optional uint32 your_discriminator = 16 [json_name = "yourDiscriminator"]; +} - // Optional port number of network endpoint. If not specified, the defaultPort - // for the network endpoint group will be used. This field can not be set for - // network endpoints of type GCE_VM_IP. - optional int32 port = 5 [json_name = "port"]; +// Next free: 15 +message BfdStatus { + // The BFD session initialization mode for this BGP peer. If set to ACTIVE, + // the Cloud Router will initiate the BFD session for this BGP peer. If set to + // PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD + // session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP + // peer. + // ACTIVE: + // DISABLED: + // PASSIVE: + optional string bfd_session_initialization_mode = 1 + [json_name = "bfdSessionInitializationMode"]; + + // Unix timestamp of the most recent config update. + optional string config_update_timestamp_micros = 2 + [json_name = "configUpdateTimestampMicros"]; + + // Control packet counts for the current BFD session. + optional BfdStatusPacketCounts control_packet_counts = 3 + [json_name = "controlPacketCounts"]; + + // Inter-packet time interval statistics for control packets. + repeated PacketIntervals control_packet_intervals = 4 + [json_name = "controlPacketIntervals"]; + + // The diagnostic code specifies the local system's reason for the last change + // in session state. This allows remote systems to determine the reason that + // the previous session failed, for example. These diagnostic codes are + // specified in section 4.1 of RFC5880 + // ADMINISTRATIVELY_DOWN: + // CONCATENATED_PATH_DOWN: + // CONTROL_DETECTION_TIME_EXPIRED: + // DIAGNOSTIC_UNSPECIFIED: + // ECHO_FUNCTION_FAILED: + // FORWARDING_PLANE_RESET: + // NEIGHBOR_SIGNALED_SESSION_DOWN: + // NO_DIAGNOSTIC: + // PATH_DOWN: + // REVERSE_CONCATENATED_PATH_DOWN: + optional string local_diagnostic = 5 [json_name = "localDiagnostic"]; + + // The current BFD session state as seen by the transmitting system. These + // states are specified in section 4.1 of RFC5880 + // ADMIN_DOWN: + // DOWN: + // INIT: + // STATE_UNSPECIFIED: + // UP: + optional string local_state = 6 [json_name = "localState"]; + + // Negotiated transmit interval for control packets. + optional uint32 negotiated_local_control_tx_interval_ms = 7 + [json_name = "negotiatedLocalControlTxIntervalMs"]; + + // The most recent Rx control packet for this BFD session. + optional BfdPacket rx_packet = 8 [json_name = "rxPacket"]; + + // The most recent Tx control packet for this BFD session. + optional BfdPacket tx_packet = 9 [json_name = "txPacket"]; + + // Session uptime in milliseconds. Value will be 0 if session is not up. + optional string uptime_ms = 10 [json_name = "uptimeMs"]; } -// Represents a collection of network endpoints. A network endpoint group (NEG) -// defines how a set of endpoints should be reached, whether they are reachable, -// and where they are located. For more information about using NEGs for -// different use cases, see Network endpoint groups overview. -message NetworkEndpointGroup { - // Metadata defined as annotations on the network endpoint group. - map annotations = 1 [json_name = "annotations"]; +message BfdStatusPacketCounts { + // Number of packets received since the beginning of the current BFD session. + optional uint32 num_rx = 1 [json_name = "numRx"]; - // Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, - // appEngine or cloudFunction may be set. - optional NetworkEndpointGroupAppEngine app_engine = 2 - [json_name = "appEngine"]; + // Number of packets received that were rejected because of errors since the + // beginning of the current BFD session. + optional uint32 num_rx_rejected = 2 [json_name = "numRxRejected"]; - // Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, - // appEngine or cloudFunction may be set. - optional NetworkEndpointGroupCloudFunction cloud_function = 3 - [json_name = "cloudFunction"]; + // Number of packets received that were successfully processed since the + // beginning of the current BFD session. + optional uint32 num_rx_successful = 3 [json_name = "numRxSuccessful"]; - // Only valid when networkEndpointType is SERVERLESS. Only one of cloudRun, - // appEngine or cloudFunction may be set. - optional NetworkEndpointGroupCloudRun cloud_run = 4 [json_name = "cloudRun"]; + // Number of packets transmitted since the beginning of the current BFD + // session. + optional uint32 num_tx = 4 [json_name = "numTx"]; +} - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 5 [json_name = "creationTimestamp"]; +// Contains NAT IP information of a NAT config (i.e. usage status, mode). +message NatIpInfo { + // A list of all NAT IPs assigned to this NAT config. + repeated NatIpInfoNatIpInfoMapping nat_ip_info_mappings = 1 + [json_name = "natIpInfoMappings"]; + + // Name of the NAT config which the NAT IP belongs to. + optional string nat_name = 2 [json_name = "natName"]; +} + +// Contains information of a NAT IP. +message NatIpInfoNatIpInfoMapping { + // Specifies whether NAT IP is auto or manual. + // AUTO: + // MANUAL: + optional string mode = 1 [json_name = "mode"]; + + // NAT IP address. For example: 203.0.113.11. + optional string nat_ip = 2 [json_name = "natIp"]; + + // Specifies whether NAT IP is currently serving at least one endpoint or not. + // IN_USE: + // UNUSED: + optional string usage = 3 [json_name = "usage"]; +} + +message NatIpInfoResponse { + // [Output Only] A list of NAT IP information. + repeated NatIpInfo result = 1 [json_name = "result"]; +} + +// Next free: 7 +message PacketIntervals { + // Average observed inter-packet interval in milliseconds. + optional string avg_ms = 1 [json_name = "avgMs"]; + + // From how long ago in the past these intervals were observed. + // DURATION_UNSPECIFIED: + // HOUR: + // MAX: From BfdSession object creation time. + // MINUTE: + optional string duration = 2 [json_name = "duration"]; + + // Maximum observed inter-packet interval in milliseconds. + optional string max_ms = 3 [json_name = "maxMs"]; + + // Minimum observed inter-packet interval in milliseconds. + optional string min_ms = 4 [json_name = "minMs"]; + + // Number of inter-packet intervals from which these statistics were derived. + optional string num_intervals = 5 [json_name = "numIntervals"]; + + // The type of packets for which inter-packet intervals were computed. + // LOOPBACK: Only applies to Echo packets. This shows the intervals between + // sending and receiving the same packet. + // RECEIVE: Intervals between received packets. + // TRANSMIT: Intervals between transmitted packets. + // TYPE_UNSPECIFIED: + optional string type = 6 [json_name = "type"]; +} - // The default port used if the port number is not specified in the network - // endpoint. If the network endpoint type is either GCE_VM_IP, SERVERLESS or - // PRIVATE_SERVICE_CONNECT, this field must not be specified. - optional int32 default_port = 6 [json_name = "defaultPort"]; +// Represents a Cloud Router resource. For more information about Cloud Router, +// read the Cloud Router overview. +message Router { + // BGP information specific to this router. + optional RouterBgp bgp = 1 [json_name = "bgp"]; + + // BGP information that must be configured into the routing stack to establish + // BGP peering. This information must specify the peer ASN and either the + // interface name, IP address, or peer IP address. Please refer to RFC4273. + repeated RouterBgpPeer bgp_peers = 2 [json_name = "bgpPeers"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 7 [json_name = "description"]; + optional string description = 4 [json_name = "description"]; + + // Indicates if a router is dedicated for use with encrypted VLAN attachments + // (interconnectAttachments). + optional bool encrypted_interconnect_router = 5 + [json_name = "encryptedInterconnectRouter"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 8 [json_name = "id"]; + optional string id = 6 [json_name = "id"]; - // [Output Only] Type of the resource. Always compute#networkEndpointGroup for - // network endpoint group. - optional string kind = 9 [json_name = "kind"]; + // Router interfaces. To create a BGP peer that uses a router interface, the + // interface must have one of the following fields specified: - + // linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create + // a router interface without any of these fields specified. However, you + // cannot create a BGP peer that uses that interface. + repeated RouterInterface interfaces = 7 [json_name = "interfaces"]; - // Name of the resource; provided by the client when the resource is created. + // [Output Only] Type of resource. Always compute#router for routers. + optional string kind = 8 [json_name = "kind"]; + + // Keys used for MD5 authentication. + repeated RouterMd5AuthenticationKey md5_authentication_keys = 9 + [json_name = "md5AuthenticationKeys"]; + + // 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 @@ -162,139 +300,39 @@ message NetworkEndpointGroup { // dash. optional string name = 10 [json_name = "name"]; - // The URL of the network to which all network endpoints in the NEG belong. - // Uses default project network if unspecified. - optional string network = 11 [json_name = "network"]; - - // Type of network endpoints in this network endpoint group. Can be one of - // GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, - // INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP. - // GCE_VM_IP: The network endpoint is represented by an IP address. - // GCE_VM_IP_PORT: The network endpoint is represented by IP address and port - // pair. - // GCE_VM_IP_PORTMAP: The network endpoint is represented by an IP, Port and - // Client Destination Port. - // INTERNET_FQDN_PORT: The network endpoint is represented by fully qualified - // domain name and port. - // INTERNET_IP_PORT: The network endpoint is represented by an internet IP - // address and port. - // NON_GCP_PRIVATE_IP_PORT: The network endpoint is represented by an IP - // address and port. The endpoint belongs to a VM or pod running in a - // customer's on-premises. - // PRIVATE_SERVICE_CONNECT: The network endpoint is either public Google APIs - // or services exposed by other GCP Project with a Service Attachment. The - // connection is set up by private service connect - // SERVERLESS: The network endpoint is handled by specified serverless - // infrastructure. - optional string network_endpoint_type = 12 - [json_name = "networkEndpointType"]; - - optional NetworkEndpointGroupPscData psc_data = 13 [json_name = "pscData"]; - - // The target service url used to set up private service connection to a - // Google API or a PSC Producer Service Attachment. An example value is: - // asia-northeast3-cloudkms.googleapis.com - optional string psc_target_service = 14 [json_name = "pscTargetService"]; - - // [Output Only] The URL of the region where the network endpoint group is - // located. - optional string region = 15 [json_name = "region"]; + // A list of NAT services created in this router. + repeated RouterNat nats = 11 [json_name = "nats"]; + + // URI of the network to which this router belongs. + optional string network = 12 [json_name = "network"]; + + // [Output Only] URI of the region where the router resides. You must specify + // this field as part of the HTTP request URL. It is not settable as a field + // in the request body. + optional string region = 13 [json_name = "region"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 16 [json_name = "selfLink"]; - - // [Output only] Number of network endpoints in the network endpoint group. - optional int32 size = 17 [json_name = "size"]; - - // Optional URL of the subnetwork to which all network endpoints in the NEG - // belong. - optional string subnetwork = 18 [json_name = "subnetwork"]; - - // [Output Only] The URL of the zone where the network endpoint group is - // located. - optional string zone = 19 [json_name = "zone"]; -} - -// Configuration for an App Engine network endpoint group (NEG). The service is -// optional, may be provided explicitly or in the URL mask. The version is -// optional and can only be provided explicitly or in the URL mask when service -// is present. Note: App Engine service must be in the same project and located -// in the same region as the Serverless NEG. -message NetworkEndpointGroupAppEngine { - // Optional serving service. The service name is case-sensitive and must be - // 1-63 characters long. Example value: default, my-service. - optional string service = 1 [json_name = "service"]; - - // An URL mask is one of the main components of the Cloud Function. 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. For 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. - optional string url_mask = 2 [json_name = "urlMask"]; - - // Optional serving version. The version name is case-sensitive and must be - // 1-100 characters long. Example value: v1, v2. - optional string version = 3 [json_name = "version"]; -} - -// Configuration for a Cloud Function network endpoint group (NEG). The function -// must be provided explicitly or in the URL mask. Note: Cloud Function must be -// in the same project and located in the same region as the Serverless NEG. -message NetworkEndpointGroupCloudFunction { - // A user-defined name of the Cloud Function. The function name is - // case-sensitive and must be 1-63 characters long. Example value: func1. - optional string function = 1 [json_name = "function"]; - - // An URL mask is one of the main components of the Cloud Function. A template - // to parse function field from a request URL. URL mask allows for routing to - // multiple Cloud Functions without having to create multiple Network Endpoint - // Groups and backend services. For example, request URLs - // mydomain.com/function1 and mydomain.com/function2 can be backed by the same - // Serverless NEG with URL mask /. The URL mask will parse them to { - // function = "function1" } and { function = "function2" } respectively. - optional string url_mask = 2 [json_name = "urlMask"]; -} - -// Configuration for a Cloud Run network endpoint group (NEG). The service must -// be provided explicitly or in the URL mask. The tag is optional, may be -// provided explicitly or in the URL mask. Note: Cloud Run service must be in -// the same project and located in the same region as the Serverless NEG. -message NetworkEndpointGroupCloudRun { - // Cloud Run service is the main resource of Cloud Run. The service must be - // 1-63 characters long, and comply with RFC1035. Example value: - // "run-service". - optional string service = 1 [json_name = "service"]; - - // Optional Cloud Run tag represents the "named-revision" to provide - // additional fine-grained traffic routing information. The tag must be 1-63 - // characters long, and comply with RFC1035. Example value: "revision-0010". - optional string tag = 2 [json_name = "tag"]; - - // An URL mask is one of the main components of the Cloud Function. A template - // to parse and fields from a request URL. URL mask allows for - // routing to multiple Run services without having to create multiple network - // endpoint groups and backend services. For example, request URLs - // foo1.domain.com/bar1 and foo1.domain.com/bar2 can be backed by the same - // Serverless Network Endpoint Group (NEG) with URL mask - // .domain.com/. The URL mask will parse them to { - // service="bar1", tag="foo1" } and { service="bar2", tag="foo2" } - // respectively. - optional string url_mask = 3 [json_name = "urlMask"]; -} - -message NetworkEndpointGroupList { + optional string self_link = 14 [json_name = "selfLink"]; +} + +// Description-tagged IP ranges for the router to advertise. +message RouterAdvertisedIpRange { + // User-specified description for the IP range. + optional string description = 1 [json_name = "description"]; + + // The IP range to advertise. The value must be a CIDR-formatted string. + optional string range = 2 [json_name = "range"]; +} + +// Contains a list of routers. +message RouterAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of NetworkEndpointGroup resources. - repeated NetworkEndpointGroup items = 2 [json_name = "items"]; + // A list of Router resources. + map items = 2 [json_name = "items"]; - // [Output Only] The resource type, which is always - // compute#networkEndpointGroupList for network endpoint group lists. + // Type of resource. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -307,6 +345,9 @@ message NetworkEndpointGroupList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -389,49 +430,318 @@ message NetworkEndpointGroupList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; +} + +message RouterBgp { + // User-specified flag to indicate which mode to use for advertisement. The + // options are DEFAULT or CUSTOM. + // CUSTOM: + // DEFAULT: + optional string advertise_mode = 1 [json_name = "advertiseMode"]; + + // User-specified list of prefix groups to advertise in custom mode. This + // field can only be populated if advertise_mode is CUSTOM and is advertised + // to all peers of the router. These groups will be advertised in addition to + // any specified prefixes. Leave this field blank to advertise no custom + // groups. + repeated string advertised_groups = 2 [json_name = "advertisedGroups"]; + + // User-specified list of individual IP ranges to advertise in custom mode. + // This field can only be populated if advertise_mode is CUSTOM and is + // advertised to all peers of the router. These IP ranges will be advertised + // in addition to any specified groups. Leave this field blank to advertise no + // custom IP ranges. + repeated RouterAdvertisedIpRange advertised_ip_ranges = 3 + [json_name = "advertisedIpRanges"]; + + // Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, + // either 16-bit or 32-bit. The value will be fixed for this router resource. + // All VPN tunnels that link to this router will have the same local ASN. + optional uint32 asn = 4 [json_name = "asn"]; + + // Explicitly specifies a range of valid BGP Identifiers for this Router. It + // is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at + // least /30, even if the BGP sessions are over IPv6. It must not overlap with + // any IPv4 BGP session ranges. Other vendors commonly call this "router ID". + optional string identifier_range = 6 [json_name = "identifierRange"]; + + // The interval in seconds between BGP keepalive messages that are sent to the + // peer. Hold time is three times the interval at which keepalive messages are + // sent, and the hold time is the maximum number of seconds allowed to elapse + // between successive keepalive messages that BGP receives from a peer. BGP + // will use the smaller of either the local hold time value or the peer's hold + // time value as the hold time for the BGP connection between the two peers. + // If set, this value must be between 20 and 60. The default is 20. + optional uint32 keepalive_interval = 5 [json_name = "keepaliveInterval"]; +} + +message RouterBgpPeer { + // User-specified flag to indicate which mode to use for advertisement. + // CUSTOM: + // DEFAULT: + optional string advertise_mode = 1 [json_name = "advertiseMode"]; + + // User-specified list of prefix groups to advertise in custom mode, which + // currently supports the following option: - ALL_SUBNETS: Advertises all of + // the router's own VPC subnets. This excludes any routes learned for subnets + // that use VPC Network Peering. Note that this field can only be populated if + // advertise_mode is CUSTOM and overrides the list defined for the router (in + // the "bgp" message). These groups are advertised in addition to any + // specified prefixes. Leave this field blank to advertise no custom groups. + repeated string advertised_groups = 2 [json_name = "advertisedGroups"]; + + // User-specified list of individual IP ranges to advertise in custom mode. + // This field can only be populated if advertise_mode is CUSTOM and overrides + // the list defined for the router (in the "bgp" message). These IP ranges are + // advertised in addition to any specified groups. Leave this field blank to + // advertise no custom IP ranges. + repeated RouterAdvertisedIpRange advertised_ip_ranges = 3 + [json_name = "advertisedIpRanges"]; + + // The priority of routes advertised to this BGP peer. Where there is more + // than one matching route of maximum length, the routes with the lowest + // priority value win. + optional uint32 advertised_route_priority = 4 + [json_name = "advertisedRoutePriority"]; + + // BFD configuration for the BGP peering. + optional RouterBgpPeerBfd bfd = 5 [json_name = "bfd"]; + + // A list of user-defined custom learned route IP address ranges for a BGP + // session. + repeated RouterBgpPeerCustomLearnedIpRange custom_learned_ip_ranges = 18 + [json_name = "customLearnedIpRanges"]; + + // The user-defined custom learned route priority for a BGP session. This + // value is applied to all custom learned route ranges for the session. You + // can choose a value from `0` to `65335`. If you don't provide a value, + // Google Cloud assigns a priority of `100` to the ranges. + optional int32 custom_learned_route_priority = 19 + [json_name = "customLearnedRoutePriority"]; + + // The status of the BGP peer connection. If set to FALSE, any active session + // with the peer is terminated and all associated routing information is + // removed. If set to TRUE, the peer connection can be established with + // routing information. The default is TRUE. + // FALSE: + // TRUE: + optional string enable = 6 [json_name = "enable"]; + + // Enable IPv4 traffic over BGP Peer. It is enabled by default if the + // peerIpAddress is version 4. + optional bool enable_ipv4 = 20 [json_name = "enableIpv4"]; + + // Enable IPv6 traffic over BGP Peer. It is enabled by default if the + // peerIpAddress is version 6. + optional bool enable_ipv6 = 7 [json_name = "enableIpv6"]; + + // List of export policies applied to this peer, in the order they must be + // evaluated. The name must correspond to an existing policy that has + // ROUTE_POLICY_TYPE_EXPORT type. Note that Route Policies are currently + // available in preview. Please use Beta API to use Route Policies. + repeated string export_policies = 21 [json_name = "exportPolicies"]; + + // List of import policies applied to this peer, in the order they must be + // evaluated. The name must correspond to an existing policy that has + // ROUTE_POLICY_TYPE_IMPORT type. Note that Route Policies are currently + // available in preview. Please use Beta API to use Route Policies. + repeated string import_policies = 22 [json_name = "importPolicies"]; + + // Name of the interface the BGP peer is associated with. + optional string interface_name = 8 [json_name = "interfaceName"]; + + // IP address of the interface inside Google Cloud Platform. + optional string ip_address = 9 [json_name = "ipAddress"]; + + // IPv4 address of the interface inside Google Cloud Platform. + optional string ipv4_nexthop_address = 23 [json_name = "ipv4NexthopAddress"]; + + // IPv6 address of the interface inside Google Cloud Platform. + optional string ipv6_nexthop_address = 10 [json_name = "ipv6NexthopAddress"]; + + // [Output Only] The resource that configures and manages this BGP peer. - + // MANAGED_BY_USER is the default value and can be managed by you or other + // users - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed + // by Cloud Interconnect, specifically by an InterconnectAttachment of type + // PARTNER. Google automatically creates, updates, and deletes this type of + // BGP peer when the PARTNER InterconnectAttachment is created, updated, or + // deleted. + // MANAGED_BY_ATTACHMENT: The BGP peer is automatically created for PARTNER + // type InterconnectAttachment; Google will automatically create/delete this + // BGP peer when the PARTNER InterconnectAttachment is created/deleted, and + // Google will update the ipAddress and peerIpAddress when the PARTNER + // InterconnectAttachment is provisioned. This type of BGP peer cannot be + // created or deleted, but can be modified for all fields except for name, + // ipAddress and peerIpAddress. + // MANAGED_BY_USER: Default value, the BGP peer is manually created and + // managed by user. + optional string management_type = 11 [json_name = "managementType"]; + + // Present if MD5 authentication is enabled for the peering. Must be the name + // of one of the entries in the Router.md5_authentication_keys. The field must + // comply with RFC1035. + optional string md5_authentication_key_name = 12 + [json_name = "md5AuthenticationKeyName"]; + + // Name of this BGP peer. 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. + optional string name = 13 [json_name = "name"]; + + // Peer BGP Autonomous System Number (ASN). Each BGP interface may use a + // different value. + optional uint32 peer_asn = 14 [json_name = "peerAsn"]; + + // IP address of the BGP interface outside Google Cloud Platform. + optional string peer_ip_address = 15 [json_name = "peerIpAddress"]; + + // IPv4 address of the BGP interface outside Google Cloud Platform. + optional string peer_ipv4_nexthop_address = 24 + [json_name = "peerIpv4NexthopAddress"]; + + // IPv6 address of the BGP interface outside Google Cloud Platform. + optional string peer_ipv6_nexthop_address = 16 + [json_name = "peerIpv6NexthopAddress"]; + + // URI of the VM instance that is used as third-party router appliances such + // as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM + // instance must be located in zones contained in the same region as this + // Cloud Router. The VM instance is the peer side of the BGP session. + optional string router_appliance_instance = 17 + [json_name = "routerApplianceInstance"]; +} + +message RouterBgpPeerBfd { + // The minimum interval, in milliseconds, between BFD control packets received + // from the peer router. The actual value is negotiated between the two + // routers and is equal to the greater of this value and the transmit interval + // of the other router. If set, this value must be between 1000 and 30000. The + // default is 1000. + optional uint32 min_receive_interval = 1 [json_name = "minReceiveInterval"]; + + // The minimum interval, in milliseconds, between BFD control packets + // transmitted to the peer router. The actual value is negotiated between the + // two routers and is equal to the greater of this value and the corresponding + // receive interval of the other router. If set, this value must be between + // 1000 and 30000. The default is 1000. + optional uint32 min_transmit_interval = 2 [json_name = "minTransmitInterval"]; + + // The number of consecutive BFD packets that must be missed before BFD + // declares that a peer is unavailable. If set, the value must be a value + // between 5 and 16. The default is 5. + optional uint32 multiplier = 3 [json_name = "multiplier"]; + + // The BFD session initialization mode for this BGP peer. If set to ACTIVE, + // the Cloud Router will initiate the BFD session for this BGP peer. If set to + // PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD + // session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP + // peer. The default is DISABLED. + // ACTIVE: + // DISABLED: + // PASSIVE: + optional string session_initialization_mode = 4 + [json_name = "sessionInitializationMode"]; +} + +message RouterBgpPeerCustomLearnedIpRange { + // The custom learned route IP address range. Must be a valid CIDR-formatted + // prefix. If an IP address is provided without a subnet mask, it is + // interpreted as, for IPv4, a `/32` singular IP address range, and, for IPv6, + // `/128`. + optional string range = 1 [json_name = "range"]; +} + +message RouterInterface { + // IP address and range of the interface. - For Internet Protocol version 4 + // (IPv4), the IP range must be in the RFC3927 link-local IP address space. + // The value must be a CIDR-formatted string, for example, 169.254.0.1/30. + // Note: Do not truncate the IP address, as it represents the IP address of + // the interface. - For Internet Protocol version 6 (IPv6), the value must be + // a unique local address (ULA) range from fdff:1::/64 with a mask length of + // 126 or less. This value should be a CIDR-formatted string, for example, + // fc00:0:1:1::1/112. Within the router's VPC, this IPv6 prefix will be + // reserved exclusively for this connection and cannot be used for any other + // purpose. + optional string ip_range = 1 [json_name = "ipRange"]; + + // IP version of this interface. + // IPV4: + // IPV6: + optional string ip_version = 9 [json_name = "ipVersion"]; + + // URI of the linked Interconnect attachment. It must be in the same region as + // the router. Each interface can have one linked resource, which can be a VPN + // tunnel, an Interconnect attachment, or a subnetwork. + optional string linked_interconnect_attachment = 2 + [json_name = "linkedInterconnectAttachment"]; + + // URI of the linked VPN tunnel, which must be in the same region as the + // router. Each interface can have one linked resource, which can be a VPN + // tunnel, an Interconnect attachment, or a subnetwork. + optional string linked_vpn_tunnel = 3 [json_name = "linkedVpnTunnel"]; + + // [Output Only] The resource that configures and manages this interface. - + // MANAGED_BY_USER is the default value and can be managed directly by users. + // - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by + // Cloud Interconnect, specifically, by an InterconnectAttachment of type + // PARTNER. Google automatically creates, updates, and deletes this type of + // interface when the PARTNER InterconnectAttachment is created, updated, or + // deleted. + // MANAGED_BY_ATTACHMENT: The interface is automatically created for PARTNER + // type InterconnectAttachment, Google will automatically create/update/delete + // this interface when the PARTNER InterconnectAttachment is + // created/provisioned/deleted. This type of interface cannot be manually + // managed by user. + // MANAGED_BY_USER: Default value, the interface is manually created and + // managed by user. + optional string management_type = 4 [json_name = "managementType"]; + + // Name of this interface entry. 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. + optional string name = 5 [json_name = "name"]; + + // The regional private internal IP address that is used to establish BGP + // sessions to a VM instance acting as a third-party Router Appliance, such as + // a Next Gen Firewall, a Virtual Router, or an SD-WAN VM. + optional string private_ip_address = 6 [json_name = "privateIpAddress"]; + + // Name of the interface that will be redundant with the current interface you + // are creating. The redundantInterface must belong to the same Cloud Router + // as the interface here. To establish the BGP session to a Router Appliance + // VM, you must create two BGP peers. The two BGP peers must be attached to + // two separate interfaces that are redundant with each other. The + // redundant_interface must be 1-63 characters long, and comply with RFC1035. + // Specifically, the redundant_interface 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. + optional string redundant_interface = 7 [json_name = "redundantInterface"]; + + // The URI of the subnetwork resource that this interface belongs to, which + // must be in the same region as the Cloud Router. When you establish a BGP + // session to a VM instance using this interface, the VM instance must belong + // to the same subnetwork as the subnetwork specified here. + optional string subnetwork = 8 [json_name = "subnetwork"]; } -// All data that is specifically relevant to only network endpoint groups of -// type PRIVATE_SERVICE_CONNECT. -message NetworkEndpointGroupPscData { - // [Output Only] Address allocated from given subnetwork for PSC. This IP - // address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in - // L7 PSC-XLB. - optional string consumer_psc_address = 1 [json_name = "consumerPscAddress"]; - - // The psc producer port is used to connect PSC NEG with specific port on the - // PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG - // type - optional int32 producer_port = 4 [json_name = "producerPort"]; - - // [Output Only] The PSC connection id of the PSC Network Endpoint Group - // Consumer. - optional string psc_connection_id = 2 [json_name = "pscConnectionId"]; - - // [Output Only] The connection status of the PSC Forwarding Rule. - // ACCEPTED: The connection has been accepted by the producer. - // CLOSED: The connection has been closed by the producer and will not serve - // traffic going forward. - // NEEDS_ATTENTION: The connection has been accepted by the producer, but the - // producer needs to take further action before the forwarding rule can serve - // traffic. - // PENDING: The connection is pending acceptance by the producer. - // REJECTED: The connection has been rejected by the producer. - // STATUS_UNSPECIFIED: - optional string psc_connection_status = 3 [json_name = "pscConnectionStatus"]; -} - -message NetworkEndpointGroupsListNetworkEndpoints { +// Contains a list of Router resources. +message RouterList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of NetworkEndpointWithHealthStatus resources. - repeated NetworkEndpointWithHealthStatus items = 2 [json_name = "items"]; + // A list of Router resources. + repeated Router items = 2 [json_name = "items"]; - // [Output Only] The resource type, which is always - // compute#networkEndpointGroupsListNetworkEndpoints for the list of network - // endpoints in the specified network endpoint group. + // [Output Only] Type of resource. Always compute#router for routers. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -441,6 +751,9 @@ message NetworkEndpointGroupsListNetworkEndpoints { // continue paging through the results. optional string next_page_token = 4 [json_name = "nextPageToken"]; + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -523,13 +836,691 @@ message NetworkEndpointGroupsListNetworkEndpoints { } // [Output Only] Informational warning message. - optional Warning warning = 5 [json_name = "warning"]; + optional Warning warning = 6 [json_name = "warning"]; +} + +message RouterMd5AuthenticationKey { + // [Input only] Value of the key. For patch and update calls, it can be + // skipped to copy the value from the previous configuration. This is allowed + // if the key with the same name existed before the operation. Maximum length + // is 80 characters. Can only contain printable ASCII characters. + optional string key = 1 [json_name = "key"]; + + // Name used to identify the key. Must be unique within a router. Must be + // referenced by exactly one bgpPeer. Must comply with RFC1035. + optional string name = 2 [json_name = "name"]; +} + +// Represents a Nat resource. It enables the VMs within the specified +// subnetworks to access Internet without external IP addresses. It specifies a +// list of subnetworks (and the ranges within) that want to use NAT. Customers +// can also provide the external IPs that would be used for NAT. GCP would +// auto-allocate ephemeral IPs if no external IPs are provided. +message RouterNat { + // The network tier to use when automatically reserving NAT IP addresses. Must + // be one of: PREMIUM, STANDARD. If not specified, then the current + // project-level default tier is used. + // FIXED_STANDARD: Public internet quality with fixed bandwidth. + // PREMIUM: High quality, Google-grade network tier, support for all + // networking products. + // STANDARD: Public internet quality, only limited support for other + // networking products. + // STANDARD_OVERRIDES_FIXED_STANDARD: (Output only) Temporary tier for + // FIXED_STANDARD when fixed standard tier is expired or not configured. + optional string auto_network_tier = 19 [json_name = "autoNetworkTier"]; + + // A list of URLs of the IP resources to be drained. These IPs must be valid + // static external IPs that have been assigned to the NAT. These IPs should be + // used for updating/patching a NAT only. + repeated string drain_nat_ips = 1 [json_name = "drainNatIps"]; + + // Enable Dynamic Port Allocation. If not specified, it is disabled by + // default. If set to true, - Dynamic Port Allocation will be enabled on this + // NAT config. - enableEndpointIndependentMapping cannot be set to true. - If + // minPorts is set, minPortsPerVm must be set to a power of two greater than + // or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be + // allocated to a VM from this NAT config. + optional bool enable_dynamic_port_allocation = 2 + [json_name = "enableDynamicPortAllocation"]; + + optional bool enable_endpoint_independent_mapping = 3 + [json_name = "enableEndpointIndependentMapping"]; + + // List of NAT-ted endpoint types supported by the Nat Gateway. If the list is + // empty, then it will be equivalent to include ENDPOINT_TYPE_VM + repeated string endpoint_types = 4 [json_name = "endpointTypes"]; + + // Timeout (in seconds) for ICMP connections. Defaults to 30s if not set. + optional int32 icmp_idle_timeout_sec = 5 [json_name = "icmpIdleTimeoutSec"]; + + // Configure logging on this NAT. + optional RouterNatLogConfig log_config = 6 [json_name = "logConfig"]; + + // Maximum number of ports allocated to a VM from this NAT config when Dynamic + // Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this + // field has no effect. If Dynamic Port Allocation is enabled, and this field + // is set, it must be set to a power of two greater than minPortsPerVm, or 64 + // if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this + // field is not set, a maximum of 65536 ports will be allocated to a VM from + // this NAT config. + optional int32 max_ports_per_vm = 7 [json_name = "maxPortsPerVm"]; + + // Minimum number of ports allocated to a VM from this NAT config. If not set, + // a default number of ports is allocated to a VM. This is rounded up to the + // nearest power of 2. For example, if the value of this field is 50, at least + // 64 ports are allocated to a VM. + optional int32 min_ports_per_vm = 8 [json_name = "minPortsPerVm"]; + + // Unique name of this Nat service. The name must be 1-63 characters long and + // comply with RFC1035. + optional string name = 9 [json_name = "name"]; + + // Specify the NatIpAllocateOption, which can take one of the following + // values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. + // When there are not enough specified Nat IPs, the Nat service fails for new + // VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers + // can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be + // empty. + // AUTO_ONLY: Nat IPs are allocated by GCP; customers can not specify any Nat + // IPs. + // MANUAL_ONLY: Only use Nat IPs provided by customers. When specified Nat IPs + // are not enough then the Nat service fails for new VMs. + optional string nat_ip_allocate_option = 10 + [json_name = "natIpAllocateOption"]; + + // A list of URLs of the IP resources used for this Nat service. These IP + // addresses must be valid static external IP addresses assigned to the + // project. + repeated string nat_ips = 11 [json_name = "natIps"]; + + // A list of rules associated with this NAT. + repeated RouterNatRule rules = 12 [json_name = "rules"]; + + // Specify the Nat option, which can take one of the following values: - + // ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are + // allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary + // IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A + // list of Subnetworks are allowed to Nat (specified in the field subnetwork + // below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note + // that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should + // not be any other Router.Nat section in any Router for this network in this + // region. + // ALL_SUBNETWORKS_ALL_IP_RANGES: All the IP ranges in every Subnetwork are + // allowed to Nat. + // ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All the primary IP ranges in every + // Subnetwork are allowed to Nat. + // LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in + // the field subnetwork below) + optional string source_subnetwork_ip_ranges_to_nat = 13 + [json_name = "sourceSubnetworkIpRangesToNat"]; + + // A list of Subnetwork resources whose traffic should be translated by NAT + // Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the + // SubnetworkIpRangeToNatOption above. + repeated RouterNatSubnetworkToNat subnetworks = 14 + [json_name = "subnetworks"]; + + // Timeout (in seconds) for TCP established connections. Defaults to 1200s if + // not set. + optional int32 tcp_established_idle_timeout_sec = 15 + [json_name = "tcpEstablishedIdleTimeoutSec"]; + + // Timeout (in seconds) for TCP connections that are in TIME_WAIT state. + // Defaults to 120s if not set. + optional int32 tcp_time_wait_timeout_sec = 16 + [json_name = "tcpTimeWaitTimeoutSec"]; + + // Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not + // set. + optional int32 tcp_transitory_idle_timeout_sec = 17 + [json_name = "tcpTransitoryIdleTimeoutSec"]; + + // Indicates whether this NAT is used for public or private IP translation. If + // unspecified, it defaults to PUBLIC. + // PRIVATE: NAT used for private IP translation. + // PUBLIC: NAT used for public IP translation. This is the default. + optional string type = 20 [json_name = "type"]; + + // Timeout (in seconds) for UDP connections. Defaults to 30s if not set. + optional int32 udp_idle_timeout_sec = 18 [json_name = "udpIdleTimeoutSec"]; +} + +// Configuration of logging on a NAT. +message RouterNatLogConfig { + // Indicates whether or not to export logs. This is false by default. + optional bool enable = 1 [json_name = "enable"]; + + // Specify the desired filtering of logs on this NAT. If unspecified, logs are + // exported for all connections handled by this NAT. This option can take one + // of the following values: - ERRORS_ONLY: Export logs only for connection + // failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. + // - ALL: Export logs for all connections, successful and unsuccessful. + // ALL: Export logs for all (successful and unsuccessful) connections. + // ERRORS_ONLY: Export logs for connection failures only. + // TRANSLATIONS_ONLY: Export logs for successful connections only. + optional string filter = 2 [json_name = "filter"]; +} + +message RouterNatRule { + // The action to be enforced for traffic that matches this rule. + optional RouterNatRuleAction action = 1 [json_name = "action"]; + + // An optional description of this rule. + optional string description = 2 [json_name = "description"]; + + // CEL expression that specifies the match condition that egress traffic from + // a VM is evaluated against. If it evaluates to true, the corresponding + // `action` is enforced. The following examples are valid match expressions + // for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || + // inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || + // destination.ip == '8.8.8.8'` The following example is a valid match + // expression for private NAT: `nexthop.hub == + // '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` + optional string match = 3 [json_name = "match"]; + + // An integer uniquely identifying a rule in the list. The rule number must be + // a positive value between 0 and 65000, and must be unique among rules within + // a NAT. + optional uint32 rule_number = 4 [json_name = "ruleNumber"]; +} + +message RouterNatRuleAction { + // A list of URLs of the IP resources used for this NAT rule. These IP + // addresses must be valid static external IP addresses assigned to the + // project. This field is used for public NAT. + repeated string source_nat_active_ips = 1 [json_name = "sourceNatActiveIps"]; + + // A list of URLs of the subnetworks used as source ranges for this NAT Rule. + // These subnetworks must have purpose set to PRIVATE_NAT. This field is used + // for private NAT. + repeated string source_nat_active_ranges = 3 + [json_name = "sourceNatActiveRanges"]; + + // A list of URLs of the IP resources to be drained. These IPs must be valid + // static external IPs that have been assigned to the NAT. These IPs should be + // used for updating/patching a NAT rule only. This field is used for public + // NAT. + repeated string source_nat_drain_ips = 2 [json_name = "sourceNatDrainIps"]; + + // A list of URLs of subnetworks representing source ranges to be drained. + // This is only supported on patch/update, and these subnetworks must have + // previously been used as active ranges in this NAT Rule. This field is used + // for private NAT. + repeated string source_nat_drain_ranges = 4 + [json_name = "sourceNatDrainRanges"]; } -message NetworkEndpointWithHealthStatus { - // [Output only] The health status of network endpoint; - repeated HealthStatusForNetworkEndpoint healths = 1 [json_name = "healths"]; +// Defines the IP ranges that want to use NAT for a subnetwork. +message RouterNatSubnetworkToNat { + // URL for the subnetwork resource that will use NAT. + optional string name = 1 [json_name = "name"]; + + // A list of the secondary ranges of the Subnetwork that are allowed to use + // NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of + // the values in source_ip_ranges_to_nat. + repeated string secondary_ip_range_names = 2 + [json_name = "secondaryIpRangeNames"]; + + // Specify the options for NAT ranges in the Subnetwork. All options of a + // single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only + // valid option with multiple values is: ["PRIMARY_IP_RANGE", + // "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES] + repeated string source_ip_ranges_to_nat = 3 + [json_name = "sourceIpRangesToNat"]; +} + +message RouterStatus { + // A list of the best dynamic routes for this Cloud Router's Virtual Private + // Cloud (VPC) network in the same region as this Cloud Router. Lists all of + // the best routes per prefix that are programmed into this region's VPC data + // plane. When global dynamic routing mode is turned on in the VPC network, + // this list can include cross-region dynamic routes from Cloud Routers in + // other regions. + repeated Route best_routes = 1 [json_name = "bestRoutes"]; + + // A list of the best BGP routes learned by this Cloud Router. It is possible + // that routes listed might not be programmed into the data plane, if the + // Google Cloud control plane finds a more optimal route for a prefix than a + // route learned by this Cloud Router. + repeated Route best_routes_for_router = 2 [json_name = "bestRoutesForRouter"]; + + repeated RouterStatusBgpPeerStatus bgp_peer_status = 3 + [json_name = "bgpPeerStatus"]; + + repeated RouterStatusNatStatus nat_status = 4 [json_name = "natStatus"]; + + // URI of the network to which this router belongs. + optional string network = 5 [json_name = "network"]; +} + +message RouterStatusBgpPeerStatus { + // Routes that were advertised to the remote BGP peer + repeated Route advertised_routes = 1 [json_name = "advertisedRoutes"]; + + optional BfdStatus bfd_status = 2 [json_name = "bfdStatus"]; + + // Enable IPv4 traffic over BGP Peer. It is enabled by default if the + // peerIpAddress is version 4. + optional bool enable_ipv4 = 18 [json_name = "enableIpv4"]; + + // Enable IPv6 traffic over BGP Peer. It is enabled by default if the + // peerIpAddress is version 6. + optional bool enable_ipv6 = 3 [json_name = "enableIpv6"]; + + // IP address of the local BGP interface. + optional string ip_address = 4 [json_name = "ipAddress"]; + + // IPv4 address of the local BGP interface. + optional string ipv4_nexthop_address = 19 [json_name = "ipv4NexthopAddress"]; + + // IPv6 address of the local BGP interface. + optional string ipv6_nexthop_address = 5 [json_name = "ipv6NexthopAddress"]; + + // URL of the VPN tunnel that this BGP peer controls. + optional string linked_vpn_tunnel = 6 [json_name = "linkedVpnTunnel"]; + + // Informs whether MD5 authentication is enabled on this BGP peer. + optional bool md5_auth_enabled = 7 [json_name = "md5AuthEnabled"]; + + // Name of this BGP peer. Unique within the Routers resource. + optional string name = 8 [json_name = "name"]; - // [Output only] The network endpoint; - optional NetworkEndpoint network_endpoint = 2 [json_name = "networkEndpoint"]; + // Number of routes learned from the remote BGP Peer. + optional uint32 num_learned_routes = 9 [json_name = "numLearnedRoutes"]; + + // IP address of the remote BGP interface. + optional string peer_ip_address = 10 [json_name = "peerIpAddress"]; + + // IPv4 address of the remote BGP interface. + optional string peer_ipv4_nexthop_address = 20 + [json_name = "peerIpv4NexthopAddress"]; + + // IPv6 address of the remote BGP interface. + optional string peer_ipv6_nexthop_address = 11 + [json_name = "peerIpv6NexthopAddress"]; + + // [Output only] URI of the VM instance that is used as third-party router + // appliances such as Next Gen Firewalls, Virtual Routers, or Router + // Appliances. The VM instance is the peer side of the BGP session. + optional string router_appliance_instance = 12 + [json_name = "routerApplianceInstance"]; + + // The state of the BGP session. For a list of possible values for this field, + // see BGP session states. + optional string state = 13 [json_name = "state"]; + + // Status of the BGP peer: {UP, DOWN} + // DOWN: + // UNKNOWN: + // UP: + optional string status = 14 [json_name = "status"]; + + // Indicates why particular status was returned. + // IPV4_PEER_ON_IPV6_ONLY_CONNECTION: BGP peer disabled because it requires + // IPv4 but the underlying connection is IPv6-only. + // IPV6_PEER_ON_IPV4_ONLY_CONNECTION: BGP peer disabled because it requires + // IPv6 but the underlying connection is IPv4-only. + // MD5_AUTH_INTERNAL_PROBLEM: Indicates internal problems with configuration + // of MD5 authentication. This particular reason can only be returned when + // md5AuthEnabled is true and status is DOWN. + // STATUS_REASON_UNSPECIFIED: + optional string status_reason = 15 [json_name = "statusReason"]; + + // Time this session has been up. Format: 14 years, 51 weeks, 6 days, 23 + // hours, 59 minutes, 59 seconds + optional string uptime = 16 [json_name = "uptime"]; + + // Time this session has been up, in seconds. Format: 145 + optional string uptime_seconds = 17 [json_name = "uptimeSeconds"]; +} + +// Status of a NAT contained in this router. +message RouterStatusNatStatus { + // A list of IPs auto-allocated for NAT. Example: ["1.1.1.1", "129.2.16.89"] + repeated string auto_allocated_nat_ips = 1 + [json_name = "autoAllocatedNatIps"]; + + // A list of IPs auto-allocated for NAT that are in drain mode. Example: + // ["1.1.1.1", "179.12.26.133"]. + repeated string drain_auto_allocated_nat_ips = 2 + [json_name = "drainAutoAllocatedNatIps"]; + + // A list of IPs user-allocated for NAT that are in drain mode. Example: + // ["1.1.1.1", "179.12.26.133"]. + repeated string drain_user_allocated_nat_ips = 3 + [json_name = "drainUserAllocatedNatIps"]; + + // The number of extra IPs to allocate. This will be greater than 0 only if + // user-specified IPs are NOT enough to allow all configured VMs to use NAT. + // This value is meaningful only when auto-allocation of NAT IPs is *not* + // used. + optional int32 min_extra_nat_ips_needed = 4 + [json_name = "minExtraNatIpsNeeded"]; + + // Unique name of this NAT. + optional string name = 5 [json_name = "name"]; + + // Number of VM endpoints (i.e., Nics) that can use NAT. + optional int32 num_vm_endpoints_with_nat_mappings = 6 + [json_name = "numVmEndpointsWithNatMappings"]; + + // Status of rules in this NAT. + repeated RouterStatusNatStatusNatRuleStatus rule_status = 7 + [json_name = "ruleStatus"]; + + // A list of fully qualified URLs of reserved IP address resources. + repeated string user_allocated_nat_ip_resources = 8 + [json_name = "userAllocatedNatIpResources"]; + + // A list of IPs user-allocated for NAT. They will be raw IP strings like + // "179.12.26.133". + repeated string user_allocated_nat_ips = 9 + [json_name = "userAllocatedNatIps"]; +} + +// Status of a NAT Rule contained in this NAT. +message RouterStatusNatStatusNatRuleStatus { + // A list of active IPs for NAT. Example: ["1.1.1.1", "179.12.26.133"]. + repeated string active_nat_ips = 1 [json_name = "activeNatIps"]; + + // A list of IPs for NAT that are in drain mode. Example: ["1.1.1.1", + // "179.12.26.133"]. + repeated string drain_nat_ips = 2 [json_name = "drainNatIps"]; + + // The number of extra IPs to allocate. This will be greater than 0 only if + // the existing IPs in this NAT Rule are NOT enough to allow all configured + // VMs to use NAT. + optional int32 min_extra_ips_needed = 3 [json_name = "minExtraIpsNeeded"]; + + // Number of VM endpoints (i.e., NICs) that have NAT Mappings from this NAT + // Rule. + optional int32 num_vm_endpoints_with_nat_mappings = 4 + [json_name = "numVmEndpointsWithNatMappings"]; + + // Rule number of the rule. + optional int32 rule_number = 5 [json_name = "ruleNumber"]; +} + +message RouterStatusResponse { + // Type of resource. + optional string kind = 1 [json_name = "kind"]; + + optional RouterStatus result = 2 [json_name = "result"]; +} + +message RoutersPreviewResponse { + // Preview of given router. + optional Router resource = 1 [json_name = "resource"]; +} + +message RoutersScopedList { + // A list of routers contained in this scope. + repeated Router routers = 1 [json_name = "routers"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of routers when the list is + // empty. + optional Warning warning = 2 [json_name = "warning"]; +} + +// Contain information of Nat mapping for a VM endpoint (i.e., NIC). +message VmEndpointNatMappings { + // Name of the VM instance which the endpoint belongs to + optional string instance_name = 1 [json_name = "instanceName"]; + + repeated VmEndpointNatMappingsInterfaceNatMappings interface_nat_mappings = 2 + [json_name = "interfaceNatMappings"]; +} + +// Contain information of Nat mapping for an interface of this endpoint. +message VmEndpointNatMappingsInterfaceNatMappings { + // List of all drain IP:port-range mappings assigned to this interface. These + // ranges are inclusive, that is, both the first and the last ports can be + // used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + repeated string drain_nat_ip_port_ranges = 1 + [json_name = "drainNatIpPortRanges"]; + + // A list of all IP:port-range mappings assigned to this interface. These + // ranges are inclusive, that is, both the first and the last ports can be + // used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. + repeated string nat_ip_port_ranges = 2 [json_name = "natIpPortRanges"]; + + // Total number of drain ports across all NAT IPs allocated to this interface. + // It equals to the aggregated port number in the field + // drain_nat_ip_port_ranges. + optional int32 num_total_drain_nat_ports = 3 + [json_name = "numTotalDrainNatPorts"]; + + // Total number of ports across all NAT IPs allocated to this interface. It + // equals to the aggregated port number in the field nat_ip_port_ranges. + optional int32 num_total_nat_ports = 4 [json_name = "numTotalNatPorts"]; + + // Information about mappings provided by rules in this NAT. + repeated VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings + rule_mappings = 5 [json_name = "ruleMappings"]; + + // Alias IP range for this interface endpoint. It will be a private (RFC 1918) + // IP range. Examples: "10.33.4.55/32", or "192.168.5.0/24". + optional string source_alias_ip_range = 6 [json_name = "sourceAliasIpRange"]; + + // Primary IP of the VM for this NIC. + optional string source_virtual_ip = 7 [json_name = "sourceVirtualIp"]; +} + +// Contains information of NAT Mappings provided by a NAT Rule. +message VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings { + // List of all drain IP:port-range mappings assigned to this interface by this + // rule. These ranges are inclusive, that is, both the first and the last + // ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + // "1.1.1.1:2234-2234"]. + repeated string drain_nat_ip_port_ranges = 1 + [json_name = "drainNatIpPortRanges"]; + + // A list of all IP:port-range mappings assigned to this interface by this + // rule. These ranges are inclusive, that is, both the first and the last + // ports can be used for NAT. Example: ["2.2.2.2:12345-12355", + // "1.1.1.1:2234-2234"]. + repeated string nat_ip_port_ranges = 2 [json_name = "natIpPortRanges"]; + + // Total number of drain ports across all NAT IPs allocated to this interface + // by this rule. It equals the aggregated port number in the field + // drain_nat_ip_port_ranges. + optional int32 num_total_drain_nat_ports = 3 + [json_name = "numTotalDrainNatPorts"]; + + // Total number of ports across all NAT IPs allocated to this interface by + // this rule. It equals the aggregated port number in the field + // nat_ip_port_ranges. + optional int32 num_total_nat_ports = 4 [json_name = "numTotalNatPorts"]; + + // Rule number of the NAT Rule. + optional int32 rule_number = 5 [json_name = "ruleNumber"]; +} + +// Contains a list of VmEndpointNatMappings. +message VmEndpointNatMappingsList { + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 1 [json_name = "id"]; + + // [Output Only] Type of resource. Always compute#vmEndpointNatMappingsList + // for lists of Nat mappings of VM endpoints. + optional string kind = 2 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 3 [json_name = "nextPageToken"]; + + // [Output Only] A list of Nat mapping information of VM endpoints. + repeated VmEndpointNatMappings result = 4 [json_name = "result"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_014.proto b/protos/google/cloud/compute/v1/internal/common_014.proto index d20fbd0392ddd..25b0e14f403da 100644 --- a/protos/google/cloud/compute/v1/internal/common_014.proto +++ b/protos/google/cloud/compute/v1/internal/common_014.proto @@ -15,281 +15,137 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_109.proto"; - -message BfdPacket { - // The Authentication Present bit of the BFD packet. This is specified in - // section 4.1 of RFC5880 - optional bool authentication_present = 1 - [json_name = "authenticationPresent"]; - - // The Control Plane Independent bit of the BFD packet. This is specified in - // section 4.1 of RFC5880 - optional bool control_plane_independent = 2 - [json_name = "controlPlaneIndependent"]; - - // The demand bit of the BFD packet. This is specified in section 4.1 of - // RFC5880 - optional bool demand = 3 [json_name = "demand"]; - - // The diagnostic code specifies the local system's reason for the last change - // in session state. This allows remote systems to determine the reason that - // the previous session failed, for example. These diagnostic codes are - // specified in section 4.1 of RFC5880 - // ADMINISTRATIVELY_DOWN: - // CONCATENATED_PATH_DOWN: - // CONTROL_DETECTION_TIME_EXPIRED: - // DIAGNOSTIC_UNSPECIFIED: - // ECHO_FUNCTION_FAILED: - // FORWARDING_PLANE_RESET: - // NEIGHBOR_SIGNALED_SESSION_DOWN: - // NO_DIAGNOSTIC: - // PATH_DOWN: - // REVERSE_CONCATENATED_PATH_DOWN: - optional string diagnostic = 4 [json_name = "diagnostic"]; - - // The Final bit of the BFD packet. This is specified in section 4.1 of - // RFC5880 - optional bool final = 5 [json_name = "final"]; - - // The length of the BFD Control packet in bytes. This is specified in section - // 4.1 of RFC5880 - optional uint32 length = 6 [json_name = "length"]; - - // The Required Min Echo RX Interval value in the BFD packet. This is - // specified in section 4.1 of RFC5880 - optional uint32 min_echo_rx_interval_ms = 7 - [json_name = "minEchoRxIntervalMs"]; - - // The Required Min RX Interval value in the BFD packet. This is specified in - // section 4.1 of RFC5880 - optional uint32 min_rx_interval_ms = 8 [json_name = "minRxIntervalMs"]; - - // The Desired Min TX Interval value in the BFD packet. This is specified in - // section 4.1 of RFC5880 - optional uint32 min_tx_interval_ms = 9 [json_name = "minTxIntervalMs"]; - - // The detection time multiplier of the BFD packet. This is specified in - // section 4.1 of RFC5880 - optional uint32 multiplier = 10 [json_name = "multiplier"]; - - // The multipoint bit of the BFD packet. This is specified in section 4.1 of - // RFC5880 - optional bool multipoint = 11 [json_name = "multipoint"]; - - // The My Discriminator value in the BFD packet. This is specified in section - // 4.1 of RFC5880 - optional uint32 my_discriminator = 12 [json_name = "myDiscriminator"]; - - // The Poll bit of the BFD packet. This is specified in section 4.1 of RFC5880 - optional bool poll = 13 [json_name = "poll"]; - - // The current BFD session state as seen by the transmitting system. These - // states are specified in section 4.1 of RFC5880 - // ADMIN_DOWN: - // DOWN: - // INIT: - // STATE_UNSPECIFIED: - // UP: - optional string state = 14 [json_name = "state"]; - - // The version number of the BFD protocol, as specified in section 4.1 of - // RFC5880. - optional uint32 version = 15 [json_name = "version"]; - - // The Your Discriminator value in the BFD packet. This is specified in - // section 4.1 of RFC5880 - optional uint32 your_discriminator = 16 [json_name = "yourDiscriminator"]; -} - -// Next free: 15 -message BfdStatus { - // The BFD session initialization mode for this BGP peer. If set to ACTIVE, - // the Cloud Router will initiate the BFD session for this BGP peer. If set to - // PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD - // session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP - // peer. - // ACTIVE: - // DISABLED: - // PASSIVE: - optional string bfd_session_initialization_mode = 1 - [json_name = "bfdSessionInitializationMode"]; - - // Unix timestamp of the most recent config update. - optional string config_update_timestamp_micros = 2 - [json_name = "configUpdateTimestampMicros"]; - - // Control packet counts for the current BFD session. - optional BfdStatusPacketCounts control_packet_counts = 3 - [json_name = "controlPacketCounts"]; - - // Inter-packet time interval statistics for control packets. - repeated PacketIntervals control_packet_intervals = 4 - [json_name = "controlPacketIntervals"]; - - // The diagnostic code specifies the local system's reason for the last change - // in session state. This allows remote systems to determine the reason that - // the previous session failed, for example. These diagnostic codes are - // specified in section 4.1 of RFC5880 - // ADMINISTRATIVELY_DOWN: - // CONCATENATED_PATH_DOWN: - // CONTROL_DETECTION_TIME_EXPIRED: - // DIAGNOSTIC_UNSPECIFIED: - // ECHO_FUNCTION_FAILED: - // FORWARDING_PLANE_RESET: - // NEIGHBOR_SIGNALED_SESSION_DOWN: - // NO_DIAGNOSTIC: - // PATH_DOWN: - // REVERSE_CONCATENATED_PATH_DOWN: - optional string local_diagnostic = 5 [json_name = "localDiagnostic"]; - - // The current BFD session state as seen by the transmitting system. These - // states are specified in section 4.1 of RFC5880 - // ADMIN_DOWN: - // DOWN: - // INIT: - // STATE_UNSPECIFIED: - // UP: - optional string local_state = 6 [json_name = "localState"]; - - // Negotiated transmit interval for control packets. - optional uint32 negotiated_local_control_tx_interval_ms = 7 - [json_name = "negotiatedLocalControlTxIntervalMs"]; - - // The most recent Rx control packet for this BFD session. - optional BfdPacket rx_packet = 8 [json_name = "rxPacket"]; - - // The most recent Tx control packet for this BFD session. - optional BfdPacket tx_packet = 9 [json_name = "txPacket"]; - - // Session uptime in milliseconds. Value will be 0 if session is not up. - optional string uptime_ms = 10 [json_name = "uptimeMs"]; -} - -message BfdStatusPacketCounts { - // Number of packets received since the beginning of the current BFD session. - optional uint32 num_rx = 1 [json_name = "numRx"]; - - // Number of packets received that were rejected because of errors since the - // beginning of the current BFD session. - optional uint32 num_rx_rejected = 2 [json_name = "numRxRejected"]; - - // Number of packets received that were successfully processed since the - // beginning of the current BFD session. - optional uint32 num_rx_successful = 3 [json_name = "numRxSuccessful"]; - - // Number of packets transmitted since the beginning of the current BFD - // session. - optional uint32 num_tx = 4 [json_name = "numTx"]; -} - -// Contains NAT IP information of a NAT config (i.e. usage status, mode). -message NatIpInfo { - // A list of all NAT IPs assigned to this NAT config. - repeated NatIpInfoNatIpInfoMapping nat_ip_info_mappings = 1 - [json_name = "natIpInfoMappings"]; - - // Name of the NAT config which the NAT IP belongs to. - optional string nat_name = 2 [json_name = "natName"]; -} - -// Contains information of a NAT IP. -message NatIpInfoNatIpInfoMapping { - // Specifies whether NAT IP is auto or manual. - // AUTO: - // MANUAL: - optional string mode = 1 [json_name = "mode"]; - - // NAT IP address. For example: 203.0.113.11. - optional string nat_ip = 2 [json_name = "natIp"]; - - // Specifies whether NAT IP is currently serving at least one endpoint or not. - // IN_USE: - // UNUSED: - optional string usage = 3 [json_name = "usage"]; -} - -message NatIpInfoResponse { - // [Output Only] A list of NAT IP information. - repeated NatIpInfo result = 1 [json_name = "result"]; -} - -// Next free: 7 -message PacketIntervals { - // Average observed inter-packet interval in milliseconds. - optional string avg_ms = 1 [json_name = "avgMs"]; - - // From how long ago in the past these intervals were observed. - // DURATION_UNSPECIFIED: - // HOUR: - // MAX: From BfdSession object creation time. - // MINUTE: - optional string duration = 2 [json_name = "duration"]; - - // Maximum observed inter-packet interval in milliseconds. - optional string max_ms = 3 [json_name = "maxMs"]; - - // Minimum observed inter-packet interval in milliseconds. - optional string min_ms = 4 [json_name = "minMs"]; - - // Number of inter-packet intervals from which these statistics were derived. - optional string num_intervals = 5 [json_name = "numIntervals"]; - - // The type of packets for which inter-packet intervals were computed. - // LOOPBACK: Only applies to Echo packets. This shows the intervals between - // sending and receiving the same packet. - // RECEIVE: Intervals between received packets. - // TRANSMIT: Intervals between transmitted packets. - // TYPE_UNSPECIFIED: - optional string type = 6 [json_name = "type"]; -} - -// Represents a Cloud Router resource. For more information about Cloud Router, -// read the Cloud Router overview. -message Router { - // BGP information specific to this router. - optional RouterBgp bgp = 1 [json_name = "bgp"]; - - // BGP information that must be configured into the routing stack to establish - // BGP peering. This information must specify the peer ASN and either the - // interface name, IP address, or peer IP address. Please refer to RFC4273. - repeated RouterBgpPeer bgp_peers = 2 [json_name = "bgpPeers"]; +import "google/cloud/compute/v1/internal/common_020.proto"; + +// A transient resource used in compute.disks.bulkInsert and +// compute.regionDisks.bulkInsert. It is only used to process requests and is +// not persisted. +message BulkInsertDiskResource { + // The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. + // This may be a full or partial URL, such as: - + // https://www.googleapis.com/compute/v1/projects/project/regions/region + // /resourcePolicies/resourcePolicy - + // projects/project/regions/region/resourcePolicies/resourcePolicy - + // regions/region/resourcePolicies/resourcePolicy + optional string source_consistency_group_policy = 1 + [json_name = "sourceConsistencyGroupPolicy"]; +} + +// Represents a Persistent Disk resource. Google Compute Engine has two Disk +// resources: * [Zonal](/compute/docs/reference/rest/v1/disks) * +// [Regional](/compute/docs/reference/rest/v1/regionDisks) Persistent disks are +// required for running your VM instances. Create both boot and non-boot (data) +// persistent disks. For more information, read Persistent Disks. For more +// storage options, read Storage options. The disks resource represents a zonal +// persistent disk. For more information, read Zonal persistent disks. The +// regionDisks resource represents a regional persistent disk. For more +// information, read Regional resources. +message Disk { + // The access mode of the disk. - READ_WRITE_SINGLE: The default AccessMode, + // means the disk can be attached to single instance in RW mode. - + // READ_WRITE_MANY: The AccessMode means the disk can be attached to multiple + // instances in RW mode. - READ_ONLY_MANY: The AccessMode means the disk can + // be attached to multiple instances in RO mode. The AccessMode is only valid + // for Hyperdisk disk types. + // READ_ONLY_MANY: The AccessMode means the disk can be attached to multiple + // instances in RO mode. + // READ_WRITE_MANY: The AccessMode means the disk can be attached to multiple + // instances in RW mode. + // READ_WRITE_SINGLE: The default AccessMode, means the disk can be attached + // to single instance in RW mode. + optional string access_mode = 50 [json_name = "accessMode"]; + + // The architecture of the disk. Valid values are ARM64 or X86_64. + // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. + // ARM64: Machines with architecture ARM64 + // X86_64: Machines with architecture X86_64 + optional string architecture = 1 [json_name = "architecture"]; + + // Disk asynchronously replicated into this disk. + optional DiskAsyncReplication async_primary_disk = 39 + [json_name = "asyncPrimaryDisk"]; + + // [Output Only] A list of disks this disk is asynchronously replicated to. + map async_secondary_disks = 40 + [json_name = "asyncSecondaryDisks"]; // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 4 [json_name = "description"]; - - // Indicates if a router is dedicated for use with encrypted VLAN attachments - // (interconnectAttachments). - optional bool encrypted_interconnect_router = 5 - [json_name = "encryptedInterconnectRouter"]; + optional string description = 3 [json_name = "description"]; + + // Encrypts the disk using a customer-supplied encryption key or a + // customer-managed encryption key. Encryption keys do not protect access to + // metadata of the disk. After you encrypt a disk with a customer-supplied + // key, you must provide the same key if you use the disk later. For example, + // to create a disk snapshot, to create a disk image, to create a machine + // image, or to attach the disk to a virtual machine. After you encrypt a disk + // with a customer-managed key, the diskEncryptionKey.kmsKeyName is set to a + // key *version* name once the disk is created. The disk is encrypted with + // this version of the key. In the response, diskEncryptionKey.kmsKeyName + // appears in the following format: "diskEncryptionKey.kmsKeyName": + // "projects/kms_project_id/locations/region/keyRings/ + // key_region/cryptoKeys/key /cryptoKeysVersions/version If you do not provide + // an encryption key when creating the disk, then the disk is encrypted using + // an automatically generated key and you don't need to provide a key to use + // the disk later. + optional CustomerEncryptionKey disk_encryption_key = 4 + [json_name = "diskEncryptionKey"]; + + // Whether this disk is using confidential compute mode. + optional bool enable_confidential_compute = 45 + [json_name = "enableConfidentialCompute"]; + + // A list of features to enable on the guest operating system. Applicable only + // for bootable images. Read Enabling guest operating system features to see a + // list of available options. + repeated GuestOsFeature guest_os_features = 5 [json_name = "guestOsFeatures"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. optional string id = 6 [json_name = "id"]; - // Router interfaces. To create a BGP peer that uses a router interface, the - // interface must have one of the following fields specified: - - // linkedVpnTunnel - linkedInterconnectAttachment - subnetwork You can create - // a router interface without any of these fields specified. However, you - // cannot create a BGP peer that uses that interface. - repeated RouterInterface interfaces = 7 [json_name = "interfaces"]; + // [Output Only] Type of the resource. Always compute#disk for disks. + optional string kind = 7 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this disk, which is + // essentially a hash of the labels set used for optimistic locking. The + // fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels, otherwise + // the request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve a disk. + optional string label_fingerprint = 8 [json_name = "labelFingerprint"]; + + // Labels to apply to this disk. These can be later modified by the setLabels + // method. + map labels = 9 [json_name = "labels"]; - // [Output Only] Type of resource. Always compute#router for routers. - optional string kind = 8 [json_name = "kind"]; + // [Output Only] Last attach timestamp in RFC3339 text format. + optional string last_attach_timestamp = 10 + [json_name = "lastAttachTimestamp"]; - // Keys used for MD5 authentication. - repeated RouterMd5AuthenticationKey md5_authentication_keys = 9 - [json_name = "md5AuthenticationKeys"]; + // [Output Only] Last detach timestamp in RFC3339 text format. + optional string last_detach_timestamp = 11 + [json_name = "lastDetachTimestamp"]; + + // Integer license codes indicating which licenses are attached to this disk. + repeated string license_codes = 12 [json_name = "licenseCodes"]; + + // A list of publicly visible licenses. Reserved for Google's use. + repeated string licenses = 13 [json_name = "licenses"]; + + // An opaque location hint used to place the disk close to other resources. + // This field is for use by internal tools that use the public API. + optional string location_hint = 14 [json_name = "locationHint"]; // 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. @@ -298,450 +154,246 @@ message Router { // 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. - optional string name = 10 [json_name = "name"]; - - // A list of NAT services created in this router. - repeated RouterNat nats = 11 [json_name = "nats"]; - - // URI of the network to which this router belongs. - optional string network = 12 [json_name = "network"]; - - // [Output Only] URI of the region where the router resides. You must specify - // this field as part of the HTTP request URL. It is not settable as a field - // in the request body. - optional string region = 13 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 14 [json_name = "selfLink"]; -} - -// Description-tagged IP ranges for the router to advertise. -message RouterAdvertisedIpRange { - // User-specified description for the IP range. - optional string description = 1 [json_name = "description"]; - - // The IP range to advertise. The value must be a CIDR-formatted string. - optional string range = 2 [json_name = "range"]; -} - -// Contains a list of routers. -message RouterAggregatedList { + optional string name = 15 [json_name = "name"]; + + // Internal use only. + optional string options = 16 [json_name = "options"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted as part of resource payload. + optional DiskParams params = 17 [json_name = "params"]; + + // Physical block size of the persistent disk, in bytes. If not present in a + // request, a default value is used. The currently supported size is 4096, + // other sizes may be added in the future. If an unsupported value is + // requested, the error message will list the supported values for the + // caller's project. + optional string physical_block_size_bytes = 18 + [json_name = "physicalBlockSizeBytes"]; + + // Indicates how many IOPS to provision for the disk. This sets the number of + // I/O operations per second that the disk can handle. Values must be between + // 10,000 and 120,000. For more details, see the Extreme persistent disk + // documentation. + optional string provisioned_iops = 19 [json_name = "provisionedIops"]; + + // Indicates how much throughput to provision for the disk. This sets the + // number of throughput mb per second that the disk can handle. Values must be + // greater than or equal to 1. + optional string provisioned_throughput = 41 + [json_name = "provisionedThroughput"]; + + // [Output Only] URL of the region where the disk resides. Only applicable for + // regional resources. You must specify this field as part of the HTTP request + // URL. It is not settable as a field in the request body. + optional string region = 20 [json_name = "region"]; + + // URLs of the zones where the disk should be replicated to. Only applicable + // for regional resources. + repeated string replica_zones = 21 [json_name = "replicaZones"]; + + // Resource policies applied to this disk for automatic snapshot creations. + repeated string resource_policies = 22 [json_name = "resourcePolicies"]; + + // [Output Only] Status information for the disk resource. + optional DiskResourceStatus resource_status = 42 + [json_name = "resourceStatus"]; + + // Output only. Reserved for future use. + optional bool satisfies_pzi = 46 [json_name = "satisfiesPzi"]; + + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 23 [json_name = "satisfiesPzs"]; + + // [Output Only] Server-defined fully-qualified URL for this resource. + optional string self_link = 24 [json_name = "selfLink"]; + + // Size, in GB, of the persistent disk. You can specify this field when + // creating a persistent disk using the sourceImage, sourceSnapshot, or + // sourceDisk parameter, or specify it alone to create an empty persistent + // disk. If you specify this field along with a source, the value of sizeGb + // must not be less than the size of the source. Acceptable values are greater + // than 0. + optional string size_gb = 25 [json_name = "sizeGb"]; + + // [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk + // that was created using a consistency group. + optional string source_consistency_group_policy = 43 + [json_name = "sourceConsistencyGroupPolicy"]; + + // [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk + // that was created using a consistency group. + optional string source_consistency_group_policy_id = 44 + [json_name = "sourceConsistencyGroupPolicyId"]; + + // The source disk used to create this disk. You can provide this as a partial + // or full URL to the resource. For example, the following are valid values: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /disks/disk - + // https://www.googleapis.com/compute/v1/projects/project/regions/region + // /disks/disk - projects/project/zones/zone/disks/disk - + // projects/project/regions/region/disks/disk - zones/zone/disks/disk - + // regions/region/disks/disk + optional string source_disk = 26 [json_name = "sourceDisk"]; + + // [Output Only] The unique ID of the disk used to create this disk. This + // value identifies the exact disk that was used to create this persistent + // disk. For example, if you created the persistent disk from a disk that was + // later deleted and recreated under the same name, the source disk ID would + // identify the exact version of the disk that was used. + optional string source_disk_id = 27 [json_name = "sourceDiskId"]; + + // The source image used to create this disk. If the source image is deleted, + // this field will not be set. To create a disk with one of the public + // operating system images, specify the image by its family name. For example, + // specify family/debian-9 to use the latest Debian 9 image: + // projects/debian-cloud/global/images/family/debian-9 Alternatively, use a + // specific version of a public operating system image: + // projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a + // disk with a custom image that you created, specify the image name in the + // following format: global/images/my-custom-image You can also specify a + // custom image by its image family, which returns the latest version of the + // image in that family. Replace the image name with family/family-name: + // global/images/family/my-image-family + optional string source_image = 28 [json_name = "sourceImage"]; + + // The customer-supplied encryption key of the source image. Required if the + // source image is protected by a customer-supplied encryption key. + optional CustomerEncryptionKey source_image_encryption_key = 29 + [json_name = "sourceImageEncryptionKey"]; + + // [Output Only] The ID value of the image used to create this disk. This + // value identifies the exact image that was used to create this persistent + // disk. For example, if you created the persistent disk from an image that + // was later deleted and recreated under the same name, the source image ID + // would identify the exact version of the image that was used. + optional string source_image_id = 30 [json_name = "sourceImageId"]; + + // The source instant snapshot used to create this disk. You can provide this + // as a partial or full URL to the resource. For example, the following are + // valid values: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /instantSnapshots/instantSnapshot - + // projects/project/zones/zone/instantSnapshots/instantSnapshot - + // zones/zone/instantSnapshots/instantSnapshot + optional string source_instant_snapshot = 47 + [json_name = "sourceInstantSnapshot"]; + + // [Output Only] The unique ID of the instant snapshot used to create this + // disk. This value identifies the exact instant snapshot that was used to + // create this persistent disk. For example, if you created the persistent + // disk from an instant snapshot that was later deleted and recreated under + // the same name, the source instant snapshot ID would identify the exact + // version of the instant snapshot that was used. + optional string source_instant_snapshot_id = 48 + [json_name = "sourceInstantSnapshotId"]; + + // The source snapshot used to create this disk. You can provide this as a + // partial or full URL to the resource. For example, the following are valid + // values: - https://www.googleapis.com/compute/v1/projects/project + // /global/snapshots/snapshot - projects/project/global/snapshots/snapshot - + // global/snapshots/snapshot + optional string source_snapshot = 31 [json_name = "sourceSnapshot"]; + + // The customer-supplied encryption key of the source snapshot. Required if + // the source snapshot is protected by a customer-supplied encryption key. + optional CustomerEncryptionKey source_snapshot_encryption_key = 32 + [json_name = "sourceSnapshotEncryptionKey"]; + + // [Output Only] The unique ID of the snapshot used to create this disk. This + // value identifies the exact snapshot that was used to create this persistent + // disk. For example, if you created the persistent disk from a snapshot that + // was later deleted and recreated under the same name, the source snapshot ID + // would identify the exact version of the snapshot that was used. + optional string source_snapshot_id = 33 [json_name = "sourceSnapshotId"]; + + // The full Google Cloud Storage URI where the disk image is stored. This file + // must be a gzip-compressed tarball whose name ends in .tar.gz or virtual + // machine disk whose name ends in vmdk. Valid URIs may start with gs:// or + // https://storage.googleapis.com/. This flag is not optimized for creating + // multiple disks from a source storage object. To create many disks from a + // source storage object, use gcloud compute images import instead. + optional string source_storage_object = 34 + [json_name = "sourceStorageObject"]; + + // [Output Only] The status of disk creation. - CREATING: Disk is + // provisioning. - RESTORING: Source data is being copied into the disk. - + // FAILED: Disk creation failed. - READY: Disk is ready for use. - DELETING: + // Disk is deleting. + // CREATING: Disk is provisioning + // DELETING: Disk is deleting. + // FAILED: Disk creation failed. + // READY: Disk is ready for use. + // RESTORING: Source data is being copied into the disk. + // UNAVAILABLE: Disk is currently unavailable and cannot be accessed, attached + // or detached. + optional string status = 35 [json_name = "status"]; + + // The storage pool in which the new disk is created. You can provide this as + // a partial or full URL to the resource. For example, the following are valid + // values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /storagePools/storagePool - + // projects/project/zones/zone/storagePools/storagePool - + // zones/zone/storagePools/storagePool + optional string storage_pool = 49 [json_name = "storagePool"]; + + // URL of the disk type resource describing which disk type to use to create + // the disk. Provide this when creating the disk. For example: + // projects/project /zones/zone/diskTypes/pd-ssd . See Persistent disk types. + optional string type = 36 [json_name = "type"]; + + // [Output Only] Links to the users of the disk (attached instances) in form: + // projects/project/zones/zone/instances/instance + repeated string users = 37 [json_name = "users"]; + + // [Output Only] URL of the zone where the disk resides. You must specify this + // field as part of the HTTP request URL. It is not settable as a field in the + // request body. + optional string zone = 38 [json_name = "zone"]; +} + +message DiskAsyncReplication { + // [Output Only] URL of the DiskConsistencyGroupPolicy if replication was + // started on the disk as a member of a group. + optional string consistency_group_policy = 1 + [json_name = "consistencyGroupPolicy"]; + + // [Output Only] ID of the DiskConsistencyGroupPolicy if replication was + // started on the disk as a member of a group. + optional string consistency_group_policy_id = 2 + [json_name = "consistencyGroupPolicyId"]; + + // The other disk asynchronously replicated to or from the current disk. You + // can provide this as a partial or full URL to the resource. For example, the + // following are valid values: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /disks/disk - projects/project/zones/zone/disks/disk - + // zones/zone/disks/disk + optional string disk = 3 [json_name = "disk"]; + + // [Output Only] The unique ID of the other disk asynchronously replicated to + // or from the current disk. This value identifies the exact disk that was + // used to create this replication. For example, if you started replicating + // the persistent disk from a disk that was later deleted and recreated under + // the same name, the disk ID would identify the exact version of the disk + // that was used. + optional string disk_id = 4 [json_name = "diskId"]; +} + +message DiskAsyncReplicationList { + optional DiskAsyncReplication async_replication_disk = 1 + [json_name = "asyncReplicationDisk"]; +} + +// A list of Disk resources. +message DiskList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of Router resources. - map items = 2 [json_name = "items"]; + // A list of Disk resources. + repeated Disk items = 2 [json_name = "items"]; - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -message RouterBgp { - // User-specified flag to indicate which mode to use for advertisement. The - // options are DEFAULT or CUSTOM. - // CUSTOM: - // DEFAULT: - optional string advertise_mode = 1 [json_name = "advertiseMode"]; - - // User-specified list of prefix groups to advertise in custom mode. This - // field can only be populated if advertise_mode is CUSTOM and is advertised - // to all peers of the router. These groups will be advertised in addition to - // any specified prefixes. Leave this field blank to advertise no custom - // groups. - repeated string advertised_groups = 2 [json_name = "advertisedGroups"]; - - // User-specified list of individual IP ranges to advertise in custom mode. - // This field can only be populated if advertise_mode is CUSTOM and is - // advertised to all peers of the router. These IP ranges will be advertised - // in addition to any specified groups. Leave this field blank to advertise no - // custom IP ranges. - repeated RouterAdvertisedIpRange advertised_ip_ranges = 3 - [json_name = "advertisedIpRanges"]; - - // Local BGP Autonomous System Number (ASN). Must be an RFC6996 private ASN, - // either 16-bit or 32-bit. The value will be fixed for this router resource. - // All VPN tunnels that link to this router will have the same local ASN. - optional uint32 asn = 4 [json_name = "asn"]; - - // Explicitly specifies a range of valid BGP Identifiers for this Router. It - // is provided as a link-local IPv4 range (from 169.254.0.0/16), of size at - // least /30, even if the BGP sessions are over IPv6. It must not overlap with - // any IPv4 BGP session ranges. Other vendors commonly call this "router ID". - optional string identifier_range = 6 [json_name = "identifierRange"]; - - // The interval in seconds between BGP keepalive messages that are sent to the - // peer. Hold time is three times the interval at which keepalive messages are - // sent, and the hold time is the maximum number of seconds allowed to elapse - // between successive keepalive messages that BGP receives from a peer. BGP - // will use the smaller of either the local hold time value or the peer's hold - // time value as the hold time for the BGP connection between the two peers. - // If set, this value must be between 20 and 60. The default is 20. - optional uint32 keepalive_interval = 5 [json_name = "keepaliveInterval"]; -} - -message RouterBgpPeer { - // User-specified flag to indicate which mode to use for advertisement. - // CUSTOM: - // DEFAULT: - optional string advertise_mode = 1 [json_name = "advertiseMode"]; - - // User-specified list of prefix groups to advertise in custom mode, which - // currently supports the following option: - ALL_SUBNETS: Advertises all of - // the router's own VPC subnets. This excludes any routes learned for subnets - // that use VPC Network Peering. Note that this field can only be populated if - // advertise_mode is CUSTOM and overrides the list defined for the router (in - // the "bgp" message). These groups are advertised in addition to any - // specified prefixes. Leave this field blank to advertise no custom groups. - repeated string advertised_groups = 2 [json_name = "advertisedGroups"]; - - // User-specified list of individual IP ranges to advertise in custom mode. - // This field can only be populated if advertise_mode is CUSTOM and overrides - // the list defined for the router (in the "bgp" message). These IP ranges are - // advertised in addition to any specified groups. Leave this field blank to - // advertise no custom IP ranges. - repeated RouterAdvertisedIpRange advertised_ip_ranges = 3 - [json_name = "advertisedIpRanges"]; - - // The priority of routes advertised to this BGP peer. Where there is more - // than one matching route of maximum length, the routes with the lowest - // priority value win. - optional uint32 advertised_route_priority = 4 - [json_name = "advertisedRoutePriority"]; - - // BFD configuration for the BGP peering. - optional RouterBgpPeerBfd bfd = 5 [json_name = "bfd"]; - - // A list of user-defined custom learned route IP address ranges for a BGP - // session. - repeated RouterBgpPeerCustomLearnedIpRange custom_learned_ip_ranges = 18 - [json_name = "customLearnedIpRanges"]; - - // The user-defined custom learned route priority for a BGP session. This - // value is applied to all custom learned route ranges for the session. You - // can choose a value from `0` to `65335`. If you don't provide a value, - // Google Cloud assigns a priority of `100` to the ranges. - optional int32 custom_learned_route_priority = 19 - [json_name = "customLearnedRoutePriority"]; - - // The status of the BGP peer connection. If set to FALSE, any active session - // with the peer is terminated and all associated routing information is - // removed. If set to TRUE, the peer connection can be established with - // routing information. The default is TRUE. - // FALSE: - // TRUE: - optional string enable = 6 [json_name = "enable"]; - - // Enable IPv4 traffic over BGP Peer. It is enabled by default if the - // peerIpAddress is version 4. - optional bool enable_ipv4 = 20 [json_name = "enableIpv4"]; - - // Enable IPv6 traffic over BGP Peer. It is enabled by default if the - // peerIpAddress is version 6. - optional bool enable_ipv6 = 7 [json_name = "enableIpv6"]; - - // List of export policies applied to this peer, in the order they must be - // evaluated. The name must correspond to an existing policy that has - // ROUTE_POLICY_TYPE_EXPORT type. Note that Route Policies are currently - // available in preview. Please use Beta API to use Route Policies. - repeated string export_policies = 21 [json_name = "exportPolicies"]; - - // List of import policies applied to this peer, in the order they must be - // evaluated. The name must correspond to an existing policy that has - // ROUTE_POLICY_TYPE_IMPORT type. Note that Route Policies are currently - // available in preview. Please use Beta API to use Route Policies. - repeated string import_policies = 22 [json_name = "importPolicies"]; - - // Name of the interface the BGP peer is associated with. - optional string interface_name = 8 [json_name = "interfaceName"]; - - // IP address of the interface inside Google Cloud Platform. - optional string ip_address = 9 [json_name = "ipAddress"]; - - // IPv4 address of the interface inside Google Cloud Platform. - optional string ipv4_nexthop_address = 23 [json_name = "ipv4NexthopAddress"]; - - // IPv6 address of the interface inside Google Cloud Platform. - optional string ipv6_nexthop_address = 10 [json_name = "ipv6NexthopAddress"]; - - // [Output Only] The resource that configures and manages this BGP peer. - - // MANAGED_BY_USER is the default value and can be managed by you or other - // users - MANAGED_BY_ATTACHMENT is a BGP peer that is configured and managed - // by Cloud Interconnect, specifically by an InterconnectAttachment of type - // PARTNER. Google automatically creates, updates, and deletes this type of - // BGP peer when the PARTNER InterconnectAttachment is created, updated, or - // deleted. - // MANAGED_BY_ATTACHMENT: The BGP peer is automatically created for PARTNER - // type InterconnectAttachment; Google will automatically create/delete this - // BGP peer when the PARTNER InterconnectAttachment is created/deleted, and - // Google will update the ipAddress and peerIpAddress when the PARTNER - // InterconnectAttachment is provisioned. This type of BGP peer cannot be - // created or deleted, but can be modified for all fields except for name, - // ipAddress and peerIpAddress. - // MANAGED_BY_USER: Default value, the BGP peer is manually created and - // managed by user. - optional string management_type = 11 [json_name = "managementType"]; - - // Present if MD5 authentication is enabled for the peering. Must be the name - // of one of the entries in the Router.md5_authentication_keys. The field must - // comply with RFC1035. - optional string md5_authentication_key_name = 12 - [json_name = "md5AuthenticationKeyName"]; - - // Name of this BGP peer. 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. - optional string name = 13 [json_name = "name"]; - - // Peer BGP Autonomous System Number (ASN). Each BGP interface may use a - // different value. - optional uint32 peer_asn = 14 [json_name = "peerAsn"]; - - // IP address of the BGP interface outside Google Cloud Platform. - optional string peer_ip_address = 15 [json_name = "peerIpAddress"]; - - // IPv4 address of the BGP interface outside Google Cloud Platform. - optional string peer_ipv4_nexthop_address = 24 - [json_name = "peerIpv4NexthopAddress"]; - - // IPv6 address of the BGP interface outside Google Cloud Platform. - optional string peer_ipv6_nexthop_address = 16 - [json_name = "peerIpv6NexthopAddress"]; - - // URI of the VM instance that is used as third-party router appliances such - // as Next Gen Firewalls, Virtual Routers, or Router Appliances. The VM - // instance must be located in zones contained in the same region as this - // Cloud Router. The VM instance is the peer side of the BGP session. - optional string router_appliance_instance = 17 - [json_name = "routerApplianceInstance"]; -} - -message RouterBgpPeerBfd { - // The minimum interval, in milliseconds, between BFD control packets received - // from the peer router. The actual value is negotiated between the two - // routers and is equal to the greater of this value and the transmit interval - // of the other router. If set, this value must be between 1000 and 30000. The - // default is 1000. - optional uint32 min_receive_interval = 1 [json_name = "minReceiveInterval"]; - - // The minimum interval, in milliseconds, between BFD control packets - // transmitted to the peer router. The actual value is negotiated between the - // two routers and is equal to the greater of this value and the corresponding - // receive interval of the other router. If set, this value must be between - // 1000 and 30000. The default is 1000. - optional uint32 min_transmit_interval = 2 [json_name = "minTransmitInterval"]; - - // The number of consecutive BFD packets that must be missed before BFD - // declares that a peer is unavailable. If set, the value must be a value - // between 5 and 16. The default is 5. - optional uint32 multiplier = 3 [json_name = "multiplier"]; - - // The BFD session initialization mode for this BGP peer. If set to ACTIVE, - // the Cloud Router will initiate the BFD session for this BGP peer. If set to - // PASSIVE, the Cloud Router will wait for the peer router to initiate the BFD - // session for this BGP peer. If set to DISABLED, BFD is disabled for this BGP - // peer. The default is DISABLED. - // ACTIVE: - // DISABLED: - // PASSIVE: - optional string session_initialization_mode = 4 - [json_name = "sessionInitializationMode"]; -} - -message RouterBgpPeerCustomLearnedIpRange { - // The custom learned route IP address range. Must be a valid CIDR-formatted - // prefix. If an IP address is provided without a subnet mask, it is - // interpreted as, for IPv4, a `/32` singular IP address range, and, for IPv6, - // `/128`. - optional string range = 1 [json_name = "range"]; -} - -message RouterInterface { - // IP address and range of the interface. - For Internet Protocol version 4 - // (IPv4), the IP range must be in the RFC3927 link-local IP address space. - // The value must be a CIDR-formatted string, for example, 169.254.0.1/30. - // Note: Do not truncate the IP address, as it represents the IP address of - // the interface. - For Internet Protocol version 6 (IPv6), the value must be - // a unique local address (ULA) range from fdff:1::/64 with a mask length of - // 126 or less. This value should be a CIDR-formatted string, for example, - // fc00:0:1:1::1/112. Within the router's VPC, this IPv6 prefix will be - // reserved exclusively for this connection and cannot be used for any other - // purpose. - optional string ip_range = 1 [json_name = "ipRange"]; - - // IP version of this interface. - // IPV4: - // IPV6: - optional string ip_version = 9 [json_name = "ipVersion"]; - - // URI of the linked Interconnect attachment. It must be in the same region as - // the router. Each interface can have one linked resource, which can be a VPN - // tunnel, an Interconnect attachment, or a subnetwork. - optional string linked_interconnect_attachment = 2 - [json_name = "linkedInterconnectAttachment"]; - - // URI of the linked VPN tunnel, which must be in the same region as the - // router. Each interface can have one linked resource, which can be a VPN - // tunnel, an Interconnect attachment, or a subnetwork. - optional string linked_vpn_tunnel = 3 [json_name = "linkedVpnTunnel"]; - - // [Output Only] The resource that configures and manages this interface. - - // MANAGED_BY_USER is the default value and can be managed directly by users. - // - MANAGED_BY_ATTACHMENT is an interface that is configured and managed by - // Cloud Interconnect, specifically, by an InterconnectAttachment of type - // PARTNER. Google automatically creates, updates, and deletes this type of - // interface when the PARTNER InterconnectAttachment is created, updated, or - // deleted. - // MANAGED_BY_ATTACHMENT: The interface is automatically created for PARTNER - // type InterconnectAttachment, Google will automatically create/update/delete - // this interface when the PARTNER InterconnectAttachment is - // created/provisioned/deleted. This type of interface cannot be manually - // managed by user. - // MANAGED_BY_USER: Default value, the interface is manually created and - // managed by user. - optional string management_type = 4 [json_name = "managementType"]; - - // Name of this interface entry. 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. - optional string name = 5 [json_name = "name"]; - - // The regional private internal IP address that is used to establish BGP - // sessions to a VM instance acting as a third-party Router Appliance, such as - // a Next Gen Firewall, a Virtual Router, or an SD-WAN VM. - optional string private_ip_address = 6 [json_name = "privateIpAddress"]; - - // Name of the interface that will be redundant with the current interface you - // are creating. The redundantInterface must belong to the same Cloud Router - // as the interface here. To establish the BGP session to a Router Appliance - // VM, you must create two BGP peers. The two BGP peers must be attached to - // two separate interfaces that are redundant with each other. The - // redundant_interface must be 1-63 characters long, and comply with RFC1035. - // Specifically, the redundant_interface 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. - optional string redundant_interface = 7 [json_name = "redundantInterface"]; - - // The URI of the subnetwork resource that this interface belongs to, which - // must be in the same region as the Cloud Router. When you establish a BGP - // session to a VM instance using this interface, the VM instance must belong - // to the same subnetwork as the subnetwork specified here. - optional string subnetwork = 8 [json_name = "subnetwork"]; -} - -// Contains a list of Router resources. -message RouterList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of Router resources. - repeated Router items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#router for routers. + // [Output Only] Type of resource. Always compute#diskList for lists of disks. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -839,688 +491,44 @@ message RouterList { optional Warning warning = 6 [json_name = "warning"]; } -message RouterMd5AuthenticationKey { - // [Input only] Value of the key. For patch and update calls, it can be - // skipped to copy the value from the previous configuration. This is allowed - // if the key with the same name existed before the operation. Maximum length - // is 80 characters. Can only contain printable ASCII characters. - optional string key = 1 [json_name = "key"]; - - // Name used to identify the key. Must be unique within a router. Must be - // referenced by exactly one bgpPeer. Must comply with RFC1035. - optional string name = 2 [json_name = "name"]; -} - -// Represents a Nat resource. It enables the VMs within the specified -// subnetworks to access Internet without external IP addresses. It specifies a -// list of subnetworks (and the ranges within) that want to use NAT. Customers -// can also provide the external IPs that would be used for NAT. GCP would -// auto-allocate ephemeral IPs if no external IPs are provided. -message RouterNat { - // The network tier to use when automatically reserving NAT IP addresses. Must - // be one of: PREMIUM, STANDARD. If not specified, then the current - // project-level default tier is used. - // FIXED_STANDARD: Public internet quality with fixed bandwidth. - // PREMIUM: High quality, Google-grade network tier, support for all - // networking products. - // STANDARD: Public internet quality, only limited support for other - // networking products. - // STANDARD_OVERRIDES_FIXED_STANDARD: (Output only) Temporary tier for - // FIXED_STANDARD when fixed standard tier is expired or not configured. - optional string auto_network_tier = 19 [json_name = "autoNetworkTier"]; - - // A list of URLs of the IP resources to be drained. These IPs must be valid - // static external IPs that have been assigned to the NAT. These IPs should be - // used for updating/patching a NAT only. - repeated string drain_nat_ips = 1 [json_name = "drainNatIps"]; - - // Enable Dynamic Port Allocation. If not specified, it is disabled by - // default. If set to true, - Dynamic Port Allocation will be enabled on this - // NAT config. - enableEndpointIndependentMapping cannot be set to true. - If - // minPorts is set, minPortsPerVm must be set to a power of two greater than - // or equal to 32. If minPortsPerVm is not set, a minimum of 32 ports will be - // allocated to a VM from this NAT config. - optional bool enable_dynamic_port_allocation = 2 - [json_name = "enableDynamicPortAllocation"]; - - optional bool enable_endpoint_independent_mapping = 3 - [json_name = "enableEndpointIndependentMapping"]; - - // List of NAT-ted endpoint types supported by the Nat Gateway. If the list is - // empty, then it will be equivalent to include ENDPOINT_TYPE_VM - repeated string endpoint_types = 4 [json_name = "endpointTypes"]; - - // Timeout (in seconds) for ICMP connections. Defaults to 30s if not set. - optional int32 icmp_idle_timeout_sec = 5 [json_name = "icmpIdleTimeoutSec"]; - - // Configure logging on this NAT. - optional RouterNatLogConfig log_config = 6 [json_name = "logConfig"]; - - // Maximum number of ports allocated to a VM from this NAT config when Dynamic - // Port Allocation is enabled. If Dynamic Port Allocation is not enabled, this - // field has no effect. If Dynamic Port Allocation is enabled, and this field - // is set, it must be set to a power of two greater than minPortsPerVm, or 64 - // if minPortsPerVm is not set. If Dynamic Port Allocation is enabled and this - // field is not set, a maximum of 65536 ports will be allocated to a VM from - // this NAT config. - optional int32 max_ports_per_vm = 7 [json_name = "maxPortsPerVm"]; - - // Minimum number of ports allocated to a VM from this NAT config. If not set, - // a default number of ports is allocated to a VM. This is rounded up to the - // nearest power of 2. For example, if the value of this field is 50, at least - // 64 ports are allocated to a VM. - optional int32 min_ports_per_vm = 8 [json_name = "minPortsPerVm"]; - - // Unique name of this Nat service. The name must be 1-63 characters long and - // comply with RFC1035. - optional string name = 9 [json_name = "name"]; - - // Specify the NatIpAllocateOption, which can take one of the following - // values: - MANUAL_ONLY: Uses only Nat IP addresses provided by customers. - // When there are not enough specified Nat IPs, the Nat service fails for new - // VMs. - AUTO_ONLY: Nat IPs are allocated by Google Cloud Platform; customers - // can't specify any Nat IPs. When choosing AUTO_ONLY, then nat_ip should be - // empty. - // AUTO_ONLY: Nat IPs are allocated by GCP; customers can not specify any Nat - // IPs. - // MANUAL_ONLY: Only use Nat IPs provided by customers. When specified Nat IPs - // are not enough then the Nat service fails for new VMs. - optional string nat_ip_allocate_option = 10 - [json_name = "natIpAllocateOption"]; - - // A list of URLs of the IP resources used for this Nat service. These IP - // addresses must be valid static external IP addresses assigned to the - // project. - repeated string nat_ips = 11 [json_name = "natIps"]; - - // A list of rules associated with this NAT. - repeated RouterNatRule rules = 12 [json_name = "rules"]; - - // Specify the Nat option, which can take one of the following values: - - // ALL_SUBNETWORKS_ALL_IP_RANGES: All of the IP ranges in every Subnetwork are - // allowed to Nat. - ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All of the primary - // IP ranges in every Subnetwork are allowed to Nat. - LIST_OF_SUBNETWORKS: A - // list of Subnetworks are allowed to Nat (specified in the field subnetwork - // below) The default is SUBNETWORK_IP_RANGE_TO_NAT_OPTION_UNSPECIFIED. Note - // that if this field contains ALL_SUBNETWORKS_ALL_IP_RANGES then there should - // not be any other Router.Nat section in any Router for this network in this - // region. - // ALL_SUBNETWORKS_ALL_IP_RANGES: All the IP ranges in every Subnetwork are - // allowed to Nat. - // ALL_SUBNETWORKS_ALL_PRIMARY_IP_RANGES: All the primary IP ranges in every - // Subnetwork are allowed to Nat. - // LIST_OF_SUBNETWORKS: A list of Subnetworks are allowed to Nat (specified in - // the field subnetwork below) - optional string source_subnetwork_ip_ranges_to_nat = 13 - [json_name = "sourceSubnetworkIpRangesToNat"]; - - // A list of Subnetwork resources whose traffic should be translated by NAT - // Gateway. It is used only when LIST_OF_SUBNETWORKS is selected for the - // SubnetworkIpRangeToNatOption above. - repeated RouterNatSubnetworkToNat subnetworks = 14 - [json_name = "subnetworks"]; - - // Timeout (in seconds) for TCP established connections. Defaults to 1200s if - // not set. - optional int32 tcp_established_idle_timeout_sec = 15 - [json_name = "tcpEstablishedIdleTimeoutSec"]; - - // Timeout (in seconds) for TCP connections that are in TIME_WAIT state. - // Defaults to 120s if not set. - optional int32 tcp_time_wait_timeout_sec = 16 - [json_name = "tcpTimeWaitTimeoutSec"]; - - // Timeout (in seconds) for TCP transitory connections. Defaults to 30s if not - // set. - optional int32 tcp_transitory_idle_timeout_sec = 17 - [json_name = "tcpTransitoryIdleTimeoutSec"]; - - // Indicates whether this NAT is used for public or private IP translation. If - // unspecified, it defaults to PUBLIC. - // PRIVATE: NAT used for private IP translation. - // PUBLIC: NAT used for public IP translation. This is the default. - optional string type = 20 [json_name = "type"]; - - // Timeout (in seconds) for UDP connections. Defaults to 30s if not set. - optional int32 udp_idle_timeout_sec = 18 [json_name = "udpIdleTimeoutSec"]; +// Additional disk params. +message DiskParams { + // Resource manager tags to be bound to the disk. Tag keys and values have the + // same definition as resource manager tags. Keys must be in the format + // `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The + // field is ignored (both PUT & PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; } -// Configuration of logging on a NAT. -message RouterNatLogConfig { - // Indicates whether or not to export logs. This is false by default. - optional bool enable = 1 [json_name = "enable"]; - - // Specify the desired filtering of logs on this NAT. If unspecified, logs are - // exported for all connections handled by this NAT. This option can take one - // of the following values: - ERRORS_ONLY: Export logs only for connection - // failures. - TRANSLATIONS_ONLY: Export logs only for successful connections. - // - ALL: Export logs for all connections, successful and unsuccessful. - // ALL: Export logs for all (successful and unsuccessful) connections. - // ERRORS_ONLY: Export logs for connection failures only. - // TRANSLATIONS_ONLY: Export logs for successful connections only. - optional string filter = 2 [json_name = "filter"]; -} - -message RouterNatRule { - // The action to be enforced for traffic that matches this rule. - optional RouterNatRuleAction action = 1 [json_name = "action"]; - - // An optional description of this rule. - optional string description = 2 [json_name = "description"]; - - // CEL expression that specifies the match condition that egress traffic from - // a VM is evaluated against. If it evaluates to true, the corresponding - // `action` is enforced. The following examples are valid match expressions - // for public NAT: `inIpRange(destination.ip, '1.1.0.0/16') || - // inIpRange(destination.ip, '2.2.0.0/16')` `destination.ip == '1.1.0.1' || - // destination.ip == '8.8.8.8'` The following example is a valid match - // expression for private NAT: `nexthop.hub == - // '//networkconnectivity.googleapis.com/projects/my-project/locations/global/hubs/hub-1'` - optional string match = 3 [json_name = "match"]; - - // An integer uniquely identifying a rule in the list. The rule number must be - // a positive value between 0 and 65000, and must be unique among rules within - // a NAT. - optional uint32 rule_number = 4 [json_name = "ruleNumber"]; -} +message DiskResourceStatus { + optional DiskResourceStatusAsyncReplicationStatus async_primary_disk = 1 + [json_name = "asyncPrimaryDisk"]; -message RouterNatRuleAction { - // A list of URLs of the IP resources used for this NAT rule. These IP - // addresses must be valid static external IP addresses assigned to the - // project. This field is used for public NAT. - repeated string source_nat_active_ips = 1 [json_name = "sourceNatActiveIps"]; - - // A list of URLs of the subnetworks used as source ranges for this NAT Rule. - // These subnetworks must have purpose set to PRIVATE_NAT. This field is used - // for private NAT. - repeated string source_nat_active_ranges = 3 - [json_name = "sourceNatActiveRanges"]; - - // A list of URLs of the IP resources to be drained. These IPs must be valid - // static external IPs that have been assigned to the NAT. These IPs should be - // used for updating/patching a NAT rule only. This field is used for public - // NAT. - repeated string source_nat_drain_ips = 2 [json_name = "sourceNatDrainIps"]; - - // A list of URLs of subnetworks representing source ranges to be drained. - // This is only supported on patch/update, and these subnetworks must have - // previously been used as active ranges in this NAT Rule. This field is used - // for private NAT. - repeated string source_nat_drain_ranges = 4 - [json_name = "sourceNatDrainRanges"]; + // Key: disk, value: AsyncReplicationStatus message + map async_secondary_disks = + 2 [json_name = "asyncSecondaryDisks"]; } -// Defines the IP ranges that want to use NAT for a subnetwork. -message RouterNatSubnetworkToNat { - // URL for the subnetwork resource that will use NAT. - optional string name = 1 [json_name = "name"]; - - // A list of the secondary ranges of the Subnetwork that are allowed to use - // NAT. This can be populated only if "LIST_OF_SECONDARY_IP_RANGES" is one of - // the values in source_ip_ranges_to_nat. - repeated string secondary_ip_range_names = 2 - [json_name = "secondaryIpRangeNames"]; - - // Specify the options for NAT ranges in the Subnetwork. All options of a - // single value are valid except NAT_IP_RANGE_OPTION_UNSPECIFIED. The only - // valid option with multiple values is: ["PRIMARY_IP_RANGE", - // "LIST_OF_SECONDARY_IP_RANGES"] Default: [ALL_IP_RANGES] - repeated string source_ip_ranges_to_nat = 3 - [json_name = "sourceIpRangesToNat"]; -} - -message RouterStatus { - // A list of the best dynamic routes for this Cloud Router's Virtual Private - // Cloud (VPC) network in the same region as this Cloud Router. Lists all of - // the best routes per prefix that are programmed into this region's VPC data - // plane. When global dynamic routing mode is turned on in the VPC network, - // this list can include cross-region dynamic routes from Cloud Routers in - // other regions. - repeated Route best_routes = 1 [json_name = "bestRoutes"]; - - // A list of the best BGP routes learned by this Cloud Router. It is possible - // that routes listed might not be programmed into the data plane, if the - // Google Cloud control plane finds a more optimal route for a prefix than a - // route learned by this Cloud Router. - repeated Route best_routes_for_router = 2 [json_name = "bestRoutesForRouter"]; - - repeated RouterStatusBgpPeerStatus bgp_peer_status = 3 - [json_name = "bgpPeerStatus"]; - - repeated RouterStatusNatStatus nat_status = 4 [json_name = "natStatus"]; - - // URI of the network to which this router belongs. - optional string network = 5 [json_name = "network"]; -} - -message RouterStatusBgpPeerStatus { - // Routes that were advertised to the remote BGP peer - repeated Route advertised_routes = 1 [json_name = "advertisedRoutes"]; - - optional BfdStatus bfd_status = 2 [json_name = "bfdStatus"]; - - // Enable IPv4 traffic over BGP Peer. It is enabled by default if the - // peerIpAddress is version 4. - optional bool enable_ipv4 = 18 [json_name = "enableIpv4"]; - - // Enable IPv6 traffic over BGP Peer. It is enabled by default if the - // peerIpAddress is version 6. - optional bool enable_ipv6 = 3 [json_name = "enableIpv6"]; - - // IP address of the local BGP interface. - optional string ip_address = 4 [json_name = "ipAddress"]; - - // IPv4 address of the local BGP interface. - optional string ipv4_nexthop_address = 19 [json_name = "ipv4NexthopAddress"]; - - // IPv6 address of the local BGP interface. - optional string ipv6_nexthop_address = 5 [json_name = "ipv6NexthopAddress"]; - - // URL of the VPN tunnel that this BGP peer controls. - optional string linked_vpn_tunnel = 6 [json_name = "linkedVpnTunnel"]; - - // Informs whether MD5 authentication is enabled on this BGP peer. - optional bool md5_auth_enabled = 7 [json_name = "md5AuthEnabled"]; - - // Name of this BGP peer. Unique within the Routers resource. - optional string name = 8 [json_name = "name"]; - - // Number of routes learned from the remote BGP Peer. - optional uint32 num_learned_routes = 9 [json_name = "numLearnedRoutes"]; - - // IP address of the remote BGP interface. - optional string peer_ip_address = 10 [json_name = "peerIpAddress"]; - - // IPv4 address of the remote BGP interface. - optional string peer_ipv4_nexthop_address = 20 - [json_name = "peerIpv4NexthopAddress"]; - - // IPv6 address of the remote BGP interface. - optional string peer_ipv6_nexthop_address = 11 - [json_name = "peerIpv6NexthopAddress"]; - - // [Output only] URI of the VM instance that is used as third-party router - // appliances such as Next Gen Firewalls, Virtual Routers, or Router - // Appliances. The VM instance is the peer side of the BGP session. - optional string router_appliance_instance = 12 - [json_name = "routerApplianceInstance"]; - - // The state of the BGP session. For a list of possible values for this field, - // see BGP session states. - optional string state = 13 [json_name = "state"]; - - // Status of the BGP peer: {UP, DOWN} - // DOWN: - // UNKNOWN: - // UP: - optional string status = 14 [json_name = "status"]; - - // Indicates why particular status was returned. - // IPV4_PEER_ON_IPV6_ONLY_CONNECTION: BGP peer disabled because it requires - // IPv4 but the underlying connection is IPv6-only. - // IPV6_PEER_ON_IPV4_ONLY_CONNECTION: BGP peer disabled because it requires - // IPv6 but the underlying connection is IPv4-only. - // MD5_AUTH_INTERNAL_PROBLEM: Indicates internal problems with configuration - // of MD5 authentication. This particular reason can only be returned when - // md5AuthEnabled is true and status is DOWN. - // STATUS_REASON_UNSPECIFIED: - optional string status_reason = 15 [json_name = "statusReason"]; - - // Time this session has been up. Format: 14 years, 51 weeks, 6 days, 23 - // hours, 59 minutes, 59 seconds - optional string uptime = 16 [json_name = "uptime"]; - - // Time this session has been up, in seconds. Format: 145 - optional string uptime_seconds = 17 [json_name = "uptimeSeconds"]; -} - -// Status of a NAT contained in this router. -message RouterStatusNatStatus { - // A list of IPs auto-allocated for NAT. Example: ["1.1.1.1", "129.2.16.89"] - repeated string auto_allocated_nat_ips = 1 - [json_name = "autoAllocatedNatIps"]; - - // A list of IPs auto-allocated for NAT that are in drain mode. Example: - // ["1.1.1.1", "179.12.26.133"]. - repeated string drain_auto_allocated_nat_ips = 2 - [json_name = "drainAutoAllocatedNatIps"]; - - // A list of IPs user-allocated for NAT that are in drain mode. Example: - // ["1.1.1.1", "179.12.26.133"]. - repeated string drain_user_allocated_nat_ips = 3 - [json_name = "drainUserAllocatedNatIps"]; - - // The number of extra IPs to allocate. This will be greater than 0 only if - // user-specified IPs are NOT enough to allow all configured VMs to use NAT. - // This value is meaningful only when auto-allocation of NAT IPs is *not* - // used. - optional int32 min_extra_nat_ips_needed = 4 - [json_name = "minExtraNatIpsNeeded"]; - - // Unique name of this NAT. - optional string name = 5 [json_name = "name"]; - - // Number of VM endpoints (i.e., Nics) that can use NAT. - optional int32 num_vm_endpoints_with_nat_mappings = 6 - [json_name = "numVmEndpointsWithNatMappings"]; - - // Status of rules in this NAT. - repeated RouterStatusNatStatusNatRuleStatus rule_status = 7 - [json_name = "ruleStatus"]; - - // A list of fully qualified URLs of reserved IP address resources. - repeated string user_allocated_nat_ip_resources = 8 - [json_name = "userAllocatedNatIpResources"]; - - // A list of IPs user-allocated for NAT. They will be raw IP strings like - // "179.12.26.133". - repeated string user_allocated_nat_ips = 9 - [json_name = "userAllocatedNatIps"]; -} - -// Status of a NAT Rule contained in this NAT. -message RouterStatusNatStatusNatRuleStatus { - // A list of active IPs for NAT. Example: ["1.1.1.1", "179.12.26.133"]. - repeated string active_nat_ips = 1 [json_name = "activeNatIps"]; - - // A list of IPs for NAT that are in drain mode. Example: ["1.1.1.1", - // "179.12.26.133"]. - repeated string drain_nat_ips = 2 [json_name = "drainNatIps"]; - - // The number of extra IPs to allocate. This will be greater than 0 only if - // the existing IPs in this NAT Rule are NOT enough to allow all configured - // VMs to use NAT. - optional int32 min_extra_ips_needed = 3 [json_name = "minExtraIpsNeeded"]; - - // Number of VM endpoints (i.e., NICs) that have NAT Mappings from this NAT - // Rule. - optional int32 num_vm_endpoints_with_nat_mappings = 4 - [json_name = "numVmEndpointsWithNatMappings"]; - - // Rule number of the rule. - optional int32 rule_number = 5 [json_name = "ruleNumber"]; -} - -message RouterStatusResponse { - // Type of resource. - optional string kind = 1 [json_name = "kind"]; - - optional RouterStatus result = 2 [json_name = "result"]; -} - -message RoutersPreviewResponse { - // Preview of given router. - optional Router resource = 1 [json_name = "resource"]; -} - -message RoutersScopedList { - // A list of routers contained in this scope. - repeated Router routers = 1 [json_name = "routers"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of routers when the list is - // empty. - optional Warning warning = 2 [json_name = "warning"]; -} - -// Contain information of Nat mapping for a VM endpoint (i.e., NIC). -message VmEndpointNatMappings { - // Name of the VM instance which the endpoint belongs to - optional string instance_name = 1 [json_name = "instanceName"]; - - repeated VmEndpointNatMappingsInterfaceNatMappings interface_nat_mappings = 2 - [json_name = "interfaceNatMappings"]; -} - -// Contain information of Nat mapping for an interface of this endpoint. -message VmEndpointNatMappingsInterfaceNatMappings { - // List of all drain IP:port-range mappings assigned to this interface. These - // ranges are inclusive, that is, both the first and the last ports can be - // used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. - repeated string drain_nat_ip_port_ranges = 1 - [json_name = "drainNatIpPortRanges"]; - - // A list of all IP:port-range mappings assigned to this interface. These - // ranges are inclusive, that is, both the first and the last ports can be - // used for NAT. Example: ["2.2.2.2:12345-12355", "1.1.1.1:2234-2234"]. - repeated string nat_ip_port_ranges = 2 [json_name = "natIpPortRanges"]; - - // Total number of drain ports across all NAT IPs allocated to this interface. - // It equals to the aggregated port number in the field - // drain_nat_ip_port_ranges. - optional int32 num_total_drain_nat_ports = 3 - [json_name = "numTotalDrainNatPorts"]; - - // Total number of ports across all NAT IPs allocated to this interface. It - // equals to the aggregated port number in the field nat_ip_port_ranges. - optional int32 num_total_nat_ports = 4 [json_name = "numTotalNatPorts"]; - - // Information about mappings provided by rules in this NAT. - repeated VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings - rule_mappings = 5 [json_name = "ruleMappings"]; - - // Alias IP range for this interface endpoint. It will be a private (RFC 1918) - // IP range. Examples: "10.33.4.55/32", or "192.168.5.0/24". - optional string source_alias_ip_range = 6 [json_name = "sourceAliasIpRange"]; - - // Primary IP of the VM for this NIC. - optional string source_virtual_ip = 7 [json_name = "sourceVirtualIp"]; -} - -// Contains information of NAT Mappings provided by a NAT Rule. -message VmEndpointNatMappingsInterfaceNatMappingsNatRuleMappings { - // List of all drain IP:port-range mappings assigned to this interface by this - // rule. These ranges are inclusive, that is, both the first and the last - // ports can be used for NAT. Example: ["2.2.2.2:12345-12355", - // "1.1.1.1:2234-2234"]. - repeated string drain_nat_ip_port_ranges = 1 - [json_name = "drainNatIpPortRanges"]; - - // A list of all IP:port-range mappings assigned to this interface by this - // rule. These ranges are inclusive, that is, both the first and the last - // ports can be used for NAT. Example: ["2.2.2.2:12345-12355", - // "1.1.1.1:2234-2234"]. - repeated string nat_ip_port_ranges = 2 [json_name = "natIpPortRanges"]; - - // Total number of drain ports across all NAT IPs allocated to this interface - // by this rule. It equals the aggregated port number in the field - // drain_nat_ip_port_ranges. - optional int32 num_total_drain_nat_ports = 3 - [json_name = "numTotalDrainNatPorts"]; - - // Total number of ports across all NAT IPs allocated to this interface by - // this rule. It equals the aggregated port number in the field - // nat_ip_port_ranges. - optional int32 num_total_nat_ports = 4 [json_name = "numTotalNatPorts"]; - - // Rule number of the NAT Rule. - optional int32 rule_number = 5 [json_name = "ruleNumber"]; -} - -// Contains a list of VmEndpointNatMappings. -message VmEndpointNatMappingsList { - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 1 [json_name = "id"]; - - // [Output Only] Type of resource. Always compute#vmEndpointNatMappingsList - // for lists of Nat mappings of VM endpoints. - optional string kind = 2 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 3 [json_name = "nextPageToken"]; - - // [Output Only] A list of Nat mapping information of VM endpoints. - repeated VmEndpointNatMappings result = 4 [json_name = "result"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; +message DiskResourceStatusAsyncReplicationStatus { + // ACTIVE: Replication is active. + // CREATED: Secondary disk is created and is waiting for replication to start. + // STARTING: Replication is starting. + // STATE_UNSPECIFIED: + // STOPPED: Replication is stopped. + // STOPPING: Replication is stopping. + optional string state = 1 [json_name = "state"]; +} + +// A transient resource used in compute.disks.stopGroupAsyncReplication and +// compute.regionDisks.stopGroupAsyncReplication. It is only used to process +// requests and is not persisted. +message DisksStopGroupAsyncReplicationResource { + // The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. + // This may be a full or partial URL, such as: - + // https://www.googleapis.com/compute/v1/projects/project/regions/region + // /resourcePolicies/resourcePolicy - + // projects/project/regions/region/resourcePolicies/resourcePolicy - + // regions/region/resourcePolicies/resourcePolicy + optional string resource_policy = 1 [json_name = "resourcePolicy"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_015.proto b/protos/google/cloud/compute/v1/internal/common_015.proto index 1fa4a0572dd9f..f3483f95d1c71 100644 --- a/protos/google/cloud/compute/v1/internal/common_015.proto +++ b/protos/google/cloud/compute/v1/internal/common_015.proto @@ -15,520 +15,119 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_021.proto"; - -// A transient resource used in compute.disks.bulkInsert and -// compute.regionDisks.bulkInsert. It is only used to process requests and is -// not persisted. -message BulkInsertDiskResource { - // The URL of the DiskConsistencyGroupPolicy for the group of disks to clone. - // This may be a full or partial URL, such as: - - // https://www.googleapis.com/compute/v1/projects/project/regions/region - // /resourcePolicies/resourcePolicy - - // projects/project/regions/region/resourcePolicies/resourcePolicy - - // regions/region/resourcePolicies/resourcePolicy - optional string source_consistency_group_policy = 1 - [json_name = "sourceConsistencyGroupPolicy"]; +import "google/cloud/compute/v1/internal/common_003.proto"; + +// A transient resource used in compute.instances.bulkInsert and +// compute.regionInstances.bulkInsert . This resource is not persisted anywhere, +// it is used only for processing the requests. +message BulkInsertInstanceResource { + // The maximum number of instances to create. + optional string count = 1 [json_name = "count"]; + + // The instance properties defining the VM instances to be created. Required + // if sourceInstanceTemplate is not provided. + optional InstanceProperties instance_properties = 2 + [json_name = "instanceProperties"]; + + // Policy for choosing target zone. For more information, see Create VMs in + // bulk. + optional LocationPolicy location_policy = 3 [json_name = "locationPolicy"]; + + // The minimum number of instances to create. If no min_count is specified + // then count is used as the default value. If min_count instances cannot be + // created, then no instances will be created and instances already created + // will be deleted. + optional string min_count = 4 [json_name = "minCount"]; + + // The string pattern used for the names of the VMs. Either name_pattern or + // per_instance_properties must be set. The pattern must contain one + // continuous sequence of placeholder hash characters (#) with each character + // corresponding to one digit of the generated instance name. Example: a + // name_pattern of inst-#### generates instance names such as inst-0001 and + // inst-0002. If existing instances in the same project and zone have names + // that match the name pattern then the generated instance numbers start after + // the biggest existing number. For example, if there exists an instance with + // name inst-0050, then instance names generated using the pattern inst-#### + // begin with inst-0051. The name pattern placeholder #...# can contain up to + // 18 characters. + optional string name_pattern = 5 [json_name = "namePattern"]; + + // Per-instance properties to be set on individual instances. Keys of this map + // specify requested instance names. Can be empty if name_pattern is used. + map + per_instance_properties = 6 [json_name = "perInstanceProperties"]; + + // Specifies the instance template from which to create instances. You may + // combine sourceInstanceTemplate with instanceProperties to override specific + // values from an existing instance template. Bulk API follows the semantics + // of JSON Merge Patch described by RFC 7396. It can be a full or partial URL. + // For example, the following are all valid URLs to an instance template: - + // https://www.googleapis.com/compute/v1/projects/project + // /global/instanceTemplates/instanceTemplate - + // projects/project/global/instanceTemplates/instanceTemplate - + // global/instanceTemplates/instanceTemplate This field is optional. + optional string source_instance_template = 7 + [json_name = "sourceInstanceTemplate"]; } -// Represents a Persistent Disk resource. Google Compute Engine has two Disk -// resources: * [Zonal](/compute/docs/reference/rest/v1/disks) * -// [Regional](/compute/docs/reference/rest/v1/regionDisks) Persistent disks are -// required for running your VM instances. Create both boot and non-boot (data) -// persistent disks. For more information, read Persistent Disks. For more -// storage options, read Storage options. The disks resource represents a zonal -// persistent disk. For more information, read Zonal persistent disks. The -// regionDisks resource represents a regional persistent disk. For more -// information, read Regional resources. -message Disk { - // The access mode of the disk. - READ_WRITE_SINGLE: The default AccessMode, - // means the disk can be attached to single instance in RW mode. - - // READ_WRITE_MANY: The AccessMode means the disk can be attached to multiple - // instances in RW mode. - READ_ONLY_MANY: The AccessMode means the disk can - // be attached to multiple instances in RO mode. The AccessMode is only valid - // for Hyperdisk disk types. - // READ_ONLY_MANY: The AccessMode means the disk can be attached to multiple - // instances in RO mode. - // READ_WRITE_MANY: The AccessMode means the disk can be attached to multiple - // instances in RW mode. - // READ_WRITE_SINGLE: The default AccessMode, means the disk can be attached - // to single instance in RW mode. - optional string access_mode = 50 [json_name = "accessMode"]; - - // The architecture of the disk. Valid values are ARM64 or X86_64. - // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. - // ARM64: Machines with architecture ARM64 - // X86_64: Machines with architecture X86_64 - optional string architecture = 1 [json_name = "architecture"]; - - // Disk asynchronously replicated into this disk. - optional DiskAsyncReplication async_primary_disk = 39 - [json_name = "asyncPrimaryDisk"]; - - // [Output Only] A list of disks this disk is asynchronously replicated to. - map async_secondary_disks = 40 - [json_name = "asyncSecondaryDisks"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; - - // Encrypts the disk using a customer-supplied encryption key or a - // customer-managed encryption key. Encryption keys do not protect access to - // metadata of the disk. After you encrypt a disk with a customer-supplied - // key, you must provide the same key if you use the disk later. For example, - // to create a disk snapshot, to create a disk image, to create a machine - // image, or to attach the disk to a virtual machine. After you encrypt a disk - // with a customer-managed key, the diskEncryptionKey.kmsKeyName is set to a - // key *version* name once the disk is created. The disk is encrypted with - // this version of the key. In the response, diskEncryptionKey.kmsKeyName - // appears in the following format: "diskEncryptionKey.kmsKeyName": - // "projects/kms_project_id/locations/region/keyRings/ - // key_region/cryptoKeys/key /cryptoKeysVersions/version If you do not provide - // an encryption key when creating the disk, then the disk is encrypted using - // an automatically generated key and you don't need to provide a key to use - // the disk later. - optional CustomerEncryptionKey disk_encryption_key = 4 - [json_name = "diskEncryptionKey"]; - - // Whether this disk is using confidential compute mode. - optional bool enable_confidential_compute = 45 - [json_name = "enableConfidentialCompute"]; - - // A list of features to enable on the guest operating system. Applicable only - // for bootable images. Read Enabling guest operating system features to see a - // list of available options. - repeated GuestOsFeature guest_os_features = 5 [json_name = "guestOsFeatures"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 6 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#disk for disks. - optional string kind = 7 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this disk, which is - // essentially a hash of the labels set used for optimistic locking. The - // fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels, otherwise - // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve a disk. - optional string label_fingerprint = 8 [json_name = "labelFingerprint"]; - - // Labels to apply to this disk. These can be later modified by the setLabels - // method. - map labels = 9 [json_name = "labels"]; - - // [Output Only] Last attach timestamp in RFC3339 text format. - optional string last_attach_timestamp = 10 - [json_name = "lastAttachTimestamp"]; - - // [Output Only] Last detach timestamp in RFC3339 text format. - optional string last_detach_timestamp = 11 - [json_name = "lastDetachTimestamp"]; - - // Integer license codes indicating which licenses are attached to this disk. - repeated string license_codes = 12 [json_name = "licenseCodes"]; - - // A list of publicly visible licenses. Reserved for Google's use. - repeated string licenses = 13 [json_name = "licenses"]; - - // An opaque location hint used to place the disk close to other resources. - // This field is for use by internal tools that use the public API. - optional string location_hint = 14 [json_name = "locationHint"]; - - // 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. - optional string name = 15 [json_name = "name"]; - - // Internal use only. - optional string options = 16 [json_name = "options"]; - - // Input only. [Input Only] Additional params passed with the request, but not - // persisted as part of resource payload. - optional DiskParams params = 17 [json_name = "params"]; - - // Physical block size of the persistent disk, in bytes. If not present in a - // request, a default value is used. The currently supported size is 4096, - // other sizes may be added in the future. If an unsupported value is - // requested, the error message will list the supported values for the - // caller's project. - optional string physical_block_size_bytes = 18 - [json_name = "physicalBlockSizeBytes"]; - - // Indicates how many IOPS to provision for the disk. This sets the number of - // I/O operations per second that the disk can handle. Values must be between - // 10,000 and 120,000. For more details, see the Extreme persistent disk - // documentation. - optional string provisioned_iops = 19 [json_name = "provisionedIops"]; - - // Indicates how much throughput to provision for the disk. This sets the - // number of throughput mb per second that the disk can handle. Values must be - // greater than or equal to 1. - optional string provisioned_throughput = 41 - [json_name = "provisionedThroughput"]; - - // [Output Only] URL of the region where the disk resides. Only applicable for - // regional resources. You must specify this field as part of the HTTP request - // URL. It is not settable as a field in the request body. - optional string region = 20 [json_name = "region"]; - - // URLs of the zones where the disk should be replicated to. Only applicable - // for regional resources. - repeated string replica_zones = 21 [json_name = "replicaZones"]; - - // Resource policies applied to this disk for automatic snapshot creations. - repeated string resource_policies = 22 [json_name = "resourcePolicies"]; - - // [Output Only] Status information for the disk resource. - optional DiskResourceStatus resource_status = 42 - [json_name = "resourceStatus"]; - - // Output only. Reserved for future use. - optional bool satisfies_pzi = 46 [json_name = "satisfiesPzi"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzs = 23 [json_name = "satisfiesPzs"]; - - // [Output Only] Server-defined fully-qualified URL for this resource. - optional string self_link = 24 [json_name = "selfLink"]; - - // Size, in GB, of the persistent disk. You can specify this field when - // creating a persistent disk using the sourceImage, sourceSnapshot, or - // sourceDisk parameter, or specify it alone to create an empty persistent - // disk. If you specify this field along with a source, the value of sizeGb - // must not be less than the size of the source. Acceptable values are greater - // than 0. - optional string size_gb = 25 [json_name = "sizeGb"]; - - // [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk - // that was created using a consistency group. - optional string source_consistency_group_policy = 43 - [json_name = "sourceConsistencyGroupPolicy"]; - - // [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk - // that was created using a consistency group. - optional string source_consistency_group_policy_id = 44 - [json_name = "sourceConsistencyGroupPolicyId"]; - - // The source disk used to create this disk. You can provide this as a partial - // or full URL to the resource. For example, the following are valid values: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /disks/disk - - // https://www.googleapis.com/compute/v1/projects/project/regions/region - // /disks/disk - projects/project/zones/zone/disks/disk - - // projects/project/regions/region/disks/disk - zones/zone/disks/disk - - // regions/region/disks/disk - optional string source_disk = 26 [json_name = "sourceDisk"]; - - // [Output Only] The unique ID of the disk used to create this disk. This - // value identifies the exact disk that was used to create this persistent - // disk. For example, if you created the persistent disk from a disk that was - // later deleted and recreated under the same name, the source disk ID would - // identify the exact version of the disk that was used. - optional string source_disk_id = 27 [json_name = "sourceDiskId"]; +// Per-instance properties to be set on individual instances. To be extended in +// the future. +message BulkInsertInstanceResourcePerInstanceProperties { + // Specifies the hostname of the instance. More details in: + // https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention + optional string hostname = 2 [json_name = "hostname"]; - // The source image used to create this disk. If the source image is deleted, - // this field will not be set. To create a disk with one of the public - // operating system images, specify the image by its family name. For example, - // specify family/debian-9 to use the latest Debian 9 image: - // projects/debian-cloud/global/images/family/debian-9 Alternatively, use a - // specific version of a public operating system image: - // projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD To create a - // disk with a custom image that you created, specify the image name in the - // following format: global/images/my-custom-image You can also specify a - // custom image by its image family, which returns the latest version of the - // image in that family. Replace the image name with family/family-name: - // global/images/family/my-image-family - optional string source_image = 28 [json_name = "sourceImage"]; - - // The customer-supplied encryption key of the source image. Required if the - // source image is protected by a customer-supplied encryption key. - optional CustomerEncryptionKey source_image_encryption_key = 29 - [json_name = "sourceImageEncryptionKey"]; - - // [Output Only] The ID value of the image used to create this disk. This - // value identifies the exact image that was used to create this persistent - // disk. For example, if you created the persistent disk from an image that - // was later deleted and recreated under the same name, the source image ID - // would identify the exact version of the image that was used. - optional string source_image_id = 30 [json_name = "sourceImageId"]; - - // The source instant snapshot used to create this disk. You can provide this - // as a partial or full URL to the resource. For example, the following are - // valid values: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /instantSnapshots/instantSnapshot - - // projects/project/zones/zone/instantSnapshots/instantSnapshot - - // zones/zone/instantSnapshots/instantSnapshot - optional string source_instant_snapshot = 47 - [json_name = "sourceInstantSnapshot"]; - - // [Output Only] The unique ID of the instant snapshot used to create this - // disk. This value identifies the exact instant snapshot that was used to - // create this persistent disk. For example, if you created the persistent - // disk from an instant snapshot that was later deleted and recreated under - // the same name, the source instant snapshot ID would identify the exact - // version of the instant snapshot that was used. - optional string source_instant_snapshot_id = 48 - [json_name = "sourceInstantSnapshotId"]; - - // The source snapshot used to create this disk. You can provide this as a - // partial or full URL to the resource. For example, the following are valid - // values: - https://www.googleapis.com/compute/v1/projects/project - // /global/snapshots/snapshot - projects/project/global/snapshots/snapshot - - // global/snapshots/snapshot - optional string source_snapshot = 31 [json_name = "sourceSnapshot"]; - - // The customer-supplied encryption key of the source snapshot. Required if - // the source snapshot is protected by a customer-supplied encryption key. - optional CustomerEncryptionKey source_snapshot_encryption_key = 32 - [json_name = "sourceSnapshotEncryptionKey"]; - - // [Output Only] The unique ID of the snapshot used to create this disk. This - // value identifies the exact snapshot that was used to create this persistent - // disk. For example, if you created the persistent disk from a snapshot that - // was later deleted and recreated under the same name, the source snapshot ID - // would identify the exact version of the snapshot that was used. - optional string source_snapshot_id = 33 [json_name = "sourceSnapshotId"]; - - // The full Google Cloud Storage URI where the disk image is stored. This file - // must be a gzip-compressed tarball whose name ends in .tar.gz or virtual - // machine disk whose name ends in vmdk. Valid URIs may start with gs:// or - // https://storage.googleapis.com/. This flag is not optimized for creating - // multiple disks from a source storage object. To create many disks from a - // source storage object, use gcloud compute images import instead. - optional string source_storage_object = 34 - [json_name = "sourceStorageObject"]; - - // [Output Only] The status of disk creation. - CREATING: Disk is - // provisioning. - RESTORING: Source data is being copied into the disk. - - // FAILED: Disk creation failed. - READY: Disk is ready for use. - DELETING: - // Disk is deleting. - // CREATING: Disk is provisioning - // DELETING: Disk is deleting. - // FAILED: Disk creation failed. - // READY: Disk is ready for use. - // RESTORING: Source data is being copied into the disk. - // UNAVAILABLE: Disk is currently unavailable and cannot be accessed, attached - // or detached. - optional string status = 35 [json_name = "status"]; - - // The storage pool in which the new disk is created. You can provide this as - // a partial or full URL to the resource. For example, the following are valid - // values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /storagePools/storagePool - - // projects/project/zones/zone/storagePools/storagePool - - // zones/zone/storagePools/storagePool - optional string storage_pool = 49 [json_name = "storagePool"]; - - // URL of the disk type resource describing which disk type to use to create - // the disk. Provide this when creating the disk. For example: - // projects/project /zones/zone/diskTypes/pd-ssd . See Persistent disk types. - optional string type = 36 [json_name = "type"]; - - // [Output Only] Links to the users of the disk (attached instances) in form: - // projects/project/zones/zone/instances/instance - repeated string users = 37 [json_name = "users"]; - - // [Output Only] URL of the zone where the disk resides. You must specify this - // field as part of the HTTP request URL. It is not settable as a field in the - // request body. - optional string zone = 38 [json_name = "zone"]; -} - -message DiskAsyncReplication { - // [Output Only] URL of the DiskConsistencyGroupPolicy if replication was - // started on the disk as a member of a group. - optional string consistency_group_policy = 1 - [json_name = "consistencyGroupPolicy"]; - - // [Output Only] ID of the DiskConsistencyGroupPolicy if replication was - // started on the disk as a member of a group. - optional string consistency_group_policy_id = 2 - [json_name = "consistencyGroupPolicyId"]; - - // The other disk asynchronously replicated to or from the current disk. You - // can provide this as a partial or full URL to the resource. For example, the - // following are valid values: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /disks/disk - projects/project/zones/zone/disks/disk - - // zones/zone/disks/disk - optional string disk = 3 [json_name = "disk"]; - - // [Output Only] The unique ID of the other disk asynchronously replicated to - // or from the current disk. This value identifies the exact disk that was - // used to create this replication. For example, if you started replicating - // the persistent disk from a disk that was later deleted and recreated under - // the same name, the disk ID would identify the exact version of the disk - // that was used. - optional string disk_id = 4 [json_name = "diskId"]; + // This field is only temporary. It will be removed. Do not use it. + optional string name = 1 [json_name = "name"]; } -message DiskAsyncReplicationList { - optional DiskAsyncReplication async_replication_disk = 1 - [json_name = "asyncReplicationDisk"]; -} - -// A list of Disk resources. -message DiskList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of Disk resources. - repeated Disk items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#diskList for lists of disks. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// Additional disk params. -message DiskParams { - // Resource manager tags to be bound to the disk. Tag keys and values have the - // same definition as resource manager tags. Keys must be in the format - // `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The - // field is ignored (both PUT & PATCH) when empty. - map resource_manager_tags = 1 - [json_name = "resourceManagerTags"]; -} - -message DiskResourceStatus { - optional DiskResourceStatusAsyncReplicationStatus async_primary_disk = 1 - [json_name = "asyncPrimaryDisk"]; - - // Key: disk, value: AsyncReplicationStatus message - map async_secondary_disks = - 2 [json_name = "asyncSecondaryDisks"]; +// Configuration for location policy among multiple possible locations (e.g. +// preferences for zone selection among zones in a single region). +message LocationPolicy { + // Location configurations mapped by location name. Currently only zone names + // are supported and must be represented as valid internal URLs, such as + // zones/us-central1-a. + map locations = 1 [json_name = "locations"]; + + // Strategy for distributing VMs across zones in a region. + // ANY: GCE picks zones for creating VM instances to fulfill the requested + // number of VMs within present resource constraints and to maximize + // utilization of unused zonal reservations. Recommended for batch workloads + // that do not require high availability. + // ANY_SINGLE_ZONE: GCE always selects a single zone for all the VMs, + // optimizing for resource quotas, available reservations and general + // capacity. Recommended for batch workloads that cannot tollerate + // distribution over multiple zones. This the default shape in Bulk Insert and + // Capacity Advisor APIs. + // BALANCED: GCE prioritizes acquisition of resources, scheduling VMs in zones + // where resources are available while distributing VMs as evenly as possible + // across allowed zones to minimize the impact of zonal failure. Recommended + // for highly available serving workloads. + optional string target_shape = 2 [json_name = "targetShape"]; } -message DiskResourceStatusAsyncReplicationStatus { - // ACTIVE: Replication is active. - // CREATED: Secondary disk is created and is waiting for replication to start. - // STARTING: Replication is starting. - // STATE_UNSPECIFIED: - // STOPPED: Replication is stopped. - // STOPPING: Replication is stopping. - optional string state = 1 [json_name = "state"]; +message LocationPolicyLocation { + // Constraints that the caller requires on the result distribution in this + // zone. + optional LocationPolicyLocationConstraints constraints = 1 + [json_name = "constraints"]; + + // Preference for a given location. Set to either ALLOW or DENY. + // ALLOW: Location is allowed for use. + // DENY: Location is prohibited. + // PREFERENCE_UNSPECIFIED: Default value, unused. + optional string preference = 2 [json_name = "preference"]; } -// A transient resource used in compute.disks.stopGroupAsyncReplication and -// compute.regionDisks.stopGroupAsyncReplication. It is only used to process -// requests and is not persisted. -message DisksStopGroupAsyncReplicationResource { - // The URL of the DiskConsistencyGroupPolicy for the group of disks to stop. - // This may be a full or partial URL, such as: - - // https://www.googleapis.com/compute/v1/projects/project/regions/region - // /resourcePolicies/resourcePolicy - - // projects/project/regions/region/resourcePolicies/resourcePolicy - - // regions/region/resourcePolicies/resourcePolicy - optional string resource_policy = 1 [json_name = "resourcePolicy"]; +// Per-zone constraints on location policy for this zone. +message LocationPolicyLocationConstraints { + // Maximum number of items that are allowed to be placed in this zone. The + // value must be non-negative. + optional int32 max_count = 1 [json_name = "maxCount"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_016.proto b/protos/google/cloud/compute/v1/internal/common_016.proto index 7d068aecaf008..8fc22c840d099 100644 --- a/protos/google/cloud/compute/v1/internal/common_016.proto +++ b/protos/google/cloud/compute/v1/internal/common_016.proto @@ -15,119 +15,422 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_003.proto"; - -// A transient resource used in compute.instances.bulkInsert and -// compute.regionInstances.bulkInsert . This resource is not persisted anywhere, -// it is used only for processing the requests. -message BulkInsertInstanceResource { - // The maximum number of instances to create. - optional string count = 1 [json_name = "count"]; - - // The instance properties defining the VM instances to be created. Required - // if sourceInstanceTemplate is not provided. - optional InstanceProperties instance_properties = 2 - [json_name = "instanceProperties"]; - - // Policy for chosing target zone. For more information, see Create VMs in - // bulk . - optional LocationPolicy location_policy = 3 [json_name = "locationPolicy"]; - - // The minimum number of instances to create. If no min_count is specified - // then count is used as the default value. If min_count instances cannot be - // created, then no instances will be created and instances already created - // will be deleted. - optional string min_count = 4 [json_name = "minCount"]; - - // The string pattern used for the names of the VMs. Either name_pattern or - // per_instance_properties must be set. The pattern must contain one - // continuous sequence of placeholder hash characters (#) with each character - // corresponding to one digit of the generated instance name. Example: a - // name_pattern of inst-#### generates instance names such as inst-0001 and - // inst-0002. If existing instances in the same project and zone have names - // that match the name pattern then the generated instance numbers start after - // the biggest existing number. For example, if there exists an instance with - // name inst-0050, then instance names generated using the pattern inst-#### - // begin with inst-0051. The name pattern placeholder #...# can contain up to - // 18 characters. - optional string name_pattern = 5 [json_name = "namePattern"]; - - // Per-instance properties to be set on individual instances. Keys of this map - // specify requested instance names. Can be empty if name_pattern is used. - map - per_instance_properties = 6 [json_name = "perInstanceProperties"]; - - // Specifies the instance template from which to create instances. You may - // combine sourceInstanceTemplate with instanceProperties to override specific - // values from an existing instance template. Bulk API follows the semantics - // of JSON Merge Patch described by RFC 7396. It can be a full or partial URL. - // For example, the following are all valid URLs to an instance template: - - // https://www.googleapis.com/compute/v1/projects/project - // /global/instanceTemplates/instanceTemplate - - // projects/project/global/instanceTemplates/instanceTemplate - - // global/instanceTemplates/instanceTemplate This field is optional. - optional string source_instance_template = 7 - [json_name = "sourceInstanceTemplate"]; +import "google/protobuf/any.proto"; + +message BulkInsertOperationStatus { + // [Output Only] Count of VMs successfully created so far. + optional int32 created_vm_count = 1 [json_name = "createdVmCount"]; + + // [Output Only] Count of VMs that got deleted during rollback. + optional int32 deleted_vm_count = 2 [json_name = "deletedVmCount"]; + + // [Output Only] Count of VMs that started creating but encountered an error. + optional int32 failed_to_create_vm_count = 3 + [json_name = "failedToCreateVmCount"]; + + // [Output Only] Creation status of BulkInsert operation - information if the + // flow is rolling forward or rolling back. + // CREATING: Rolling forward - creating VMs. + // DONE: Done + // ROLLING_BACK: Rolling back - cleaning up after an error. + // STATUS_UNSPECIFIED: + optional string status = 4 [json_name = "status"]; + + // [Output Only] Count of VMs originally planned to be created. + optional int32 target_vm_count = 5 [json_name = "targetVmCount"]; +} + +// Describes the cause of the error with structured details. Example of an error +// when contacting the "pubsub.googleapis.com" API when it is not enabled: { +// "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": +// "projects/123", "service": "pubsub.googleapis.com" } } This response +// indicates that the pubsub.googleapis.com API is not enabled. Example of an +// error that is returned when attempting to create a Spanner instance in a +// region that is out of stock: { "reason": "STOCKOUT" "domain": +// "spanner.googleapis.com", "metadata": { "availableRegions": +// "us-central1,us-east2" } } +message ErrorInfo { + // The logical grouping to which the "reason" belongs. The error domain is + // typically the registered service name of the tool or product that generates + // the error. Example: "pubsub.googleapis.com". If the error is generated by + // some common infrastructure, the error domain must be a globally unique + // value that identifies the infrastructure. For Google API infrastructure, + // the error domain is "googleapis.com". + optional string domain = 1 [json_name = "domain"]; + + // Additional structured details about this error. Keys must match /a-z+/ but + // should ideally be lowerCamelCase. Also they must be limited to 64 + // characters in length. When identifying the current value of an exceeded + // limit, the units should be contained in the key, not the value. For + // example, rather than {"instanceLimit": "100/request"}, should be returned + // as, {"instanceLimitPerRequest": "100"}, if the client exceeds the number of + // instances that can be created in a single (batch) request. + map metadatas = 2 [json_name = "metadatas"]; + + // The reason of the error. This is a constant value that identifies the + // proximate cause of the error. Error reasons are unique within a particular + // domain of errors. This should be at most 63 characters and match a regular + // expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. + optional string reason = 3 [json_name = "reason"]; +} + +// Provides links to documentation or for performing an out of band action. For +// example, if a quota check failed with an error indicating the calling project +// hasn't enabled the accessed service, this can contain a URL pointing directly +// to the right place in the developer console to flip the bit. +message Help { + // URL(s) pointing to additional information on handling the current error. + repeated HelpLink links = 1 [json_name = "links"]; +} + +// Describes a URL link. +message HelpLink { + // Describes what the link offers. + optional string description = 1 [json_name = "description"]; + + // The URL of the link. + optional string url = 2 [json_name = "url"]; +} + +message InstancesBulkInsertOperationMetadata { + // Status information per location (location name is key). Example key: + // zones/us-central1-a + map per_location_status = 1 + [json_name = "perLocationStatus"]; +} + +// Provides a localized error message that is safe to return to the user which +// can be attached to an RPC error. +message LocalizedMessage { + // The locale used following the specification defined at + // https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", + // "fr-CH", "es-MX" + optional string locale = 1 [json_name = "locale"]; + + // The localized error message in the above locale. + optional string message = 2 [json_name = "message"]; +} + +// Represents an Operation resource. Google Compute Engine has three Operation +// resources: * [Global](/compute/docs/reference/rest/v1/globalOperations) * +// [Regional](/compute/docs/reference/rest/v1/regionOperations) * +// [Zonal](/compute/docs/reference/rest/v1/zoneOperations) You can use an +// operation resource to manage asynchronous API requests. For more information, +// read Handling API responses. Operations can be global, regional or zonal. - +// For global operations, use the `globalOperations` resource. - For regional +// operations, use the `regionOperations` resource. - For zonal operations, use +// the `zoneOperations` resource. For more information, read Global, Regional, +// and Zonal Resources. Note that completed Operation resources have a limited +// retention period. +message Operation { + // [Output Only] The value of `requestId` if you provided it in the request. + // Not present otherwise. + optional string client_operation_id = 1 [json_name = "clientOperationId"]; + + // [Deprecated] This field is deprecated. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // [Output Only] A textual description of the operation, which is set when the + // operation is created. + optional string description = 3 [json_name = "description"]; + + // [Output Only] The time that this operation was completed. This value is in + // RFC3339 text format. + optional string end_time = 4 [json_name = "endTime"]; + + message Error { + message ErrorsItem { + // [Output Only] The error type identifier for this error. + optional string code = 1 [json_name = "code"]; + + message ErrorDetailsItem { + optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; + + optional Help help = 2 [json_name = "help"]; + + optional LocalizedMessage localized_message = 3 + [json_name = "localizedMessage"]; + + optional QuotaExceededInfo quota_info = 4 [json_name = "quotaInfo"]; + } + + // [Output Only] An optional list of messages that contain the error + // details. There is a set of defined message types to use for providing + // details.The syntax depends on the error code. For example, + // QuotaExceededInfo will have details when the error code is + // QUOTA_EXCEEDED. + repeated ErrorDetailsItem error_details = 2 [json_name = "errorDetails"]; + + // [Output Only] Indicates the field in the request that caused the error. + // This property is optional. + optional string location = 3 [json_name = "location"]; + + // [Output Only] An optional, human-readable error message. + optional string message = 4 [json_name = "message"]; + } + + // [Output Only] The array of errors encountered while processing this + // operation. + repeated ErrorsItem errors = 1 [json_name = "errors"]; + } + + // [Output Only] If errors are generated during processing of the operation, + // this field will be populated. + optional Error error = 5 [json_name = "error"]; + + // [Output Only] If the operation fails, this field contains the HTTP error + // message that was returned, such as `NOT FOUND`. + optional string http_error_message = 6 [json_name = "httpErrorMessage"]; + + // [Output Only] If the operation fails, this field contains the HTTP error + // status code that was returned. For example, a `404` means the resource was + // not found. + optional int32 http_error_status_code = 7 [json_name = "httpErrorStatusCode"]; + + // [Output Only] The unique identifier for the operation. This identifier is + // defined by the server. + optional string id = 8 [json_name = "id"]; + + // [Output Only] The time that this operation was requested. This value is in + // RFC3339 text format. + optional string insert_time = 9 [json_name = "insertTime"]; + + optional InstancesBulkInsertOperationMetadata + instances_bulk_insert_operation_metadata = 25 + [json_name = "instancesBulkInsertOperationMetadata"]; + + // [Output Only] Type of the resource. Always `compute#operation` for + // Operation resources. + optional string kind = 10 [json_name = "kind"]; + + // [Output Only] Name of the operation. + optional string name = 11 [json_name = "name"]; + + // [Output Only] An ID that represents a group of operations, such as when a + // group of operations results from a `bulkInsert` API request. + optional string operation_group_id = 12 [json_name = "operationGroupId"]; + + // [Output Only] The type of operation, such as `insert`, `update`, or + // `delete`, and so on. + optional string operation_type = 13 [json_name = "operationType"]; + + // [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 when the operation will be + // complete. This number should monotonically increase as the operation + // progresses. + optional int32 progress = 14 [json_name = "progress"]; + + // [Output Only] The URL of the region where the operation resides. Only + // applicable when performing regional operations. + optional string region = 15 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 16 [json_name = "selfLink"]; + + // [Output Only] If the operation is for projects.setCommonInstanceMetadata, + // this field will contain information on all underlying zonal actions and + // their state. + optional SetCommonInstanceMetadataOperationMetadata + set_common_instance_metadata_operation_metadata = 26 + [json_name = "setCommonInstanceMetadataOperationMetadata"]; + + // [Output Only] The time that this operation was started by the server. This + // value is in RFC3339 text format. + optional string start_time = 17 [json_name = "startTime"]; + + // [Output Only] The status of the operation, which can be one of the + // following: `PENDING`, `RUNNING`, or `DONE`. + // DONE: + // PENDING: + // RUNNING: + optional string status = 18 [json_name = "status"]; + + // [Output Only] An optional textual description of the current status of the + // operation. + optional string status_message = 19 [json_name = "statusMessage"]; + + // [Output Only] The unique target ID, which identifies a specific incarnation + // of the target resource. + optional string target_id = 20 [json_name = "targetId"]; + + // [Output Only] The URL of the resource that the operation modifies. For + // operations related to creating a snapshot, this points to the disk that the + // snapshot was created from. + optional string target_link = 21 [json_name = "targetLink"]; + + // [Output Only] User who requested the operation, for example: + // `user@example.com` or `alice_smith_identifier + // (global/workforcePools/example-com-us-employees)`. + optional string user = 22 [json_name = "user"]; + + message WarningsItem { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] If warning messages are generated during processing of the + // operation, this field will be populated. + repeated WarningsItem warnings = 23 [json_name = "warnings"]; + + // [Output Only] The URL of the zone where the operation resides. Only + // applicable when performing per-zone operations. + optional string zone = 24 [json_name = "zone"]; } -// Per-instance properties to be set on individual instances. To be extended in -// the future. -message BulkInsertInstanceResourcePerInstanceProperties { - // Specifies the hostname of the instance. More details in: - // https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention - optional string hostname = 2 [json_name = "hostname"]; +// Additional details for quota exceeded error for resource quota. +message QuotaExceededInfo { + // The map holding related quota dimensions. + map dimensions = 1 [json_name = "dimensions"]; - // This field is only temporary. It will be removed. Do not use it. - optional string name = 1 [json_name = "name"]; + // Future quota limit being rolled out. The limit's unit depends on the quota + // type or metric. + optional double future_limit = 5 [json_name = "futureLimit"]; + + // Current effective quota limit. The limit's unit depends on the quota type + // or metric. + optional double limit = 2 [json_name = "limit"]; + + // The name of the quota limit. + optional string limit_name = 3 [json_name = "limitName"]; + + // The Compute Engine quota metric name. + optional string metric_name = 4 [json_name = "metricName"]; + + // Rollout status of the future quota limit. + // IN_PROGRESS: IN_PROGRESS - A rollout is in process which will change the + // limit value to future limit. + // ROLLOUT_STATUS_UNSPECIFIED: ROLLOUT_STATUS_UNSPECIFIED - Rollout status is + // not specified. The default value. + optional string rollout_status = 6 [json_name = "rolloutStatus"]; } -// Configuration for location policy among multiple possible locations (e.g. -// preferences for zone selection among zones in a single region). -message LocationPolicy { - // Location configurations mapped by location name. Currently only zone names - // are supported and must be represented as valid internal URLs, such as - // zones/us-central1-a. - map locations = 1 [json_name = "locations"]; - - // Strategy for distributing VMs across zones in a region. - // ANY: GCE picks zones for creating VM instances to fulfill the requested - // number of VMs within present resource constraints and to maximize - // utilization of unused zonal reservations. Recommended for batch workloads - // that do not require high availability. - // ANY_SINGLE_ZONE: GCE always selects a single zone for all the VMs, - // optimizing for resource quotas, available reservations and general - // capacity. Recommended for batch workloads that cannot tollerate - // distribution over multiple zones. This the default shape in Bulk Insert and - // Capacity Advisor APIs. - // BALANCED: GCE prioritizes acquisition of resources, scheduling VMs in zones - // where resources are available while distributing VMs as evenly as possible - // across allowed zones to minimize the impact of zonal failure. Recommended - // for highly available serving workloads. - optional string target_shape = 2 [json_name = "targetShape"]; +message SetCommonInstanceMetadataOperationMetadata { + // [Output Only] The client operation id. + optional string client_operation_id = 1 [json_name = "clientOperationId"]; + + // [Output Only] Status information per location (location name is key). + // Example key: zones/us-central1-a + map + per_location_operations = 2 [json_name = "perLocationOperations"]; } -message LocationPolicyLocation { - // Constraints that the caller requires on the result distribution in this - // zone. - optional LocationPolicyLocationConstraints constraints = 1 - [json_name = "constraints"]; - - // Preference for a given location. Set to either ALLOW or DENY. - // ALLOW: Location is allowed for use. - // DENY: Location is prohibited. - // PREFERENCE_UNSPECIFIED: Default value, unused. - optional string preference = 2 [json_name = "preference"]; +message SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo { + // [Output Only] If state is `ABANDONED` or `FAILED`, this field is populated. + optional Status error = 1 [json_name = "error"]; + + // [Output Only] Status of the action, which can be one of the following: + // `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. + // ABANDONED: Operation not tracked in this location e.g. zone is marked as + // DOWN. + // DONE: Operation has completed successfully. + // FAILED: Operation is in an error state. + // PROPAGATED: Operation is confirmed to be in the location. + // PROPAGATING: Operation is not yet confirmed to have been created in the + // location. + // UNSPECIFIED: + optional string state = 2 [json_name = "state"]; } -// Per-zone constraints on location policy for this zone. -message LocationPolicyLocationConstraints { - // Maximum number of items that are allowed to be placed in this zone. The - // value must be non-negative. - optional int32 max_count = 1 [json_name = "maxCount"]; +// The `Status` type defines a logical error model that is suitable for +// different programming environments, including REST APIs and RPC APIs. It is +// used by [gRPC](https://github.com/grpc). Each `Status` message contains three +// pieces of data: error code, error message, and error details. You can find +// out more about this error model and how to work with it in the [API Design +// Guide](https://cloud.google.com/apis/design/errors). +message Status { + // The status code, which should be an enum value of google.rpc.Code. + optional int32 code = 1 [json_name = "code"]; + + // A list of messages that carry the error details. There is a common set of + // message types for APIs to use. + repeated google.protobuf.Any details = 2 [json_name = "details"]; + + // A developer-facing error message, which should be in English. Any + // user-facing error message should be localized and sent in the + // google.rpc.Status.details field, or localized by the client. + optional string message = 3 [json_name = "message"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_017.proto b/protos/google/cloud/compute/v1/internal/common_017.proto index 9efcf3ff0d3de..5efb33b151e82 100644 --- a/protos/google/cloud/compute/v1/internal/common_017.proto +++ b/protos/google/cloud/compute/v1/internal/common_017.proto @@ -15,262 +15,46 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/protobuf/any.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; -message BulkInsertOperationStatus { - // [Output Only] Count of VMs successfully created so far. - optional int32 created_vm_count = 1 [json_name = "createdVmCount"]; +message CacheInvalidationRule { + // If set, this invalidation rule will only apply to requests with a Host + // header matching host. + optional string host = 1 [json_name = "host"]; - // [Output Only] Count of VMs that got deleted during rollback. - optional int32 deleted_vm_count = 2 [json_name = "deletedVmCount"]; - - // [Output Only] Count of VMs that started creating but encountered an error. - optional int32 failed_to_create_vm_count = 3 - [json_name = "failedToCreateVmCount"]; - - // [Output Only] Creation status of BulkInsert operation - information if the - // flow is rolling forward or rolling back. - // CREATING: Rolling forward - creating VMs. - // DONE: Done - // ROLLING_BACK: Rolling back - cleaning up after an error. - // STATUS_UNSPECIFIED: - optional string status = 4 [json_name = "status"]; - - // [Output Only] Count of VMs originally planned to be created. - optional int32 target_vm_count = 5 [json_name = "targetVmCount"]; -} - -// Describes the cause of the error with structured details. Example of an error -// when contacting the "pubsub.googleapis.com" API when it is not enabled: { -// "reason": "API_DISABLED" "domain": "googleapis.com" "metadata": { "resource": -// "projects/123", "service": "pubsub.googleapis.com" } } This response -// indicates that the pubsub.googleapis.com API is not enabled. Example of an -// error that is returned when attempting to create a Spanner instance in a -// region that is out of stock: { "reason": "STOCKOUT" "domain": -// "spanner.googleapis.com", "metadata": { "availableRegions": -// "us-central1,us-east2" } } -message ErrorInfo { - // The logical grouping to which the "reason" belongs. The error domain is - // typically the registered service name of the tool or product that generates - // the error. Example: "pubsub.googleapis.com". If the error is generated by - // some common infrastructure, the error domain must be a globally unique - // value that identifies the infrastructure. For Google API infrastructure, - // the error domain is "googleapis.com". - optional string domain = 1 [json_name = "domain"]; - - // Additional structured details about this error. Keys must match /a-z+/ but - // should ideally be lowerCamelCase. Also they must be limited to 64 - // characters in length. When identifying the current value of an exceeded - // limit, the units should be contained in the key, not the value. For - // example, rather than {"instanceLimit": "100/request"}, should be returned - // as, {"instanceLimitPerRequest": "100"}, if the client exceeds the number of - // instances that can be created in a single (batch) request. - map metadatas = 2 [json_name = "metadatas"]; - - // The reason of the error. This is a constant value that identifies the - // proximate cause of the error. Error reasons are unique within a particular - // domain of errors. This should be at most 63 characters and match a regular - // expression of `A-Z+[A-Z0-9]`, which represents UPPER_SNAKE_CASE. - optional string reason = 3 [json_name = "reason"]; -} - -// Provides links to documentation or for performing an out of band action. For -// example, if a quota check failed with an error indicating the calling project -// hasn't enabled the accessed service, this can contain a URL pointing directly -// to the right place in the developer console to flip the bit. -message Help { - // URL(s) pointing to additional information on handling the current error. - repeated HelpLink links = 1 [json_name = "links"]; -} - -// Describes a URL link. -message HelpLink { - // Describes what the link offers. - optional string description = 1 [json_name = "description"]; - - // The URL of the link. - optional string url = 2 [json_name = "url"]; -} - -message InstancesBulkInsertOperationMetadata { - // Status information per location (location name is key). Example key: - // zones/us-central1-a - map per_location_status = 1 - [json_name = "perLocationStatus"]; -} - -// Provides a localized error message that is safe to return to the user which -// can be attached to an RPC error. -message LocalizedMessage { - // The locale used following the specification defined at - // https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Examples are: "en-US", - // "fr-CH", "es-MX" - optional string locale = 1 [json_name = "locale"]; - - // The localized error message in the above locale. - optional string message = 2 [json_name = "message"]; + optional string path = 2 [json_name = "path"]; } -// Represents an Operation resource. Google Compute Engine has three Operation -// resources: * [Global](/compute/docs/reference/rest/v1/globalOperations) * -// [Regional](/compute/docs/reference/rest/v1/regionOperations) * -// [Zonal](/compute/docs/reference/rest/v1/zoneOperations) You can use an -// operation resource to manage asynchronous API requests. For more information, -// read Handling API responses. Operations can be global, regional or zonal. - -// For global operations, use the `globalOperations` resource. - For regional -// operations, use the `regionOperations` resource. - For zonal operations, use -// the `zoneOperations` resource. For more information, read Global, Regional, -// and Zonal Resources. Note that completed Operation resources have a limited -// retention period. -message Operation { - // [Output Only] The value of `requestId` if you provided it in the request. - // Not present otherwise. - optional string client_operation_id = 1 [json_name = "clientOperationId"]; - - // [Deprecated] This field is deprecated. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // [Output Only] A textual description of the operation, which is set when the - // operation is created. - optional string description = 3 [json_name = "description"]; - - // [Output Only] The time that this operation was completed. This value is in - // RFC3339 text format. - optional string end_time = 4 [json_name = "endTime"]; - - message Error { - message ErrorsItem { - // [Output Only] The error type identifier for this error. - optional string code = 1 [json_name = "code"]; - - message ErrorDetailsItem { - optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; - - optional Help help = 2 [json_name = "help"]; - - optional LocalizedMessage localized_message = 3 - [json_name = "localizedMessage"]; - - optional QuotaExceededInfo quota_info = 4 [json_name = "quotaInfo"]; - } - - // [Output Only] An optional list of messages that contain the error - // details. There is a set of defined message types to use for providing - // details.The syntax depends on the error code. For example, - // QuotaExceededInfo will have details when the error code is - // QUOTA_EXCEEDED. - repeated ErrorDetailsItem error_details = 2 [json_name = "errorDetails"]; - - // [Output Only] Indicates the field in the request that caused the error. - // This property is optional. - optional string location = 3 [json_name = "location"]; - - // [Output Only] An optional, human-readable error message. - optional string message = 4 [json_name = "message"]; - } - - // [Output Only] The array of errors encountered while processing this - // operation. - repeated ErrorsItem errors = 1 [json_name = "errors"]; - } - - // [Output Only] If errors are generated during processing of the operation, - // this field will be populated. - optional Error error = 5 [json_name = "error"]; - - // [Output Only] If the operation fails, this field contains the HTTP error - // message that was returned, such as `NOT FOUND`. - optional string http_error_message = 6 [json_name = "httpErrorMessage"]; +message UrlMapsAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; - // [Output Only] If the operation fails, this field contains the HTTP error - // status code that was returned. For example, a `404` means the resource was - // not found. - optional int32 http_error_status_code = 7 [json_name = "httpErrorStatusCode"]; + // A list of UrlMapsScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] The unique identifier for the operation. This identifier is - // defined by the server. - optional string id = 8 [json_name = "id"]; + // Type of resource. + optional string kind = 3 [json_name = "kind"]; - // [Output Only] The time that this operation was requested. This value is in - // RFC3339 text format. - optional string insert_time = 9 [json_name = "insertTime"]; + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; - optional InstancesBulkInsertOperationMetadata - instances_bulk_insert_operation_metadata = 25 - [json_name = "instancesBulkInsertOperationMetadata"]; + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Type of the resource. Always `compute#operation` for - // Operation resources. - optional string kind = 10 [json_name = "kind"]; + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; - // [Output Only] Name of the operation. - optional string name = 11 [json_name = "name"]; - - // [Output Only] An ID that represents a group of operations, such as when a - // group of operations results from a `bulkInsert` API request. - optional string operation_group_id = 12 [json_name = "operationGroupId"]; - - // [Output Only] The type of operation, such as `insert`, `update`, or - // `delete`, and so on. - optional string operation_type = 13 [json_name = "operationType"]; - - // [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 when the operation will be - // complete. This number should monotonically increase as the operation - // progresses. - optional int32 progress = 14 [json_name = "progress"]; - - // [Output Only] The URL of the region where the operation resides. Only - // applicable when performing regional operations. - optional string region = 15 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 16 [json_name = "selfLink"]; - - // [Output Only] If the operation is for projects.setCommonInstanceMetadata, - // this field will contain information on all underlying zonal actions and - // their state. - optional SetCommonInstanceMetadataOperationMetadata - set_common_instance_metadata_operation_metadata = 26 - [json_name = "setCommonInstanceMetadataOperationMetadata"]; - - // [Output Only] The time that this operation was started by the server. This - // value is in RFC3339 text format. - optional string start_time = 17 [json_name = "startTime"]; - - // [Output Only] The status of the operation, which can be one of the - // following: `PENDING`, `RUNNING`, or `DONE`. - // DONE: - // PENDING: - // RUNNING: - optional string status = 18 [json_name = "status"]; - - // [Output Only] An optional textual description of the current status of the - // operation. - optional string status_message = 19 [json_name = "statusMessage"]; - - // [Output Only] The unique target ID, which identifies a specific incarnation - // of the target resource. - optional string target_id = 20 [json_name = "targetId"]; - - // [Output Only] The URL of the resource that the operation modifies. For - // operations related to creating a snapshot, this points to the persistent - // disk that the snapshot was created from. - optional string target_link = 21 [json_name = "targetLink"]; - - // [Output Only] User who requested the operation, for example: - // `user@example.com` or `alice_smith_identifier - // (global/workforcePools/example-com-us-employees)`. - optional string user = 22 [json_name = "user"]; - - message WarningsItem { + message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by @@ -351,86 +135,116 @@ message Operation { optional string message = 3 [json_name = "message"]; } - // [Output Only] If warning messages are generated during processing of the - // operation, this field will be populated. - repeated WarningsItem warnings = 23 [json_name = "warnings"]; - - // [Output Only] The URL of the zone where the operation resides. Only - // applicable when performing per-zone operations. - optional string zone = 24 [json_name = "zone"]; + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; } -// Additional details for quota exceeded error for resource quota. -message QuotaExceededInfo { - // The map holding related quota dimensions. - map dimensions = 1 [json_name = "dimensions"]; - - // Future quota limit being rolled out. The limit's unit depends on the quota - // type or metric. - optional double future_limit = 5 [json_name = "futureLimit"]; - - // Current effective quota limit. The limit's unit depends on the quota type - // or metric. - optional double limit = 2 [json_name = "limit"]; +message UrlMapsScopedList { + // A list of UrlMaps contained in this scope. + repeated UrlMap url_maps = 1 [json_name = "urlMaps"]; - // The name of the quota limit. - optional string limit_name = 3 [json_name = "limitName"]; - - // The Compute Engine quota metric name. - optional string metric_name = 4 [json_name = "metricName"]; + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; - // Rollout status of the future quota limit. - // IN_PROGRESS: IN_PROGRESS - A rollout is in process which will change the - // limit value to future limit. - // ROLLOUT_STATUS_UNSPECIFIED: ROLLOUT_STATUS_UNSPECIFIED - Rollout status is - // not specified. The default value. - optional string rollout_status = 6 [json_name = "rolloutStatus"]; -} + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; -message SetCommonInstanceMetadataOperationMetadata { - // [Output Only] The client operation id. - optional string client_operation_id = 1 [json_name = "clientOperationId"]; + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } - // [Output Only] Status information per location (location name is key). - // Example key: zones/us-central1-a - map - per_location_operations = 2 [json_name = "perLocationOperations"]; -} + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; -message SetCommonInstanceMetadataOperationMetadataPerLocationOperationInfo { - // [Output Only] If state is `ABANDONED` or `FAILED`, this field is populated. - optional Status error = 1 [json_name = "error"]; + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // [Output Only] Status of the action, which can be one of the following: - // `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`. - // ABANDONED: Operation not tracked in this location e.g. zone is marked as - // DOWN. - // DONE: Operation has completed successfully. - // FAILED: Operation is in an error state. - // PROPAGATED: Operation is confirmed to be in the location. - // PROPAGATING: Operation is not yet confirmed to have been created in the - // location. - // UNSPECIFIED: - optional string state = 2 [json_name = "state"]; + // Informational warning which replaces the list of backend services when the + // list is empty. + optional Warning warning = 2 [json_name = "warning"]; } -// The `Status` type defines a logical error model that is suitable for -// different programming environments, including REST APIs and RPC APIs. It is -// used by [gRPC](https://github.com/grpc). Each `Status` message contains three -// pieces of data: error code, error message, and error details. You can find -// out more about this error model and how to work with it in the [API Design -// Guide](https://cloud.google.com/apis/design/errors). -message Status { - // The status code, which should be an enum value of google.rpc.Code. - optional int32 code = 1 [json_name = "code"]; - - // A list of messages that carry the error details. There is a common set of - // message types for APIs to use. - repeated google.protobuf.Any details = 2 [json_name = "details"]; - - // A developer-facing error message, which should be in English. Any - // user-facing error message should be localized and sent in the - // google.rpc.Status.details field, or localized by the client. - optional string message = 3 [json_name = "message"]; +message UrlMapsValidateRequest { + // Specifies the load balancer type(s) this validation request is for. Use + // EXTERNAL_MANAGED for global external Application Load Balancers and + // regional external Application Load Balancers. Use EXTERNAL for classic + // Application Load Balancers. Use INTERNAL_MANAGED for internal Application + // Load Balancers. For more information, refer to Choosing a load balancer. If + // unspecified, the load balancing scheme will be inferred from the backend + // service resources this URL map references. If that can not be inferred (for + // example, this URL map only references backend buckets, or this Url map is + // for rewrites and redirects only and doesn't reference any backends), + // EXTERNAL will be used as the default type. If specified, the scheme(s) must + // not conflict with the load balancing scheme of the backend service + // resources this Url map references. + repeated string load_balancing_schemes = 1 + [json_name = "loadBalancingSchemes"]; + + // Content of the UrlMap to be validated. + optional UrlMap resource = 2 [json_name = "resource"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_018.proto b/protos/google/cloud/compute/v1/internal/common_018.proto index 2e4462948a877..e06bfd61555eb 100644 --- a/protos/google/cloud/compute/v1/internal/common_018.proto +++ b/protos/google/cloud/compute/v1/internal/common_018.proto @@ -15,30 +15,168 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_020.proto"; +import "google/cloud/compute/v1/internal/common_006.proto"; -message CacheInvalidationRule { - // If set, this invalidation rule will only apply to requests with a Host - // header matching host. - optional string host = 1 [json_name = "host"]; +// Represents a regional Commitment resource. Creating a commitment resource +// means that you are purchasing a committed use contract with an explicit start +// and end time. You can create commitments based on vCPUs and memory usage and +// receive discounted rates. For full details, read Signing Up for Committed Use +// Discounts. +message Commitment { + // Specifies whether to enable automatic renewal for the commitment. The + // default value is false if not specified. The field can be updated until the + // day of the commitment expiration at 12:00am PST. If the field is set to + // true, the commitment will be automatically renewed for either one or three + // years according to the terms of the existing commitment. + optional bool auto_renew = 1 [json_name = "autoRenew"]; - optional string path = 2 [json_name = "path"]; + // The category of the commitment. Category MACHINE specifies commitments + // composed of machine resources such as VCPU or MEMORY, listed in resources. + // Category LICENSE specifies commitments composed of software licenses, + // listed in licenseResources. Note that only MACHINE commitments should have + // a Type specified. + // CATEGORY_UNSPECIFIED: + // LICENSE: + // MACHINE: + optional string category = 2 [json_name = "category"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + + // [Input Only] Optional, specifies the CUD end time requested by the customer + // in RFC3339 text format. Needed when the customer wants CUD's end date is + // later than the start date + term duration. + optional string custom_end_timestamp = 22 [json_name = "customEndTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 4 [json_name = "description"]; + + // [Output Only] Commitment end time in RFC3339 text format. + optional string end_timestamp = 5 [json_name = "endTimestamp"]; + + // Specifies the already existing reservations to attach to the Commitment. + // This field is optional, and it can be a full or partial URL. For example, + // the following are valid URLs to an reservation: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /reservations/reservation - + // projects/project/zones/zone/reservations/reservation + repeated string existing_reservations = 21 + [json_name = "existingReservations"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#commitment for + // commitments. + optional string kind = 7 [json_name = "kind"]; + + // The license specification required as part of a license commitment. + optional LicenseResourceCommitment license_resource = 8 + [json_name = "licenseResource"]; + + // List of source commitments to be merged into a new commitment. + repeated string merge_source_commitments = 9 + [json_name = "mergeSourceCommitments"]; + + // 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. + optional string name = 10 [json_name = "name"]; + + // The plan for this commitment, which determines duration and discount rate. + // The currently supported plans are TWELVE_MONTH (1 year), and + // THIRTY_SIX_MONTH (3 years). + // INVALID: + // THIRTY_SIX_MONTH: + // TWELVE_MONTH: + optional string plan = 11 [json_name = "plan"]; + + // [Output Only] URL of the region where this commitment may be used. + optional string region = 12 [json_name = "region"]; + + // List of create-on-create reservations for this commitment. + repeated Reservation reservations = 13 [json_name = "reservations"]; + + // [Output Only] Status information for Commitment resource. + optional CommitmentResourceStatus resource_status = 23 + [json_name = "resourceStatus"]; + + // A list of commitment amounts for particular resources. Note that VCPU and + // MEMORY resource commitments must occur together. + repeated ResourceCommitment resources = 14 [json_name = "resources"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 15 [json_name = "selfLink"]; + + // Source commitment to be split into a new commitment. + optional string split_source_commitment = 16 + [json_name = "splitSourceCommitment"]; + + // [Output Only] Commitment start time in RFC3339 text format. + optional string start_timestamp = 17 [json_name = "startTimestamp"]; + + // [Output Only] Status of the commitment with regards to eventual expiration + // (each commitment has an end date defined). One of the following values: + // NOT_YET_ACTIVE, ACTIVE, EXPIRED. + // ACTIVE: + // CANCELLED: Deprecate CANCELED status. Will use separate status to + // differentiate cancel by mergeCud or manual cancellation. + // CREATING: + // EXPIRED: + // NOT_YET_ACTIVE: + optional string status = 18 [json_name = "status"]; + + // [Output Only] An optional, human-readable explanation of the status. + optional string status_message = 19 [json_name = "statusMessage"]; + + // The type of commitment, which affects the discount rate and the eligible + // resources. Type MEMORY_OPTIMIZED specifies a commitment that will only + // apply to memory optimized machines. Type ACCELERATOR_OPTIMIZED specifies a + // commitment that will only apply to accelerator optimized machines. + // ACCELERATOR_OPTIMIZED: + // ACCELERATOR_OPTIMIZED_A3: + // ACCELERATOR_OPTIMIZED_A3_MEGA: + // COMPUTE_OPTIMIZED: + // COMPUTE_OPTIMIZED_C2D: + // COMPUTE_OPTIMIZED_C3: + // COMPUTE_OPTIMIZED_C3D: + // COMPUTE_OPTIMIZED_H3: + // GENERAL_PURPOSE: + // GENERAL_PURPOSE_C4: + // GENERAL_PURPOSE_E2: + // GENERAL_PURPOSE_N2: + // GENERAL_PURPOSE_N2D: + // GENERAL_PURPOSE_N4: + // GENERAL_PURPOSE_T2D: + // GRAPHICS_OPTIMIZED: + // MEMORY_OPTIMIZED: + // MEMORY_OPTIMIZED_M3: + // STORAGE_OPTIMIZED_Z3: + // TYPE_UNSPECIFIED: + optional string type = 20 [json_name = "type"]; } -message UrlMapsAggregatedList { +message CommitmentAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of UrlMapsScopedList resources. - map items = 2 [json_name = "items"]; + // A list of CommitmentsScopedList resources. + map items = 2 [json_name = "items"]; - // Type of resource. + // [Output Only] Type of resource. Always compute#commitmentAggregatedList for + // aggregated lists of commitments. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -139,9 +277,27 @@ message UrlMapsAggregatedList { optional Warning warning = 7 [json_name = "warning"]; } -message UrlMapsScopedList { - // A list of UrlMaps contained in this scope. - repeated UrlMap url_maps = 1 [json_name = "urlMaps"]; +// Contains a list of Commitment resources. +message CommitmentList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of Commitment resources. + repeated Commitment items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#commitmentList for lists of + // commitments. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -224,27 +380,140 @@ message UrlMapsScopedList { optional string message = 3 [json_name = "message"]; } - // Informational warning which replaces the list of backend services when the - // list is empty. + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +// [Output Only] Contains output only fields. +message CommitmentResourceStatus { + // [Output Only] Indicates the end time of customer's eligibility to send + // custom term requests in RFC3339 text format. Term extension requests that + // (not the end time in the request) after this time will be rejected. + optional string custom_term_eligibility_end_timestamp = 1 + [json_name = "customTermEligibilityEndTimestamp"]; +} + +message CommitmentsScopedList { + // [Output Only] A list of commitments contained in this scope. + repeated Commitment commitments = 1 [json_name = "commitments"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning which replaces the list of commitments + // when the list is empty. optional Warning warning = 2 [json_name = "warning"]; } -message UrlMapsValidateRequest { - // Specifies the load balancer type(s) this validation request is for. Use - // EXTERNAL_MANAGED for global external Application Load Balancers and - // regional external Application Load Balancers. Use EXTERNAL for classic - // Application Load Balancers. Use INTERNAL_MANAGED for internal Application - // Load Balancers. For more information, refer to Choosing a load balancer. If - // unspecified, the load balancing scheme will be inferred from the backend - // service resources this URL map references. If that can not be inferred (for - // example, this URL map only references backend buckets, or this Url map is - // for rewrites and redirects only and doesn't reference any backends), - // EXTERNAL will be used as the default type. If specified, the scheme(s) must - // not conflict with the load balancing scheme of the backend service - // resources this Url map references. - repeated string load_balancing_schemes = 1 - [json_name = "loadBalancingSchemes"]; - - // Content of the UrlMap to be validated. - optional UrlMap resource = 2 [json_name = "resource"]; +// Commitment for a particular license resource. +message LicenseResourceCommitment { + // The number of licenses purchased. + optional string amount = 1 [json_name = "amount"]; + + // Specifies the core range of the instance for which this license applies. + optional string cores_per_license = 2 [json_name = "coresPerLicense"]; + + // Any applicable license URI. + optional string license = 3 [json_name = "license"]; +} + +// Commitment for a particular resource (a Commitment is composed of one or more +// of these). +message ResourceCommitment { + // Name of the accelerator type resource. Applicable only when the type is + // ACCELERATOR. + optional string accelerator_type = 1 [json_name = "acceleratorType"]; + + // The amount of the resource purchased (in a type-dependent unit, such as + // bytes). For vCPUs, this can just be an integer. For memory, this must be + // provided in MB. Memory must be a multiple of 256 MB, with up to 6.5GB of + // memory per every vCPU. + optional string amount = 2 [json_name = "amount"]; + + // Type of resource for which this commitment applies. Possible values are + // VCPU, MEMORY, LOCAL_SSD, and ACCELERATOR. + // ACCELERATOR: + // LOCAL_SSD: + // MEMORY: + // UNSPECIFIED: + // VCPU: + optional string type = 3 [json_name = "type"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_019.proto b/protos/google/cloud/compute/v1/internal/common_019.proto index 37b60e3348669..1125c704f00ae 100644 --- a/protos/google/cloud/compute/v1/internal/common_019.proto +++ b/protos/google/cloud/compute/v1/internal/common_019.proto @@ -15,269 +15,986 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_006.proto"; - -// Represents a regional Commitment resource. Creating a commitment resource -// means that you are purchasing a committed use contract with an explicit start -// and end time. You can create commitments based on vCPUs and memory usage and -// receive discounted rates. For full details, read Signing Up for Committed Use -// Discounts. -message Commitment { - // Specifies whether to enable automatic renewal for the commitment. The - // default value is false if not specified. The field can be updated until the - // day of the commitment expiration at 12:00am PST. If the field is set to - // true, the commitment will be automatically renewed for either one or three - // years according to the terms of the existing commitment. - optional bool auto_renew = 1 [json_name = "autoRenew"]; - - // The category of the commitment. Category MACHINE specifies commitments - // composed of machine resources such as VCPU or MEMORY, listed in resources. - // Category LICENSE specifies commitments composed of software licenses, - // listed in licenseResources. Note that only MACHINE commitments should have - // a Type specified. - // CATEGORY_UNSPECIFIED: - // LICENSE: - // MACHINE: - optional string category = 2 [json_name = "category"]; +import "google/cloud/compute/v1/internal/common_029.proto"; +import "google/cloud/compute/v1/internal/common_077.proto"; - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; +// The specification for allowing client-side cross-origin requests. For more +// information about the W3C recommendation for cross-origin resource sharing +// (CORS), see Fetch API Living Standard. +message CorsPolicy { + // In response to a preflight request, setting this to true indicates that the + // actual request can include user credentials. This field translates to the + // Access-Control-Allow-Credentials header. Default is false. + optional bool allow_credentials = 1 [json_name = "allowCredentials"]; + + // Specifies the content for the Access-Control-Allow-Headers header. + repeated string allow_headers = 2 [json_name = "allowHeaders"]; + + // Specifies the content for the Access-Control-Allow-Methods header. + repeated string allow_methods = 3 [json_name = "allowMethods"]; + + // Specifies a regular expression that matches allowed origins. For more + // information, see regular expression syntax . An origin is allowed if it + // matches either an item in allowOrigins or an item in allowOriginRegexes. + // Regular expressions can only be used when the loadBalancingScheme is set to + // INTERNAL_SELF_MANAGED. + repeated string allow_origin_regexes = 4 [json_name = "allowOriginRegexes"]; + + // Specifies the list of origins that is allowed to do CORS requests. An + // origin is allowed if it matches either an item in allowOrigins or an item + // in allowOriginRegexes. + repeated string allow_origins = 5 [json_name = "allowOrigins"]; + + // If true, disables the CORS policy. The default value is false, which + // indicates that the CORS policy is in effect. + optional bool disabled = 6 [json_name = "disabled"]; + + // Specifies the content for the Access-Control-Expose-Headers header. + repeated string expose_headers = 7 [json_name = "exposeHeaders"]; + + // Specifies how long results of a preflight request can be cached in seconds. + // This field translates to the Access-Control-Max-Age header. + optional int32 max_age = 8 [json_name = "maxAge"]; +} + +// Specifies the custom error response policy that must be applied when the +// backend service or backend bucket responds with an error. +message CustomErrorResponsePolicy { + // Specifies rules for returning error responses. In a given policy, if you + // specify rules for both a range of error codes as well as rules for specific + // error codes then rules with specific error codes have a higher priority. + // For example, assume that you configure a rule for 401 (Un-authorized) code, + // and another for all 4 series error codes (4XX). If the backend service + // returns a 401, then the rule for 401 will be applied. However if the + // backend service returns a 403, the rule for 4xx takes effect. + repeated CustomErrorResponsePolicyCustomErrorResponseRule + error_response_rules = 1 [json_name = "errorResponseRules"]; + + // The full or partial URL to the BackendBucket resource that contains the + // custom error content. Examples are: - + // https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket + // - compute/v1/projects/project/global/backendBuckets/myBackendBucket - + // global/backendBuckets/myBackendBucket If errorService is not specified at + // lower levels like pathMatcher, pathRule and routeRule, an errorService + // specified at a higher level in the UrlMap will be used. If + // UrlMap.defaultCustomErrorResponsePolicy contains one or more + // errorResponseRules[], it must specify errorService. If load balancer cannot + // reach the backendBucket, a simple Not Found Error will be returned, with + // the original response code (or overrideResponseCode if configured). + // errorService is not supported for internal or regional HTTP/HTTPS load + // balancers. + optional string error_service = 2 [json_name = "errorService"]; +} + +// Specifies the mapping between the response code that will be returned along +// with the custom error content and the response code returned by the backend +// service. +message CustomErrorResponsePolicyCustomErrorResponseRule { + // Valid values include: - A number between 400 and 599: For example 401 or + // 503, in which case the load balancer applies the policy if the error code + // exactly matches this value. - 5xx: Load Balancer will apply the policy if + // the backend service responds with any response code in the range of 500 to + // 599. - 4xx: Load Balancer will apply the policy if the backend service + // responds with any response code in the range of 400 to 499. Values must be + // unique within matchResponseCodes and across all errorResponseRules of + // CustomErrorResponsePolicy. + repeated string match_response_codes = 1 [json_name = "matchResponseCodes"]; + + // The HTTP status code returned with the response containing the custom error + // content. If overrideResponseCode is not supplied, the same response code + // returned by the original backend bucket or backend service is returned to + // the client. + optional int32 override_response_code = 2 + [json_name = "overrideResponseCode"]; + + // The full path to a file within backendBucket . For example: + // /errors/defaultError.html path must start with a leading slash. path cannot + // have trailing slashes. If the file is not available in backendBucket or the + // load balancer cannot reach the BackendBucket, a simple Not Found Error is + // returned to the client. The value must be from 1 to 1024 characters + optional string path = 3 [json_name = "path"]; +} + +// UrlMaps A host-matching rule for a URL. If matched, will use the named +// PathMatcher to select the BackendService. +message HostRule { + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 1 [json_name = "description"]; + + // The list of host patterns to match. They must be valid hostnames with + // optional port numbers in the format host:port. * matches any string of + // ([a-z0-9-.]*). In that case, * must be the first character, and if followed + // by anything, the immediate following character must be either - or .. * + // based matching is not supported when the URL map is bound to a target gRPC + // proxy that has the validateForProxyless field set to true. + repeated string hosts = 2 [json_name = "hosts"]; + + // The name of the PathMatcher to use to match the path portion of the URL if + // the hostRule matches the URL's host portion. + optional string path_matcher = 3 [json_name = "pathMatcher"]; +} + +// Specification for how requests are aborted as part of fault injection. +message HttpFaultAbort { + // The HTTP status code used to abort the request. The value must be from 200 + // to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP + // status code according to this mapping table. HTTP status 200 is mapped to + // gRPC status UNKNOWN. Injecting an OK status is currently not supported by + // Traffic Director. + optional uint32 http_status = 1 [json_name = "httpStatus"]; + + // The percentage of traffic for connections, operations, or requests that is + // aborted as part of fault injection. The value must be from 0.0 to 100.0 + // inclusive. + optional double percentage = 2 [json_name = "percentage"]; +} + +// Specifies the delay introduced by the load balancer before forwarding the +// request to the backend service as part of fault injection. +message HttpFaultDelay { + // Specifies the value of the fixed delay interval. + optional Duration fixed_delay = 1 [json_name = "fixedDelay"]; + + // The percentage of traffic for connections, operations, or requests for + // which a delay is introduced as part of fault injection. The value must be + // from 0.0 to 100.0 inclusive. + optional double percentage = 2 [json_name = "percentage"]; +} + +// The specification for fault injection introduced into traffic to test the +// resiliency of clients to backend service failure. As part of fault injection, +// when clients send requests to a backend service, delays can be introduced by +// the load balancer on a percentage of requests before sending those request to +// the backend service. Similarly requests from clients can be aborted by the +// load balancer for a percentage of requests. +message HttpFaultInjection { + // The specification for how client requests are aborted as part of fault + // injection. + optional HttpFaultAbort abort = 1 [json_name = "abort"]; + + // The specification for how client requests are delayed as part of fault + // injection, before being sent to a backend service. + optional HttpFaultDelay delay = 2 [json_name = "delay"]; +} + +// The request and response header transformations that take effect before the +// request is passed along to the selected backendService. +message HttpHeaderAction { + // Headers to add to a matching request before forwarding the request to the + // backendService. + repeated HttpHeaderOption request_headers_to_add = 1 + [json_name = "requestHeadersToAdd"]; + + // A list of header names for headers that need to be removed from the request + // before forwarding the request to the backendService. + repeated string request_headers_to_remove = 2 + [json_name = "requestHeadersToRemove"]; + + // Headers to add the response before sending the response back to the client. + repeated HttpHeaderOption response_headers_to_add = 3 + [json_name = "responseHeadersToAdd"]; + + // A list of header names for headers that need to be removed from the + // response before sending the response back to the client. + repeated string response_headers_to_remove = 4 + [json_name = "responseHeadersToRemove"]; +} + +// matchRule criteria for request header matches. +message HttpHeaderMatch { + // The value should exactly match contents of exactMatch. Only one of + // exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or + // rangeMatch must be set. + optional string exact_match = 1 [json_name = "exactMatch"]; + + // The name of the HTTP header to match. For matching against the HTTP + // request's authority, use a headerMatch with the header name ":authority". + // For matching a request's method, use the headerName ":method". When the URL + // map is bound to a target gRPC proxy that has the validateForProxyless field + // set to true, only non-binary user-specified custom metadata and the + // `content-type` header are supported. The following transport-level headers + // cannot be used in header matching rules: `:authority`, `:method`, `:path`, + // `:scheme`, `user-agent`, `accept-encoding`, `content-encoding`, + // `grpc-accept-encoding`, `grpc-encoding`, `grpc-previous-rpc-attempts`, + // `grpc-tags-bin`, `grpc-timeout` and `grpc-trace-bin`. + optional string header_name = 2 [json_name = "headerName"]; + + // If set to false, the headerMatch is considered a match if the preceding + // match criteria are met. If set to true, the headerMatch is considered a + // match if the preceding match criteria are NOT met. The default setting is + // false. + optional bool invert_match = 3 [json_name = "invertMatch"]; + + // The value of the header must start with the contents of prefixMatch. Only + // one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or + // rangeMatch must be set. + optional string prefix_match = 4 [json_name = "prefixMatch"]; + + // A header with the contents of headerName must exist. The match takes place + // whether or not the request's header has a value. Only one of exactMatch, + // prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be + // set. + optional bool present_match = 5 [json_name = "presentMatch"]; + + // The header value must be an integer and its value must be in the range + // specified in rangeMatch. If the header does not contain an integer, number + // or is empty, the match fails. For example for a range [-5, 0] - -3 will + // match. - 0 will not match. - 0.25 will not match. - -3someString will not + // match. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, + // presentMatch or rangeMatch must be set. rangeMatch is not supported for + // load balancers that have loadBalancingScheme set to EXTERNAL. + optional Int64RangeMatch range_match = 6 [json_name = "rangeMatch"]; + + // The value of the header must match the regular expression specified in + // regexMatch. For more information about regular expression syntax, see + // Syntax. For matching against a port specified in the HTTP request, use a + // headerMatch with headerName set to PORT and a regular expression that + // satisfies the RFC2616 Host header's port specifier. Only one of exactMatch, + // prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be + // set. Regular expressions can only be used when the loadBalancingScheme is + // set to INTERNAL_SELF_MANAGED. + optional string regex_match = 7 [json_name = "regexMatch"]; + + // The value of the header must end with the contents of suffixMatch. Only one + // of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or + // rangeMatch must be set. + optional string suffix_match = 8 [json_name = "suffixMatch"]; +} + +// Specification determining how headers are added to requests or responses. +message HttpHeaderOption { + // The name of the header. + optional string header_name = 1 [json_name = "headerName"]; + + // The value of the header to add. + optional string header_value = 2 [json_name = "headerValue"]; + + // If false, headerValue is appended to any values that already exist for the + // header. If true, headerValue is set for the header, discarding any values + // that were set for that header. The default value is false. + optional bool replace = 3 [json_name = "replace"]; +} + +// HttpRouteRuleMatch criteria for a request's query parameter. +message HttpQueryParameterMatch { + // The queryParameterMatch matches if the value of the parameter exactly + // matches the contents of exactMatch. Only one of presentMatch, exactMatch, + // or regexMatch must be set. + optional string exact_match = 1 [json_name = "exactMatch"]; + + // The name of the query parameter to match. The query parameter must exist in + // the request, in the absence of which the request match fails. + optional string name = 2 [json_name = "name"]; + + // Specifies that the queryParameterMatch matches if the request contains the + // query parameter, irrespective of whether the parameter has a value or not. + // Only one of presentMatch, exactMatch, or regexMatch must be set. + optional bool present_match = 3 [json_name = "presentMatch"]; + + // The queryParameterMatch matches if the value of the parameter matches the + // regular expression specified by regexMatch. For more information about + // regular expression syntax, see Syntax. Only one of presentMatch, + // exactMatch, or regexMatch must be set. Regular expressions can only be used + // when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. + optional string regex_match = 4 [json_name = "regexMatch"]; +} + +// Specifies settings for an HTTP redirect. +message HttpRedirectAction { + // The host that is used in the redirect response instead of the one that was + // supplied in the request. The value must be from 1 to 255 characters. + optional string host_redirect = 1 [json_name = "hostRedirect"]; + + // If set to true, the URL scheme in the redirected request is set to HTTPS. + // If set to false, the URL scheme of the redirected request remains the same + // as that of the request. This must only be set for URL maps used in + // TargetHttpProxys. Setting this true for TargetHttpsProxy is not permitted. + // The default is set to false. + optional bool https_redirect = 2 [json_name = "httpsRedirect"]; + + // The path that is used in the redirect response instead of the one that was + // supplied in the request. pathRedirect cannot be supplied together with + // prefixRedirect. Supply one alone or neither. If neither is supplied, the + // path of the original request is used for the redirect. The value must be + // from 1 to 1024 characters. + optional string path_redirect = 3 [json_name = "pathRedirect"]; + + // The prefix that replaces the prefixMatch specified in the + // HttpRouteRuleMatch, retaining the remaining portion of the URL before + // redirecting the request. prefixRedirect cannot be supplied together with + // pathRedirect. Supply one alone or neither. If neither is supplied, the path + // of the original request is used for the redirect. The value must be from 1 + // to 1024 characters. + optional string prefix_redirect = 4 [json_name = "prefixRedirect"]; + + // The HTTP Status code to use for this RedirectAction. Supported values are: + // - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds to + // 301. - FOUND, which corresponds to 302. - SEE_OTHER which corresponds to + // 303. - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the + // request method is retained. - PERMANENT_REDIRECT, which corresponds to 308. + // In this case, the request method is retained. + // FOUND: Http Status Code 302 - Found. + // MOVED_PERMANENTLY_DEFAULT: Http Status Code 301 - Moved Permanently. + // PERMANENT_REDIRECT: Http Status Code 308 - Permanent Redirect maintaining + // HTTP method. + // SEE_OTHER: Http Status Code 303 - See Other. + // TEMPORARY_REDIRECT: Http Status Code 307 - Temporary Redirect maintaining + // HTTP method. + optional string redirect_response_code = 5 + [json_name = "redirectResponseCode"]; + + // If set to true, any accompanying query portion of the original URL is + // removed before redirecting the request. If set to false, the query portion + // of the original URL is retained. The default is set to false. + optional bool strip_query = 6 [json_name = "stripQuery"]; +} + +// The retry policy associates with HttpRouteRule +message HttpRetryPolicy { + // Specifies the allowed number retries. This number must be > 0. If not + // specified, defaults to 1. + optional uint32 num_retries = 1 [json_name = "numRetries"]; + + // Specifies a non-zero timeout per retry attempt. If not specified, will use + // the timeout set in the HttpRouteAction field. If timeout in the + // HttpRouteAction field is not set, this field uses the largest timeout among + // all backend services associated with the route. Not supported when the URL + // map is bound to a target gRPC proxy that has the validateForProxyless field + // set to true. + optional Duration per_try_timeout = 2 [json_name = "perTryTimeout"]; + + // Specifies one or more conditions when this retry policy applies. Valid + // values are: - 5xx: retry is attempted if the instance or endpoint responds + // with any 5xx response code, or if the instance or endpoint does not respond + // at all. For example, disconnects, reset, read timeout, connection failure, + // and refused streams. - gateway-error: Similar to 5xx, but only applies to + // response codes 502, 503 or 504. - connect-failure: a retry is attempted on + // failures connecting to the instance or endpoint. For example, connection + // timeouts. - retriable-4xx: a retry is attempted if the instance or endpoint + // responds with a 4xx response code. The only error that you can retry is + // error code 409. - refused-stream: a retry is attempted if the instance or + // endpoint resets the stream with a REFUSED_STREAM error code. This reset + // type indicates that it is safe to retry. - cancelled: a retry is attempted + // if the gRPC status code in the response header is set to cancelled. - + // deadline-exceeded: a retry is attempted if the gRPC status code in the + // response header is set to deadline-exceeded. - internal: a retry is + // attempted if the gRPC status code in the response header is set to + // internal. - resource-exhausted: a retry is attempted if the gRPC status + // code in the response header is set to resource-exhausted. - unavailable: a + // retry is attempted if the gRPC status code in the response header is set to + // unavailable. Only the following codes are supported when the URL map is + // bound to target gRPC proxy that has validateForProxyless field set to true. + // - cancelled - deadline-exceeded - internal - resource-exhausted - + // unavailable + repeated string retry_conditions = 3 [json_name = "retryConditions"]; +} + +message HttpRouteAction { + // The specification for allowing client-side cross-origin requests. For more + // information about the W3C recommendation for cross-origin resource sharing + // (CORS), see Fetch API Living Standard. Not supported when the URL map is + // bound to a target gRPC proxy. + optional CorsPolicy cors_policy = 1 [json_name = "corsPolicy"]; + + // The specification for fault injection introduced into traffic to test the + // resiliency of clients to backend service failure. As part of fault + // injection, when clients send requests to a backend service, delays can be + // introduced by a load balancer on a percentage of requests before sending + // those requests to the backend service. Similarly requests from clients can + // be aborted by the load balancer for a percentage of requests. timeout and + // retry_policy is ignored by clients that are configured with a + // fault_injection_policy if: 1. The traffic is generated by fault injection + // AND 2. The fault injection is not a delay fault injection. Fault injection + // is not supported with the classic Application Load Balancer . To see which + // load balancers support fault injection, see Load balancing: Routing and + // traffic management features. + optional HttpFaultInjection fault_injection_policy = 2 + [json_name = "faultInjectionPolicy"]; + + // Specifies the maximum duration (timeout) for streams on the selected route. + // Unlike the timeout field where the timeout duration starts from the time + // the request has been fully processed (known as *end-of-stream*), the + // duration in this field is computed from the beginning of the stream until + // the response has been processed, including all retries. A stream that does + // not complete in this duration is closed. If not specified, this field uses + // the maximum maxStreamDuration value among all backend services associated + // with the route. This field is only allowed if the Url map is used with + // backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED. + optional Duration max_stream_duration = 3 [json_name = "maxStreamDuration"]; + + // Specifies the policy on how requests intended for the route's backends are + // shadowed to a separate mirrored backend service. The load balancer does not + // wait for responses from the shadow service. Before sending traffic to the + // shadow service, the host / authority header is suffixed with -shadow. Not + // supported when the URL map is bound to a target gRPC proxy that has the + // validateForProxyless field set to true. + optional RequestMirrorPolicy request_mirror_policy = 4 + [json_name = "requestMirrorPolicy"]; + + // Specifies the retry policy associated with this route. + optional HttpRetryPolicy retry_policy = 5 [json_name = "retryPolicy"]; + + // Specifies the timeout for the selected route. Timeout is computed from the + // time the request has been fully processed (known as *end-of-stream*) up + // until the response has been processed. Timeout includes all retries. If not + // specified, this field uses the largest timeout among all backend services + // associated with the route. Not supported when the URL map is bound to a + // target gRPC proxy that has validateForProxyless field set to true. + optional Duration timeout = 6 [json_name = "timeout"]; + + // The spec to modify the URL of the request, before forwarding the request to + // the matched service. urlRewrite is the only action supported in UrlMaps for + // classic Application Load Balancers. Not supported when the URL map is bound + // to a target gRPC proxy that has the validateForProxyless field set to true. + optional UrlRewrite url_rewrite = 7 [json_name = "urlRewrite"]; + + // A list of weighted backend services to send traffic to when a route match + // occurs. The weights determine the fraction of traffic that flows to their + // corresponding backend service. If all traffic needs to go to a single + // backend service, there must be one weightedBackendService with weight set + // to a non-zero number. After a backend service is identified and before + // forwarding the request to the backend service, advanced routing actions + // such as URL rewrites and header transformations are applied depending on + // additional settings specified in this HttpRouteAction. + repeated WeightedBackendService weighted_backend_services = 8 + [json_name = "weightedBackendServices"]; +} + +// The HttpRouteRule setting specifies how to match an HTTP request and the +// corresponding routing action that load balancing proxies perform. +message HttpRouteRule { + // customErrorResponsePolicy specifies how the Load Balancer returns error + // responses when BackendServiceor BackendBucket responds with an error. If a + // policy for an error code is not configured for the RouteRule, a policy for + // the error code configured in pathMatcher.defaultCustomErrorResponsePolicy + // is applied. If one is not specified in + // pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in + // UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider + // a UrlMap with the following configuration: - + // UrlMap.defaultCustomErrorResponsePolicy are configured with policies for + // 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the + // error code 404. If the request is for www.myotherdomain.com and a 404 is + // encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes + // effect. If a 404 response is encountered for the request + // www.example.com/current_events/, the pathMatcher's policy takes effect. If + // however, the request for www.example.com/coming_soon/ encounters a 404, the + // policy in RouteRule.customErrorResponsePolicy takes effect. If any of the + // requests in this example encounter a 500 error code, the policy at + // UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in + // conjunction with routeRules.routeAction.retryPolicy, retries take + // precedence. Only once all retries are exhausted, the + // customErrorResponsePolicy is applied. While attempting a retry, if load + // balancer is successful in reaching the service, the + // customErrorResponsePolicy is ignored and the response from the service is + // returned to the client. customErrorResponsePolicy is supported only for + // global external Application Load Balancers. + optional CustomErrorResponsePolicy custom_error_response_policy = 8 + [json_name = "customErrorResponsePolicy"]; + + // The short description conveying the intent of this routeRule. The + // description can have a maximum length of 1024 characters. + optional string description = 1 [json_name = "description"]; + + // Specifies changes to request and response headers that need to take effect + // for the selected backendService. The headerAction value specified here is + // applied before the matching pathMatchers[].headerAction and after + // pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction + // HeaderAction is not supported for load balancers that have their + // loadBalancingScheme set to EXTERNAL. Not supported when the URL map is + // bound to a target gRPC proxy that has validateForProxyless field set to + // true. + optional HttpHeaderAction header_action = 2 [json_name = "headerAction"]; + + // The list of criteria for matching attributes of a request to this + // routeRule. This list has OR semantics: the request matches this routeRule + // when any of the matchRules are satisfied. However predicates within a given + // matchRule have AND semantics. All predicates within a matchRule must match + // for the request to match the rule. + repeated HttpRouteRuleMatch match_rules = 3 [json_name = "matchRules"]; + + // For routeRules within a given pathMatcher, priority determines the order in + // which a load balancer interprets routeRules. RouteRules are evaluated in + // order of priority, from the lowest to highest number. The priority of a + // rule decreases as its number increases (1, 2, 3, N+1). The first rule that + // matches the request is applied. You cannot configure two or more routeRules + // with the same priority. Priority for each rule must be set to a number from + // 0 to 2147483647 inclusive. Priority numbers can have gaps, which enable you + // to add or remove rules in the future without affecting the rest of the + // rules. For example, 1, 2, 3, 4, 5, 9, 12, 16 is a valid series of priority + // numbers to which you could add rules numbered from 6 to 8, 10 to 11, and 13 + // to 15 in the future without any impact on existing rules. + optional int32 priority = 4 [json_name = "priority"]; + + // In response to a matching matchRule, the load balancer performs advanced + // routing actions, such as URL rewrites and header transformations, before + // forwarding the request to the selected backend. If routeAction specifies + // any weightedBackendServices, service must not be set. Conversely if service + // is set, routeAction cannot contain any weightedBackendServices. Only one of + // urlRedirect, service or routeAction.weightedBackendService must be set. URL + // maps for classic Application Load Balancers only support the urlRewrite + // action within a route rule's routeAction. + optional HttpRouteAction route_action = 5 [json_name = "routeAction"]; + + // The full or partial URL of the backend service resource to which traffic is + // directed if this rule is matched. If routeAction is also specified, + // advanced routing actions, such as URL rewrites, take effect before sending + // the request to the backend. However, if service is specified, routeAction + // cannot contain any weightedBackendServices. Conversely, if routeAction + // specifies any weightedBackendServices, service must not be specified. Only + // one of urlRedirect, service or routeAction.weightedBackendService must be + // set. + optional string service = 6 [json_name = "service"]; + + // When this rule is matched, the request is redirected to a URL specified by + // urlRedirect. If urlRedirect is specified, service or routeAction must not + // be set. Not supported when the URL map is bound to a target gRPC proxy. + optional HttpRedirectAction url_redirect = 7 [json_name = "urlRedirect"]; +} + +// HttpRouteRuleMatch specifies a set of criteria for matching requests to an +// HttpRouteRule. All specified criteria must be satisfied for a match to occur. +message HttpRouteRuleMatch { + // For satisfying the matchRule condition, the path of the request must + // exactly match the value specified in fullPathMatch after removing any query + // parameters and anchor that may be part of the original URL. fullPathMatch + // must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch + // or regexMatch must be specified. + optional string full_path_match = 1 [json_name = "fullPathMatch"]; + + // Specifies a list of header match criteria, all of which must match + // corresponding headers in the request. + repeated HttpHeaderMatch header_matches = 2 [json_name = "headerMatches"]; + + // Specifies that prefixMatch and fullPathMatch matches are case sensitive. + // The default value is false. ignoreCase must not be used with regexMatch. + // Not supported when the URL map is bound to a target gRPC proxy. + optional bool ignore_case = 3 [json_name = "ignoreCase"]; + + // Opaque filter criteria used by the load balancer to restrict routing + // configuration to a limited set of xDS compliant clients. In their xDS + // requests to the load balancer, xDS clients present node metadata. When + // there is a match, the relevant routing configuration is made available to + // those proxies. For each metadataFilter in this list, if its + // filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels + // must match the corresponding label provided in the metadata. If its + // filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must + // match with corresponding labels provided in the metadata. If multiple + // metadata filters are specified, all of them need to be satisfied in order + // to be considered a match. metadataFilters specified here is applied after + // those specified in ForwardingRule that refers to the UrlMap this + // HttpRouteRuleMatch belongs to. metadataFilters only applies to load + // balancers that have loadBalancingScheme set to INTERNAL_SELF_MANAGED. Not + // supported when the URL map is bound to a target gRPC proxy that has + // validateForProxyless field set to true. + repeated MetadataFilter metadata_filters = 4 [json_name = "metadataFilters"]; + + // If specified, the route is a pattern match expression that must match the + // :path header once the query string is removed. A pattern match allows you + // to match - The value must be between 1 and 1024 characters - The pattern + // must start with a leading slash ("/") - There may be no more than 5 + // operators in pattern Precisely one of prefix_match, full_path_match, + // regex_match or path_template_match must be set. + optional string path_template_match = 8 [json_name = "pathTemplateMatch"]; + + // For satisfying the matchRule condition, the request's path must begin with + // the specified prefixMatch. prefixMatch must begin with a /. The value must + // be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or + // regexMatch must be specified. + optional string prefix_match = 5 [json_name = "prefixMatch"]; + + // Specifies a list of query parameter match criteria, all of which must match + // corresponding query parameters in the request. Not supported when the URL + // map is bound to a target gRPC proxy. + repeated HttpQueryParameterMatch query_parameter_matches = 6 + [json_name = "queryParameterMatches"]; + + // For satisfying the matchRule condition, the path of the request must + // satisfy the regular expression specified in regexMatch after removing any + // query parameters and anchor supplied with the original URL. For more + // information about regular expression syntax, see Syntax. Only one of + // prefixMatch, fullPathMatch or regexMatch must be specified. Regular + // expressions can only be used when the loadBalancingScheme is set to + // INTERNAL_SELF_MANAGED. + optional string regex_match = 7 [json_name = "regexMatch"]; +} + +// HttpRouteRuleMatch criteria for field values that must stay within the +// specified integer range. +message Int64RangeMatch { + // The end of the range (exclusive) in signed long integer format. + optional string range_end = 1 [json_name = "rangeEnd"]; + + // The start of the range (inclusive) in signed long integer format. + optional string range_start = 2 [json_name = "rangeStart"]; +} + +// A matcher for the path portion of the URL. The BackendService from the +// longest-matched rule will serve the URL. If no rule was matched, the default +// service is used. +message PathMatcher { + // defaultCustomErrorResponsePolicy specifies how the Load Balancer returns + // error responses when BackendServiceor BackendBucket responds with an error. + // This policy takes effect at the PathMatcher level and applies only when no + // policy has been defined for the error code at lower levels like RouteRule + // and PathRule within this PathMatcher. If an error code does not have a + // policy defined in defaultCustomErrorResponsePolicy, then a policy defined + // for the error code in UrlMap.defaultCustomErrorResponsePolicy takes effect. + // For example, consider a UrlMap with the following configuration: - + // UrlMap.defaultCustomErrorResponsePolicy is configured with policies for 5xx + // and 4xx errors - A RouteRule for /coming_soon/ is configured for the error + // code 404. If the request is for www.myotherdomain.com and a 404 is + // encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes + // effect. If a 404 response is encountered for the request + // www.example.com/current_events/, the pathMatcher's policy takes effect. If + // however, the request for www.example.com/coming_soon/ encounters a 404, the + // policy in RouteRule.customErrorResponsePolicy takes effect. If any of the + // requests in this example encounter a 500 error code, the policy at + // UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in + // conjunction with pathMatcher.defaultRouteAction.retryPolicy, retries take + // precedence. Only once all retries are exhausted, the + // defaultCustomErrorResponsePolicy is applied. While attempting a retry, if + // load balancer is successful in reaching the service, the + // defaultCustomErrorResponsePolicy is ignored and the response from the + // service is returned to the client. defaultCustomErrorResponsePolicy is + // supported only for global external Application Load Balancers. + optional CustomErrorResponsePolicy default_custom_error_response_policy = 9 + [json_name = "defaultCustomErrorResponsePolicy"]; + + // defaultRouteAction takes effect when none of the pathRules or routeRules + // match. The load balancer performs advanced routing actions, such as URL + // rewrites and header transformations, before forwarding the request to the + // selected backend. If defaultRouteAction specifies any + // weightedBackendServices, defaultService must not be set. Conversely if + // defaultService is set, defaultRouteAction cannot contain any + // weightedBackendServices. If defaultRouteAction is specified, don't set + // defaultUrlRedirect. If defaultRouteAction.weightedBackendServices is + // specified, don't set defaultService. URL maps for classic Application Load + // Balancers only support the urlRewrite action within a path matcher's + // defaultRouteAction. + optional HttpRouteAction default_route_action = 1 + [json_name = "defaultRouteAction"]; + + // The full or partial URL to the BackendService resource. This URL is used if + // none of the pathRules or routeRules defined by this PathMatcher are + // matched. For example, the following are all valid URLs to a BackendService + // resource: - https://www.googleapis.com/compute/v1/projects/project + // /global/backendServices/backendService - + // compute/v1/projects/project/global/backendServices/backendService - + // global/backendServices/backendService If defaultRouteAction is also + // specified, advanced routing actions, such as URL rewrites, take effect + // before sending the request to the backend. However, if defaultService is + // specified, defaultRouteAction cannot contain any weightedBackendServices. + // Conversely, if defaultRouteAction specifies any weightedBackendServices, + // defaultService must not be specified. If defaultService is specified, then + // set either defaultUrlRedirect or defaultRouteAction.weightedBackendService. + // Don't set both. Authorization requires one or more of the following Google + // IAM permissions on the specified resource default_service: - + // compute.backendBuckets.use - compute.backendServices.use + optional string default_service = 2 [json_name = "defaultService"]; + + // When none of the specified pathRules or routeRules match, the request is + // redirected to a URL specified by defaultUrlRedirect. If defaultUrlRedirect + // is specified, then set either defaultService or defaultRouteAction. Don't + // set both. Not supported when the URL map is bound to a target gRPC proxy. + optional HttpRedirectAction default_url_redirect = 3 + [json_name = "defaultUrlRedirect"]; // An optional description of this resource. Provide this property when you // create the resource. optional string description = 4 [json_name = "description"]; - // [Output Only] Commitment end time in RFC3339 text format. - optional string end_timestamp = 5 [json_name = "endTimestamp"]; + // Specifies changes to request and response headers that need to take effect + // for the selected backend service. HeaderAction specified here are applied + // after the matching HttpRouteRule HeaderAction and before the HeaderAction + // in the UrlMap HeaderAction is not supported for load balancers that have + // their loadBalancingScheme set to EXTERNAL. Not supported when the URL map + // is bound to a target gRPC proxy that has validateForProxyless field set to + // true. + optional HttpHeaderAction header_action = 5 [json_name = "headerAction"]; - // Specifies the already existing reservations to attach to the Commitment. - // This field is optional, and it can be a full or partial URL. For example, - // the following are valid URLs to an reservation: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /reservations/reservation - - // projects/project/zones/zone/reservations/reservation - repeated string existing_reservations = 21 - [json_name = "existingReservations"]; + // The name to which this PathMatcher is referred by the HostRule. + optional string name = 6 [json_name = "name"]; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 6 [json_name = "id"]; + // The list of path rules. Use this list instead of routeRules when routing + // based on simple path matching is all that's required. The order by which + // path rules are specified does not matter. Matches are always done on the + // longest-path-first basis. For example: a pathRule with a path /a/b/c/* will + // match before /a/b/* irrespective of the order in which those paths appear + // in this list. Within a given pathMatcher, only one of pathRules or + // routeRules must be set. + repeated PathRule path_rules = 7 [json_name = "pathRules"]; - // [Output Only] Type of the resource. Always compute#commitment for - // commitments. - optional string kind = 7 [json_name = "kind"]; + // The list of HTTP route rules. Use this list instead of pathRules when + // advanced route matching and routing actions are desired. routeRules are + // evaluated in order of priority, from the lowest to highest number. Within a + // given pathMatcher, you can set only one of pathRules or routeRules. + repeated HttpRouteRule route_rules = 8 [json_name = "routeRules"]; +} - // The license specification required as part of a license commitment. - optional LicenseResourceCommitment license_resource = 8 - [json_name = "licenseResource"]; +// A path-matching rule for a URL. If matched, will use the specified +// BackendService to handle the traffic arriving at this URL. +message PathRule { + // customErrorResponsePolicy specifies how the Load Balancer returns error + // responses when BackendServiceor BackendBucket responds with an error. If a + // policy for an error code is not configured for the PathRule, a policy for + // the error code configured in pathMatcher.defaultCustomErrorResponsePolicy + // is applied. If one is not specified in + // pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in + // UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider + // a UrlMap with the following configuration: - + // UrlMap.defaultCustomErrorResponsePolicy are configured with policies for + // 5xx and 4xx errors - A PathRule for /coming_soon/ is configured for the + // error code 404. If the request is for www.myotherdomain.com and a 404 is + // encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes + // effect. If a 404 response is encountered for the request + // www.example.com/current_events/, the pathMatcher's policy takes effect. If + // however, the request for www.example.com/coming_soon/ encounters a 404, the + // policy in PathRule.customErrorResponsePolicy takes effect. If any of the + // requests in this example encounter a 500 error code, the policy at + // UrlMap.defaultCustomErrorResponsePolicy takes effect. + // customErrorResponsePolicy is supported only for global external Application + // Load Balancers. + optional CustomErrorResponsePolicy custom_error_response_policy = 5 + [json_name = "customErrorResponsePolicy"]; - // List of source commitments to be merged into a new commitment. - repeated string merge_source_commitments = 9 - [json_name = "mergeSourceCommitments"]; + // The list of path patterns to match. Each must start with / and the only + // place a * is allowed is at the end following a /. The string fed to the + // path matcher does not include any text after the first ? or #, and those + // chars are not allowed here. + repeated string paths = 1 [json_name = "paths"]; - // 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. - optional string name = 10 [json_name = "name"]; + // In response to a matching path, the load balancer performs advanced routing + // actions, such as URL rewrites and header transformations, before forwarding + // the request to the selected backend. If routeAction specifies any + // weightedBackendServices, service must not be set. Conversely if service is + // set, routeAction cannot contain any weightedBackendServices. Only one of + // routeAction or urlRedirect must be set. URL maps for classic Application + // Load Balancers only support the urlRewrite action within a path rule's + // routeAction. + optional HttpRouteAction route_action = 2 [json_name = "routeAction"]; - // The plan for this commitment, which determines duration and discount rate. - // The currently supported plans are TWELVE_MONTH (1 year), and - // THIRTY_SIX_MONTH (3 years). - // INVALID: - // THIRTY_SIX_MONTH: - // TWELVE_MONTH: - optional string plan = 11 [json_name = "plan"]; + // The full or partial URL of the backend service resource to which traffic is + // directed if this rule is matched. If routeAction is also specified, + // advanced routing actions, such as URL rewrites, take effect before sending + // the request to the backend. However, if service is specified, routeAction + // cannot contain any weightedBackendServices. Conversely, if routeAction + // specifies any weightedBackendServices, service must not be specified. Only + // one of urlRedirect, service or routeAction.weightedBackendService must be + // set. + optional string service = 3 [json_name = "service"]; - // [Output Only] URL of the region where this commitment may be used. - optional string region = 12 [json_name = "region"]; + // When a path pattern is matched, the request is redirected to a URL + // specified by urlRedirect. If urlRedirect is specified, service or + // routeAction must not be set. Not supported when the URL map is bound to a + // target gRPC proxy. + optional HttpRedirectAction url_redirect = 4 [json_name = "urlRedirect"]; +} - // List of create-on-create reservations for this commitment. - repeated Reservation reservations = 13 [json_name = "reservations"]; +// A policy that specifies how requests intended for the route's backends are +// shadowed to a separate mirrored backend service. The load balancer doesn't +// wait for responses from the shadow service. Before sending traffic to the +// shadow service, the host or authority header is suffixed with -shadow. +message RequestMirrorPolicy { + // The full or partial URL to the BackendService resource being mirrored to. + // The backend service configured for a mirroring policy must reference + // backends that are of the same type as the original backend service matched + // in the URL map. Serverless NEG backends are not currently supported as a + // mirrored backend service. + optional string backend_service = 1 [json_name = "backendService"]; +} - // A list of commitment amounts for particular resources. Note that VCPU and - // MEMORY resource commitments must occur together. - repeated ResourceCommitment resources = 14 [json_name = "resources"]; +message TestFailure { + // The actual output URL evaluated by a load balancer containing the scheme, + // host, path and query parameters. + optional string actual_output_url = 1 [json_name = "actualOutputUrl"]; - // [Output Only] Server-defined URL for the resource. - optional string self_link = 15 [json_name = "selfLink"]; - - // Source commitment to be split into a new commitment. - optional string split_source_commitment = 16 - [json_name = "splitSourceCommitment"]; - - // [Output Only] Commitment start time in RFC3339 text format. - optional string start_timestamp = 17 [json_name = "startTimestamp"]; - - // [Output Only] Status of the commitment with regards to eventual expiration - // (each commitment has an end date defined). One of the following values: - // NOT_YET_ACTIVE, ACTIVE, EXPIRED. - // ACTIVE: - // CANCELLED: Deprecate CANCELED status. Will use separate status to - // differentiate cancel by mergeCud or manual cancellation. - // CREATING: - // EXPIRED: - // NOT_YET_ACTIVE: - optional string status = 18 [json_name = "status"]; - - // [Output Only] An optional, human-readable explanation of the status. - optional string status_message = 19 [json_name = "statusMessage"]; - - // The type of commitment, which affects the discount rate and the eligible - // resources. Type MEMORY_OPTIMIZED specifies a commitment that will only - // apply to memory optimized machines. Type ACCELERATOR_OPTIMIZED specifies a - // commitment that will only apply to accelerator optimized machines. - // ACCELERATOR_OPTIMIZED: - // ACCELERATOR_OPTIMIZED_A3: - // ACCELERATOR_OPTIMIZED_A3_MEGA: - // COMPUTE_OPTIMIZED: - // COMPUTE_OPTIMIZED_C2D: - // COMPUTE_OPTIMIZED_C3: - // COMPUTE_OPTIMIZED_C3D: - // COMPUTE_OPTIMIZED_H3: - // GENERAL_PURPOSE: - // GENERAL_PURPOSE_C4: - // GENERAL_PURPOSE_E2: - // GENERAL_PURPOSE_N2: - // GENERAL_PURPOSE_N2D: - // GENERAL_PURPOSE_N4: - // GENERAL_PURPOSE_T2D: - // GRAPHICS_OPTIMIZED: - // MEMORY_OPTIMIZED: - // MEMORY_OPTIMIZED_M3: - // STORAGE_OPTIMIZED_Z3: - // TYPE_UNSPECIFIED: - optional string type = 20 [json_name = "type"]; + // Actual HTTP status code for rule with `urlRedirect` calculated by load + // balancer + optional int32 actual_redirect_response_code = 2 + [json_name = "actualRedirectResponseCode"]; + + // BackendService or BackendBucket returned by load balancer. + optional string actual_service = 3 [json_name = "actualService"]; + + // The expected output URL evaluated by a load balancer containing the scheme, + // host, path and query parameters. + optional string expected_output_url = 4 [json_name = "expectedOutputUrl"]; + + // Expected HTTP status code for rule with `urlRedirect` calculated by load + // balancer + optional int32 expected_redirect_response_code = 5 + [json_name = "expectedRedirectResponseCode"]; + + // Expected BackendService or BackendBucket resource the given URL should be + // mapped to. + optional string expected_service = 6 [json_name = "expectedService"]; + + // HTTP headers of the request. + repeated UrlMapTestHeader headers = 7 [json_name = "headers"]; + + // Host portion of the URL. + optional string host = 8 [json_name = "host"]; + + // Path portion including query parameters in the URL. + optional string path = 9 [json_name = "path"]; } -message CommitmentAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; +// Represents a URL Map resource. Compute Engine has two URL Map resources: * +// [Global](/compute/docs/reference/rest/v1/urlMaps) * +// [Regional](/compute/docs/reference/rest/v1/regionUrlMaps) A URL map resource +// is a component of certain types of cloud load balancers and Traffic Director: +// * urlMaps are used by global external Application Load Balancers, classic +// Application Load Balancers, and cross-region internal Application Load +// Balancers. * regionUrlMaps are used by internal Application Load Balancers, +// regional external Application Load Balancers and regional internal +// Application Load Balancers. For a list of supported URL map features by the +// load balancer type, see the Load balancing features: Routing and traffic +// management table. For a list of supported URL map features for Traffic +// Director, see the Traffic Director features: Routing and traffic management +// table. This resource defines mappings from hostnames and URL paths to either +// a backend service or a backend bucket. To use the global urlMaps resource, +// the backend service must have a loadBalancingScheme of either EXTERNAL, +// EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use the regionUrlMaps +// resource, the backend service must have a loadBalancingScheme of +// INTERNAL_MANAGED. For more information, read URL Map Concepts. +message UrlMap { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // A list of CommitmentsScopedList resources. - map items = 2 [json_name = "items"]; + // defaultCustomErrorResponsePolicy specifies how the Load Balancer returns + // error responses when BackendServiceor BackendBucket responds with an error. + // This policy takes effect at the load balancer level and applies only when + // no policy has been defined for the error code at lower levels like + // PathMatcher, RouteRule and PathRule within this UrlMap. For example, + // consider a UrlMap with the following configuration: - + // defaultCustomErrorResponsePolicy containing policies for responding to 5xx + // and 4xx errors - A PathMatcher configured for *.example.com has + // defaultCustomErrorResponsePolicy for 4xx. If a request for + // http://www.example.com/ encounters a 404, the policy in + // pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the + // request for http://www.example.com/ encounters a 502, the policy in + // UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request + // that does not match any host in *.example.com such as + // http://www.myotherexample.com/, encounters a 404, + // UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in + // conjunction with defaultRouteAction.retryPolicy, retries take precedence. + // Only once all retries are exhausted, the defaultCustomErrorResponsePolicy + // is applied. While attempting a retry, if load balancer is successful in + // reaching the service, the defaultCustomErrorResponsePolicy is ignored and + // the response from the service is returned to the client. + // defaultCustomErrorResponsePolicy is supported only for global external + // Application Load Balancers. + optional CustomErrorResponsePolicy default_custom_error_response_policy = 16 + [json_name = "defaultCustomErrorResponsePolicy"]; - // [Output Only] Type of resource. Always compute#commitmentAggregatedList for - // aggregated lists of commitments. - optional string kind = 3 [json_name = "kind"]; + // defaultRouteAction takes effect when none of the hostRules match. The load + // balancer performs advanced routing actions, such as URL rewrites and header + // transformations, before forwarding the request to the selected backend. If + // defaultRouteAction specifies any weightedBackendServices, defaultService + // must not be set. Conversely if defaultService is set, defaultRouteAction + // cannot contain any weightedBackendServices. Only one of defaultRouteAction + // or defaultUrlRedirect must be set. URL maps for classic Application Load + // Balancers only support the urlRewrite action within defaultRouteAction. + // defaultRouteAction has no effect when the URL map is bound to a target gRPC + // proxy that has the validateForProxyless field set to true. + optional HttpRouteAction default_route_action = 2 + [json_name = "defaultRouteAction"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; + // The full or partial URL of the defaultService resource to which traffic is + // directed if none of the hostRules match. If defaultRouteAction is also + // specified, advanced routing actions, such as URL rewrites, take effect + // before sending the request to the backend. However, if defaultService is + // specified, defaultRouteAction cannot contain any + // defaultRouteAction.weightedBackendServices. Conversely, if + // defaultRouteAction specifies any + // defaultRouteAction.weightedBackendServices, defaultService must not be + // specified. If defaultService is specified, then set either + // defaultUrlRedirect , or defaultRouteAction.weightedBackendService Don't set + // both. defaultService has no effect when the URL map is bound to a target + // gRPC proxy that has the validateForProxyless field set to true. + optional string default_service = 3 [json_name = "defaultService"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // When none of the specified hostRules match, the request is redirected to a + // URL specified by defaultUrlRedirect. If defaultUrlRedirect is specified, + // defaultService or defaultRouteAction must not be set. Not supported when + // the URL map is bound to a target gRPC proxy. + optional HttpRedirectAction default_url_redirect = 4 + [json_name = "defaultUrlRedirect"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 5 [json_name = "description"]; - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; + // Fingerprint of this resource. A hash of the contents stored in this object. + // This field is used in optimistic locking. This field is ignored when + // inserting a UrlMap. An up-to-date fingerprint must be provided in order to + // update the UrlMap, otherwise the request will fail with error 412 + // conditionNotMet. To see the latest fingerprint, make a get() request to + // retrieve a UrlMap. + optional string fingerprint = 6 [json_name = "fingerprint"]; - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; + // Specifies changes to request and response headers that need to take effect + // for the selected backendService. The headerAction specified here take + // effect after headerAction specified under pathMatcher. headerAction is not + // supported for load balancers that have their loadBalancingScheme set to + // EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy + // that has validateForProxyless field set to true. + optional HttpHeaderAction header_action = 7 [json_name = "headerAction"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // The list of host rules to use against the URL. + repeated HostRule host_rules = 8 [json_name = "hostRules"]; - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 9 [json_name = "id"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // [Output Only] Type of the resource. Always compute#urlMaps for url maps. + optional string kind = 10 [json_name = "kind"]; - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + // 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. + optional string name = 11 [json_name = "name"]; + + // The list of named PathMatchers to use against the URL. + repeated PathMatcher path_matchers = 12 [json_name = "pathMatchers"]; + + // [Output Only] URL of the region where the regional URL map resides. This + // field is not applicable to global URL maps. You must specify this field as + // part of the HTTP request URL. It is not settable as a field in the request + // body. + optional string region = 13 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 14 [json_name = "selfLink"]; + + // The list of expected URL mapping tests. Request to update the UrlMap + // succeeds only if all test cases pass. You can specify a maximum of 100 + // tests per UrlMap. Not supported when the URL map is bound to a target gRPC + // proxy that has validateForProxyless field set to true. + repeated UrlMapTest tests = 15 [json_name = "tests"]; } -// Contains a list of Commitment resources. -message CommitmentList { +// Contains a list of UrlMap resources. +message UrlMapList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of Commitment resources. - repeated Commitment items = 2 [json_name = "items"]; + // A list of UrlMap resources. + repeated UrlMap items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#commitmentList for lists of - // commitments. + // Type of resource. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -375,127 +1092,134 @@ message CommitmentList { optional Warning warning = 6 [json_name = "warning"]; } -message CommitmentsScopedList { - // [Output Only] A list of commitments contained in this scope. - repeated Commitment commitments = 1 [json_name = "commitments"]; +// Message for the expected URL mappings. +message UrlMapTest { + // Description of this test case. + optional string description = 1 [json_name = "description"]; - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; + // The expected output URL evaluated by the load balancer containing the + // scheme, host, path and query parameters. For rules that forward requests to + // backends, the test passes only when expectedOutputUrl matches the request + // forwarded by the load balancer to backends. For rules with urlRewrite, the + // test verifies that the forwarded request matches hostRewrite and + // pathPrefixRewrite in the urlRewrite action. When service is specified, + // expectedOutputUrl`s scheme is ignored. For rules with urlRedirect, the test + // passes only if expectedOutputUrl matches the URL in the load balancer's + // redirect response. If urlRedirect specifies https_redirect, the test passes + // only if the scheme in expectedOutputUrl is also set to HTTPS. If + // urlRedirect specifies strip_query, the test passes only if + // expectedOutputUrl does not contain any query parameters. expectedOutputUrl + // is optional when service is specified. + optional string expected_output_url = 2 [json_name = "expectedOutputUrl"]; - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; + // For rules with urlRedirect, the test passes only if + // expectedRedirectResponseCode matches the HTTP status code in load + // balancer's redirect response. expectedRedirectResponseCode cannot be set + // when service is set. + optional int32 expected_redirect_response_code = 3 + [json_name = "expectedRedirectResponseCode"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // HTTP headers for this request. If headers contains a host header, then host + // must also match the header value. + repeated UrlMapTestHeader headers = 4 [json_name = "headers"]; - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; + // Host portion of the URL. If headers contains a host header, then host must + // also match the header value. + optional string host = 5 [json_name = "host"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // Path portion of the URL. + optional string path = 6 [json_name = "path"]; + + // Expected BackendService or BackendBucket resource the given URL should be + // mapped to. The service field cannot be set if expectedRedirectResponseCode + // is set. + optional string service = 7 [json_name = "service"]; +} + +// HTTP headers used in UrlMapTests. +message UrlMapTestHeader { + // Header name. + optional string name = 1 [json_name = "name"]; - // [Output Only] Informational warning which replaces the list of commitments - // when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // Header value. + optional string value = 2 [json_name = "value"]; } -// Commitment for a particular license resource. -message LicenseResourceCommitment { - // The number of licenses purchased. - optional string amount = 1 [json_name = "amount"]; +// Message representing the validation result for a UrlMap. +message UrlMapValidationResult { + repeated string load_errors = 1 [json_name = "loadErrors"]; - // Specifies the core range of the instance for which this license applies. - optional string cores_per_license = 2 [json_name = "coresPerLicense"]; + // Whether the given UrlMap can be successfully loaded. If false, 'loadErrors' + // indicates the reasons. + optional bool load_succeeded = 2 [json_name = "loadSucceeded"]; - // Any applicable license URI. - optional string license = 3 [json_name = "license"]; + repeated TestFailure test_failures = 3 [json_name = "testFailures"]; + + // If successfully loaded, this field indicates whether the test passed. If + // false, 'testFailures's indicate the reason of failure. + optional bool test_passed = 4 [json_name = "testPassed"]; +} + +message UrlMapsValidateResponse { + optional UrlMapValidationResult result = 1 [json_name = "result"]; } -// Commitment for a particular resource (a Commitment is composed of one or more -// of these). -message ResourceCommitment { - // Name of the accelerator type resource. Applicable only when the type is - // ACCELERATOR. - optional string accelerator_type = 1 [json_name = "acceleratorType"]; - - // The amount of the resource purchased (in a type-dependent unit, such as - // bytes). For vCPUs, this can just be an integer. For memory, this must be - // provided in MB. Memory must be a multiple of 256 MB, with up to 6.5GB of - // memory per every vCPU. - optional string amount = 2 [json_name = "amount"]; - - // Type of resource for which this commitment applies. Possible values are - // VCPU, MEMORY, LOCAL_SSD, and ACCELERATOR. - // ACCELERATOR: - // LOCAL_SSD: - // MEMORY: - // UNSPECIFIED: - // VCPU: - optional string type = 3 [json_name = "type"]; +// The spec for modifying the path before sending the request to the matched +// backend service. +message UrlRewrite { + // Before forwarding the request to the selected service, the request's host + // header is replaced with contents of hostRewrite. The value must be from 1 + // to 255 characters. + optional string host_rewrite = 1 [json_name = "hostRewrite"]; + + // Before forwarding the request to the selected backend service, the matching + // portion of the request's path is replaced by pathPrefixRewrite. The value + // must be from 1 to 1024 characters. + optional string path_prefix_rewrite = 2 [json_name = "pathPrefixRewrite"]; + + // If specified, the pattern rewrites the URL path (based on the :path + // header) using the HTTP template syntax. A corresponding path_template_match + // must be specified. Any template variables must exist in the + // path_template_match field. - -At least one variable must be specified in + // the path_template_match field - You can omit variables from the rewritten + // URL - The * and ** operators cannot be matched unless they have a + // corresponding variable name - e.g. {format=*} or {var=**}. For example, a + // path_template_match of /static/{format=**} could be rewritten as + // /static/content/{format} to prefix /content to the URL. Variables can also + // be re-ordered in a rewrite, so that /{country}/{format}/{suffix=**} can be + // rewritten as /content/{format}/{country}/{suffix}. At least one non-empty + // routeRules[].matchRules[].path_template_match is required. Only one of + // path_prefix_rewrite or path_template_rewrite may be specified. + optional string path_template_rewrite = 3 [json_name = "pathTemplateRewrite"]; +} + +// In contrast to a single BackendService in HttpRouteAction to which all +// matching traffic is directed to, WeightedBackendService allows traffic to be +// split across multiple backend services. The volume of traffic for each +// backend service is proportional to the weight specified in each +// WeightedBackendService +message WeightedBackendService { + // The full or partial URL to the default BackendService resource. Before + // forwarding the request to backendService, the load balancer applies any + // relevant headerActions specified as part of this backendServiceWeight. + optional string backend_service = 1 [json_name = "backendService"]; + + // Specifies changes to request and response headers that need to take effect + // for the selected backendService. headerAction specified here take effect + // before headerAction in the enclosing HttpRouteRule, PathMatcher and UrlMap. + // headerAction is not supported for load balancers that have their + // loadBalancingScheme set to EXTERNAL. Not supported when the URL map is + // bound to a target gRPC proxy that has validateForProxyless field set to + // true. + optional HttpHeaderAction header_action = 2 [json_name = "headerAction"]; + + // Specifies the fraction of traffic sent to a backend service, computed as + // weight / (sum of all weightedBackendService weights in routeAction) . The + // selection of a backend service is determined only for new traffic. Once a + // user's request has been directed to a backend service, subsequent requests + // are sent to the same backend service as determined by the backend service's + // session affinity policy. Don't configure session affinity if you're using + // weighted traffic splitting. If you do, the weighted traffic splitting + // configuration takes precedence. The value must be from 0 to 1000. + optional uint32 weight = 3 [json_name = "weight"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_020.proto b/protos/google/cloud/compute/v1/internal/common_020.proto index e06e4ac05e141..2d869ed788556 100644 --- a/protos/google/cloud/compute/v1/internal/common_020.proto +++ b/protos/google/cloud/compute/v1/internal/common_020.proto @@ -15,1211 +15,73 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_030.proto"; -import "google/cloud/compute/v1/internal/common_079.proto"; - -// The specification for allowing client-side cross-origin requests. For more -// information about the W3C recommendation for cross-origin resource sharing -// (CORS), see Fetch API Living Standard. -message CorsPolicy { - // In response to a preflight request, setting this to true indicates that the - // actual request can include user credentials. This field translates to the - // Access-Control-Allow-Credentials header. Default is false. - optional bool allow_credentials = 1 [json_name = "allowCredentials"]; - - // Specifies the content for the Access-Control-Allow-Headers header. - repeated string allow_headers = 2 [json_name = "allowHeaders"]; - - // Specifies the content for the Access-Control-Allow-Methods header. - repeated string allow_methods = 3 [json_name = "allowMethods"]; - - // Specifies a regular expression that matches allowed origins. For more - // information, see regular expression syntax . An origin is allowed if it - // matches either an item in allowOrigins or an item in allowOriginRegexes. - // Regular expressions can only be used when the loadBalancingScheme is set to - // INTERNAL_SELF_MANAGED. - repeated string allow_origin_regexes = 4 [json_name = "allowOriginRegexes"]; - - // Specifies the list of origins that is allowed to do CORS requests. An - // origin is allowed if it matches either an item in allowOrigins or an item - // in allowOriginRegexes. - repeated string allow_origins = 5 [json_name = "allowOrigins"]; - - // If true, disables the CORS policy. The default value is false, which - // indicates that the CORS policy is in effect. - optional bool disabled = 6 [json_name = "disabled"]; - - // Specifies the content for the Access-Control-Expose-Headers header. - repeated string expose_headers = 7 [json_name = "exposeHeaders"]; - - // Specifies how long results of a preflight request can be cached in seconds. - // This field translates to the Access-Control-Max-Age header. - optional int32 max_age = 8 [json_name = "maxAge"]; -} - -// Specifies the custom error response policy that must be applied when the -// backend service or backend bucket responds with an error. -message CustomErrorResponsePolicy { - // Specifies rules for returning error responses. In a given policy, if you - // specify rules for both a range of error codes as well as rules for specific - // error codes then rules with specific error codes have a higher priority. - // For example, assume that you configure a rule for 401 (Un-authorized) code, - // and another for all 4 series error codes (4XX). If the backend service - // returns a 401, then the rule for 401 will be applied. However if the - // backend service returns a 403, the rule for 4xx takes effect. - repeated CustomErrorResponsePolicyCustomErrorResponseRule - error_response_rules = 1 [json_name = "errorResponseRules"]; - - // The full or partial URL to the BackendBucket resource that contains the - // custom error content. Examples are: - - // https://www.googleapis.com/compute/v1/projects/project/global/backendBuckets/myBackendBucket - // - compute/v1/projects/project/global/backendBuckets/myBackendBucket - - // global/backendBuckets/myBackendBucket If errorService is not specified at - // lower levels like pathMatcher, pathRule and routeRule, an errorService - // specified at a higher level in the UrlMap will be used. If - // UrlMap.defaultCustomErrorResponsePolicy contains one or more - // errorResponseRules[], it must specify errorService. If load balancer cannot - // reach the backendBucket, a simple Not Found Error will be returned, with - // the original response code (or overrideResponseCode if configured). - // errorService is not supported for internal or regional HTTP/HTTPS load - // balancers. - optional string error_service = 2 [json_name = "errorService"]; -} - -// Specifies the mapping between the response code that will be returned along -// with the custom error content and the response code returned by the backend -// service. -message CustomErrorResponsePolicyCustomErrorResponseRule { - // Valid values include: - A number between 400 and 599: For example 401 or - // 503, in which case the load balancer applies the policy if the error code - // exactly matches this value. - 5xx: Load Balancer will apply the policy if - // the backend service responds with any response code in the range of 500 to - // 599. - 4xx: Load Balancer will apply the policy if the backend service - // responds with any response code in the range of 400 to 499. Values must be - // unique within matchResponseCodes and across all errorResponseRules of - // CustomErrorResponsePolicy. - repeated string match_response_codes = 1 [json_name = "matchResponseCodes"]; - - // The HTTP status code returned with the response containing the custom error - // content. If overrideResponseCode is not supplied, the same response code - // returned by the original backend bucket or backend service is returned to - // the client. - optional int32 override_response_code = 2 - [json_name = "overrideResponseCode"]; - - // The full path to a file within backendBucket . For example: - // /errors/defaultError.html path must start with a leading slash. path cannot - // have trailing slashes. If the file is not available in backendBucket or the - // load balancer cannot reach the BackendBucket, a simple Not Found Error is - // returned to the client. The value must be from 1 to 1024 characters - optional string path = 3 [json_name = "path"]; -} - -// UrlMaps A host-matching rule for a URL. If matched, will use the named -// PathMatcher to select the BackendService. -message HostRule { - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 1 [json_name = "description"]; - - // The list of host patterns to match. They must be valid hostnames with - // optional port numbers in the format host:port. * matches any string of - // ([a-z0-9-.]*). In that case, * must be the first character, and if followed - // by anything, the immediate following character must be either - or .. * - // based matching is not supported when the URL map is bound to a target gRPC - // proxy that has the validateForProxyless field set to true. - repeated string hosts = 2 [json_name = "hosts"]; - - // The name of the PathMatcher to use to match the path portion of the URL if - // the hostRule matches the URL's host portion. - optional string path_matcher = 3 [json_name = "pathMatcher"]; -} - -// Specification for how requests are aborted as part of fault injection. -message HttpFaultAbort { - // The HTTP status code used to abort the request. The value must be from 200 - // to 599 inclusive. For gRPC protocol, the gRPC status code is mapped to HTTP - // status code according to this mapping table. HTTP status 200 is mapped to - // gRPC status UNKNOWN. Injecting an OK status is currently not supported by - // Traffic Director. - optional uint32 http_status = 1 [json_name = "httpStatus"]; - - // The percentage of traffic for connections, operations, or requests that is - // aborted as part of fault injection. The value must be from 0.0 to 100.0 - // inclusive. - optional double percentage = 2 [json_name = "percentage"]; -} - -// Specifies the delay introduced by the load balancer before forwarding the -// request to the backend service as part of fault injection. -message HttpFaultDelay { - // Specifies the value of the fixed delay interval. - optional Duration fixed_delay = 1 [json_name = "fixedDelay"]; - - // The percentage of traffic for connections, operations, or requests for - // which a delay is introduced as part of fault injection. The value must be - // from 0.0 to 100.0 inclusive. - optional double percentage = 2 [json_name = "percentage"]; -} - -// The specification for fault injection introduced into traffic to test the -// resiliency of clients to backend service failure. As part of fault injection, -// when clients send requests to a backend service, delays can be introduced by -// the load balancer on a percentage of requests before sending those request to -// the backend service. Similarly requests from clients can be aborted by the -// load balancer for a percentage of requests. -message HttpFaultInjection { - // The specification for how client requests are aborted as part of fault - // injection. - optional HttpFaultAbort abort = 1 [json_name = "abort"]; - - // The specification for how client requests are delayed as part of fault - // injection, before being sent to a backend service. - optional HttpFaultDelay delay = 2 [json_name = "delay"]; -} - -// The request and response header transformations that take effect before the -// request is passed along to the selected backendService. -message HttpHeaderAction { - // Headers to add to a matching request before forwarding the request to the - // backendService. - repeated HttpHeaderOption request_headers_to_add = 1 - [json_name = "requestHeadersToAdd"]; - - // A list of header names for headers that need to be removed from the request - // before forwarding the request to the backendService. - repeated string request_headers_to_remove = 2 - [json_name = "requestHeadersToRemove"]; - - // Headers to add the response before sending the response back to the client. - repeated HttpHeaderOption response_headers_to_add = 3 - [json_name = "responseHeadersToAdd"]; - - // A list of header names for headers that need to be removed from the - // response before sending the response back to the client. - repeated string response_headers_to_remove = 4 - [json_name = "responseHeadersToRemove"]; -} - -// matchRule criteria for request header matches. -message HttpHeaderMatch { - // The value should exactly match contents of exactMatch. Only one of - // exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or - // rangeMatch must be set. - optional string exact_match = 1 [json_name = "exactMatch"]; - - // The name of the HTTP header to match. For matching against the HTTP - // request's authority, use a headerMatch with the header name ":authority". - // For matching a request's method, use the headerName ":method". When the URL - // map is bound to a target gRPC proxy that has the validateForProxyless field - // set to true, only non-binary user-specified custom metadata and the - // `content-type` header are supported. The following transport-level headers - // cannot be used in header matching rules: `:authority`, `:method`, `:path`, - // `:scheme`, `user-agent`, `accept-encoding`, `content-encoding`, - // `grpc-accept-encoding`, `grpc-encoding`, `grpc-previous-rpc-attempts`, - // `grpc-tags-bin`, `grpc-timeout` and `grpc-trace-bin`. - optional string header_name = 2 [json_name = "headerName"]; - - // If set to false, the headerMatch is considered a match if the preceding - // match criteria are met. If set to true, the headerMatch is considered a - // match if the preceding match criteria are NOT met. The default setting is - // false. - optional bool invert_match = 3 [json_name = "invertMatch"]; - - // The value of the header must start with the contents of prefixMatch. Only - // one of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or - // rangeMatch must be set. - optional string prefix_match = 4 [json_name = "prefixMatch"]; - - // A header with the contents of headerName must exist. The match takes place - // whether or not the request's header has a value. Only one of exactMatch, - // prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be - // set. - optional bool present_match = 5 [json_name = "presentMatch"]; - - // The header value must be an integer and its value must be in the range - // specified in rangeMatch. If the header does not contain an integer, number - // or is empty, the match fails. For example for a range [-5, 0] - -3 will - // match. - 0 will not match. - 0.25 will not match. - -3someString will not - // match. Only one of exactMatch, prefixMatch, suffixMatch, regexMatch, - // presentMatch or rangeMatch must be set. rangeMatch is not supported for - // load balancers that have loadBalancingScheme set to EXTERNAL. - optional Int64RangeMatch range_match = 6 [json_name = "rangeMatch"]; - - // The value of the header must match the regular expression specified in - // regexMatch. For more information about regular expression syntax, see - // Syntax. For matching against a port specified in the HTTP request, use a - // headerMatch with headerName set to PORT and a regular expression that - // satisfies the RFC2616 Host header's port specifier. Only one of exactMatch, - // prefixMatch, suffixMatch, regexMatch, presentMatch or rangeMatch must be - // set. Regular expressions can only be used when the loadBalancingScheme is - // set to INTERNAL_SELF_MANAGED. - optional string regex_match = 7 [json_name = "regexMatch"]; - - // The value of the header must end with the contents of suffixMatch. Only one - // of exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch or - // rangeMatch must be set. - optional string suffix_match = 8 [json_name = "suffixMatch"]; -} - -// Specification determining how headers are added to requests or responses. -message HttpHeaderOption { - // The name of the header. - optional string header_name = 1 [json_name = "headerName"]; - - // The value of the header to add. - optional string header_value = 2 [json_name = "headerValue"]; - - // If false, headerValue is appended to any values that already exist for the - // header. If true, headerValue is set for the header, discarding any values - // that were set for that header. The default value is false. - optional bool replace = 3 [json_name = "replace"]; -} - -// HttpRouteRuleMatch criteria for a request's query parameter. -message HttpQueryParameterMatch { - // The queryParameterMatch matches if the value of the parameter exactly - // matches the contents of exactMatch. Only one of presentMatch, exactMatch, - // or regexMatch must be set. - optional string exact_match = 1 [json_name = "exactMatch"]; - - // The name of the query parameter to match. The query parameter must exist in - // the request, in the absence of which the request match fails. - optional string name = 2 [json_name = "name"]; - - // Specifies that the queryParameterMatch matches if the request contains the - // query parameter, irrespective of whether the parameter has a value or not. - // Only one of presentMatch, exactMatch, or regexMatch must be set. - optional bool present_match = 3 [json_name = "presentMatch"]; - - // The queryParameterMatch matches if the value of the parameter matches the - // regular expression specified by regexMatch. For more information about - // regular expression syntax, see Syntax. Only one of presentMatch, - // exactMatch, or regexMatch must be set. Regular expressions can only be used - // when the loadBalancingScheme is set to INTERNAL_SELF_MANAGED. - optional string regex_match = 4 [json_name = "regexMatch"]; -} - -// Specifies settings for an HTTP redirect. -message HttpRedirectAction { - // The host that is used in the redirect response instead of the one that was - // supplied in the request. The value must be from 1 to 255 characters. - optional string host_redirect = 1 [json_name = "hostRedirect"]; - - // If set to true, the URL scheme in the redirected request is set to HTTPS. - // If set to false, the URL scheme of the redirected request remains the same - // as that of the request. This must only be set for URL maps used in - // TargetHttpProxys. Setting this true for TargetHttpsProxy is not permitted. - // The default is set to false. - optional bool https_redirect = 2 [json_name = "httpsRedirect"]; - - // The path that is used in the redirect response instead of the one that was - // supplied in the request. pathRedirect cannot be supplied together with - // prefixRedirect. Supply one alone or neither. If neither is supplied, the - // path of the original request is used for the redirect. The value must be - // from 1 to 1024 characters. - optional string path_redirect = 3 [json_name = "pathRedirect"]; - - // The prefix that replaces the prefixMatch specified in the - // HttpRouteRuleMatch, retaining the remaining portion of the URL before - // redirecting the request. prefixRedirect cannot be supplied together with - // pathRedirect. Supply one alone or neither. If neither is supplied, the path - // of the original request is used for the redirect. The value must be from 1 - // to 1024 characters. - optional string prefix_redirect = 4 [json_name = "prefixRedirect"]; - - // The HTTP Status code to use for this RedirectAction. Supported values are: - // - MOVED_PERMANENTLY_DEFAULT, which is the default value and corresponds to - // 301. - FOUND, which corresponds to 302. - SEE_OTHER which corresponds to - // 303. - TEMPORARY_REDIRECT, which corresponds to 307. In this case, the - // request method is retained. - PERMANENT_REDIRECT, which corresponds to 308. - // In this case, the request method is retained. - // FOUND: Http Status Code 302 - Found. - // MOVED_PERMANENTLY_DEFAULT: Http Status Code 301 - Moved Permanently. - // PERMANENT_REDIRECT: Http Status Code 308 - Permanent Redirect maintaining - // HTTP method. - // SEE_OTHER: Http Status Code 303 - See Other. - // TEMPORARY_REDIRECT: Http Status Code 307 - Temporary Redirect maintaining - // HTTP method. - optional string redirect_response_code = 5 - [json_name = "redirectResponseCode"]; - - // If set to true, any accompanying query portion of the original URL is - // removed before redirecting the request. If set to false, the query portion - // of the original URL is retained. The default is set to false. - optional bool strip_query = 6 [json_name = "stripQuery"]; -} - -// The retry policy associates with HttpRouteRule -message HttpRetryPolicy { - // Specifies the allowed number retries. This number must be > 0. If not - // specified, defaults to 1. - optional uint32 num_retries = 1 [json_name = "numRetries"]; - - // Specifies a non-zero timeout per retry attempt. If not specified, will use - // the timeout set in the HttpRouteAction field. If timeout in the - // HttpRouteAction field is not set, this field uses the largest timeout among - // all backend services associated with the route. Not supported when the URL - // map is bound to a target gRPC proxy that has the validateForProxyless field - // set to true. - optional Duration per_try_timeout = 2 [json_name = "perTryTimeout"]; - - // Specifies one or more conditions when this retry policy applies. Valid - // values are: - 5xx: retry is attempted if the instance or endpoint responds - // with any 5xx response code, or if the instance or endpoint does not respond - // at all. For example, disconnects, reset, read timeout, connection failure, - // and refused streams. - gateway-error: Similar to 5xx, but only applies to - // response codes 502, 503 or 504. - connect-failure: a retry is attempted on - // failures connecting to the instance or endpoint. For example, connection - // timeouts. - retriable-4xx: a retry is attempted if the instance or endpoint - // responds with a 4xx response code. The only error that you can retry is - // error code 409. - refused-stream: a retry is attempted if the instance or - // endpoint resets the stream with a REFUSED_STREAM error code. This reset - // type indicates that it is safe to retry. - cancelled: a retry is attempted - // if the gRPC status code in the response header is set to cancelled. - - // deadline-exceeded: a retry is attempted if the gRPC status code in the - // response header is set to deadline-exceeded. - internal: a retry is - // attempted if the gRPC status code in the response header is set to - // internal. - resource-exhausted: a retry is attempted if the gRPC status - // code in the response header is set to resource-exhausted. - unavailable: a - // retry is attempted if the gRPC status code in the response header is set to - // unavailable. Only the following codes are supported when the URL map is - // bound to target gRPC proxy that has validateForProxyless field set to true. - // - cancelled - deadline-exceeded - internal - resource-exhausted - - // unavailable - repeated string retry_conditions = 3 [json_name = "retryConditions"]; -} - -message HttpRouteAction { - // The specification for allowing client-side cross-origin requests. For more - // information about the W3C recommendation for cross-origin resource sharing - // (CORS), see Fetch API Living Standard. Not supported when the URL map is - // bound to a target gRPC proxy. - optional CorsPolicy cors_policy = 1 [json_name = "corsPolicy"]; - - // The specification for fault injection introduced into traffic to test the - // resiliency of clients to backend service failure. As part of fault - // injection, when clients send requests to a backend service, delays can be - // introduced by a load balancer on a percentage of requests before sending - // those requests to the backend service. Similarly requests from clients can - // be aborted by the load balancer for a percentage of requests. timeout and - // retry_policy is ignored by clients that are configured with a - // fault_injection_policy if: 1. The traffic is generated by fault injection - // AND 2. The fault injection is not a delay fault injection. Fault injection - // is not supported with the classic Application Load Balancer . To see which - // load balancers support fault injection, see Load balancing: Routing and - // traffic management features. - optional HttpFaultInjection fault_injection_policy = 2 - [json_name = "faultInjectionPolicy"]; - - // Specifies the maximum duration (timeout) for streams on the selected route. - // Unlike the timeout field where the timeout duration starts from the time - // the request has been fully processed (known as *end-of-stream*), the - // duration in this field is computed from the beginning of the stream until - // the response has been processed, including all retries. A stream that does - // not complete in this duration is closed. If not specified, this field uses - // the maximum maxStreamDuration value among all backend services associated - // with the route. This field is only allowed if the Url map is used with - // backend services with loadBalancingScheme set to INTERNAL_SELF_MANAGED. - optional Duration max_stream_duration = 3 [json_name = "maxStreamDuration"]; - - // Specifies the policy on how requests intended for the route's backends are - // shadowed to a separate mirrored backend service. The load balancer does not - // wait for responses from the shadow service. Before sending traffic to the - // shadow service, the host / authority header is suffixed with -shadow. Not - // supported when the URL map is bound to a target gRPC proxy that has the - // validateForProxyless field set to true. - optional RequestMirrorPolicy request_mirror_policy = 4 - [json_name = "requestMirrorPolicy"]; - - // Specifies the retry policy associated with this route. - optional HttpRetryPolicy retry_policy = 5 [json_name = "retryPolicy"]; - - // Specifies the timeout for the selected route. Timeout is computed from the - // time the request has been fully processed (known as *end-of-stream*) up - // until the response has been processed. Timeout includes all retries. If not - // specified, this field uses the largest timeout among all backend services - // associated with the route. Not supported when the URL map is bound to a - // target gRPC proxy that has validateForProxyless field set to true. - optional Duration timeout = 6 [json_name = "timeout"]; - - // The spec to modify the URL of the request, before forwarding the request to - // the matched service. urlRewrite is the only action supported in UrlMaps for - // classic Application Load Balancers. Not supported when the URL map is bound - // to a target gRPC proxy that has the validateForProxyless field set to true. - optional UrlRewrite url_rewrite = 7 [json_name = "urlRewrite"]; - - // A list of weighted backend services to send traffic to when a route match - // occurs. The weights determine the fraction of traffic that flows to their - // corresponding backend service. If all traffic needs to go to a single - // backend service, there must be one weightedBackendService with weight set - // to a non-zero number. After a backend service is identified and before - // forwarding the request to the backend service, advanced routing actions - // such as URL rewrites and header transformations are applied depending on - // additional settings specified in this HttpRouteAction. - repeated WeightedBackendService weighted_backend_services = 8 - [json_name = "weightedBackendServices"]; -} - -// The HttpRouteRule setting specifies how to match an HTTP request and the -// corresponding routing action that load balancing proxies perform. -message HttpRouteRule { - // customErrorResponsePolicy specifies how the Load Balancer returns error - // responses when BackendServiceor BackendBucket responds with an error. If a - // policy for an error code is not configured for the RouteRule, a policy for - // the error code configured in pathMatcher.defaultCustomErrorResponsePolicy - // is applied. If one is not specified in - // pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in - // UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider - // a UrlMap with the following configuration: - - // UrlMap.defaultCustomErrorResponsePolicy are configured with policies for - // 5xx and 4xx errors - A RouteRule for /coming_soon/ is configured for the - // error code 404. If the request is for www.myotherdomain.com and a 404 is - // encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes - // effect. If a 404 response is encountered for the request - // www.example.com/current_events/, the pathMatcher's policy takes effect. If - // however, the request for www.example.com/coming_soon/ encounters a 404, the - // policy in RouteRule.customErrorResponsePolicy takes effect. If any of the - // requests in this example encounter a 500 error code, the policy at - // UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in - // conjunction with routeRules.routeAction.retryPolicy, retries take - // precedence. Only once all retries are exhausted, the - // customErrorResponsePolicy is applied. While attempting a retry, if load - // balancer is successful in reaching the service, the - // customErrorResponsePolicy is ignored and the response from the service is - // returned to the client. customErrorResponsePolicy is supported only for - // global external Application Load Balancers. - optional CustomErrorResponsePolicy custom_error_response_policy = 8 - [json_name = "customErrorResponsePolicy"]; - - // The short description conveying the intent of this routeRule. The - // description can have a maximum length of 1024 characters. - optional string description = 1 [json_name = "description"]; - - // Specifies changes to request and response headers that need to take effect - // for the selected backendService. The headerAction value specified here is - // applied before the matching pathMatchers[].headerAction and after - // pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction - // HeaderAction is not supported for load balancers that have their - // loadBalancingScheme set to EXTERNAL. Not supported when the URL map is - // bound to a target gRPC proxy that has validateForProxyless field set to - // true. - optional HttpHeaderAction header_action = 2 [json_name = "headerAction"]; - - // The list of criteria for matching attributes of a request to this - // routeRule. This list has OR semantics: the request matches this routeRule - // when any of the matchRules are satisfied. However predicates within a given - // matchRule have AND semantics. All predicates within a matchRule must match - // for the request to match the rule. - repeated HttpRouteRuleMatch match_rules = 3 [json_name = "matchRules"]; - - // For routeRules within a given pathMatcher, priority determines the order in - // which a load balancer interprets routeRules. RouteRules are evaluated in - // order of priority, from the lowest to highest number. The priority of a - // rule decreases as its number increases (1, 2, 3, N+1). The first rule that - // matches the request is applied. You cannot configure two or more routeRules - // with the same priority. Priority for each rule must be set to a number from - // 0 to 2147483647 inclusive. Priority numbers can have gaps, which enable you - // to add or remove rules in the future without affecting the rest of the - // rules. For example, 1, 2, 3, 4, 5, 9, 12, 16 is a valid series of priority - // numbers to which you could add rules numbered from 6 to 8, 10 to 11, and 13 - // to 15 in the future without any impact on existing rules. - optional int32 priority = 4 [json_name = "priority"]; - - // In response to a matching matchRule, the load balancer performs advanced - // routing actions, such as URL rewrites and header transformations, before - // forwarding the request to the selected backend. If routeAction specifies - // any weightedBackendServices, service must not be set. Conversely if service - // is set, routeAction cannot contain any weightedBackendServices. Only one of - // urlRedirect, service or routeAction.weightedBackendService must be set. URL - // maps for classic Application Load Balancers only support the urlRewrite - // action within a route rule's routeAction. - optional HttpRouteAction route_action = 5 [json_name = "routeAction"]; - - // The full or partial URL of the backend service resource to which traffic is - // directed if this rule is matched. If routeAction is also specified, - // advanced routing actions, such as URL rewrites, take effect before sending - // the request to the backend. However, if service is specified, routeAction - // cannot contain any weightedBackendServices. Conversely, if routeAction - // specifies any weightedBackendServices, service must not be specified. Only - // one of urlRedirect, service or routeAction.weightedBackendService must be - // set. - optional string service = 6 [json_name = "service"]; - - // When this rule is matched, the request is redirected to a URL specified by - // urlRedirect. If urlRedirect is specified, service or routeAction must not - // be set. Not supported when the URL map is bound to a target gRPC proxy. - optional HttpRedirectAction url_redirect = 7 [json_name = "urlRedirect"]; -} - -// HttpRouteRuleMatch specifies a set of criteria for matching requests to an -// HttpRouteRule. All specified criteria must be satisfied for a match to occur. -message HttpRouteRuleMatch { - // For satisfying the matchRule condition, the path of the request must - // exactly match the value specified in fullPathMatch after removing any query - // parameters and anchor that may be part of the original URL. fullPathMatch - // must be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch - // or regexMatch must be specified. - optional string full_path_match = 1 [json_name = "fullPathMatch"]; - - // Specifies a list of header match criteria, all of which must match - // corresponding headers in the request. - repeated HttpHeaderMatch header_matches = 2 [json_name = "headerMatches"]; - - // Specifies that prefixMatch and fullPathMatch matches are case sensitive. - // The default value is false. ignoreCase must not be used with regexMatch. - // Not supported when the URL map is bound to a target gRPC proxy. - optional bool ignore_case = 3 [json_name = "ignoreCase"]; - - // Opaque filter criteria used by the load balancer to restrict routing - // configuration to a limited set of xDS compliant clients. In their xDS - // requests to the load balancer, xDS clients present node metadata. When - // there is a match, the relevant routing configuration is made available to - // those proxies. For each metadataFilter in this list, if its - // filterMatchCriteria is set to MATCH_ANY, at least one of the filterLabels - // must match the corresponding label provided in the metadata. If its - // filterMatchCriteria is set to MATCH_ALL, then all of its filterLabels must - // match with corresponding labels provided in the metadata. If multiple - // metadata filters are specified, all of them need to be satisfied in order - // to be considered a match. metadataFilters specified here is applied after - // those specified in ForwardingRule that refers to the UrlMap this - // HttpRouteRuleMatch belongs to. metadataFilters only applies to load - // balancers that have loadBalancingScheme set to INTERNAL_SELF_MANAGED. Not - // supported when the URL map is bound to a target gRPC proxy that has - // validateForProxyless field set to true. - repeated MetadataFilter metadata_filters = 4 [json_name = "metadataFilters"]; - - // If specified, the route is a pattern match expression that must match the - // :path header once the query string is removed. A pattern match allows you - // to match - The value must be between 1 and 1024 characters - The pattern - // must start with a leading slash ("/") - There may be no more than 5 - // operators in pattern Precisely one of prefix_match, full_path_match, - // regex_match or path_template_match must be set. - optional string path_template_match = 8 [json_name = "pathTemplateMatch"]; - - // For satisfying the matchRule condition, the request's path must begin with - // the specified prefixMatch. prefixMatch must begin with a /. The value must - // be from 1 to 1024 characters. Only one of prefixMatch, fullPathMatch or - // regexMatch must be specified. - optional string prefix_match = 5 [json_name = "prefixMatch"]; - - // Specifies a list of query parameter match criteria, all of which must match - // corresponding query parameters in the request. Not supported when the URL - // map is bound to a target gRPC proxy. - repeated HttpQueryParameterMatch query_parameter_matches = 6 - [json_name = "queryParameterMatches"]; - - // For satisfying the matchRule condition, the path of the request must - // satisfy the regular expression specified in regexMatch after removing any - // query parameters and anchor supplied with the original URL. For more - // information about regular expression syntax, see Syntax. Only one of - // prefixMatch, fullPathMatch or regexMatch must be specified. Regular - // expressions can only be used when the loadBalancingScheme is set to - // INTERNAL_SELF_MANAGED. - optional string regex_match = 7 [json_name = "regexMatch"]; -} - -// HttpRouteRuleMatch criteria for field values that must stay within the -// specified integer range. -message Int64RangeMatch { - // The end of the range (exclusive) in signed long integer format. - optional string range_end = 1 [json_name = "rangeEnd"]; - - // The start of the range (inclusive) in signed long integer format. - optional string range_start = 2 [json_name = "rangeStart"]; -} - -// A matcher for the path portion of the URL. The BackendService from the -// longest-matched rule will serve the URL. If no rule was matched, the default -// service is used. -message PathMatcher { - // defaultCustomErrorResponsePolicy specifies how the Load Balancer returns - // error responses when BackendServiceor BackendBucket responds with an error. - // This policy takes effect at the PathMatcher level and applies only when no - // policy has been defined for the error code at lower levels like RouteRule - // and PathRule within this PathMatcher. If an error code does not have a - // policy defined in defaultCustomErrorResponsePolicy, then a policy defined - // for the error code in UrlMap.defaultCustomErrorResponsePolicy takes effect. - // For example, consider a UrlMap with the following configuration: - - // UrlMap.defaultCustomErrorResponsePolicy is configured with policies for 5xx - // and 4xx errors - A RouteRule for /coming_soon/ is configured for the error - // code 404. If the request is for www.myotherdomain.com and a 404 is - // encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes - // effect. If a 404 response is encountered for the request - // www.example.com/current_events/, the pathMatcher's policy takes effect. If - // however, the request for www.example.com/coming_soon/ encounters a 404, the - // policy in RouteRule.customErrorResponsePolicy takes effect. If any of the - // requests in this example encounter a 500 error code, the policy at - // UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in - // conjunction with pathMatcher.defaultRouteAction.retryPolicy, retries take - // precedence. Only once all retries are exhausted, the - // defaultCustomErrorResponsePolicy is applied. While attempting a retry, if - // load balancer is successful in reaching the service, the - // defaultCustomErrorResponsePolicy is ignored and the response from the - // service is returned to the client. defaultCustomErrorResponsePolicy is - // supported only for global external Application Load Balancers. - optional CustomErrorResponsePolicy default_custom_error_response_policy = 9 - [json_name = "defaultCustomErrorResponsePolicy"]; - - // defaultRouteAction takes effect when none of the pathRules or routeRules - // match. The load balancer performs advanced routing actions, such as URL - // rewrites and header transformations, before forwarding the request to the - // selected backend. If defaultRouteAction specifies any - // weightedBackendServices, defaultService must not be set. Conversely if - // defaultService is set, defaultRouteAction cannot contain any - // weightedBackendServices. If defaultRouteAction is specified, don't set - // defaultUrlRedirect. If defaultRouteAction.weightedBackendServices is - // specified, don't set defaultService. URL maps for classic Application Load - // Balancers only support the urlRewrite action within a path matcher's - // defaultRouteAction. - optional HttpRouteAction default_route_action = 1 - [json_name = "defaultRouteAction"]; - - // The full or partial URL to the BackendService resource. This URL is used if - // none of the pathRules or routeRules defined by this PathMatcher are - // matched. For example, the following are all valid URLs to a BackendService - // resource: - https://www.googleapis.com/compute/v1/projects/project - // /global/backendServices/backendService - - // compute/v1/projects/project/global/backendServices/backendService - - // global/backendServices/backendService If defaultRouteAction is also - // specified, advanced routing actions, such as URL rewrites, take effect - // before sending the request to the backend. However, if defaultService is - // specified, defaultRouteAction cannot contain any weightedBackendServices. - // Conversely, if defaultRouteAction specifies any weightedBackendServices, - // defaultService must not be specified. If defaultService is specified, then - // set either defaultUrlRedirect or defaultRouteAction.weightedBackendService. - // Don't set both. Authorization requires one or more of the following Google - // IAM permissions on the specified resource default_service: - - // compute.backendBuckets.use - compute.backendServices.use - optional string default_service = 2 [json_name = "defaultService"]; - - // When none of the specified pathRules or routeRules match, the request is - // redirected to a URL specified by defaultUrlRedirect. If defaultUrlRedirect - // is specified, then set either defaultService or defaultRouteAction. Don't - // set both. Not supported when the URL map is bound to a target gRPC proxy. - optional HttpRedirectAction default_url_redirect = 3 - [json_name = "defaultUrlRedirect"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 4 [json_name = "description"]; - - // Specifies changes to request and response headers that need to take effect - // for the selected backend service. HeaderAction specified here are applied - // after the matching HttpRouteRule HeaderAction and before the HeaderAction - // in the UrlMap HeaderAction is not supported for load balancers that have - // their loadBalancingScheme set to EXTERNAL. Not supported when the URL map - // is bound to a target gRPC proxy that has validateForProxyless field set to - // true. - optional HttpHeaderAction header_action = 5 [json_name = "headerAction"]; - - // The name to which this PathMatcher is referred by the HostRule. - optional string name = 6 [json_name = "name"]; - - // The list of path rules. Use this list instead of routeRules when routing - // based on simple path matching is all that's required. The order by which - // path rules are specified does not matter. Matches are always done on the - // longest-path-first basis. For example: a pathRule with a path /a/b/c/* will - // match before /a/b/* irrespective of the order in which those paths appear - // in this list. Within a given pathMatcher, only one of pathRules or - // routeRules must be set. - repeated PathRule path_rules = 7 [json_name = "pathRules"]; - - // The list of HTTP route rules. Use this list instead of pathRules when - // advanced route matching and routing actions are desired. routeRules are - // evaluated in order of priority, from the lowest to highest number. Within a - // given pathMatcher, you can set only one of pathRules or routeRules. - repeated HttpRouteRule route_rules = 8 [json_name = "routeRules"]; -} - -// A path-matching rule for a URL. If matched, will use the specified -// BackendService to handle the traffic arriving at this URL. -message PathRule { - // customErrorResponsePolicy specifies how the Load Balancer returns error - // responses when BackendServiceor BackendBucket responds with an error. If a - // policy for an error code is not configured for the PathRule, a policy for - // the error code configured in pathMatcher.defaultCustomErrorResponsePolicy - // is applied. If one is not specified in - // pathMatcher.defaultCustomErrorResponsePolicy, the policy configured in - // UrlMap.defaultCustomErrorResponsePolicy takes effect. For example, consider - // a UrlMap with the following configuration: - - // UrlMap.defaultCustomErrorResponsePolicy are configured with policies for - // 5xx and 4xx errors - A PathRule for /coming_soon/ is configured for the - // error code 404. If the request is for www.myotherdomain.com and a 404 is - // encountered, the policy under UrlMap.defaultCustomErrorResponsePolicy takes - // effect. If a 404 response is encountered for the request - // www.example.com/current_events/, the pathMatcher's policy takes effect. If - // however, the request for www.example.com/coming_soon/ encounters a 404, the - // policy in PathRule.customErrorResponsePolicy takes effect. If any of the - // requests in this example encounter a 500 error code, the policy at - // UrlMap.defaultCustomErrorResponsePolicy takes effect. - // customErrorResponsePolicy is supported only for global external Application - // Load Balancers. - optional CustomErrorResponsePolicy custom_error_response_policy = 5 - [json_name = "customErrorResponsePolicy"]; - - // The list of path patterns to match. Each must start with / and the only - // place a * is allowed is at the end following a /. The string fed to the - // path matcher does not include any text after the first ? or #, and those - // chars are not allowed here. - repeated string paths = 1 [json_name = "paths"]; - - // In response to a matching path, the load balancer performs advanced routing - // actions, such as URL rewrites and header transformations, before forwarding - // the request to the selected backend. If routeAction specifies any - // weightedBackendServices, service must not be set. Conversely if service is - // set, routeAction cannot contain any weightedBackendServices. Only one of - // routeAction or urlRedirect must be set. URL maps for classic Application - // Load Balancers only support the urlRewrite action within a path rule's - // routeAction. - optional HttpRouteAction route_action = 2 [json_name = "routeAction"]; - - // The full or partial URL of the backend service resource to which traffic is - // directed if this rule is matched. If routeAction is also specified, - // advanced routing actions, such as URL rewrites, take effect before sending - // the request to the backend. However, if service is specified, routeAction - // cannot contain any weightedBackendServices. Conversely, if routeAction - // specifies any weightedBackendServices, service must not be specified. Only - // one of urlRedirect, service or routeAction.weightedBackendService must be - // set. - optional string service = 3 [json_name = "service"]; - - // When a path pattern is matched, the request is redirected to a URL - // specified by urlRedirect. If urlRedirect is specified, service or - // routeAction must not be set. Not supported when the URL map is bound to a - // target gRPC proxy. - optional HttpRedirectAction url_redirect = 4 [json_name = "urlRedirect"]; -} - -// A policy that specifies how requests intended for the route's backends are -// shadowed to a separate mirrored backend service. The load balancer doesn't -// wait for responses from the shadow service. Before sending traffic to the -// shadow service, the host or authority header is suffixed with -shadow. -message RequestMirrorPolicy { - // The full or partial URL to the BackendService resource being mirrored to. - // The backend service configured for a mirroring policy must reference - // backends that are of the same type as the original backend service matched - // in the URL map. Serverless NEG backends are not currently supported as a - // mirrored backend service. - optional string backend_service = 1 [json_name = "backendService"]; -} - -message TestFailure { - // The actual output URL evaluated by a load balancer containing the scheme, - // host, path and query parameters. - optional string actual_output_url = 1 [json_name = "actualOutputUrl"]; - - // Actual HTTP status code for rule with `urlRedirect` calculated by load - // balancer - optional int32 actual_redirect_response_code = 2 - [json_name = "actualRedirectResponseCode"]; - - // BackendService or BackendBucket returned by load balancer. - optional string actual_service = 3 [json_name = "actualService"]; - - // The expected output URL evaluated by a load balancer containing the scheme, - // host, path and query parameters. - optional string expected_output_url = 4 [json_name = "expectedOutputUrl"]; - - // Expected HTTP status code for rule with `urlRedirect` calculated by load - // balancer - optional int32 expected_redirect_response_code = 5 - [json_name = "expectedRedirectResponseCode"]; - - // Expected BackendService or BackendBucket resource the given URL should be - // mapped to. - optional string expected_service = 6 [json_name = "expectedService"]; - - // HTTP headers of the request. - repeated UrlMapTestHeader headers = 7 [json_name = "headers"]; - - // Host portion of the URL. - optional string host = 8 [json_name = "host"]; - - // Path portion including query parameters in the URL. - optional string path = 9 [json_name = "path"]; -} - -// Represents a URL Map resource. Compute Engine has two URL Map resources: * -// [Global](/compute/docs/reference/rest/v1/urlMaps) * -// [Regional](/compute/docs/reference/rest/v1/regionUrlMaps) A URL map resource -// is a component of certain types of cloud load balancers and Traffic Director: -// * urlMaps are used by global external Application Load Balancers, classic -// Application Load Balancers, and cross-region internal Application Load -// Balancers. * regionUrlMaps are used by internal Application Load Balancers, -// regional external Application Load Balancers and regional internal -// Application Load Balancers. For a list of supported URL map features by the -// load balancer type, see the Load balancing features: Routing and traffic -// management table. For a list of supported URL map features for Traffic -// Director, see the Traffic Director features: Routing and traffic management -// table. This resource defines mappings from hostnames and URL paths to either -// a backend service or a backend bucket. To use the global urlMaps resource, -// the backend service must have a loadBalancingScheme of either EXTERNAL or -// INTERNAL_SELF_MANAGED. To use the regionUrlMaps resource, the backend service -// must have a loadBalancingScheme of INTERNAL_MANAGED. For more information, -// read URL Map Concepts. -message UrlMap { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // defaultCustomErrorResponsePolicy specifies how the Load Balancer returns - // error responses when BackendServiceor BackendBucket responds with an error. - // This policy takes effect at the load balancer level and applies only when - // no policy has been defined for the error code at lower levels like - // PathMatcher, RouteRule and PathRule within this UrlMap. For example, - // consider a UrlMap with the following configuration: - - // defaultCustomErrorResponsePolicy containing policies for responding to 5xx - // and 4xx errors - A PathMatcher configured for *.example.com has - // defaultCustomErrorResponsePolicy for 4xx. If a request for - // http://www.example.com/ encounters a 404, the policy in - // pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the - // request for http://www.example.com/ encounters a 502, the policy in - // UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request - // that does not match any host in *.example.com such as - // http://www.myotherexample.com/, encounters a 404, - // UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in - // conjunction with defaultRouteAction.retryPolicy, retries take precedence. - // Only once all retries are exhausted, the defaultCustomErrorResponsePolicy - // is applied. While attempting a retry, if load balancer is successful in - // reaching the service, the defaultCustomErrorResponsePolicy is ignored and - // the response from the service is returned to the client. - // defaultCustomErrorResponsePolicy is supported only for global external - // Application Load Balancers. - optional CustomErrorResponsePolicy default_custom_error_response_policy = 16 - [json_name = "defaultCustomErrorResponsePolicy"]; - - // defaultRouteAction takes effect when none of the hostRules match. The load - // balancer performs advanced routing actions, such as URL rewrites and header - // transformations, before forwarding the request to the selected backend. If - // defaultRouteAction specifies any weightedBackendServices, defaultService - // must not be set. Conversely if defaultService is set, defaultRouteAction - // cannot contain any weightedBackendServices. Only one of defaultRouteAction - // or defaultUrlRedirect must be set. URL maps for classic Application Load - // Balancers only support the urlRewrite action within defaultRouteAction. - // defaultRouteAction has no effect when the URL map is bound to a target gRPC - // proxy that has the validateForProxyless field set to true. - optional HttpRouteAction default_route_action = 2 - [json_name = "defaultRouteAction"]; - - // The full or partial URL of the defaultService resource to which traffic is - // directed if none of the hostRules match. If defaultRouteAction is also - // specified, advanced routing actions, such as URL rewrites, take effect - // before sending the request to the backend. However, if defaultService is - // specified, defaultRouteAction cannot contain any - // defaultRouteAction.weightedBackendServices. Conversely, if - // defaultRouteAction specifies any - // defaultRouteAction.weightedBackendServices, defaultService must not be - // specified. If defaultService is specified, then set either - // defaultUrlRedirect , or defaultRouteAction.weightedBackendService Don't set - // both. defaultService has no effect when the URL map is bound to a target - // gRPC proxy that has the validateForProxyless field set to true. - optional string default_service = 3 [json_name = "defaultService"]; - - // When none of the specified hostRules match, the request is redirected to a - // URL specified by defaultUrlRedirect. If defaultUrlRedirect is specified, - // defaultService or defaultRouteAction must not be set. Not supported when - // the URL map is bound to a target gRPC proxy. - optional HttpRedirectAction default_url_redirect = 4 - [json_name = "defaultUrlRedirect"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 5 [json_name = "description"]; - - // Fingerprint of this resource. A hash of the contents stored in this object. - // This field is used in optimistic locking. This field is ignored when - // inserting a UrlMap. An up-to-date fingerprint must be provided in order to - // update the UrlMap, otherwise the request will fail with error 412 - // conditionNotMet. To see the latest fingerprint, make a get() request to - // retrieve a UrlMap. - optional string fingerprint = 6 [json_name = "fingerprint"]; - - // Specifies changes to request and response headers that need to take effect - // for the selected backendService. The headerAction specified here take - // effect after headerAction specified under pathMatcher. headerAction is not - // supported for load balancers that have their loadBalancingScheme set to - // EXTERNAL. Not supported when the URL map is bound to a target gRPC proxy - // that has validateForProxyless field set to true. - optional HttpHeaderAction header_action = 7 [json_name = "headerAction"]; - - // The list of host rules to use against the URL. - repeated HostRule host_rules = 8 [json_name = "hostRules"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 9 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#urlMaps for url maps. - optional string kind = 10 [json_name = "kind"]; - - // 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. - optional string name = 11 [json_name = "name"]; - - // The list of named PathMatchers to use against the URL. - repeated PathMatcher path_matchers = 12 [json_name = "pathMatchers"]; - - // [Output Only] URL of the region where the regional URL map resides. This - // field is not applicable to global URL maps. You must specify this field as - // part of the HTTP request URL. It is not settable as a field in the request - // body. - optional string region = 13 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 14 [json_name = "selfLink"]; - - // The list of expected URL mapping tests. Request to update the UrlMap - // succeeds only if all test cases pass. You can specify a maximum of 100 - // tests per UrlMap. Not supported when the URL map is bound to a target gRPC - // proxy that has validateForProxyless field set to true. - repeated UrlMapTest tests = 15 [json_name = "tests"]; -} - -// Contains a list of UrlMap resources. -message UrlMapList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of UrlMap resources. - repeated UrlMap items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// Message for the expected URL mappings. -message UrlMapTest { - // Description of this test case. - optional string description = 1 [json_name = "description"]; - - // The expected output URL evaluated by the load balancer containing the - // scheme, host, path and query parameters. For rules that forward requests to - // backends, the test passes only when expectedOutputUrl matches the request - // forwarded by the load balancer to backends. For rules with urlRewrite, the - // test verifies that the forwarded request matches hostRewrite and - // pathPrefixRewrite in the urlRewrite action. When service is specified, - // expectedOutputUrl`s scheme is ignored. For rules with urlRedirect, the test - // passes only if expectedOutputUrl matches the URL in the load balancer's - // redirect response. If urlRedirect specifies https_redirect, the test passes - // only if the scheme in expectedOutputUrl is also set to HTTPS. If - // urlRedirect specifies strip_query, the test passes only if - // expectedOutputUrl does not contain any query parameters. expectedOutputUrl - // is optional when service is specified. - optional string expected_output_url = 2 [json_name = "expectedOutputUrl"]; - - // For rules with urlRedirect, the test passes only if - // expectedRedirectResponseCode matches the HTTP status code in load - // balancer's redirect response. expectedRedirectResponseCode cannot be set - // when service is set. - optional int32 expected_redirect_response_code = 3 - [json_name = "expectedRedirectResponseCode"]; - - // HTTP headers for this request. If headers contains a host header, then host - // must also match the header value. - repeated UrlMapTestHeader headers = 4 [json_name = "headers"]; - - // Host portion of the URL. If headers contains a host header, then host must - // also match the header value. - optional string host = 5 [json_name = "host"]; - - // Path portion of the URL. - optional string path = 6 [json_name = "path"]; - - // Expected BackendService or BackendBucket resource the given URL should be - // mapped to. The service field cannot be set if expectedRedirectResponseCode - // is set. - optional string service = 7 [json_name = "service"]; -} - -// HTTP headers used in UrlMapTests. -message UrlMapTestHeader { - // Header name. - optional string name = 1 [json_name = "name"]; - - // Header value. - optional string value = 2 [json_name = "value"]; -} - -// Message representing the validation result for a UrlMap. -message UrlMapValidationResult { - repeated string load_errors = 1 [json_name = "loadErrors"]; - - // Whether the given UrlMap can be successfully loaded. If false, 'loadErrors' - // indicates the reasons. - optional bool load_succeeded = 2 [json_name = "loadSucceeded"]; - - repeated TestFailure test_failures = 3 [json_name = "testFailures"]; - - // If successfully loaded, this field indicates whether the test passed. If - // false, 'testFailures's indicate the reason of failure. - optional bool test_passed = 4 [json_name = "testPassed"]; -} - -message UrlMapsValidateResponse { - optional UrlMapValidationResult result = 1 [json_name = "result"]; -} - -// The spec for modifying the path before sending the request to the matched -// backend service. -message UrlRewrite { - // Before forwarding the request to the selected service, the request's host - // header is replaced with contents of hostRewrite. The value must be from 1 - // to 255 characters. - optional string host_rewrite = 1 [json_name = "hostRewrite"]; - - // Before forwarding the request to the selected backend service, the matching - // portion of the request's path is replaced by pathPrefixRewrite. The value - // must be from 1 to 1024 characters. - optional string path_prefix_rewrite = 2 [json_name = "pathPrefixRewrite"]; - - // If specified, the pattern rewrites the URL path (based on the :path - // header) using the HTTP template syntax. A corresponding path_template_match - // must be specified. Any template variables must exist in the - // path_template_match field. - -At least one variable must be specified in - // the path_template_match field - You can omit variables from the rewritten - // URL - The * and ** operators cannot be matched unless they have a - // corresponding variable name - e.g. {format=*} or {var=**}. For example, a - // path_template_match of /static/{format=**} could be rewritten as - // /static/content/{format} to prefix /content to the URL. Variables can also - // be re-ordered in a rewrite, so that /{country}/{format}/{suffix=**} can be - // rewritten as /content/{format}/{country}/{suffix}. At least one non-empty - // routeRules[].matchRules[].path_template_match is required. Only one of - // path_prefix_rewrite or path_template_rewrite may be specified. - optional string path_template_rewrite = 3 [json_name = "pathTemplateRewrite"]; -} - -// In contrast to a single BackendService in HttpRouteAction to which all -// matching traffic is directed to, WeightedBackendService allows traffic to be -// split across multiple backend services. The volume of traffic for each -// backend service is proportional to the weight specified in each -// WeightedBackendService -message WeightedBackendService { - // The full or partial URL to the default BackendService resource. Before - // forwarding the request to backendService, the load balancer applies any - // relevant headerActions specified as part of this backendServiceWeight. - optional string backend_service = 1 [json_name = "backendService"]; - - // Specifies changes to request and response headers that need to take effect - // for the selected backendService. headerAction specified here take effect - // before headerAction in the enclosing HttpRouteRule, PathMatcher and UrlMap. - // headerAction is not supported for load balancers that have their - // loadBalancingScheme set to EXTERNAL. Not supported when the URL map is - // bound to a target gRPC proxy that has validateForProxyless field set to - // true. - optional HttpHeaderAction header_action = 2 [json_name = "headerAction"]; - - // Specifies the fraction of traffic sent to a backend service, computed as - // weight / (sum of all weightedBackendService weights in routeAction) . The - // selection of a backend service is determined only for new traffic. Once a - // user's request has been directed to a backend service, subsequent requests - // are sent to the same backend service as determined by the backend service's - // session affinity policy. Don't configure session affinity if you're using - // weighted traffic splitting. If you do, the weighted traffic splitting - // configuration takes precedence. The value must be from 0 to 1000. - optional uint32 weight = 3 [json_name = "weight"]; +message CustomerEncryptionKey { + // The name of the encryption key that is stored in Google Cloud KMS. For + // example: "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ + // key_region/cryptoKeys/key The fully-qualifed key name may be returned for + // resource GET requests. For example: "kmsKeyName": + // "projects/kms_project_id/locations/region/keyRings/ + // key_region/cryptoKeys/key /cryptoKeyVersions/1 + optional string kms_key_name = 1 [json_name = "kmsKeyName"]; + + // The service account being used for the encryption request for the given KMS + // key. If absent, the Compute Engine default service account is used. For + // example: "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/ + optional string kms_key_service_account = 2 + [json_name = "kmsKeyServiceAccount"]; + + // Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 + // base64 to either encrypt or decrypt this resource. You can provide either + // the rawKey or the rsaEncryptedKey. For example: "rawKey": + // "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=" + optional string raw_key = 3 [json_name = "rawKey"]; + + // Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit + // customer-supplied encryption key to either encrypt or decrypt this + // resource. You can provide either the rawKey or the rsaEncryptedKey. For + // example: "rsaEncryptedKey": + // "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH + // z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD + // D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==" + // The key must meet the following requirements before you can provide it to + // Compute Engine: 1. The key is wrapped using a RSA public key certificate + // provided by Google. 2. After being wrapped, the key must be encoded in RFC + // 4648 base64 encoding. Gets the RSA public key certificate provided by + // Google at: + // https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem + optional string rsa_encrypted_key = 4 [json_name = "rsaEncryptedKey"]; + + // [Output only] The RFC 4648 base64 encoded SHA-256 hash of the + // customer-supplied encryption key that protects this resource. + optional string sha256 = 5 [json_name = "sha256"]; +} + +// Guest OS features. +message GuestOsFeature { + // The ID of a supported feature. To add multiple values, use commas to + // separate values. Set to one or more of the following values: - + // VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - + // GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE_V2 - + // SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF For more information, see Enabling + // guest operating system features. + // FEATURE_TYPE_UNSPECIFIED: + // GVNIC: + // IDPF: + // MULTI_IP_SUBNET: + // SECURE_BOOT: + // SEV_CAPABLE: + // SEV_LIVE_MIGRATABLE: + // SEV_LIVE_MIGRATABLE_V2: + // SEV_SNP_CAPABLE: + // TDX_CAPABLE: + // UEFI_COMPATIBLE: + // VIRTIO_SCSI_MULTIQUEUE: + // WINDOWS: + optional string type = 1 [json_name = "type"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_021.proto b/protos/google/cloud/compute/v1/internal/common_021.proto index 313b5d793c4be..e2ab1aa91c929 100644 --- a/protos/google/cloud/compute/v1/internal/common_021.proto +++ b/protos/google/cloud/compute/v1/internal/common_021.proto @@ -15,73 +15,967 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message CustomerEncryptionKey { - // The name of the encryption key that is stored in Google Cloud KMS. For - // example: "kmsKeyName": "projects/kms_project_id/locations/region/keyRings/ - // key_region/cryptoKeys/key The fully-qualifed key name may be returned for - // resource GET requests. For example: "kmsKeyName": - // "projects/kms_project_id/locations/region/keyRings/ - // key_region/cryptoKeys/key /cryptoKeyVersions/1 - optional string kms_key_name = 1 [json_name = "kmsKeyName"]; - - // The service account being used for the encryption request for the given KMS - // key. If absent, the Compute Engine default service account is used. For - // example: "kmsKeyServiceAccount": "name@project_id.iam.gserviceaccount.com/ - optional string kms_key_service_account = 2 - [json_name = "kmsKeyServiceAccount"]; - - // Specifies a 256-bit customer-supplied encryption key, encoded in RFC 4648 - // base64 to either encrypt or decrypt this resource. You can provide either - // the rawKey or the rsaEncryptedKey. For example: "rawKey": - // "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=" - optional string raw_key = 3 [json_name = "rawKey"]; - - // Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit - // customer-supplied encryption key to either encrypt or decrypt this - // resource. You can provide either the rawKey or the rsaEncryptedKey. For - // example: "rsaEncryptedKey": - // "ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH - // z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD - // D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==" - // The key must meet the following requirements before you can provide it to - // Compute Engine: 1. The key is wrapped using a RSA public key certificate - // provided by Google. 2. After being wrapped, the key must be encoded in RFC - // 4648 base64 encoding. Gets the RSA public key certificate provided by - // Google at: - // https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem - optional string rsa_encrypted_key = 4 [json_name = "rsaEncryptedKey"]; - - // [Output only] The RFC 4648 base64 encoded SHA-256 hash of the - // customer-supplied encryption key that protects this resource. - optional string sha256 = 5 [json_name = "sha256"]; -} - -// Guest OS features. -message GuestOsFeature { - // The ID of a supported feature. To add multiple values, use commas to - // separate values. Set to one or more of the following values: - - // VIRTIO_SCSI_MULTIQUEUE - WINDOWS - MULTI_IP_SUBNET - UEFI_COMPATIBLE - - // GVNIC - SEV_CAPABLE - SUSPEND_RESUME_COMPATIBLE - SEV_LIVE_MIGRATABLE_V2 - - // SEV_SNP_CAPABLE - TDX_CAPABLE - IDPF For more information, see Enabling - // guest operating system features. - // FEATURE_TYPE_UNSPECIFIED: - // GVNIC: - // IDPF: - // MULTI_IP_SUBNET: - // SECURE_BOOT: - // SEV_CAPABLE: - // SEV_LIVE_MIGRATABLE: - // SEV_LIVE_MIGRATABLE_V2: - // SEV_SNP_CAPABLE: - // TDX_CAPABLE: - // UEFI_COMPATIBLE: - // VIRTIO_SCSI_MULTIQUEUE: - // WINDOWS: - optional string type = 1 [json_name = "type"]; +import "google/cloud/compute/v1/internal/common_001.proto"; +import "google/cloud/compute/v1/internal/common_003.proto"; +import "google/cloud/compute/v1/internal/common_020.proto"; +import "google/cloud/compute/v1/internal/common_034.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; +import "google/cloud/compute/v1/internal/common_076.proto"; +import "google/cloud/compute/v1/internal/common_138.proto"; + +message CustomerEncryptionKeyProtectedDisk { + // Decrypts data associated with the disk with a customer-supplied encryption + // key. + optional CustomerEncryptionKey disk_encryption_key = 1 + [json_name = "diskEncryptionKey"]; + + // Specifies a valid partial or full URL to an existing Persistent Disk + // resource. This field is only applicable for persistent disks. For example: + // "source": "/compute/v1/projects/project_id/zones/zone/disks/ disk_name + optional string source = 2 [json_name = "source"]; +} + +// A set of Display Device options +message DisplayDevice { + // Defines whether the instance has Display enabled. + optional bool enable_display = 1 [json_name = "enableDisplay"]; +} + +// A guest attributes entry. +message GuestAttributes { + // [Output Only] Type of the resource. Always compute#guestAttributes for + // guest attributes entry. + optional string kind = 1 [json_name = "kind"]; + + // The path to be queried. This can be the default namespace ('') or a nested + // namespace ('\/') or a specified key ('\/\'). + optional string query_path = 2 [json_name = "queryPath"]; + + // [Output Only] The value of the requested queried path. + optional GuestAttributesValue query_value = 3 [json_name = "queryValue"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 4 [json_name = "selfLink"]; + + // The key to search for. + optional string variable_key = 5 [json_name = "variableKey"]; + + // [Output Only] The value found for the requested key. + optional string variable_value = 6 [json_name = "variableValue"]; +} + +// A guest attributes namespace/key/value entry. +message GuestAttributesEntry { + // Key for the guest attribute entry. + optional string key = 1 [json_name = "key"]; + + // Namespace for the guest attribute entry. + optional string namespace = 2 [json_name = "namespace"]; + + // Value for the guest attribute entry. + optional string value = 3 [json_name = "value"]; +} + +// Array of guest attribute namespace/key/value tuples. +message GuestAttributesValue { + repeated GuestAttributesEntry items = 1 [json_name = "items"]; +} + +// Represents an Instance resource. An instance is a virtual machine that is +// hosted on Google Cloud Platform. For more information, read Virtual Machine +// Instances. +message Instance { + // Controls for advanced machine-related behavior features. + optional AdvancedMachineFeatures advanced_machine_features = 1 + [json_name = "advancedMachineFeatures"]; + + // Allows this instance to send and receive packets with non-matching + // destination or source IPs. This is required if you plan to use this + // instance to forward routes. For more information, see Enabling IP + // Forwarding . + optional bool can_ip_forward = 2 [json_name = "canIpForward"]; + + optional ConfidentialInstanceConfig confidential_instance_config = 3 + [json_name = "confidentialInstanceConfig"]; + + // [Output Only] The CPU platform used by this instance. + optional string cpu_platform = 4 [json_name = "cpuPlatform"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 5 [json_name = "creationTimestamp"]; + + // Whether the resource should be protected against deletion. + optional bool deletion_protection = 6 [json_name = "deletionProtection"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 7 [json_name = "description"]; + + // Array of disks associated with this instance. Persistent disks must be + // created before you can assign them. + repeated AttachedDisk disks = 8 [json_name = "disks"]; + + // Enables display device for the instance. + optional DisplayDevice display_device = 9 [json_name = "displayDevice"]; + + // Specifies a fingerprint for this resource, which is essentially a hash of + // the instance's contents and used for optimistic locking. The fingerprint is + // initially generated by Compute Engine and changes after every request to + // modify or update the instance. You must always provide an up-to-date + // fingerprint hash in order to update the instance. To see the latest + // fingerprint, make get() request to the instance. + optional string fingerprint = 10 [json_name = "fingerprint"]; + + // A list of the type and count of accelerator cards attached to the instance. + repeated AcceleratorConfig guest_accelerators = 11 + [json_name = "guestAccelerators"]; + + // Specifies the hostname of the instance. The specified hostname must be + // RFC1035 compliant. If hostname is not specified, the default hostname is + // [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and + // [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS. + optional string hostname = 12 [json_name = "hostname"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 13 [json_name = "id"]; + + // Encrypts suspended data for an instance with a customer-managed encryption + // key. If you are creating a new instance, this field will encrypt the local + // SSD and in-memory contents of the instance during the suspend operation. If + // you do not provide an encryption key when creating the instance, then the + // local SSD and in-memory contents will be encrypted using an automatically + // generated key during the suspend operation. + optional CustomerEncryptionKey instance_encryption_key = 45 + [json_name = "instanceEncryptionKey"]; + + // KeyRevocationActionType of the instance. Supported options are "STOP" and + // "NONE". The default value is "NONE" if it is not specified. + // KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED: Default value. This value is + // unused. + // NONE: Indicates user chose no operation. + // STOP: Indicates user chose to opt for VM shutdown on key revocation. + optional string key_revocation_action_type = 14 + [json_name = "keyRevocationActionType"]; + + // [Output Only] Type of the resource. Always compute#instance for instances. + optional string kind = 15 [json_name = "kind"]; + + // A fingerprint for this request, which is essentially a hash of the label's + // contents and used for optimistic locking. The fingerprint is initially + // generated by Compute Engine and changes after every request to modify or + // update labels. You must always provide an up-to-date fingerprint hash in + // order to update or change labels. To see the latest fingerprint, make get() + // request to the instance. + optional string label_fingerprint = 16 [json_name = "labelFingerprint"]; + + // Labels to apply to this instance. These can be later modified by the + // setLabels method. + map labels = 17 [json_name = "labels"]; + + // [Output Only] Last start timestamp in RFC3339 text format. + optional string last_start_timestamp = 18 [json_name = "lastStartTimestamp"]; + + // [Output Only] Last stop timestamp in RFC3339 text format. + optional string last_stop_timestamp = 19 [json_name = "lastStopTimestamp"]; + + // [Output Only] Last suspended timestamp in RFC3339 text format. + optional string last_suspended_timestamp = 20 + [json_name = "lastSuspendedTimestamp"]; + + // Full or partial URL of the machine type resource to use for this instance, + // in the format: zones/zone/machineTypes/machine-type. This is provided by + // the client when the instance is created. For example, the following is a + // valid partial url to a predefined machine type: + // zones/us-central1-f/machineTypes/n1-standard-1 To create a custom machine + // type, provide a URL to a machine type in the following format, where CPUS + // is 1 or an even number up to 32 (2, 4, 6, ... 24, etc), and MEMORY is the + // total memory for this instance. Memory must be a multiple of 256 MB and + // must be supplied in MB (e.g. 5 GB of memory is 5120 MB): + // zones/zone/machineTypes/custom-CPUS-MEMORY For example: + // zones/us-central1-f/machineTypes/custom-4-5120 For a full list of + // restrictions, read the Specifications for custom machine types. + optional string machine_type = 21 [json_name = "machineType"]; + + // The metadata key/value pairs assigned to this instance. This includes + // custom metadata and predefined keys. + optional Metadata metadata = 22 [json_name = "metadata"]; + + // Specifies a minimum CPU platform for the VM instance. Applicable values are + // the friendly names of CPU platforms, such as minCpuPlatform: "Intel + // Haswell" or minCpuPlatform: "Intel Sandy Bridge". + optional string min_cpu_platform = 23 [json_name = "minCpuPlatform"]; + + // The name of the resource, provided by the client when initially creating + // the resource. The resource name must be 1-63 characters long, and comply + // with RFC1035. Specifically, the name must be 1-63 characters long and match + // the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + // character must be a lowercase letter, and all following characters must be + // a dash, lowercase letter, or digit, except the last character, which cannot + // be a dash. + optional string name = 24 [json_name = "name"]; + + // An array of network configurations for this instance. These specify how + // interfaces are configured to interact with other network services, such as + // connecting to the internet. Multiple interfaces are supported per instance. + repeated NetworkInterface network_interfaces = 25 + [json_name = "networkInterfaces"]; + + optional NetworkPerformanceConfig network_performance_config = 26 + [json_name = "networkPerformanceConfig"]; + + // Input only. [Input Only] Additional params passed with the request, but not + // persisted as part of resource payload. + optional InstanceParams params = 27 [json_name = "params"]; + + // The private IPv6 google access type for the VM. If not specified, use + // INHERIT_FROM_SUBNETWORK as default. + // ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE: Bidirectional private IPv6 access + // to/from Google services. If specified, the subnetwork who is attached to + // the instance's default network interface will be assigned an internal IPv6 + // prefix if it doesn't have before. + // ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE: Outbound private IPv6 access from VMs + // in this subnet to Google services. If specified, the subnetwork who is + // attached to the instance's default network interface will be assigned an + // internal IPv6 prefix if it doesn't have before. + // INHERIT_FROM_SUBNETWORK: Each network interface inherits + // PrivateIpv6GoogleAccess from its subnetwork. + optional string private_ipv6_google_access = 28 + [json_name = "privateIpv6GoogleAccess"]; + + // Specifies the reservations that this instance can consume from. + optional ReservationAffinity reservation_affinity = 29 + [json_name = "reservationAffinity"]; + + // Resource policies applied to this instance. + repeated string resource_policies = 30 [json_name = "resourcePolicies"]; + + // [Output Only] Specifies values set for instance attributes as compared to + // the values requested by user in the corresponding input only field. + optional ResourceStatus resource_status = 31 [json_name = "resourceStatus"]; + + // [Output Only] Reserved for future use. + optional bool satisfies_pzi = 46 [json_name = "satisfiesPzi"]; + + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 32 [json_name = "satisfiesPzs"]; + + // Sets the scheduling options for this instance. + optional Scheduling scheduling = 33 [json_name = "scheduling"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 34 [json_name = "selfLink"]; + + // A list of service accounts, with their specified scopes, authorized for + // this instance. Only one service account per VM instance is supported. + // Service accounts generate access tokens that can be accessed through the + // metadata server and used to authenticate applications on the instance. See + // Service Accounts for more information. + repeated ServiceAccount service_accounts = 35 [json_name = "serviceAccounts"]; + + optional ShieldedInstanceConfig shielded_instance_config = 36 + [json_name = "shieldedInstanceConfig"]; + + optional ShieldedInstanceIntegrityPolicy shielded_instance_integrity_policy = + 37 [json_name = "shieldedInstanceIntegrityPolicy"]; + + // Source machine image + optional string source_machine_image = 38 [json_name = "sourceMachineImage"]; + + // Source machine image encryption key when creating an instance from a + // machine image. + optional CustomerEncryptionKey source_machine_image_encryption_key = 39 + [json_name = "sourceMachineImageEncryptionKey"]; + + // [Output Only] Whether a VM has been restricted for start because Compute + // Engine has detected suspicious activity. + optional bool start_restricted = 40 [json_name = "startRestricted"]; + + // [Output Only] The status of the instance. One of the following values: + // PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING, + // and TERMINATED. For more information about the status of the instance, see + // Instance life cycle. + // DEPROVISIONING: The instance is halted and we are performing tear down + // tasks like network deprogramming, releasing quota, IP, tearing down disks + // etc. + // PROVISIONING: Resources are being allocated for the instance. + // REPAIRING: The instance is in repair. + // RUNNING: The instance is running. + // STAGING: All required resources have been allocated and the instance is + // being started. + // STOPPED: The instance has stopped successfully. + // STOPPING: The instance is currently stopping (either being deleted or + // killed). + // SUSPENDED: The instance has suspended. + // SUSPENDING: The instance is suspending. + // TERMINATED: The instance has stopped (either by explicit action or + // underlying failure). + optional string status = 41 [json_name = "status"]; + + // [Output Only] An optional, human-readable explanation of the status. + optional string status_message = 42 [json_name = "statusMessage"]; + + // Tags to apply to this instance. Tags are used to identify valid sources or + // targets for network firewalls and are specified by the client during + // instance creation. The tags can be later modified by the setTags method. + // Each tag within the list must comply with RFC1035. Multiple tags can be + // specified via the 'tags.items' field. + optional Tags tags = 43 [json_name = "tags"]; + + // [Output Only] URL of the zone where the instance resides. You must specify + // this field as part of the HTTP request URL. It is not settable as a field + // in the request body. + optional string zone = 44 [json_name = "zone"]; +} + +message InstanceAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // An object that contains a list of instances scoped by zone. + map items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#instanceAggregatedList for + // aggregated lists of Instance resources. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +// Contains a list of instances. +message InstanceList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of Instance resources. + repeated Instance items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#instanceList for lists of + // Instance resources. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +// Contains a list of instance referrers. +message InstanceListReferrers { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of Reference resources. + repeated Reference items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#instanceListReferrers for + // lists of Instance referrers. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +// Additional instance params. +message InstanceParams { + // Resource manager tags to be bound to the instance. Tag keys and values have + // the same definition as resource manager tags. Keys must be in the format + // `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The + // field is ignored (both PUT & PATCH) when empty. + map resource_manager_tags = 1 + [json_name = "resourceManagerTags"]; +} + +message InstancesAddResourcePoliciesRequest { + // Resource policies to be added to this instance. + repeated string resource_policies = 1 [json_name = "resourcePolicies"]; +} + +message InstancesGetEffectiveFirewallsResponse { + // [Output Only] Effective firewalls from firewall policies. + repeated InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy + firewall_policys = 1 [json_name = "firewallPolicys"]; + + // Effective firewalls on the instance. + repeated Firewall firewalls = 2 [json_name = "firewalls"]; +} + +message InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy { + // [Output Only] Deprecated, please use short name instead. The display name + // of the firewall policy. + optional string display_name = 1 [json_name = "displayName"]; + + // [Output Only] The name of the firewall policy. + optional string name = 2 [json_name = "name"]; + + // [Output only] Priority of firewall policy association. Not applicable for + // type=HIERARCHY. + optional int32 priority = 6 [json_name = "priority"]; + + // [Output Only] The rules that apply to the instance. Only rules that target + // the specific VM instance are returned if target service accounts or target + // secure tags are specified in the rules. + repeated FirewallPolicyRule rules = 3 [json_name = "rules"]; + + // [Output Only] The short name of the firewall policy. + optional string short_name = 4 [json_name = "shortName"]; + + // [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + // NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + // HIERARCHY: + // NETWORK: + // NETWORK_REGIONAL: + // SYSTEM_GLOBAL: + // SYSTEM_REGIONAL: + // UNSPECIFIED: + optional string type = 5 [json_name = "type"]; +} + +message InstancesRemoveResourcePoliciesRequest { + // Resource policies to be removed from this instance. + repeated string resource_policies = 1 [json_name = "resourcePolicies"]; +} + +message InstancesScopedList { + // [Output Only] A list of instances contained in this scope. + repeated Instance instances = 1 [json_name = "instances"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning which replaces the list of instances + // when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; +} + +message InstancesSetLabelsRequest { + // Fingerprint of the previous set of labels for this resource, used to + // prevent conflicts. Provide the latest fingerprint value when making a + // request to add or change labels. + optional string label_fingerprint = 1 [json_name = "labelFingerprint"]; + + map labels = 2 [json_name = "labels"]; +} + +message InstancesSetMachineResourcesRequest { + // A list of the type and count of accelerator cards attached to the instance. + repeated AcceleratorConfig guest_accelerators = 1 + [json_name = "guestAccelerators"]; +} + +message InstancesSetMachineTypeRequest { + // Full or partial URL of the machine type resource. See Machine Types for a + // full list of machine types. For example: + // zones/us-central1-f/machineTypes/n1-standard-1 + optional string machine_type = 1 [json_name = "machineType"]; +} + +message InstancesSetMinCpuPlatformRequest { + // Minimum cpu/platform this instance should be started at. + optional string min_cpu_platform = 1 [json_name = "minCpuPlatform"]; +} + +message InstancesSetNameRequest { + // The current name of this resource, used to prevent conflicts. Provide the + // latest name when making a request to change name. + optional string current_name = 1 [json_name = "currentName"]; + + // The name to be applied to the instance. Needs to be RFC 1035 compliant. + optional string name = 2 [json_name = "name"]; +} + +message InstancesSetSecurityPolicyRequest { + // The network interfaces that the security policy will be applied to. Network + // interfaces use the nicN naming format. You can only set a security policy + // for network interfaces with an access config. + repeated string network_interfaces = 1 [json_name = "networkInterfaces"]; + + // A full or partial URL to a security policy to add to this instance. If this + // field is set to an empty string it will remove the associated security + // policy. + optional string security_policy = 2 [json_name = "securityPolicy"]; +} + +message InstancesSetServiceAccountRequest { + // Email address of the service account. + optional string email = 1 [json_name = "email"]; + + // The list of scopes to be made available for this service account. + repeated string scopes = 2 [json_name = "scopes"]; +} + +message InstancesStartWithEncryptionKeyRequest { + // Array of disks associated with this instance that are protected with a + // customer-supplied encryption key. In order to start the instance, the disk + // url and its corresponding key must be provided. If the disk is not + // protected with a customer-supplied encryption key it should not be + // specified. + repeated CustomerEncryptionKeyProtectedDisk disks = 1 [json_name = "disks"]; +} + +// Represents a reference to a resource. +message Reference { + // [Output Only] Type of the resource. Always compute#reference for + // references. + optional string kind = 1 [json_name = "kind"]; + + // A description of the reference type with no implied semantics. Possible + // values include: 1. MEMBER_OF + optional string reference_type = 2 [json_name = "referenceType"]; + + // URL of the resource which refers to the target. + optional string referrer = 3 [json_name = "referrer"]; + + // URL of the resource to which this reference points. + optional string target = 4 [json_name = "target"]; +} + +// Contains output only fields. Use this sub-message for actual values set on +// Instance attributes as compared to the value requested by the user (intent) +// in their instance CRUD calls. +message ResourceStatus { + // [Output Only] An opaque ID of the host on which the VM is running. + optional string physical_host = 1 [json_name = "physicalHost"]; + + optional ResourceStatusScheduling scheduling = 3 [json_name = "scheduling"]; + + optional UpcomingMaintenance upcoming_maintenance = 2 + [json_name = "upcomingMaintenance"]; +} + +message ResourceStatusScheduling { + // Specifies the availability domain to place the instance in. The value must + // be a number between 1 and the number of availability domains specified in + // the spread placement policy attached to the instance. + optional int32 availability_domain = 1 [json_name = "availabilityDomain"]; +} + +// An instance's screenshot. +message Screenshot { + // [Output Only] The Base64-encoded screenshot data. + optional string contents = 1 [json_name = "contents"]; + + // [Output Only] Type of the resource. Always compute#screenshot for the + // screenshots. + optional string kind = 2 [json_name = "kind"]; +} + +// An instance serial console output. +message SerialPortOutput { + // [Output Only] The contents of the console output. + optional string contents = 1 [json_name = "contents"]; + + // [Output Only] Type of the resource. Always compute#serialPortOutput for + // serial port output. + optional string kind = 2 [json_name = "kind"]; + + // [Output Only] The position of the next byte of content, regardless of + // whether the content exists, following the output returned in the `contents` + // property. Use this value in the next request as the start parameter. + optional string next = 3 [json_name = "next"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 4 [json_name = "selfLink"]; + + // The starting byte position of the output that was returned. This should + // match the start parameter sent with the request. If the serial console + // output exceeds the size of the buffer (1 MB), older output is overwritten + // by newer content. The output start value will indicate the byte position of + // the output that was returned, which might be different than the `start` + // value that was specified in the request. + optional string start = 5 [json_name = "start"]; +} + +// A Shielded Instance Identity. +message ShieldedInstanceIdentity { + // An Endorsement Key (EK) made by the RSA 2048 algorithm issued to the + // Shielded Instance's vTPM. + optional ShieldedInstanceIdentityEntry encryption_key = 1 + [json_name = "encryptionKey"]; + + // [Output Only] Type of the resource. Always compute#shieldedInstanceIdentity + // for shielded Instance identity entry. + optional string kind = 2 [json_name = "kind"]; + + // An Attestation Key (AK) made by the RSA 2048 algorithm issued to the + // Shielded Instance's vTPM. + optional ShieldedInstanceIdentityEntry signing_key = 3 + [json_name = "signingKey"]; +} + +// A Shielded Instance Identity Entry. +message ShieldedInstanceIdentityEntry { + // A PEM-encoded X.509 certificate. This field can be empty. + optional string ek_cert = 1 [json_name = "ekCert"]; + + // A PEM-encoded public key. + optional string ek_pub = 2 [json_name = "ekPub"]; +} + +// The policy describes the baseline against which Instance boot integrity is +// measured. +message ShieldedInstanceIntegrityPolicy { + // Updates the integrity policy baseline using the measurements from the VM + // instance's most recent boot. + optional bool update_auto_learn_policy = 1 + [json_name = "updateAutoLearnPolicy"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_022.proto b/protos/google/cloud/compute/v1/internal/common_022.proto index 41f68df96eaa8..f5db76f5ba90c 100644 --- a/protos/google/cloud/compute/v1/internal/common_022.proto +++ b/protos/google/cloud/compute/v1/internal/common_022.proto @@ -15,965 +15,43 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_001.proto"; -import "google/cloud/compute/v1/internal/common_003.proto"; -import "google/cloud/compute/v1/internal/common_021.proto"; -import "google/cloud/compute/v1/internal/common_035.proto"; -import "google/cloud/compute/v1/internal/common_039.proto"; -import "google/cloud/compute/v1/internal/common_078.proto"; -import "google/cloud/compute/v1/internal/common_140.proto"; - -message CustomerEncryptionKeyProtectedDisk { - // Decrypts data associated with the disk with a customer-supplied encryption - // key. - optional CustomerEncryptionKey disk_encryption_key = 1 - [json_name = "diskEncryptionKey"]; - - // Specifies a valid partial or full URL to an existing Persistent Disk - // resource. This field is only applicable for persistent disks. For example: - // "source": "/compute/v1/projects/project_id/zones/zone/disks/ disk_name - optional string source = 2 [json_name = "source"]; -} - -// A set of Display Device options -message DisplayDevice { - // Defines whether the instance has Display enabled. - optional bool enable_display = 1 [json_name = "enableDisplay"]; -} - -// A guest attributes entry. -message GuestAttributes { - // [Output Only] Type of the resource. Always compute#guestAttributes for - // guest attributes entry. - optional string kind = 1 [json_name = "kind"]; - - // The path to be queried. This can be the default namespace ('') or a nested - // namespace ('\/') or a specified key ('\/\'). - optional string query_path = 2 [json_name = "queryPath"]; - - // [Output Only] The value of the requested queried path. - optional GuestAttributesValue query_value = 3 [json_name = "queryValue"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 4 [json_name = "selfLink"]; - - // The key to search for. - optional string variable_key = 5 [json_name = "variableKey"]; - - // [Output Only] The value found for the requested key. - optional string variable_value = 6 [json_name = "variableValue"]; -} - -// A guest attributes namespace/key/value entry. -message GuestAttributesEntry { - // Key for the guest attribute entry. - optional string key = 1 [json_name = "key"]; - - // Namespace for the guest attribute entry. - optional string namespace = 2 [json_name = "namespace"]; - - // Value for the guest attribute entry. - optional string value = 3 [json_name = "value"]; -} - -// Array of guest attribute namespace/key/value tuples. -message GuestAttributesValue { - repeated GuestAttributesEntry items = 1 [json_name = "items"]; -} - -// Represents an Instance resource. An instance is a virtual machine that is -// hosted on Google Cloud Platform. For more information, read Virtual Machine -// Instances. -message Instance { - // Controls for advanced machine-related behavior features. - optional AdvancedMachineFeatures advanced_machine_features = 1 - [json_name = "advancedMachineFeatures"]; - - // Allows this instance to send and receive packets with non-matching - // destination or source IPs. This is required if you plan to use this - // instance to forward routes. For more information, see Enabling IP - // Forwarding . - optional bool can_ip_forward = 2 [json_name = "canIpForward"]; - - optional ConfidentialInstanceConfig confidential_instance_config = 3 - [json_name = "confidentialInstanceConfig"]; - - // [Output Only] The CPU platform used by this instance. - optional string cpu_platform = 4 [json_name = "cpuPlatform"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 5 [json_name = "creationTimestamp"]; - - // Whether the resource should be protected against deletion. - optional bool deletion_protection = 6 [json_name = "deletionProtection"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 7 [json_name = "description"]; - - // Array of disks associated with this instance. Persistent disks must be - // created before you can assign them. - repeated AttachedDisk disks = 8 [json_name = "disks"]; - - // Enables display device for the instance. - optional DisplayDevice display_device = 9 [json_name = "displayDevice"]; - - // Specifies a fingerprint for this resource, which is essentially a hash of - // the instance's contents and used for optimistic locking. The fingerprint is - // initially generated by Compute Engine and changes after every request to - // modify or update the instance. You must always provide an up-to-date - // fingerprint hash in order to update the instance. To see the latest - // fingerprint, make get() request to the instance. - optional string fingerprint = 10 [json_name = "fingerprint"]; - - // A list of the type and count of accelerator cards attached to the instance. - repeated AcceleratorConfig guest_accelerators = 11 - [json_name = "guestAccelerators"]; - - // Specifies the hostname of the instance. The specified hostname must be - // RFC1035 compliant. If hostname is not specified, the default hostname is - // [INSTANCE_NAME].c.[PROJECT_ID].internal when using the global DNS, and - // [INSTANCE_NAME].[ZONE].c.[PROJECT_ID].internal when using zonal DNS. - optional string hostname = 12 [json_name = "hostname"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 13 [json_name = "id"]; - - // Encrypts suspended data for an instance with a customer-managed encryption - // key. If you are creating a new instance, this field will encrypt the local - // SSD and in-memory contents of the instance during the suspend operation. If - // you do not provide an encryption key when creating the instance, then the - // local SSD and in-memory contents will be encrypted using an automatically - // generated key during the suspend operation. - optional CustomerEncryptionKey instance_encryption_key = 45 - [json_name = "instanceEncryptionKey"]; - - // KeyRevocationActionType of the instance. Supported options are "STOP" and - // "NONE". The default value is "NONE" if it is not specified. - // KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED: Default value. This value is - // unused. - // NONE: Indicates user chose no operation. - // STOP: Indicates user chose to opt for VM shutdown on key revocation. - optional string key_revocation_action_type = 14 - [json_name = "keyRevocationActionType"]; - - // [Output Only] Type of the resource. Always compute#instance for instances. - optional string kind = 15 [json_name = "kind"]; - - // A fingerprint for this request, which is essentially a hash of the label's - // contents and used for optimistic locking. The fingerprint is initially - // generated by Compute Engine and changes after every request to modify or - // update labels. You must always provide an up-to-date fingerprint hash in - // order to update or change labels. To see the latest fingerprint, make get() - // request to the instance. - optional string label_fingerprint = 16 [json_name = "labelFingerprint"]; - - // Labels to apply to this instance. These can be later modified by the - // setLabels method. - map labels = 17 [json_name = "labels"]; - - // [Output Only] Last start timestamp in RFC3339 text format. - optional string last_start_timestamp = 18 [json_name = "lastStartTimestamp"]; - - // [Output Only] Last stop timestamp in RFC3339 text format. - optional string last_stop_timestamp = 19 [json_name = "lastStopTimestamp"]; - - // [Output Only] Last suspended timestamp in RFC3339 text format. - optional string last_suspended_timestamp = 20 - [json_name = "lastSuspendedTimestamp"]; - - // Full or partial URL of the machine type resource to use for this instance, - // in the format: zones/zone/machineTypes/machine-type. This is provided by - // the client when the instance is created. For example, the following is a - // valid partial url to a predefined machine type: - // zones/us-central1-f/machineTypes/n1-standard-1 To create a custom machine - // type, provide a URL to a machine type in the following format, where CPUS - // is 1 or an even number up to 32 (2, 4, 6, ... 24, etc), and MEMORY is the - // total memory for this instance. Memory must be a multiple of 256 MB and - // must be supplied in MB (e.g. 5 GB of memory is 5120 MB): - // zones/zone/machineTypes/custom-CPUS-MEMORY For example: - // zones/us-central1-f/machineTypes/custom-4-5120 For a full list of - // restrictions, read the Specifications for custom machine types. - optional string machine_type = 21 [json_name = "machineType"]; - - // The metadata key/value pairs assigned to this instance. This includes - // custom metadata and predefined keys. - optional Metadata metadata = 22 [json_name = "metadata"]; - - // Specifies a minimum CPU platform for the VM instance. Applicable values are - // the friendly names of CPU platforms, such as minCpuPlatform: "Intel - // Haswell" or minCpuPlatform: "Intel Sandy Bridge". - optional string min_cpu_platform = 23 [json_name = "minCpuPlatform"]; - - // The name of the resource, provided by the client when initially creating - // the resource. The resource name must be 1-63 characters long, and comply - // with RFC1035. Specifically, the name must be 1-63 characters long and match - // the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first - // character must be a lowercase letter, and all following characters must be - // a dash, lowercase letter, or digit, except the last character, which cannot - // be a dash. - optional string name = 24 [json_name = "name"]; - - // An array of network configurations for this instance. These specify how - // interfaces are configured to interact with other network services, such as - // connecting to the internet. Multiple interfaces are supported per instance. - repeated NetworkInterface network_interfaces = 25 - [json_name = "networkInterfaces"]; - - optional NetworkPerformanceConfig network_performance_config = 26 - [json_name = "networkPerformanceConfig"]; - - // Input only. [Input Only] Additional params passed with the request, but not - // persisted as part of resource payload. - optional InstanceParams params = 27 [json_name = "params"]; - - // The private IPv6 google access type for the VM. If not specified, use - // INHERIT_FROM_SUBNETWORK as default. - // ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE: Bidirectional private IPv6 access - // to/from Google services. If specified, the subnetwork who is attached to - // the instance's default network interface will be assigned an internal IPv6 - // prefix if it doesn't have before. - // ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE: Outbound private IPv6 access from VMs - // in this subnet to Google services. If specified, the subnetwork who is - // attached to the instance's default network interface will be assigned an - // internal IPv6 prefix if it doesn't have before. - // INHERIT_FROM_SUBNETWORK: Each network interface inherits - // PrivateIpv6GoogleAccess from its subnetwork. - optional string private_ipv6_google_access = 28 - [json_name = "privateIpv6GoogleAccess"]; - - // Specifies the reservations that this instance can consume from. - optional ReservationAffinity reservation_affinity = 29 - [json_name = "reservationAffinity"]; - - // Resource policies applied to this instance. - repeated string resource_policies = 30 [json_name = "resourcePolicies"]; - - // [Output Only] Specifies values set for instance attributes as compared to - // the values requested by user in the corresponding input only field. - optional ResourceStatus resource_status = 31 [json_name = "resourceStatus"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzi = 46 [json_name = "satisfiesPzi"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzs = 32 [json_name = "satisfiesPzs"]; - - // Sets the scheduling options for this instance. - optional Scheduling scheduling = 33 [json_name = "scheduling"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 34 [json_name = "selfLink"]; - - // A list of service accounts, with their specified scopes, authorized for - // this instance. Only one service account per VM instance is supported. - // Service accounts generate access tokens that can be accessed through the - // metadata server and used to authenticate applications on the instance. See - // Service Accounts for more information. - repeated ServiceAccount service_accounts = 35 [json_name = "serviceAccounts"]; - - optional ShieldedInstanceConfig shielded_instance_config = 36 - [json_name = "shieldedInstanceConfig"]; - - optional ShieldedInstanceIntegrityPolicy shielded_instance_integrity_policy = - 37 [json_name = "shieldedInstanceIntegrityPolicy"]; - - // Source machine image - optional string source_machine_image = 38 [json_name = "sourceMachineImage"]; - - // Source machine image encryption key when creating an instance from a - // machine image. - optional CustomerEncryptionKey source_machine_image_encryption_key = 39 - [json_name = "sourceMachineImageEncryptionKey"]; - - // [Output Only] Whether a VM has been restricted for start because Compute - // Engine has detected suspicious activity. - optional bool start_restricted = 40 [json_name = "startRestricted"]; - - // [Output Only] The status of the instance. One of the following values: - // PROVISIONING, STAGING, RUNNING, STOPPING, SUSPENDING, SUSPENDED, REPAIRING, - // and TERMINATED. For more information about the status of the instance, see - // Instance life cycle. - // DEPROVISIONING: The instance is halted and we are performing tear down - // tasks like network deprogramming, releasing quota, IP, tearing down disks - // etc. - // PROVISIONING: Resources are being allocated for the instance. - // REPAIRING: The instance is in repair. - // RUNNING: The instance is running. - // STAGING: All required resources have been allocated and the instance is - // being started. - // STOPPED: The instance has stopped successfully. - // STOPPING: The instance is currently stopping (either being deleted or - // killed). - // SUSPENDED: The instance has suspended. - // SUSPENDING: The instance is suspending. - // TERMINATED: The instance has stopped (either by explicit action or - // underlying failure). - optional string status = 41 [json_name = "status"]; - - // [Output Only] An optional, human-readable explanation of the status. - optional string status_message = 42 [json_name = "statusMessage"]; - - // Tags to apply to this instance. Tags are used to identify valid sources or - // targets for network firewalls and are specified by the client during - // instance creation. The tags can be later modified by the setTags method. - // Each tag within the list must comply with RFC1035. Multiple tags can be - // specified via the 'tags.items' field. - optional Tags tags = 43 [json_name = "tags"]; - - // [Output Only] URL of the zone where the instance resides. You must specify - // this field as part of the HTTP request URL. It is not settable as a field - // in the request body. - optional string zone = 44 [json_name = "zone"]; -} - -message InstanceAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // An object that contains a list of instances scoped by zone. - map items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#instanceAggregatedList for - // aggregated lists of Instance resources. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -// Contains a list of instances. -message InstanceList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of Instance resources. - repeated Instance items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#instanceList for lists of - // Instance resources. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// Contains a list of instance referrers. -message InstanceListReferrers { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of Reference resources. - repeated Reference items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#instanceListReferrers for - // lists of Instance referrers. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// Additional instance params. -message InstanceParams { - // Resource manager tags to be bound to the instance. Tag keys and values have - // the same definition as resource manager tags. Keys must be in the format - // `tagKeys/{tag_key_id}`, and values are in the format `tagValues/456`. The - // field is ignored (both PUT & PATCH) when empty. - map resource_manager_tags = 1 - [json_name = "resourceManagerTags"]; -} - -message InstancesAddResourcePoliciesRequest { - // Resource policies to be added to this instance. - repeated string resource_policies = 1 [json_name = "resourcePolicies"]; -} - -message InstancesGetEffectiveFirewallsResponse { - // Effective firewalls from firewall policies. - repeated InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy - firewall_policys = 1 [json_name = "firewallPolicys"]; - - // Effective firewalls on the instance. - repeated Firewall firewalls = 2 [json_name = "firewalls"]; -} - -message InstancesGetEffectiveFirewallsResponseEffectiveFirewallPolicy { - // [Output Only] Deprecated, please use short name instead. The display name - // of the firewall policy. - optional string display_name = 1 [json_name = "displayName"]; - - // [Output Only] The name of the firewall policy. - optional string name = 2 [json_name = "name"]; - - // [Output only] Priority of firewall policy association. Not applicable for - // type=HIERARCHY. - optional int32 priority = 6 [json_name = "priority"]; - - // The rules that apply to the network. - repeated FirewallPolicyRule rules = 3 [json_name = "rules"]; - - // [Output Only] The short name of the firewall policy. - optional string short_name = 4 [json_name = "shortName"]; - - // [Output Only] The type of the firewall policy. Can be one of HIERARCHY, - // NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. - // HIERARCHY: - // NETWORK: - // NETWORK_REGIONAL: - // SYSTEM_GLOBAL: - // SYSTEM_REGIONAL: - // UNSPECIFIED: - optional string type = 5 [json_name = "type"]; -} - -message InstancesRemoveResourcePoliciesRequest { - // Resource policies to be removed from this instance. - repeated string resource_policies = 1 [json_name = "resourcePolicies"]; -} - -message InstancesScopedList { - // [Output Only] A list of instances contained in this scope. - repeated Instance instances = 1 [json_name = "instances"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning which replaces the list of instances - // when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} - -message InstancesSetLabelsRequest { - // Fingerprint of the previous set of labels for this resource, used to - // prevent conflicts. Provide the latest fingerprint value when making a - // request to add or change labels. - optional string label_fingerprint = 1 [json_name = "labelFingerprint"]; - - map labels = 2 [json_name = "labels"]; -} - -message InstancesSetMachineResourcesRequest { - // A list of the type and count of accelerator cards attached to the instance. - repeated AcceleratorConfig guest_accelerators = 1 - [json_name = "guestAccelerators"]; -} - -message InstancesSetMachineTypeRequest { - // Full or partial URL of the machine type resource. See Machine Types for a - // full list of machine types. For example: - // zones/us-central1-f/machineTypes/n1-standard-1 - optional string machine_type = 1 [json_name = "machineType"]; -} - -message InstancesSetMinCpuPlatformRequest { - // Minimum cpu/platform this instance should be started at. - optional string min_cpu_platform = 1 [json_name = "minCpuPlatform"]; -} - -message InstancesSetNameRequest { - // The current name of this resource, used to prevent conflicts. Provide the - // latest name when making a request to change name. - optional string current_name = 1 [json_name = "currentName"]; - - // The name to be applied to the instance. Needs to be RFC 1035 compliant. - optional string name = 2 [json_name = "name"]; -} - -message InstancesSetSecurityPolicyRequest { - // The network interfaces that the security policy will be applied to. Network - // interfaces use the nicN naming format. You can only set a security policy - // for network interfaces with an access config. - repeated string network_interfaces = 1 [json_name = "networkInterfaces"]; - - // A full or partial URL to a security policy to add to this instance. If this - // field is set to an empty string it will remove the associated security - // policy. - optional string security_policy = 2 [json_name = "securityPolicy"]; -} - -message InstancesSetServiceAccountRequest { - // Email address of the service account. - optional string email = 1 [json_name = "email"]; - - // The list of scopes to be made available for this service account. - repeated string scopes = 2 [json_name = "scopes"]; -} - -message InstancesStartWithEncryptionKeyRequest { - // Array of disks associated with this instance that are protected with a - // customer-supplied encryption key. In order to start the instance, the disk - // url and its corresponding key must be provided. If the disk is not - // protected with a customer-supplied encryption key it should not be - // specified. - repeated CustomerEncryptionKeyProtectedDisk disks = 1 [json_name = "disks"]; -} - -// Represents a reference to a resource. -message Reference { - // [Output Only] Type of the resource. Always compute#reference for - // references. - optional string kind = 1 [json_name = "kind"]; - - // A description of the reference type with no implied semantics. Possible - // values include: 1. MEMBER_OF - optional string reference_type = 2 [json_name = "referenceType"]; - - // URL of the resource which refers to the target. - optional string referrer = 3 [json_name = "referrer"]; - - // URL of the resource to which this reference points. - optional string target = 4 [json_name = "target"]; -} - -// Contains output only fields. Use this sub-message for actual values set on -// Instance attributes as compared to the value requested by the user (intent) -// in their instance CRUD calls. -message ResourceStatus { - // [Output Only] An opaque ID of the host on which the VM is running. - optional string physical_host = 1 [json_name = "physicalHost"]; - - optional ResourceStatusScheduling scheduling = 3 [json_name = "scheduling"]; - - optional UpcomingMaintenance upcoming_maintenance = 2 - [json_name = "upcomingMaintenance"]; -} - -message ResourceStatusScheduling { - // Specifies the availability domain to place the instance in. The value must - // be a number between 1 and the number of availability domains specified in - // the spread placement policy attached to the instance. - optional int32 availability_domain = 1 [json_name = "availabilityDomain"]; -} - -// An instance's screenshot. -message Screenshot { - // [Output Only] The Base64-encoded screenshot data. - optional string contents = 1 [json_name = "contents"]; - - // [Output Only] Type of the resource. Always compute#screenshot for the - // screenshots. - optional string kind = 2 [json_name = "kind"]; -} - -// An instance serial console output. -message SerialPortOutput { - // [Output Only] The contents of the console output. - optional string contents = 1 [json_name = "contents"]; - - // [Output Only] Type of the resource. Always compute#serialPortOutput for - // serial port output. - optional string kind = 2 [json_name = "kind"]; - - // [Output Only] The position of the next byte of content, regardless of - // whether the content exists, following the output returned in the `contents` - // property. Use this value in the next request as the start parameter. - optional string next = 3 [json_name = "next"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 4 [json_name = "selfLink"]; - - // The starting byte position of the output that was returned. This should - // match the start parameter sent with the request. If the serial console - // output exceeds the size of the buffer (1 MB), older output is overwritten - // by newer content. The output start value will indicate the byte position of - // the output that was returned, which might be different than the `start` - // value that was specified in the request. - optional string start = 5 [json_name = "start"]; -} - -// A Shielded Instance Identity. -message ShieldedInstanceIdentity { - // An Endorsement Key (EK) made by the RSA 2048 algorithm issued to the - // Shielded Instance's vTPM. - optional ShieldedInstanceIdentityEntry encryption_key = 1 - [json_name = "encryptionKey"]; - - // [Output Only] Type of the resource. Always compute#shieldedInstanceIdentity - // for shielded Instance identity entry. - optional string kind = 2 [json_name = "kind"]; - - // An Attestation Key (AK) made by the RSA 2048 algorithm issued to the - // Shielded Instance's vTPM. - optional ShieldedInstanceIdentityEntry signing_key = 3 - [json_name = "signingKey"]; -} - -// A Shielded Instance Identity Entry. -message ShieldedInstanceIdentityEntry { - // A PEM-encoded X.509 certificate. This field can be empty. - optional string ek_cert = 1 [json_name = "ekCert"]; - - // A PEM-encoded public key. - optional string ek_pub = 2 [json_name = "ekPub"]; -} - -// The policy describes the baseline against which Instance boot integrity is -// measured. -message ShieldedInstanceIntegrityPolicy { - // Updates the integrity policy baseline using the measurements from the VM - // instance's most recent boot. - optional bool update_auto_learn_policy = 1 - [json_name = "updateAutoLearnPolicy"]; +// Deprecation status for a public resource. +message DeprecationStatus { + // An optional RFC3339 timestamp on or after which the state of this resource + // is intended to change to DELETED. This is only informational and the status + // will not change unless the client explicitly changes it. + optional string deleted = 1 [json_name = "deleted"]; + + // An optional RFC3339 timestamp on or after which the state of this resource + // is intended to change to DEPRECATED. This is only informational and the + // status will not change unless the client explicitly changes it. + optional string deprecated = 2 [json_name = "deprecated"]; + + // An optional RFC3339 timestamp on or after which the state of this resource + // is intended to change to OBSOLETE. This is only informational and the + // status will not change unless the client explicitly changes it. + optional string obsolete = 3 [json_name = "obsolete"]; + + // The URL of the suggested replacement for a deprecated resource. The + // suggested replacement resource must be the same kind of resource as the + // deprecated resource. + optional string replacement = 4 [json_name = "replacement"]; + + // The deprecation state of this resource. This can be ACTIVE, DEPRECATED, + // OBSOLETE, or DELETED. Operations which communicate the end of life date for + // an image, can use ACTIVE. Operations which create a new resource using a + // DEPRECATED resource will return successfully, but with a warning indicating + // the deprecated resource and recommending its replacement. Operations which + // use OBSOLETE or DELETED resources will be rejected and result in an error. + // ACTIVE: + // DELETED: + // DEPRECATED: + // OBSOLETE: + optional string state = 5 [json_name = "state"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_023.proto b/protos/google/cloud/compute/v1/internal/common_023.proto index 90f26a2fee6f6..dbd9b1ee8171b 100644 --- a/protos/google/cloud/compute/v1/internal/common_023.proto +++ b/protos/google/cloud/compute/v1/internal/common_023.proto @@ -15,43 +15,238 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Deprecation status for a public resource. -message DeprecationStatus { - // An optional RFC3339 timestamp on or after which the state of this resource - // is intended to change to DELETED. This is only informational and the status - // will not change unless the client explicitly changes it. - optional string deleted = 1 [json_name = "deleted"]; - - // An optional RFC3339 timestamp on or after which the state of this resource - // is intended to change to DEPRECATED. This is only informational and the - // status will not change unless the client explicitly changes it. - optional string deprecated = 2 [json_name = "deprecated"]; - - // An optional RFC3339 timestamp on or after which the state of this resource - // is intended to change to OBSOLETE. This is only informational and the - // status will not change unless the client explicitly changes it. - optional string obsolete = 3 [json_name = "obsolete"]; - - // The URL of the suggested replacement for a deprecated resource. The - // suggested replacement resource must be the same kind of resource as the - // deprecated resource. - optional string replacement = 4 [json_name = "replacement"]; - - // The deprecation state of this resource. This can be ACTIVE, DEPRECATED, - // OBSOLETE, or DELETED. Operations which communicate the end of life date for - // an image, can use ACTIVE. Operations which create a new resource using a - // DEPRECATED resource will return successfully, but with a warning indicating - // the deprecated resource and recommending its replacement. Operations which - // use OBSOLETE or DELETED resources will be rejected and result in an error. - // ACTIVE: - // DELETED: - // DEPRECATED: - // OBSOLETE: - optional string state = 5 [json_name = "state"]; +import "google/cloud/compute/v1/internal/common_014.proto"; + +message DiskAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of DisksScopedList resources. + map items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#diskAggregatedList for + // aggregated lists of persistent disks. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +message DisksAddResourcePoliciesRequest { + // Full or relative path to the resource policy to be added to this disk. You + // can only specify one resource policy. + repeated string resource_policies = 1 [json_name = "resourcePolicies"]; +} + +message DisksRemoveResourcePoliciesRequest { + // Resource policies to be removed from this disk. + repeated string resource_policies = 1 [json_name = "resourcePolicies"]; +} + +message DisksResizeRequest { + // The new size of the persistent disk, which is specified in GB. + optional string size_gb = 1 [json_name = "sizeGb"]; +} + +message DisksScopedList { + // [Output Only] A list of disks contained in this scope. + repeated Disk disks = 1 [json_name = "disks"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning which replaces the list of disks when + // the list is empty. + optional Warning warning = 2 [json_name = "warning"]; +} + +message DisksStartAsyncReplicationRequest { + // The secondary disk to start asynchronous replication to. You can provide + // this as a partial or full URL to the resource. For example, the following + // are valid values: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /disks/disk - + // https://www.googleapis.com/compute/v1/projects/project/regions/region + // /disks/disk - projects/project/zones/zone/disks/disk - + // projects/project/regions/region/disks/disk - zones/zone/disks/disk - + // regions/region/disks/disk + optional string async_secondary_disk = 1 [json_name = "asyncSecondaryDisk"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_024.proto b/protos/google/cloud/compute/v1/internal/common_024.proto index eda61282901b8..8057e8f1a3961 100644 --- a/protos/google/cloud/compute/v1/internal/common_024.proto +++ b/protos/google/cloud/compute/v1/internal/common_024.proto @@ -15,23 +15,131 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_015.proto"; +import "google/cloud/compute/v1/internal/common_003.proto"; + +// A specification of the desired way to instantiate a disk in the instance +// template when its created from a source instance. +message DiskInstantiationConfig { + // Specifies whether the disk will be auto-deleted when the instance is + // deleted (but not when the disk is detached from the instance). + optional bool auto_delete = 1 [json_name = "autoDelete"]; + + // The custom source image to be used to restore this disk when instantiating + // this instance template. + optional string custom_image = 2 [json_name = "customImage"]; + + // Specifies the device name of the disk to which the configurations apply to. + optional string device_name = 3 [json_name = "deviceName"]; + + // Specifies whether to include the disk and what image to use. Possible + // values are: - source-image: to use the same image that was used to create + // the source instance's corresponding disk. Applicable to the boot disk and + // additional read-write disks. - source-image-family: to use the same image + // family that was used to create the source instance's corresponding disk. + // Applicable to the boot disk and additional read-write disks. - + // custom-image: to use a user-provided image url for disk creation. + // Applicable to the boot disk and additional read-write disks. - + // attach-read-only: to attach a read-only disk. Applicable to read-only + // disks. - do-not-include: to exclude a disk from the template. Applicable to + // additional read-write disks, local SSDs, and read-only disks. + // ATTACH_READ_ONLY: Attach the existing disk in read-only mode. The request + // will fail if the disk was attached in read-write mode on the source + // instance. Applicable to: read-only disks. + // BLANK: Create a blank disk. The disk will be created unformatted. + // Applicable to: additional read-write disks, local SSDs. + // CUSTOM_IMAGE: Use the custom image specified in the custom_image field. + // Applicable to: boot disk, additional read-write disks. + // DEFAULT: Use the default instantiation option for the corresponding type of + // disk. For boot disk and any other R/W disks, new custom images will be + // created from each disk. For read-only disks, they will be attached in + // read-only mode. Local SSD disks will be created as blank volumes. + // DO_NOT_INCLUDE: Do not include the disk in the instance template. + // Applicable to: additional read-write disks, local SSDs, read-only disks. + // SOURCE_IMAGE: Use the same source image used for creation of the source + // instance's corresponding disk. The request will fail if the source VM's + // disk was created from a snapshot. Applicable to: boot disk, additional + // read-write disks. + // SOURCE_IMAGE_FAMILY: Use the same source image family used for creation of + // the source instance's corresponding disk. The request will fail if the + // source image of the source disk does not belong to any image family. + // Applicable to: boot disk, additional read-write disks. + optional string instantiate_from = 4 [json_name = "instantiateFrom"]; +} + +// Represents an Instance Template resource. Google Compute Engine has two +// Instance Template resources: * +// [Global](/compute/docs/reference/rest/v1/instanceTemplates) * +// [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates) You can +// reuse a global instance template in different regions whereas you can use a +// regional instance template in a specified region only. If you want to reduce +// cross-region dependency or achieve data residency, use a regional instance +// template. To create VMs, managed instance groups, and reservations, you can +// use either global or regional instance templates. For more information, read +// Instance Templates. +message InstanceTemplate { + // [Output Only] The creation timestamp for this instance template in RFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; + + // [Output Only] A unique identifier for this instance template. The server + // defines this identifier. + optional string id = 3 [json_name = "id"]; + + // [Output Only] The resource type, which is always compute#instanceTemplate + // for instance templates. + optional string kind = 4 [json_name = "kind"]; + + // 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. + optional string name = 5 [json_name = "name"]; + + // The instance properties for this instance template. + optional InstanceProperties properties = 6 [json_name = "properties"]; + + // [Output Only] URL of the region where the instance template resides. Only + // applicable for regional resources. + optional string region = 7 [json_name = "region"]; + + // [Output Only] The URL for this instance template. The server defines this + // URL. + optional string self_link = 8 [json_name = "selfLink"]; + + // The source instance used to create the template. You can provide this as a + // partial or full URL to the resource. For example, the following are valid + // values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /instances/instance - projects/project/zones/zone/instances/instance + optional string source_instance = 9 [json_name = "sourceInstance"]; + + // The source instance params to use to create this instance template. + optional SourceInstanceParams source_instance_params = 10 + [json_name = "sourceInstanceParams"]; +} -message DiskAggregatedList { +// A list of instance templates. +message InstanceTemplateList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of DisksScopedList resources. - map items = 2 [json_name = "items"]; + // A list of InstanceTemplate resources. + repeated InstanceTemplate items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#diskAggregatedList for - // aggregated lists of persistent disks. + // [Output Only] The resource type, which is always + // compute#instanceTemplatesListResponse for instance template lists. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -44,9 +152,6 @@ message DiskAggregatedList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -129,124 +234,15 @@ message DiskAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -message DisksAddResourcePoliciesRequest { - // Full or relative path to the resource policy to be added to this disk. You - // can only specify one resource policy. - repeated string resource_policies = 1 [json_name = "resourcePolicies"]; -} - -message DisksRemoveResourcePoliciesRequest { - // Resource policies to be removed from this disk. - repeated string resource_policies = 1 [json_name = "resourcePolicies"]; -} - -message DisksResizeRequest { - // The new size of the persistent disk, which is specified in GB. - optional string size_gb = 1 [json_name = "sizeGb"]; -} - -message DisksScopedList { - // [Output Only] A list of disks contained in this scope. - repeated Disk disks = 1 [json_name = "disks"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning which replaces the list of disks when - // the list is empty. - optional Warning warning = 2 [json_name = "warning"]; + optional Warning warning = 6 [json_name = "warning"]; } -message DisksStartAsyncReplicationRequest { - // The secondary disk to start asynchronous replication to. You can provide - // this as a partial or full URL to the resource. For example, the following - // are valid values: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /disks/disk - - // https://www.googleapis.com/compute/v1/projects/project/regions/region - // /disks/disk - projects/project/zones/zone/disks/disk - - // projects/project/regions/region/disks/disk - zones/zone/disks/disk - - // regions/region/disks/disk - optional string async_secondary_disk = 1 [json_name = "asyncSecondaryDisk"]; +// A specification of the parameters to use when creating the instance template +// from a source instance. +message SourceInstanceParams { + // Attached disks configuration. If not provided, defaults are applied: For + // boot disk and any other R/W disks, the source images for each disk will be + // used. For read-only disks, they will be attached in read-only mode. Local + // SSD disks will be created as blank volumes. + repeated DiskInstantiationConfig disk_configs = 1 [json_name = "diskConfigs"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_025.proto b/protos/google/cloud/compute/v1/internal/common_025.proto index cf96398967a2d..770772157d908 100644 --- a/protos/google/cloud/compute/v1/internal/common_025.proto +++ b/protos/google/cloud/compute/v1/internal/common_025.proto @@ -15,131 +15,208 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_003.proto"; - -// A specification of the desired way to instantiate a disk in the instance -// template when its created from a source instance. -message DiskInstantiationConfig { - // Specifies whether the disk will be auto-deleted when the instance is - // deleted (but not when the disk is detached from the instance). - optional bool auto_delete = 1 [json_name = "autoDelete"]; - - // The custom source image to be used to restore this disk when instantiating - // this instance template. - optional string custom_image = 2 [json_name = "customImage"]; - - // Specifies the device name of the disk to which the configurations apply to. - optional string device_name = 3 [json_name = "deviceName"]; - - // Specifies whether to include the disk and what image to use. Possible - // values are: - source-image: to use the same image that was used to create - // the source instance's corresponding disk. Applicable to the boot disk and - // additional read-write disks. - source-image-family: to use the same image - // family that was used to create the source instance's corresponding disk. - // Applicable to the boot disk and additional read-write disks. - - // custom-image: to use a user-provided image url for disk creation. - // Applicable to the boot disk and additional read-write disks. - - // attach-read-only: to attach a read-only disk. Applicable to read-only - // disks. - do-not-include: to exclude a disk from the template. Applicable to - // additional read-write disks, local SSDs, and read-only disks. - // ATTACH_READ_ONLY: Attach the existing disk in read-only mode. The request - // will fail if the disk was attached in read-write mode on the source - // instance. Applicable to: read-only disks. - // BLANK: Create a blank disk. The disk will be created unformatted. - // Applicable to: additional read-write disks, local SSDs. - // CUSTOM_IMAGE: Use the custom image specified in the custom_image field. - // Applicable to: boot disk, additional read-write disks. - // DEFAULT: Use the default instantiation option for the corresponding type of - // disk. For boot disk and any other R/W disks, new custom images will be - // created from each disk. For read-only disks, they will be attached in - // read-only mode. Local SSD disks will be created as blank volumes. - // DO_NOT_INCLUDE: Do not include the disk in the instance template. - // Applicable to: additional read-write disks, local SSDs, read-only disks. - // SOURCE_IMAGE: Use the same source image used for creation of the source - // instance's corresponding disk. The request will fail if the source VM's - // disk was created from a snapshot. Applicable to: boot disk, additional - // read-write disks. - // SOURCE_IMAGE_FAMILY: Use the same source image family used for creation of - // the source instance's corresponding disk. The request will fail if the - // source image of the source disk does not belong to any image family. - // Applicable to: boot disk, additional read-write disks. - optional string instantiate_from = 4 [json_name = "instantiateFrom"]; +import "google/cloud/compute/v1/internal/common_076.proto"; +import "google/cloud/compute/v1/internal/common_092.proto"; + +message DiskMoveRequest { + // The URL of the destination zone to move the disk. This can be a full or + // partial URL. For example, the following are all valid URLs to a zone: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone - + // projects/project/zones/zone - zones/zone + optional string destination_zone = 1 [json_name = "destinationZone"]; + + // 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: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /disks/disk - projects/project/zones/zone/disks/disk - + // zones/zone/disks/disk + optional string target_disk = 2 [json_name = "targetDisk"]; +} + +message InstanceMoveRequest { + // The URL of the destination zone to move the instance. This can be a full or + // partial URL. For example, the following are all valid URLs to a zone: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone - + // projects/project/zones/zone - zones/zone + optional string destination_zone = 1 [json_name = "destinationZone"]; + + // The URL of the target instance to move. This can be a full or partial URL. + // For example, the following are all valid URLs to an instance: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /instances/instance - projects/project/zones/zone/instances/instance - + // zones/zone/instances/instance + optional string target_instance = 2 [json_name = "targetInstance"]; +} + +// Represents a Project resource. A project is used to organize resources in a +// Google Cloud Platform environment. For more information, read about the +// Resource Hierarchy. +message Project { + // [Output Only] The Cloud Armor tier for this project. It can be one of the + // following values: CA_STANDARD, CA_ENTERPRISE_PAYGO. If this field is not + // specified, it is assumed to be CA_STANDARD. + // CA_ENTERPRISE_ANNUAL: Enterprise tier protection billed annually. + // CA_ENTERPRISE_PAYGO: Enterprise tier protection billed monthly. + // CA_STANDARD: Standard protection. + optional string cloud_armor_tier = 15 [json_name = "cloudArmorTier"]; + + // Metadata key/value pairs available to all instances contained in this + // project. See Custom metadata for more information. + optional Metadata common_instance_metadata = 1 + [json_name = "commonInstanceMetadata"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // This signifies the default network tier used for configuring resources of + // the project and can only take the following values: PREMIUM, STANDARD. + // Initially the default network tier is PREMIUM. + // FIXED_STANDARD: Public internet quality with fixed bandwidth. + // PREMIUM: High quality, Google-grade network tier, support for all + // networking products. + // STANDARD: Public internet quality, only limited support for other + // networking products. + // STANDARD_OVERRIDES_FIXED_STANDARD: (Output only) Temporary tier for + // FIXED_STANDARD when fixed standard tier is expired or not configured. + optional string default_network_tier = 3 [json_name = "defaultNetworkTier"]; + + // [Output Only] Default service account used by VMs running in this project. + optional string default_service_account = 4 + [json_name = "defaultServiceAccount"]; + + // An optional textual description of the resource. + optional string description = 5 [json_name = "description"]; + + // Restricted features enabled for use on this project. + repeated string enabled_features = 6 [json_name = "enabledFeatures"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. This is *not* the project ID, and is just a unique + // ID used by Compute Engine to identify resources. + optional string id = 7 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#project for projects. + optional string kind = 8 [json_name = "kind"]; + + // The project ID. For example: my-example-project. Use the project ID to make + // requests to Compute Engine. + optional string name = 9 [json_name = "name"]; + + // [Output Only] Quotas assigned to this project. + repeated Quota quotas = 10 [json_name = "quotas"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 11 [json_name = "selfLink"]; + + // The naming prefix for daily usage reports and the Google Cloud Storage + // bucket where they are stored. + optional UsageExportLocation usage_export_location = 12 + [json_name = "usageExportLocation"]; + + // [Output Only] Default internal DNS setting used by VMs running in this + // project. + // GLOBAL_DEFAULT: + // UNSPECIFIED_VM_DNS_SETTING: + // ZONAL_DEFAULT: + // ZONAL_ONLY: + optional string vm_dns_setting = 13 [json_name = "vmDnsSetting"]; + + // [Output Only] The role this project has in a shared VPC configuration. + // Currently, only projects with the host role, which is specified by the + // value HOST, are differentiated. + // HOST: + // UNSPECIFIED_XPN_PROJECT_STATUS: + optional string xpn_project_status = 14 [json_name = "xpnProjectStatus"]; } -// Represents an Instance Template resource. Google Compute Engine has two -// Instance Template resources: * -// [Global](/compute/docs/reference/rest/v1/instanceTemplates) * -// [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates) You can -// reuse a global instance template in different regions whereas you can use a -// regional instance template in a specified region only. If you want to reduce -// cross-region dependency or achieve data residency, use a regional instance -// template. To create VMs, managed instance groups, and reservations, you can -// use either global or regional instance templates. For more information, read -// Instance Templates. -message InstanceTemplate { - // [Output Only] The creation timestamp for this instance template in RFC3339 - // text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // [Output Only] A unique identifier for this instance template. The server - // defines this identifier. - optional string id = 3 [json_name = "id"]; - - // [Output Only] The resource type, which is always compute#instanceTemplate - // for instance templates. - optional string kind = 4 [json_name = "kind"]; - - // 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. - optional string name = 5 [json_name = "name"]; - - // The instance properties for this instance template. - optional InstanceProperties properties = 6 [json_name = "properties"]; - - // [Output Only] URL of the region where the instance template resides. Only - // applicable for regional resources. - optional string region = 7 [json_name = "region"]; - - // [Output Only] The URL for this instance template. The server defines this - // URL. - optional string self_link = 8 [json_name = "selfLink"]; - - // The source instance used to create the template. You can provide this as a - // partial or full URL to the resource. For example, the following are valid - // values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /instances/instance - projects/project/zones/zone/instances/instance - optional string source_instance = 9 [json_name = "sourceInstance"]; - - // The source instance params to use to create this instance template. - optional SourceInstanceParams source_instance_params = 10 - [json_name = "sourceInstanceParams"]; +message ProjectsDisableXpnResourceRequest { + // Service resource (a.k.a service project) ID. + optional XpnResourceId xpn_resource = 1 [json_name = "xpnResource"]; } -// A list of instance templates. -message InstanceTemplateList { +message ProjectsEnableXpnResourceRequest { + // Service resource (a.k.a service project) ID. + optional XpnResourceId xpn_resource = 1 [json_name = "xpnResource"]; +} + +message ProjectsGetXpnResources { + // [Output Only] Type of resource. Always compute#projectsGetXpnResources for + // lists of service resources (a.k.a service projects) + optional string kind = 1 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 2 [json_name = "nextPageToken"]; + + // Service resources (a.k.a service projects) attached to this project as + // their shared VPC host. + repeated XpnResourceId resources = 3 [json_name = "resources"]; +} + +message ProjectsListXpnHostsRequest { + // Optional organization ID managed by Cloud Resource Manager, for which to + // list shared VPC host projects. If not specified, the organization will be + // inferred from the project. + optional string organization = 1 [json_name = "organization"]; +} + +message ProjectsSetCloudArmorTierRequest { + // Managed protection tier to be set. + // CA_ENTERPRISE_ANNUAL: Enterprise tier protection billed annually. + // CA_ENTERPRISE_PAYGO: Enterprise tier protection billed monthly. + // CA_STANDARD: Standard protection. + optional string cloud_armor_tier = 1 [json_name = "cloudArmorTier"]; +} + +message ProjectsSetDefaultNetworkTierRequest { + // Default network tier to be set. + // FIXED_STANDARD: Public internet quality with fixed bandwidth. + // PREMIUM: High quality, Google-grade network tier, support for all + // networking products. + // STANDARD: Public internet quality, only limited support for other + // networking products. + // STANDARD_OVERRIDES_FIXED_STANDARD: (Output only) Temporary tier for + // FIXED_STANDARD when fixed standard tier is expired or not configured. + optional string network_tier = 1 [json_name = "networkTier"]; +} + +// The location in Cloud Storage and naming method of the daily usage report. +// Contains bucket_name and report_name prefix. +message UsageExportLocation { + // The name of an existing bucket in Cloud Storage where the usage report + // object is stored. The Google Service Account is granted write access to + // this bucket. This can either be the bucket name by itself, such as + // example-bucket, or the bucket name with gs:// or + // https://storage.googleapis.com/ in front of it, such as + // gs://example-bucket. + optional string bucket_name = 1 [json_name = "bucketName"]; + + // An optional prefix for the name of the usage report object stored in + // bucketName. If not supplied, defaults to usage_gce. The report is stored as + // a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the + // day of the usage according to Pacific Time. If you supply a prefix, it + // should conform to Cloud Storage object naming conventions. + optional string report_name_prefix = 2 [json_name = "reportNamePrefix"]; +} + +message XpnHostList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of InstanceTemplate resources. - repeated InstanceTemplate items = 2 [json_name = "items"]; + // [Output Only] A list of shared VPC host project URLs. + repeated Project items = 2 [json_name = "items"]; - // [Output Only] The resource type, which is always - // compute#instanceTemplatesListResponse for instance template lists. + // [Output Only] Type of resource. Always compute#xpnHostList for lists of + // shared VPC hosts. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -237,12 +314,15 @@ message InstanceTemplateList { optional Warning warning = 6 [json_name = "warning"]; } -// A specification of the parameters to use when creating the instance template -// from a source instance. -message SourceInstanceParams { - // Attached disks configuration. If not provided, defaults are applied: For - // boot disk and any other R/W disks, the source images for each disk will be - // used. For read-only disks, they will be attached in read-only mode. Local - // SSD disks will be created as blank volumes. - repeated DiskInstantiationConfig disk_configs = 1 [json_name = "diskConfigs"]; +// Service resource (a.k.a service project) ID. +message XpnResourceId { + // The ID of the service resource. In the case of projects, this field + // supports project id (e.g., my-project-123) and project number (e.g. + // 12345678). + optional string id = 1 [json_name = "id"]; + + // The type of the service resource. + // PROJECT: + // XPN_RESOURCE_TYPE_UNSPECIFIED: + optional string type = 2 [json_name = "type"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_026.proto b/protos/google/cloud/compute/v1/internal/common_026.proto index 9e609594384d7..a28422560e4cd 100644 --- a/protos/google/cloud/compute/v1/internal/common_026.proto +++ b/protos/google/cloud/compute/v1/internal/common_026.proto @@ -15,314 +15,59 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_078.proto"; -import "google/cloud/compute/v1/internal/common_094.proto"; - -message DiskMoveRequest { - // The URL of the destination zone to move the disk. This can be a full or - // partial URL. For example, the following are all valid URLs to a zone: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - - // projects/project/zones/zone - zones/zone - optional string destination_zone = 1 [json_name = "destinationZone"]; - - // 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: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /disks/disk - projects/project/zones/zone/disks/disk - - // zones/zone/disks/disk - optional string target_disk = 2 [json_name = "targetDisk"]; -} - -message InstanceMoveRequest { - // The URL of the destination zone to move the instance. This can be a full or - // partial URL. For example, the following are all valid URLs to a zone: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - - // projects/project/zones/zone - zones/zone - optional string destination_zone = 1 [json_name = "destinationZone"]; - - // The URL of the target instance to move. This can be a full or partial URL. - // For example, the following are all valid URLs to an instance: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /instances/instance - projects/project/zones/zone/instances/instance - - // zones/zone/instances/instance - optional string target_instance = 2 [json_name = "targetInstance"]; -} - -// Represents a Project resource. A project is used to organize resources in a -// Google Cloud Platform environment. For more information, read about the -// Resource Hierarchy. -message Project { - // [Output Only] The Cloud Armor tier for this project. It can be one of the - // following values: CA_STANDARD, CA_ENTERPRISE_PAYGO. If this field is not - // specified, it is assumed to be CA_STANDARD. - // CA_ENTERPRISE_ANNUAL: Enterprise tier protection billed annually. - // CA_ENTERPRISE_PAYGO: Enterprise tier protection billed monthly. - // CA_STANDARD: Standard protection. - optional string cloud_armor_tier = 15 [json_name = "cloudArmorTier"]; - - // Metadata key/value pairs available to all instances contained in this - // project. See Custom metadata for more information. - optional Metadata common_instance_metadata = 1 - [json_name = "commonInstanceMetadata"]; - +import "google/cloud/compute/v1/internal/common_022.proto"; + +// Represents a Disk Type resource. Google Compute Engine has two Disk Type +// resources: * [Regional](/compute/docs/reference/rest/v1/regionDiskTypes) * +// [Zonal](/compute/docs/reference/rest/v1/diskTypes) You can choose from a +// variety of disk types based on your needs. For more information, read Storage +// options. The diskTypes resource represents disk types for a zonal persistent +// disk. For more information, read Zonal persistent disks. The regionDiskTypes +// resource represents disk types for a regional persistent disk. For more +// information, read Regional persistent disks. +message DiskType { // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // This signifies the default network tier used for configuring resources of - // the project and can only take the following values: PREMIUM, STANDARD. - // Initially the default network tier is PREMIUM. - // FIXED_STANDARD: Public internet quality with fixed bandwidth. - // PREMIUM: High quality, Google-grade network tier, support for all - // networking products. - // STANDARD: Public internet quality, only limited support for other - // networking products. - // STANDARD_OVERRIDES_FIXED_STANDARD: (Output only) Temporary tier for - // FIXED_STANDARD when fixed standard tier is expired or not configured. - optional string default_network_tier = 3 [json_name = "defaultNetworkTier"]; + // [Output Only] Server-defined default disk size in GB. + optional string default_disk_size_gb = 2 [json_name = "defaultDiskSizeGb"]; - // [Output Only] Default service account used by VMs running in this project. - optional string default_service_account = 4 - [json_name = "defaultServiceAccount"]; + // [Output Only] The deprecation status associated with this disk type. + optional DeprecationStatus deprecated = 3 [json_name = "deprecated"]; - // An optional textual description of the resource. - optional string description = 5 [json_name = "description"]; - - // Restricted features enabled for use on this project. - repeated string enabled_features = 6 [json_name = "enabledFeatures"]; + // [Output Only] An optional description of this resource. + optional string description = 4 [json_name = "description"]; // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. This is *not* the project ID, and is just a unique - // ID used by Compute Engine to identify resources. - optional string id = 7 [json_name = "id"]; + // defined by the server. + optional string id = 5 [json_name = "id"]; - // [Output Only] Type of the resource. Always compute#project for projects. - optional string kind = 8 [json_name = "kind"]; + // [Output Only] Type of the resource. Always compute#diskType for disk types. + optional string kind = 6 [json_name = "kind"]; - // The project ID. For example: my-example-project. Use the project ID to make - // requests to Compute Engine. - optional string name = 9 [json_name = "name"]; + // [Output Only] Name of the resource. + optional string name = 7 [json_name = "name"]; - // [Output Only] Quotas assigned to this project. - repeated Quota quotas = 10 [json_name = "quotas"]; + // [Output Only] URL of the region where the disk type resides. Only + // applicable for regional resources. You must specify this field as part of + // the HTTP request URL. It is not settable as a field in the request body. + optional string region = 8 [json_name = "region"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 11 [json_name = "selfLink"]; - - // The naming prefix for daily usage reports and the Google Cloud Storage - // bucket where they are stored. - optional UsageExportLocation usage_export_location = 12 - [json_name = "usageExportLocation"]; - - // [Output Only] Default internal DNS setting used by VMs running in this - // project. - // GLOBAL_DEFAULT: - // UNSPECIFIED_VM_DNS_SETTING: - // ZONAL_DEFAULT: - // ZONAL_ONLY: - optional string vm_dns_setting = 13 [json_name = "vmDnsSetting"]; - - // [Output Only] The role this project has in a shared VPC configuration. - // Currently, only projects with the host role, which is specified by the - // value HOST, are differentiated. - // HOST: - // UNSPECIFIED_XPN_PROJECT_STATUS: - optional string xpn_project_status = 14 [json_name = "xpnProjectStatus"]; -} - -message ProjectsDisableXpnResourceRequest { - // Service resource (a.k.a service project) ID. - optional XpnResourceId xpn_resource = 1 [json_name = "xpnResource"]; -} - -message ProjectsEnableXpnResourceRequest { - // Service resource (a.k.a service project) ID. - optional XpnResourceId xpn_resource = 1 [json_name = "xpnResource"]; -} - -message ProjectsGetXpnResources { - // [Output Only] Type of resource. Always compute#projectsGetXpnResources for - // lists of service resources (a.k.a service projects) - optional string kind = 1 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 2 [json_name = "nextPageToken"]; - - // Service resources (a.k.a service projects) attached to this project as - // their shared VPC host. - repeated XpnResourceId resources = 3 [json_name = "resources"]; -} - -message ProjectsListXpnHostsRequest { - // Optional organization ID managed by Cloud Resource Manager, for which to - // list shared VPC host projects. If not specified, the organization will be - // inferred from the project. - optional string organization = 1 [json_name = "organization"]; -} - -message ProjectsSetCloudArmorTierRequest { - // Managed protection tier to be set. - // CA_ENTERPRISE_ANNUAL: Enterprise tier protection billed annually. - // CA_ENTERPRISE_PAYGO: Enterprise tier protection billed monthly. - // CA_STANDARD: Standard protection. - optional string cloud_armor_tier = 1 [json_name = "cloudArmorTier"]; -} - -message ProjectsSetDefaultNetworkTierRequest { - // Default network tier to be set. - // FIXED_STANDARD: Public internet quality with fixed bandwidth. - // PREMIUM: High quality, Google-grade network tier, support for all - // networking products. - // STANDARD: Public internet quality, only limited support for other - // networking products. - // STANDARD_OVERRIDES_FIXED_STANDARD: (Output only) Temporary tier for - // FIXED_STANDARD when fixed standard tier is expired or not configured. - optional string network_tier = 1 [json_name = "networkTier"]; -} - -// The location in Cloud Storage and naming method of the daily usage report. -// Contains bucket_name and report_name prefix. -message UsageExportLocation { - // The name of an existing bucket in Cloud Storage where the usage report - // object is stored. The Google Service Account is granted write access to - // this bucket. This can either be the bucket name by itself, such as - // example-bucket, or the bucket name with gs:// or - // https://storage.googleapis.com/ in front of it, such as - // gs://example-bucket. - optional string bucket_name = 1 [json_name = "bucketName"]; - - // An optional prefix for the name of the usage report object stored in - // bucketName. If not supplied, defaults to usage_gce. The report is stored as - // a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the - // day of the usage according to Pacific Time. If you supply a prefix, it - // should conform to Cloud Storage object naming conventions. - optional string report_name_prefix = 2 [json_name = "reportNamePrefix"]; -} - -message XpnHostList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // [Output Only] A list of shared VPC host project URLs. - repeated Project items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#xpnHostList for lists of - // shared VPC hosts. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} + optional string self_link = 9 [json_name = "selfLink"]; -// Service resource (a.k.a service project) ID. -message XpnResourceId { - // The ID of the service resource. In the case of projects, this field - // supports project id (e.g., my-project-123) and project number (e.g. - // 12345678). - optional string id = 1 [json_name = "id"]; + // [Output Only] An optional textual description of the valid disk size, such + // as "10GB-10TB". + optional string valid_disk_size = 10 [json_name = "validDiskSize"]; - // The type of the service resource. - // PROJECT: - // XPN_RESOURCE_TYPE_UNSPECIFIED: - optional string type = 2 [json_name = "type"]; + // [Output Only] URL of the zone where the disk type resides. You must specify + // this field as part of the HTTP request URL. It is not settable as a field + // in the request body. + optional string zone = 11 [json_name = "zone"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_027.proto b/protos/google/cloud/compute/v1/internal/common_027.proto index 9eac3003a793d..6b62b2ad90dab 100644 --- a/protos/google/cloud/compute/v1/internal/common_027.proto +++ b/protos/google/cloud/compute/v1/internal/common_027.proto @@ -15,59 +15,314 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; +import "google/cloud/compute/v1/internal/common_026.proto"; -// Represents a Disk Type resource. Google Compute Engine has two Disk Type -// resources: * [Regional](/compute/docs/reference/rest/v1/regionDiskTypes) * -// [Zonal](/compute/docs/reference/rest/v1/diskTypes) You can choose from a -// variety of disk types based on your needs. For more information, read Storage -// options. The diskTypes resource represents disk types for a zonal persistent -// disk. For more information, read Zonal persistent disks. The regionDiskTypes -// resource represents disk types for a regional persistent disk. For more -// information, read Regional persistent disks. -message DiskType { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; +message DiskTypeAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; - // [Output Only] Server-defined default disk size in GB. - optional string default_disk_size_gb = 2 [json_name = "defaultDiskSizeGb"]; + // A list of DiskTypesScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] The deprecation status associated with this disk type. - optional DeprecationStatus deprecated = 3 [json_name = "deprecated"]; + // [Output Only] Type of resource. Always compute#diskTypeAggregatedList. + optional string kind = 3 [json_name = "kind"]; - // [Output Only] An optional description of this resource. - optional string description = 4 [json_name = "description"]; + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 5 [json_name = "id"]; + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Type of the resource. Always compute#diskType for disk types. - optional string kind = 6 [json_name = "kind"]; + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; - // [Output Only] Name of the resource. - optional string name = 7 [json_name = "name"]; + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; - // [Output Only] URL of the region where the disk type resides. Only - // applicable for regional resources. You must specify this field as part of - // the HTTP request URL. It is not settable as a field in the request body. - optional string region = 8 [json_name = "region"]; + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; - // [Output Only] Server-defined URL for the resource. - optional string self_link = 9 [json_name = "selfLink"]; + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } - // [Output Only] An optional textual description of the valid disk size, such - // as "10GB-10TB". - optional string valid_disk_size = 10 [json_name = "validDiskSize"]; + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; - // [Output Only] URL of the zone where the disk type resides. You must specify - // this field as part of the HTTP request URL. It is not settable as a field - // in the request body. - optional string zone = 11 [json_name = "zone"]; + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +// Contains a list of disk types. +message DiskTypeList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of DiskType resources. + repeated DiskType items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#diskTypeList for disk types. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message DiskTypesScopedList { + // [Output Only] A list of disk types contained in this scope. + repeated DiskType disk_types = 1 [json_name = "diskTypes"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning which replaces the list of disk types + // when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_028.proto b/protos/google/cloud/compute/v1/internal/common_028.proto index 3fdd9a3e60e1f..fa0daaec33d9d 100644 --- a/protos/google/cloud/compute/v1/internal/common_028.proto +++ b/protos/google/cloud/compute/v1/internal/common_028.proto @@ -15,314 +15,921 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_027.proto"; - -message DiskTypeAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of DiskTypesScopedList resources. - map items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#diskTypeAggregatedList. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_039.proto"; +import "google/cloud/compute/v1/internal/common_078.proto"; + +message DistributionPolicy { + // The distribution shape to which the group converges either proactively or + // on resize events (depending on the value set in + // updatePolicy.instanceRedistributionType). + // ANY: The group picks zones for creating VM instances to fulfill the + // requested number of VMs within present resource constraints and to maximize + // utilization of unused zonal reservations. Recommended for batch workloads + // that do not require high availability. + // ANY_SINGLE_ZONE: The group creates all VM instances within a single zone. + // The zone is selected based on the present resource constraints and to + // maximize utilization of unused zonal reservations. Recommended for batch + // workloads with heavy interprocess communication. + // BALANCED: The group prioritizes acquisition of resources, scheduling VMs in + // zones where resources are available while distributing VMs as evenly as + // possible across selected zones to minimize the impact of zonal failure. + // Recommended for highly available serving workloads. + // EVEN: The group schedules VM instance creation and deletion to achieve and + // maintain an even number of managed instances across the selected zones. The + // distribution is even when the number of managed instances does not differ + // by more than 1 between any two zones. Recommended for highly available + // serving workloads. + optional string target_shape = 1 [json_name = "targetShape"]; + + // Zones where the regional managed instance group will create and manage its + // instances. + repeated DistributionPolicyZoneConfiguration zones = 2 [json_name = "zones"]; +} - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; +message DistributionPolicyZoneConfiguration { + // The URL of the zone. The zone must exist in the region where the managed + // instance group is located. + optional string zone = 1 [json_name = "zone"]; +} - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +// Represents a Managed Instance Group resource. An instance group is a +// collection of VM instances that you can manage as a single entity. For more +// information, read Instance groups. For zonal Managed Instance Group, use the +// instanceGroupManagers resource. For regional Managed Instance Group, use the +// regionInstanceGroupManagers resource. +message InstanceGroupManager { + // Specifies configuration that overrides the instance template configuration + // for the group. + optional InstanceGroupManagerAllInstancesConfig all_instances_config = 25 + [json_name = "allInstancesConfig"]; + + // The autohealing policy for this managed instance group. You can specify + // only one value. + repeated InstanceGroupManagerAutoHealingPolicy auto_healing_policies = 1 + [json_name = "autoHealingPolicies"]; + + // The base instance name is a prefix that you want to attach to the names of + // all VMs in a MIG. The maximum character length is 58 and the name must + // comply with RFC1035 format. When a VM is created in the group, the MIG + // appends a hyphen and a random four-character string to the base instance + // name. If you want the MIG to assign sequential numbers instead of a random + // string, then end the base instance name with a hyphen followed by one or + // more hash symbols. The hash symbols indicate the number of digits. For + // example, a base instance name of "vm-###" results in "vm-001" as a VM name. + // @pattern + // [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?)) + optional string base_instance_name = 2 [json_name = "baseInstanceName"]; + + // [Output Only] The creation timestamp for this managed instance group in + // RFC3339 text format. + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + + // [Output Only] The list of instance actions and the number of instances in + // this managed instance group that are scheduled for each of those actions. + optional InstanceGroupManagerActionsSummary current_actions = 4 + [json_name = "currentActions"]; + + // An optional description of this resource. + optional string description = 5 [json_name = "description"]; + + // Policy specifying the intended distribution of managed instances across + // zones in a regional managed instance group. + optional DistributionPolicy distribution_policy = 6 + [json_name = "distributionPolicy"]; + + // Fingerprint of this resource. This field may be used in optimistic locking. + // It will be ignored when inserting an InstanceGroupManager. An up-to-date + // fingerprint must be provided in order to update the InstanceGroupManager, + // otherwise the request will fail with error 412 conditionNotMet. To see the + // latest fingerprint, make a get() request to retrieve an + // InstanceGroupManager. + optional string fingerprint = 7 [json_name = "fingerprint"]; + + // [Output Only] A unique identifier for this resource type. The server + // generates this identifier. + optional string id = 8 [json_name = "id"]; + + // Instance flexibility allowing MIG to create VMs from multiple types of + // machines. Instance flexibility configuration on MIG overrides instance + // template configuration. + optional InstanceGroupManagerInstanceFlexibilityPolicy + instance_flexibility_policy = 28 + [json_name = "instanceFlexibilityPolicy"]; + + // [Output Only] The URL of the Instance Group resource. + optional string instance_group = 9 [json_name = "instanceGroup"]; + + // The repair policy for this managed instance group. + optional InstanceGroupManagerInstanceLifecyclePolicy + instance_lifecycle_policy = 24 [json_name = "instanceLifecyclePolicy"]; + + // The URL of the instance template that is specified for this managed + // instance group. The group uses this template to create all new instances in + // the managed instance group. The templates for existing instances in the + // group do not change unless you run recreateInstances, run + // applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + optional string instance_template = 10 [json_name = "instanceTemplate"]; + + // [Output Only] The resource type, which is always + // compute#instanceGroupManager for managed instance groups. + optional string kind = 11 [json_name = "kind"]; + + // Pagination behavior of the listManagedInstances API method for this managed + // instance group. + // PAGELESS: (Default) Pagination is disabled for the group's + // listManagedInstances API method. maxResults and pageToken query parameters + // are ignored and all instances are returned in a single response. + // PAGINATED: Pagination is enabled for the group's listManagedInstances API + // method. maxResults and pageToken query parameters are respected. + optional string list_managed_instances_results = 12 + [json_name = "listManagedInstancesResults"]; + + // The name of the managed instance group. The name must be 1-63 characters + // long, and comply with RFC1035. + optional string name = 13 [json_name = "name"]; + + // [Output Only] Named ports configured on the Instance Groups complementary + // to this Instance Group Manager. + repeated NamedPort named_ports = 14 [json_name = "namedPorts"]; + + // [Output Only] The URL of the region where the managed instance group + // resides (for regional resources). + optional string region = 15 [json_name = "region"]; + + // [Output Only] Reserved for future use. + optional bool satisfies_pzi = 26 [json_name = "satisfiesPzi"]; + + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 27 [json_name = "satisfiesPzs"]; + + // [Output Only] The URL for this managed instance group. The server defines + // this URL. + optional string self_link = 16 [json_name = "selfLink"]; + + // Stateful configuration for this Instanced Group Manager + optional StatefulPolicy stateful_policy = 17 [json_name = "statefulPolicy"]; + + // [Output Only] The status of this managed instance group. + optional InstanceGroupManagerStatus status = 18 [json_name = "status"]; + + // The URLs for all TargetPool resources to which instances in the + // instanceGroup field are added. The target pools automatically apply to all + // of the instances in the managed instance group. + repeated string target_pools = 19 [json_name = "targetPools"]; + + // The target number of running instances for this managed instance group. You + // can reduce this number by using the instanceGroupManager deleteInstances or + // abandonInstances methods. Resizing the group also changes this number. + optional int32 target_size = 20 [json_name = "targetSize"]; + + // The update policy for this managed instance group. + optional InstanceGroupManagerUpdatePolicy update_policy = 21 + [json_name = "updatePolicy"]; + + // Specifies the instance templates used by this managed instance group to + // create instances. Each version is defined by an instanceTemplate and a + // name. Every version can appear at most once per instance group. This field + // overrides the top-level instanceTemplate field. Read more about the + // relationships between these fields. Exactly one version must leave the + // targetSize field unset. That version will be applied to all remaining + // instances. For more information, read about canary updates. + repeated InstanceGroupManagerVersion versions = 22 [json_name = "versions"]; + + // [Output Only] The URL of a zone where the managed instance group is located + // (for zonal resources). + optional string zone = 23 [json_name = "zone"]; +} - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -// Contains a list of disk types. -message DiskTypeList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of DiskType resources. - repeated DiskType items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#diskTypeList for disk types. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } +message InstanceGroupManagerActionsSummary { + // [Output Only] The total number of instances in the managed instance group + // that are scheduled to be abandoned. Abandoning an instance removes it from + // the managed instance group without deleting it. + optional int32 abandoning = 1 [json_name = "abandoning"]; + + // [Output Only] The number of instances in the managed instance group that + // are scheduled to be created or are currently being created. If the group + // fails to create any of these instances, it tries again until it creates the + // instance successfully. If you have disabled creation retries, this field + // will not be populated; instead, the creatingWithoutRetries field will be + // populated. + optional int32 creating = 2 [json_name = "creating"]; + + // [Output Only] The number of instances that the managed instance group will + // attempt to create. The group attempts to create each instance only once. If + // the group fails to create any of these instances, it decreases the group's + // targetSize value accordingly. + optional int32 creating_without_retries = 3 + [json_name = "creatingWithoutRetries"]; + + // [Output Only] The number of instances in the managed instance group that + // are scheduled to be deleted or are currently being deleted. + optional int32 deleting = 4 [json_name = "deleting"]; + + // [Output Only] The number of instances in the managed instance group that + // are running and have no scheduled actions. + optional int32 none = 5 [json_name = "none"]; + + // [Output Only] The number of instances in the managed instance group that + // are scheduled to be recreated or are currently being being recreated. + // Recreating an instance deletes the existing root persistent disk and + // creates a new disk from the image that is defined in the instance template. + optional int32 recreating = 6 [json_name = "recreating"]; + + // [Output Only] The number of instances in the managed instance group that + // are being reconfigured with properties that do not require a restart or a + // recreate action. For example, setting or removing target pools for the + // instance. + optional int32 refreshing = 7 [json_name = "refreshing"]; + + // [Output Only] The number of instances in the managed instance group that + // are scheduled to be restarted or are currently being restarted. + optional int32 restarting = 8 [json_name = "restarting"]; + + // [Output Only] The number of instances in the managed instance group that + // are scheduled to be resumed or are currently being resumed. + optional int32 resuming = 9 [json_name = "resuming"]; + + // [Output Only] The number of instances in the managed instance group that + // are scheduled to be started or are currently being started. + optional int32 starting = 10 [json_name = "starting"]; + + // [Output Only] The number of instances in the managed instance group that + // are scheduled to be stopped or are currently being stopped. + optional int32 stopping = 11 [json_name = "stopping"]; + + // [Output Only] The number of instances in the managed instance group that + // are scheduled to be suspended or are currently being suspended. + optional int32 suspending = 12 [json_name = "suspending"]; + + // [Output Only] The number of instances in the managed instance group that + // are being verified. See the managedInstances[].currentAction property in + // the listManagedInstances method documentation. + optional int32 verifying = 13 [json_name = "verifying"]; +} - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; +message InstanceGroupManagerAllInstancesConfig { + // Properties to set on all instances in the group. You can add or modify + // properties using the instanceGroupManagers.patch or + // regionInstanceGroupManagers.patch. After setting allInstancesConfig on the + // group, you must update the group's instances to apply the configuration. To + // apply the configuration, set the group's updatePolicy.type field to use + // proactive updates or use the applyUpdatesToInstances method. + optional InstancePropertiesPatch properties = 1 [json_name = "properties"]; +} - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +message InstanceGroupManagerAutoHealingPolicy { + // The URL for the health check that signals autohealing. + optional string health_check = 1 [json_name = "healthCheck"]; + + // The initial delay is the number of seconds that a new VM takes to + // initialize and run its startup script. During a VM's initial delay period, + // the MIG ignores unsuccessful health checks because the VM might be in the + // startup process. This prevents the MIG from prematurely recreating a VM. If + // the health check receives a healthy response during the initial delay, it + // indicates that the startup process is complete and the VM is ready. The + // value of initial delay must be between 0 and 3600 seconds. The default + // value is 0. + optional int32 initial_delay_sec = 2 [json_name = "initialDelaySec"]; +} - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -message DiskTypesScopedList { - // [Output Only] A list of disk types contained in this scope. - repeated DiskType disk_types = 1 [json_name = "diskTypes"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } +message InstanceGroupManagerInstanceFlexibilityPolicy { + // Named instance selections configuring properties that the group will use + // when creating new VMs. + map + instance_selections = 1 [json_name = "instanceSelections"]; +} + +message InstanceGroupManagerInstanceFlexibilityPolicyInstanceSelection { + // Full machine-type names, e.g. "n1-standard-16". + repeated string machine_types = 1 [json_name = "machineTypes"]; + + // Preference of this instance selection. Lower number means higher + // preference. MIG will first try to create a VM based on the machine-type + // with lowest rank and fallback to next rank based on availability. Machine + // types and instance selections with the same rank have the same preference. + optional int32 rank = 2 [json_name = "rank"]; +} + +message InstanceGroupManagerInstanceLifecyclePolicy { + // The action that a MIG performs on a failed or an unhealthy VM. A VM is + // marked as unhealthy when the application running on that VM fails a health + // check. Valid values are - REPAIR (default): MIG automatically repairs a + // failed or an unhealthy VM by recreating it. For more information, see About + // repairing VMs in a MIG. - DO_NOTHING: MIG does not repair a failed or an + // unhealthy VM. + // DO_NOTHING: MIG does not repair a failed or an unhealthy VM. + // REPAIR: (Default) MIG automatically repairs a failed or an unhealthy VM by + // recreating it. For more information, see About repairing VMs in a MIG. + optional string default_action_on_failure = 2 + [json_name = "defaultActionOnFailure"]; + + // A bit indicating whether to forcefully apply the group's latest + // configuration when repairing a VM. Valid options are: - NO (default): If + // configuration updates are available, they are not forcefully applied during + // repair. Instead, configuration updates are applied according to the group's + // update policy. - YES: If configuration updates are available, they are + // applied during repair. + // NO: + // YES: + optional string force_update_on_repair = 1 + [json_name = "forceUpdateOnRepair"]; +} + +message InstanceGroupManagerStatus { + // [Output only] Status of all-instances configuration on the group. + optional InstanceGroupManagerStatusAllInstancesConfig all_instances_config = 5 + [json_name = "allInstancesConfig"]; + + // [Output Only] The URL of the Autoscaler that targets this instance group + // manager. + optional string autoscaler = 1 [json_name = "autoscaler"]; + + // [Output Only] A bit indicating whether the managed instance group is in a + // stable state. A stable state means that: none of the instances in the + // managed instance group is currently undergoing any type of change (for + // example, creation, restart, or deletion); no future changes are scheduled + // for instances in the managed instance group; and the managed instance group + // itself is not being modified. + optional bool is_stable = 2 [json_name = "isStable"]; + + // [Output Only] Stateful status of the given Instance Group Manager. + optional InstanceGroupManagerStatusStateful stateful = 3 + [json_name = "stateful"]; + + // [Output Only] A status of consistency of Instances' versions with their + // target version specified by version field on Instance Group Manager. + optional InstanceGroupManagerStatusVersionTarget version_target = 4 + [json_name = "versionTarget"]; +} + +message InstanceGroupManagerStatusAllInstancesConfig { + // [Output Only] Current all-instances configuration revision. This value is + // in RFC3339 text format. + optional string current_revision = 1 [json_name = "currentRevision"]; + + // [Output Only] A bit indicating whether this configuration has been applied + // to all managed instances in the group. + optional bool effective = 2 [json_name = "effective"]; +} + +message InstanceGroupManagerStatusStateful { + // [Output Only] A bit indicating whether the managed instance group has + // stateful configuration, that is, if you have configured any items in a + // stateful policy or in per-instance configs. The group might report that it + // has no stateful configuration even when there is still some preserved state + // on a managed instance, for example, if you have deleted all PICs but not + // yet applied those deletions. + optional bool has_stateful_config = 1 [json_name = "hasStatefulConfig"]; + + // [Output Only] Status of per-instance configurations on the instances. + optional InstanceGroupManagerStatusStatefulPerInstanceConfigs + per_instance_configs = 2 [json_name = "perInstanceConfigs"]; +} + +message InstanceGroupManagerStatusStatefulPerInstanceConfigs { + // A bit indicating if all of the group's per-instance configurations (listed + // in the output of a listPerInstanceConfigs API call) have status EFFECTIVE + // or there are no per-instance-configs. + optional bool all_effective = 1 [json_name = "allEffective"]; +} + +message InstanceGroupManagerStatusVersionTarget { + // [Output Only] A bit indicating whether version target has been reached in + // this managed instance group, i.e. all instances are in their target + // version. Instances' target version are specified by version field on + // Instance Group Manager. + optional bool is_reached = 1 [json_name = "isReached"]; +} + +message InstanceGroupManagerUpdatePolicy { + // The instance redistribution policy for regional managed instance groups. + // Valid values are: - PROACTIVE (default): The group attempts to maintain an + // even distribution of VM instances across zones in the region. - NONE: For + // non-autoscaled groups, proactive redistribution is disabled. + // NONE: No action is being proactively performed in order to bring this IGM + // to its target instance distribution. + // PROACTIVE: This IGM will actively converge to its target instance + // distribution. + optional string instance_redistribution_type = 1 + [json_name = "instanceRedistributionType"]; + + // The maximum number of instances that can be created above the specified + // targetSize during the update process. This value can be either a fixed + // number or, if the group has 10 or more instances, a percentage. If you set + // a percentage, the number of instances is rounded if necessary. The default + // value for maxSurge is a fixed value equal to the number of zones in which + // the managed instance group operates. At least one of either maxSurge or + // maxUnavailable must be greater than 0. Learn more about maxSurge. + optional FixedOrPercent max_surge = 2 [json_name = "maxSurge"]; + + // The maximum number of instances that can be unavailable during the update + // process. An instance is considered available if all of the following + // conditions are satisfied: - The instance's status is RUNNING. - If there is + // a health check on the instance group, the instance's health check status + // must be HEALTHY at least once. If there is no health check on the group, + // then the instance only needs to have a status of RUNNING to be considered + // available. This value can be either a fixed number or, if the group has 10 + // or more instances, a percentage. If you set a percentage, the number of + // instances is rounded if necessary. The default value for maxUnavailable is + // a fixed value equal to the number of zones in which the managed instance + // group operates. At least one of either maxSurge or maxUnavailable must be + // greater than 0. Learn more about maxUnavailable. + optional FixedOrPercent max_unavailable = 3 [json_name = "maxUnavailable"]; + + // Minimal action to be taken on an instance. Use this option to minimize + // disruption as much as possible or to apply a more disruptive action than is + // necessary. - To limit disruption as much as possible, set the minimal + // action to REFRESH. If your update requires a more disruptive action, + // Compute Engine performs the necessary action to execute the update. - To + // apply a more disruptive action than is strictly necessary, set the minimal + // action to RESTART or REPLACE. For example, Compute Engine does not need to + // restart a VM to change its metadata. But if your application reads instance + // metadata only when a VM is restarted, you can set the minimal action to + // RESTART in order to pick up metadata changes. + // NONE: Do not perform any action. + // REFRESH: Do not stop the instance. + // REPLACE: (Default.) Replace the instance according to the replacement + // method option. + // RESTART: Stop the instance and start it again. + optional string minimal_action = 4 [json_name = "minimalAction"]; + + // Most disruptive action that is allowed to be taken on an instance. You can + // specify either NONE to forbid any actions, REFRESH to avoid restarting the + // VM and to limit disruption as much as possible. RESTART to allow actions + // that can be applied without instance replacing or REPLACE to allow all + // possible actions. If the Updater determines that the minimal update action + // needed is more disruptive than most disruptive allowed action you specify + // it will not perform the update at all. + // NONE: Do not perform any action. + // REFRESH: Do not stop the instance. + // REPLACE: (Default.) Replace the instance according to the replacement + // method option. + // RESTART: Stop the instance and start it again. + optional string most_disruptive_allowed_action = 5 + [json_name = "mostDisruptiveAllowedAction"]; + + // What action should be used to replace instances. See minimal_action.REPLACE + // RECREATE: Instances will be recreated (with the same name) + // SUBSTITUTE: Default option: instances will be deleted and created (with a + // new name) + optional string replacement_method = 6 [json_name = "replacementMethod"]; + + // The type of update process. You can specify either PROACTIVE so that the + // MIG automatically updates VMs to the latest configurations or OPPORTUNISTIC + // so that you can select the VMs that you want to update. + // OPPORTUNISTIC: MIG will apply new configurations to existing VMs only when + // you selectively target specific or all VMs to be updated. + // PROACTIVE: MIG will automatically apply new configurations to all or a + // subset of existing VMs and also to new VMs that are added to the group. + optional string type = 7 [json_name = "type"]; +} + +message InstanceGroupManagerVersion { + // The URL of the instance template that is specified for this managed + // instance group. The group uses this template to create new instances in the + // managed instance group until the `targetSize` for this version is reached. + // The templates for existing instances in the group do not change unless you + // run recreateInstances, run applyUpdatesToInstances, or set the group's + // updatePolicy.type to PROACTIVE; in those cases, existing instances are + // updated until the `targetSize` for this version is reached. + optional string instance_template = 1 [json_name = "instanceTemplate"]; + + // Name of the version. Unique among all versions in the scope of this managed + // instance group. + optional string name = 2 [json_name = "name"]; + + // Specifies the intended number of instances to be created from the + // instanceTemplate. The final number of instances created from the template + // will be equal to: - If expressed as a fixed number, the minimum of either + // targetSize.fixed or instanceGroupManager.targetSize is used. - if expressed + // as a percent, the targetSize would be (targetSize.percent/100 * + // InstanceGroupManager.targetSize) If there is a remainder, the number is + // rounded. If unset, this version will update any remaining instances not + // updated by another version. Read Starting a canary update for more + // information. + optional FixedOrPercent target_size = 3 [json_name = "targetSize"]; +} - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; +message InstanceManagedByIgmError { + // [Output Only] Contents of the error. + optional InstanceManagedByIgmErrorManagedInstanceError error = 1 + [json_name = "error"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; + // [Output Only] Details of the instance action that triggered this error. May + // be null, if the error was not caused by an action on an instance. This + // field is optional. + optional InstanceManagedByIgmErrorInstanceActionDetails + instance_action_details = 2 [json_name = "instanceActionDetails"]; + + // [Output Only] The time that this error occurred. This value is in RFC3339 + // text format. + optional string timestamp = 3 [json_name = "timestamp"]; +} + +message InstanceManagedByIgmErrorInstanceActionDetails { + // [Output Only] Action that managed instance group was executing on the + // instance when the error occurred. Possible values: + // ABANDONING: The managed instance group is abandoning this instance. The + // instance will be removed from the instance group and from any target pools + // that are associated with this group. + // CREATING: The managed instance group is creating this instance. If the + // group fails to create this instance, it will try again until it is + // successful. + // CREATING_WITHOUT_RETRIES: The managed instance group is attempting to + // create this instance only once. If the group fails to create this instance, + // it does not try again and the group's targetSize value is decreased. + // DELETING: The managed instance group is permanently deleting this instance. + // NONE: The managed instance group has not scheduled any actions for this + // instance. + // RECREATING: The managed instance group is recreating this instance. + // REFRESHING: The managed instance group is applying configuration changes to + // the instance without stopping it. For example, the group can update the + // target pool list for an instance without stopping that instance. + // RESTARTING: The managed instance group is restarting this instance. + // RESUMING: The managed instance group is resuming this instance. + // STARTING: The managed instance group is starting this instance. + // STOPPING: The managed instance group is stopping this instance. + // SUSPENDING: The managed instance group is suspending this instance. + // VERIFYING: The managed instance group is verifying this already created + // instance. Verification happens every time the instance is (re)created or + // restarted and consists of: 1. Waiting until health check specified as part + // of this managed instance group's autohealing policy reports HEALTHY. Note: + // Applies only if autohealing policy has a health check specified 2. Waiting + // for addition verification steps performed as post-instance creation + // (subject to future extensions). + optional string action = 1 [json_name = "action"]; + + // [Output Only] The URL of the instance. The URL can be set even if the + // instance has not yet been created. + optional string instance = 2 [json_name = "instance"]; + + // [Output Only] Version this instance was created from, or was being created + // from, but the creation failed. Corresponds to one of the versions that were + // set on the Instance Group Manager resource at the time this instance was + // being created. + optional ManagedInstanceVersion version = 3 [json_name = "version"]; +} + +message InstanceManagedByIgmErrorManagedInstanceError { + // [Output Only] Error code. + optional string code = 1 [json_name = "code"]; + + // [Output Only] Error message. + optional string message = 2 [json_name = "message"]; +} + +// Represents the change that you want to make to the instance properties. +message InstancePropertiesPatch { + // The label key-value pairs that you want to patch onto the instance. + map labels = 1 [json_name = "labels"]; + + // The metadata key-value pairs that you want to patch onto the instance. For + // more information, see Project and instance metadata. + map metadata = 2 [json_name = "metadata"]; +} + +// A Managed Instance resource. +message ManagedInstance { + // [Output Only] The current action that the managed instance group has + // scheduled for the instance. Possible values: - NONE The instance is + // running, and the managed instance group does not have any scheduled actions + // for this instance. - CREATING The managed instance group is creating this + // instance. If the group fails to create this instance, it will try again + // until it is successful. - CREATING_WITHOUT_RETRIES The managed instance + // group is attempting to create this instance only once. If the group fails + // to create this instance, it does not try again and the group's targetSize + // value is decreased instead. - RECREATING The managed instance group is + // recreating this instance. - DELETING The managed instance group is + // permanently deleting this instance. - ABANDONING The managed instance group + // is abandoning this instance. The instance will be removed from the instance + // group and from any target pools that are associated with this group. - + // RESTARTING The managed instance group is restarting the instance. - + // REFRESHING The managed instance group is applying configuration changes to + // the instance without stopping it. For example, the group can update the + // target pool list for an instance without stopping that instance. - + // VERIFYING The managed instance group has created the instance and it is in + // the process of being verified. + // ABANDONING: The managed instance group is abandoning this instance. The + // instance will be removed from the instance group and from any target pools + // that are associated with this group. + // CREATING: The managed instance group is creating this instance. If the + // group fails to create this instance, it will try again until it is + // successful. + // CREATING_WITHOUT_RETRIES: The managed instance group is attempting to + // create this instance only once. If the group fails to create this instance, + // it does not try again and the group's targetSize value is decreased. + // DELETING: The managed instance group is permanently deleting this instance. + // NONE: The managed instance group has not scheduled any actions for this + // instance. + // RECREATING: The managed instance group is recreating this instance. + // REFRESHING: The managed instance group is applying configuration changes to + // the instance without stopping it. For example, the group can update the + // target pool list for an instance without stopping that instance. + // RESTARTING: The managed instance group is restarting this instance. + // RESUMING: The managed instance group is resuming this instance. + // STARTING: The managed instance group is starting this instance. + // STOPPING: The managed instance group is stopping this instance. + // SUSPENDING: The managed instance group is suspending this instance. + // VERIFYING: The managed instance group is verifying this already created + // instance. Verification happens every time the instance is (re)created or + // restarted and consists of: 1. Waiting until health check specified as part + // of this managed instance group's autohealing policy reports HEALTHY. Note: + // Applies only if autohealing policy has a health check specified 2. Waiting + // for addition verification steps performed as post-instance creation + // (subject to future extensions). + optional string current_action = 1 [json_name = "currentAction"]; + + // [Output only] The unique identifier for this resource. This field is empty + // when instance does not exist. + optional string id = 2 [json_name = "id"]; + + // [Output Only] The URL of the instance. The URL can exist even if the + // instance has not yet been created. + optional string instance = 3 [json_name = "instance"]; + + // [Output Only] Health state of the instance per health-check. + repeated ManagedInstanceInstanceHealth instance_health = 4 + [json_name = "instanceHealth"]; + + // [Output Only] The status of the instance. This field is empty when the + // instance does not exist. + // DEPROVISIONING: The instance is halted and we are performing tear down + // tasks like network deprogramming, releasing quota, IP, tearing down disks + // etc. + // PROVISIONING: Resources are being allocated for the instance. + // REPAIRING: The instance is in repair. + // RUNNING: The instance is running. + // STAGING: All required resources have been allocated and the instance is + // being started. + // STOPPED: The instance has stopped successfully. + // STOPPING: The instance is currently stopping (either being deleted or + // killed). + // SUSPENDED: The instance has suspended. + // SUSPENDING: The instance is suspending. + // TERMINATED: The instance has stopped (either by explicit action or + // underlying failure). + optional string instance_status = 5 [json_name = "instanceStatus"]; + + // [Output Only] Information about the last attempt to create or delete the + // instance. + optional ManagedInstanceLastAttempt last_attempt = 6 + [json_name = "lastAttempt"]; + + // [Output Only] The name of the instance. The name always exists even if the + // instance has not yet been created. + optional string name = 10 [json_name = "name"]; + + // [Output Only] Preserved state applied from per-instance config for this + // instance. + optional PreservedState preserved_state_from_config = 7 + [json_name = "preservedStateFromConfig"]; + + // [Output Only] Preserved state generated based on stateful policy for this + // instance. + optional PreservedState preserved_state_from_policy = 8 + [json_name = "preservedStateFromPolicy"]; + + // [Output Only] Instance properties selected for this instance resulting from + // InstanceFlexibilityPolicy. + optional ManagedInstancePropertiesFromFlexibilityPolicy + properties_from_flexibility_policy = 11 + [json_name = "propertiesFromFlexibilityPolicy"]; + + // [Output Only] Intended version of this instance. + optional ManagedInstanceVersion version = 9 [json_name = "version"]; +} + +message ManagedInstanceInstanceHealth { + // [Output Only] The current detailed instance health state. + // DRAINING: The instance is being drained. The existing connections to the + // instance have time to complete, but the new ones are being refused. + // HEALTHY: The instance is reachable i.e. a connection to the application + // health checking endpoint can be established, and conforms to the + // requirements defined by the health check. + // TIMEOUT: The instance is unreachable i.e. a connection to the application + // health checking endpoint cannot be established, or the server does not + // respond within the specified timeout. + // UNHEALTHY: The instance is reachable, but does not conform to the + // requirements defined by the health check. + // UNKNOWN: The health checking system is aware of the instance but its health + // is not known at the moment. + optional string detailed_health_state = 1 [json_name = "detailedHealthState"]; + + // [Output Only] The URL for the health check that verifies whether the + // instance is healthy. + optional string health_check = 2 [json_name = "healthCheck"]; +} + +message ManagedInstanceLastAttempt { + message Errors { + message ErrorsItem { + // [Output Only] The error type identifier for this error. + optional string code = 1 [json_name = "code"]; + + message ErrorDetailsItem { + optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; + + optional Help help = 2 [json_name = "help"]; + + optional LocalizedMessage localized_message = 3 + [json_name = "localizedMessage"]; + + optional QuotaExceededInfo quota_info = 4 [json_name = "quotaInfo"]; + } + + // [Output Only] An optional list of messages that contain the error + // details. There is a set of defined message types to use for providing + // details.The syntax depends on the error code. For example, + // QuotaExceededInfo will have details when the error code is + // QUOTA_EXCEEDED. + repeated ErrorDetailsItem error_details = 2 [json_name = "errorDetails"]; + + // [Output Only] Indicates the field in the request that caused the error. + // This property is optional. + optional string location = 3 [json_name = "location"]; + + // [Output Only] An optional, human-readable error message. + optional string message = 4 [json_name = "message"]; + } + + // [Output Only] The array of errors encountered while processing this + // operation. + repeated ErrorsItem errors = 1 [json_name = "errors"]; } - // [Output Only] Informational warning which replaces the list of disk types - // when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // [Output Only] Encountered errors during the last attempt to create or + // delete the instance. + optional Errors errors = 1 [json_name = "errors"]; +} + +message ManagedInstancePropertiesFromFlexibilityPolicy { + // The machine type to be used for this instance. + optional string machine_type = 1 [json_name = "machineType"]; +} + +message ManagedInstanceVersion { + // [Output Only] The intended template of the instance. This field is empty + // when current_action is one of { DELETING, ABANDONING }. + optional string instance_template = 1 [json_name = "instanceTemplate"]; + + // [Output Only] Name of the version. + optional string name = 2 [json_name = "name"]; +} + +message PerInstanceConfig { + // Fingerprint of this per-instance config. This field can be used in + // optimistic locking. It is ignored when inserting a per-instance config. An + // up-to-date fingerprint must be provided in order to update an existing + // per-instance configuration or the field needs to be unset. + optional string fingerprint = 1 [json_name = "fingerprint"]; + + // The name of a per-instance configuration and its corresponding instance. + // Serves as a merge key during UpdatePerInstanceConfigs operations, that is, + // if a per-instance configuration with the same name exists then it will be + // updated, otherwise a new one will be created for the VM instance with the + // same name. An attempt to create a per-instance configconfiguration for a VM + // instance that either doesn't exist or is not part of the group will result + // in an error. + optional string name = 2 [json_name = "name"]; + + // The intended preserved state for the given instance. Does not contain + // preserved state generated from a stateful policy. + optional PreservedState preserved_state = 3 [json_name = "preservedState"]; + + // The status of applying this per-instance configuration on the corresponding + // managed instance. + // APPLYING: The per-instance configuration is being applied to the instance, + // but is not yet effective, possibly waiting for the instance to, for + // example, REFRESH. + // DELETING: The per-instance configuration deletion is being applied on the + // instance, possibly waiting for the instance to, for example, REFRESH. + // EFFECTIVE: The per-instance configuration is effective on the instance, + // meaning that all disks, ips and metadata specified in this configuration + // are attached or set on the instance. + // NONE: *[Default]* The default status, when no per-instance configuration + // exists. + // UNAPPLIED: The per-instance configuration is set on an instance but not + // been applied yet. + // UNAPPLIED_DELETION: The per-instance configuration has been deleted, but + // the deletion is not yet applied. + optional string status = 4 [json_name = "status"]; +} + +// Preserved state for a given instance. +message PreservedState { + // Preserved disks defined for this instance. This map is keyed with the + // device names of the disks. + map disks = 1 [json_name = "disks"]; + + // Preserved external IPs defined for this instance. This map is keyed with + // the name of the network interface. + map external_i_ps = 3 + [json_name = "externalIPs"]; + + // Preserved internal IPs defined for this instance. This map is keyed with + // the name of the network interface. + map internal_i_ps = 4 + [json_name = "internalIPs"]; + + // Preserved metadata defined for this instance. + map metadata = 2 [json_name = "metadata"]; +} + +message PreservedStatePreservedDisk { + // These stateful disks will never be deleted during autohealing, update, + // instance recreate operations. This flag is used to configure if the disk + // should be deleted after it is no longer used by the group, e.g. when the + // given instance or the whole MIG is deleted. Note: disks attached in + // READ_ONLY mode cannot be auto-deleted. + // NEVER: + // ON_PERMANENT_INSTANCE_DELETION: + optional string auto_delete = 1 [json_name = "autoDelete"]; + + // The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If + // not specified, the default is to attach the disk in READ_WRITE mode. + // READ_ONLY: Attaches this disk in read-only mode. Multiple VM instances can + // use a disk in READ_ONLY mode at a time. + // READ_WRITE: *[Default]* Attaches this disk in READ_WRITE mode. Only one VM + // instance at a time can be attached to a disk in READ_WRITE mode. + optional string mode = 2 [json_name = "mode"]; + + // The URL of the disk resource that is stateful and should be attached to the + // VM instance. + optional string source = 3 [json_name = "source"]; +} + +message PreservedStatePreservedNetworkIp { + // These stateful IPs will never be released during autohealing, update or VM + // instance recreate operations. This flag is used to configure if the IP + // reservation should be deleted after it is no longer used by the group, e.g. + // when the given instance or the whole group is deleted. + // NEVER: + // ON_PERMANENT_INSTANCE_DELETION: + optional string auto_delete = 1 [json_name = "autoDelete"]; + + // Ip address representation + optional PreservedStatePreservedNetworkIpIpAddress ip_address = 2 + [json_name = "ipAddress"]; +} + +message PreservedStatePreservedNetworkIpIpAddress { + // The URL of the reservation for this IP address. + optional string address = 1 [json_name = "address"]; + + // An IPv4 internal network address to assign to the instance for this network + // interface. + optional string literal = 2 [json_name = "literal"]; +} + +message StatefulPolicy { + optional StatefulPolicyPreservedState preserved_state = 1 + [json_name = "preservedState"]; +} + +// Configuration of preserved resources. +message StatefulPolicyPreservedState { + // Disks created on the instances that will be preserved on instance delete, + // update, etc. This map is keyed with the device names of the disks. + map disks = 1 + [json_name = "disks"]; + + // External network IPs assigned to the instances that will be preserved on + // instance delete, update, etc. This map is keyed with the network interface + // name. + map external_i_ps = 2 + [json_name = "externalIPs"]; + + // Internal network IPs assigned to the instances that will be preserved on + // instance delete, update, etc. This map is keyed with the network interface + // name. + map internal_i_ps = 3 + [json_name = "internalIPs"]; +} + +message StatefulPolicyPreservedStateDiskDevice { + // These stateful disks will never be deleted during autohealing, update or VM + // instance recreate operations. This flag is used to configure if the disk + // should be deleted after it is no longer used by the group, e.g. when the + // given instance or the whole group is deleted. Note: disks attached in + // READ_ONLY mode cannot be auto-deleted. + // NEVER: + // ON_PERMANENT_INSTANCE_DELETION: + optional string auto_delete = 1 [json_name = "autoDelete"]; +} + +message StatefulPolicyPreservedStateNetworkIp { + // These stateful IPs will never be released during autohealing, update or VM + // instance recreate operations. This flag is used to configure if the IP + // reservation should be deleted after it is no longer used by the group, e.g. + // when the given instance or the whole group is deleted. + // NEVER: + // ON_PERMANENT_INSTANCE_DELETION: + optional string auto_delete = 1 [json_name = "autoDelete"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_029.proto b/protos/google/cloud/compute/v1/internal/common_029.proto index d2eec748a0e42..f1b3740186f6b 100644 --- a/protos/google/cloud/compute/v1/internal/common_029.proto +++ b/protos/google/cloud/compute/v1/internal/common_029.proto @@ -15,885 +15,24 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_040.proto"; -import "google/cloud/compute/v1/internal/common_080.proto"; - -message DistributionPolicy { - // The distribution shape to which the group converges either proactively or - // on resize events (depending on the value set in - // updatePolicy.instanceRedistributionType). - // ANY: The group picks zones for creating VM instances to fulfill the - // requested number of VMs within present resource constraints and to maximize - // utilization of unused zonal reservations. Recommended for batch workloads - // that do not require high availability. - // ANY_SINGLE_ZONE: The group creates all VM instances within a single zone. - // The zone is selected based on the present resource constraints and to - // maximize utilization of unused zonal reservations. Recommended for batch - // workloads with heavy interprocess communication. - // BALANCED: The group prioritizes acquisition of resources, scheduling VMs in - // zones where resources are available while distributing VMs as evenly as - // possible across selected zones to minimize the impact of zonal failure. - // Recommended for highly available serving workloads. - // EVEN: The group schedules VM instance creation and deletion to achieve and - // maintain an even number of managed instances across the selected zones. The - // distribution is even when the number of managed instances does not differ - // by more than 1 between any two zones. Recommended for highly available - // serving workloads. - optional string target_shape = 1 [json_name = "targetShape"]; - - // Zones where the regional managed instance group will create and manage its - // instances. - repeated DistributionPolicyZoneConfiguration zones = 2 [json_name = "zones"]; -} - -message DistributionPolicyZoneConfiguration { - // The URL of the zone. The zone must exist in the region where the managed - // instance group is located. - optional string zone = 1 [json_name = "zone"]; -} - -// Represents a Managed Instance Group resource. An instance group is a -// collection of VM instances that you can manage as a single entity. For more -// information, read Instance groups. For zonal Managed Instance Group, use the -// instanceGroupManagers resource. For regional Managed Instance Group, use the -// regionInstanceGroupManagers resource. -message InstanceGroupManager { - // Specifies configuration that overrides the instance template configuration - // for the group. - optional InstanceGroupManagerAllInstancesConfig all_instances_config = 25 - [json_name = "allInstancesConfig"]; - - // The autohealing policy for this managed instance group. You can specify - // only one value. - repeated InstanceGroupManagerAutoHealingPolicy auto_healing_policies = 1 - [json_name = "autoHealingPolicies"]; - - // The base instance name is a prefix that you want to attach to the names of - // all VMs in a MIG. The maximum character length is 58 and the name must - // comply with RFC1035 format. When a VM is created in the group, the MIG - // appends a hyphen and a random four-character string to the base instance - // name. If you want the MIG to assign sequential numbers instead of a random - // string, then end the base instance name with a hyphen followed by one or - // more hash symbols. The hash symbols indicate the number of digits. For - // example, a base instance name of "vm-###" results in "vm-001" as a VM name. - // @pattern - // [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?)) - optional string base_instance_name = 2 [json_name = "baseInstanceName"]; - - // [Output Only] The creation timestamp for this managed instance group in - // RFC3339 text format. - optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; - - // [Output Only] The list of instance actions and the number of instances in - // this managed instance group that are scheduled for each of those actions. - optional InstanceGroupManagerActionsSummary current_actions = 4 - [json_name = "currentActions"]; - - // An optional description of this resource. - optional string description = 5 [json_name = "description"]; - - // Policy specifying the intended distribution of managed instances across - // zones in a regional managed instance group. - optional DistributionPolicy distribution_policy = 6 - [json_name = "distributionPolicy"]; - - // Fingerprint of this resource. This field may be used in optimistic locking. - // It will be ignored when inserting an InstanceGroupManager. An up-to-date - // fingerprint must be provided in order to update the InstanceGroupManager, - // otherwise the request will fail with error 412 conditionNotMet. To see the - // latest fingerprint, make a get() request to retrieve an - // InstanceGroupManager. - optional string fingerprint = 7 [json_name = "fingerprint"]; - - // [Output Only] A unique identifier for this resource type. The server - // generates this identifier. - optional string id = 8 [json_name = "id"]; - - // [Output Only] The URL of the Instance Group resource. - optional string instance_group = 9 [json_name = "instanceGroup"]; - - // The repair policy for this managed instance group. - optional InstanceGroupManagerInstanceLifecyclePolicy - instance_lifecycle_policy = 24 [json_name = "instanceLifecyclePolicy"]; - - // The URL of the instance template that is specified for this managed - // instance group. The group uses this template to create all new instances in - // the managed instance group. The templates for existing instances in the - // group do not change unless you run recreateInstances, run - // applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. - optional string instance_template = 10 [json_name = "instanceTemplate"]; - - // [Output Only] The resource type, which is always - // compute#instanceGroupManager for managed instance groups. - optional string kind = 11 [json_name = "kind"]; - - // Pagination behavior of the listManagedInstances API method for this managed - // instance group. - // PAGELESS: (Default) Pagination is disabled for the group's - // listManagedInstances API method. maxResults and pageToken query parameters - // are ignored and all instances are returned in a single response. - // PAGINATED: Pagination is enabled for the group's listManagedInstances API - // method. maxResults and pageToken query parameters are respected. - optional string list_managed_instances_results = 12 - [json_name = "listManagedInstancesResults"]; - - // The name of the managed instance group. The name must be 1-63 characters - // long, and comply with RFC1035. - optional string name = 13 [json_name = "name"]; - - // Named ports configured for the Instance Groups complementary to this - // Instance Group Manager. - repeated NamedPort named_ports = 14 [json_name = "namedPorts"]; - - // [Output Only] The URL of the region where the managed instance group - // resides (for regional resources). - optional string region = 15 [json_name = "region"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzi = 26 [json_name = "satisfiesPzi"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzs = 27 [json_name = "satisfiesPzs"]; - - // [Output Only] The URL for this managed instance group. The server defines - // this URL. - optional string self_link = 16 [json_name = "selfLink"]; - - // Stateful configuration for this Instanced Group Manager - optional StatefulPolicy stateful_policy = 17 [json_name = "statefulPolicy"]; - - // [Output Only] The status of this managed instance group. - optional InstanceGroupManagerStatus status = 18 [json_name = "status"]; - - // The URLs for all TargetPool resources to which instances in the - // instanceGroup field are added. The target pools automatically apply to all - // of the instances in the managed instance group. - repeated string target_pools = 19 [json_name = "targetPools"]; - - // The target number of running instances for this managed instance group. You - // can reduce this number by using the instanceGroupManager deleteInstances or - // abandonInstances methods. Resizing the group also changes this number. - optional int32 target_size = 20 [json_name = "targetSize"]; - - // The update policy for this managed instance group. - optional InstanceGroupManagerUpdatePolicy update_policy = 21 - [json_name = "updatePolicy"]; - - // Specifies the instance templates used by this managed instance group to - // create instances. Each version is defined by an instanceTemplate and a - // name. Every version can appear at most once per instance group. This field - // overrides the top-level instanceTemplate field. Read more about the - // relationships between these fields. Exactly one version must leave the - // targetSize field unset. That version will be applied to all remaining - // instances. For more information, read about canary updates. - repeated InstanceGroupManagerVersion versions = 22 [json_name = "versions"]; - - // [Output Only] The URL of a zone where the managed instance group is located - // (for zonal resources). - optional string zone = 23 [json_name = "zone"]; -} - -message InstanceGroupManagerActionsSummary { - // [Output Only] The total number of instances in the managed instance group - // that are scheduled to be abandoned. Abandoning an instance removes it from - // the managed instance group without deleting it. - optional int32 abandoning = 1 [json_name = "abandoning"]; - - // [Output Only] The number of instances in the managed instance group that - // are scheduled to be created or are currently being created. If the group - // fails to create any of these instances, it tries again until it creates the - // instance successfully. If you have disabled creation retries, this field - // will not be populated; instead, the creatingWithoutRetries field will be - // populated. - optional int32 creating = 2 [json_name = "creating"]; - - // [Output Only] The number of instances that the managed instance group will - // attempt to create. The group attempts to create each instance only once. If - // the group fails to create any of these instances, it decreases the group's - // targetSize value accordingly. - optional int32 creating_without_retries = 3 - [json_name = "creatingWithoutRetries"]; - - // [Output Only] The number of instances in the managed instance group that - // are scheduled to be deleted or are currently being deleted. - optional int32 deleting = 4 [json_name = "deleting"]; - - // [Output Only] The number of instances in the managed instance group that - // are running and have no scheduled actions. - optional int32 none = 5 [json_name = "none"]; - - // [Output Only] The number of instances in the managed instance group that - // are scheduled to be recreated or are currently being being recreated. - // Recreating an instance deletes the existing root persistent disk and - // creates a new disk from the image that is defined in the instance template. - optional int32 recreating = 6 [json_name = "recreating"]; - - // [Output Only] The number of instances in the managed instance group that - // are being reconfigured with properties that do not require a restart or a - // recreate action. For example, setting or removing target pools for the - // instance. - optional int32 refreshing = 7 [json_name = "refreshing"]; - - // [Output Only] The number of instances in the managed instance group that - // are scheduled to be restarted or are currently being restarted. - optional int32 restarting = 8 [json_name = "restarting"]; - - // [Output Only] The number of instances in the managed instance group that - // are scheduled to be resumed or are currently being resumed. - optional int32 resuming = 9 [json_name = "resuming"]; - - // [Output Only] The number of instances in the managed instance group that - // are scheduled to be started or are currently being started. - optional int32 starting = 10 [json_name = "starting"]; - - // [Output Only] The number of instances in the managed instance group that - // are scheduled to be stopped or are currently being stopped. - optional int32 stopping = 11 [json_name = "stopping"]; - - // [Output Only] The number of instances in the managed instance group that - // are scheduled to be suspended or are currently being suspended. - optional int32 suspending = 12 [json_name = "suspending"]; - - // [Output Only] The number of instances in the managed instance group that - // are being verified. See the managedInstances[].currentAction property in - // the listManagedInstances method documentation. - optional int32 verifying = 13 [json_name = "verifying"]; -} - -message InstanceGroupManagerAllInstancesConfig { - // Properties to set on all instances in the group. You can add or modify - // properties using the instanceGroupManagers.patch or - // regionInstanceGroupManagers.patch. After setting allInstancesConfig on the - // group, you must update the group's instances to apply the configuration. To - // apply the configuration, set the group's updatePolicy.type field to use - // proactive updates or use the applyUpdatesToInstances method. - optional InstancePropertiesPatch properties = 1 [json_name = "properties"]; -} - -message InstanceGroupManagerAutoHealingPolicy { - // The URL for the health check that signals autohealing. - optional string health_check = 1 [json_name = "healthCheck"]; - - // The initial delay is the number of seconds that a new VM takes to - // initialize and run its startup script. During a VM's initial delay period, - // the MIG ignores unsuccessful health checks because the VM might be in the - // startup process. This prevents the MIG from prematurely recreating a VM. If - // the health check receives a healthy response during the initial delay, it - // indicates that the startup process is complete and the VM is ready. The - // value of initial delay must be between 0 and 3600 seconds. The default - // value is 0. - optional int32 initial_delay_sec = 2 [json_name = "initialDelaySec"]; -} - -message InstanceGroupManagerInstanceLifecyclePolicy { - // The action that a MIG performs on a failed or an unhealthy VM. A VM is - // marked as unhealthy when the application running on that VM fails a health - // check. Valid values are - REPAIR (default): MIG automatically repairs a - // failed or an unhealthy VM by recreating it. For more information, see About - // repairing VMs in a MIG. - DO_NOTHING: MIG does not repair a failed or an - // unhealthy VM. - // DO_NOTHING: MIG does not repair a failed or an unhealthy VM. - // REPAIR: (Default) MIG automatically repairs a failed or an unhealthy VM by - // recreating it. For more information, see About repairing VMs in a MIG. - optional string default_action_on_failure = 2 - [json_name = "defaultActionOnFailure"]; - - // A bit indicating whether to forcefully apply the group's latest - // configuration when repairing a VM. Valid options are: - NO (default): If - // configuration updates are available, they are not forcefully applied during - // repair. Instead, configuration updates are applied according to the group's - // update policy. - YES: If configuration updates are available, they are - // applied during repair. - // NO: - // YES: - optional string force_update_on_repair = 1 - [json_name = "forceUpdateOnRepair"]; -} - -message InstanceGroupManagerStatus { - // [Output only] Status of all-instances configuration on the group. - optional InstanceGroupManagerStatusAllInstancesConfig all_instances_config = 5 - [json_name = "allInstancesConfig"]; - - // [Output Only] The URL of the Autoscaler that targets this instance group - // manager. - optional string autoscaler = 1 [json_name = "autoscaler"]; - - // [Output Only] A bit indicating whether the managed instance group is in a - // stable state. A stable state means that: none of the instances in the - // managed instance group is currently undergoing any type of change (for - // example, creation, restart, or deletion); no future changes are scheduled - // for instances in the managed instance group; and the managed instance group - // itself is not being modified. - optional bool is_stable = 2 [json_name = "isStable"]; - - // [Output Only] Stateful status of the given Instance Group Manager. - optional InstanceGroupManagerStatusStateful stateful = 3 - [json_name = "stateful"]; - - // [Output Only] A status of consistency of Instances' versions with their - // target version specified by version field on Instance Group Manager. - optional InstanceGroupManagerStatusVersionTarget version_target = 4 - [json_name = "versionTarget"]; -} - -message InstanceGroupManagerStatusAllInstancesConfig { - // [Output Only] Current all-instances configuration revision. This value is - // in RFC3339 text format. - optional string current_revision = 1 [json_name = "currentRevision"]; - - // [Output Only] A bit indicating whether this configuration has been applied - // to all managed instances in the group. - optional bool effective = 2 [json_name = "effective"]; -} - -message InstanceGroupManagerStatusStateful { - // [Output Only] A bit indicating whether the managed instance group has - // stateful configuration, that is, if you have configured any items in a - // stateful policy or in per-instance configs. The group might report that it - // has no stateful configuration even when there is still some preserved state - // on a managed instance, for example, if you have deleted all PICs but not - // yet applied those deletions. - optional bool has_stateful_config = 1 [json_name = "hasStatefulConfig"]; - - // [Output Only] Status of per-instance configurations on the instances. - optional InstanceGroupManagerStatusStatefulPerInstanceConfigs - per_instance_configs = 2 [json_name = "perInstanceConfigs"]; -} - -message InstanceGroupManagerStatusStatefulPerInstanceConfigs { - // A bit indicating if all of the group's per-instance configurations (listed - // in the output of a listPerInstanceConfigs API call) have status EFFECTIVE - // or there are no per-instance-configs. - optional bool all_effective = 1 [json_name = "allEffective"]; -} - -message InstanceGroupManagerStatusVersionTarget { - // [Output Only] A bit indicating whether version target has been reached in - // this managed instance group, i.e. all instances are in their target - // version. Instances' target version are specified by version field on - // Instance Group Manager. - optional bool is_reached = 1 [json_name = "isReached"]; -} - -message InstanceGroupManagerUpdatePolicy { - // The instance redistribution policy for regional managed instance groups. - // Valid values are: - PROACTIVE (default): The group attempts to maintain an - // even distribution of VM instances across zones in the region. - NONE: For - // non-autoscaled groups, proactive redistribution is disabled. - // NONE: No action is being proactively performed in order to bring this IGM - // to its target instance distribution. - // PROACTIVE: This IGM will actively converge to its target instance - // distribution. - optional string instance_redistribution_type = 1 - [json_name = "instanceRedistributionType"]; - - // The maximum number of instances that can be created above the specified - // targetSize during the update process. This value can be either a fixed - // number or, if the group has 10 or more instances, a percentage. If you set - // a percentage, the number of instances is rounded if necessary. The default - // value for maxSurge is a fixed value equal to the number of zones in which - // the managed instance group operates. At least one of either maxSurge or - // maxUnavailable must be greater than 0. Learn more about maxSurge. - optional FixedOrPercent max_surge = 2 [json_name = "maxSurge"]; - - // The maximum number of instances that can be unavailable during the update - // process. An instance is considered available if all of the following - // conditions are satisfied: - The instance's status is RUNNING. - If there is - // a health check on the instance group, the instance's health check status - // must be HEALTHY at least once. If there is no health check on the group, - // then the instance only needs to have a status of RUNNING to be considered - // available. This value can be either a fixed number or, if the group has 10 - // or more instances, a percentage. If you set a percentage, the number of - // instances is rounded if necessary. The default value for maxUnavailable is - // a fixed value equal to the number of zones in which the managed instance - // group operates. At least one of either maxSurge or maxUnavailable must be - // greater than 0. Learn more about maxUnavailable. - optional FixedOrPercent max_unavailable = 3 [json_name = "maxUnavailable"]; - - // Minimal action to be taken on an instance. Use this option to minimize - // disruption as much as possible or to apply a more disruptive action than is - // necessary. - To limit disruption as much as possible, set the minimal - // action to REFRESH. If your update requires a more disruptive action, - // Compute Engine performs the necessary action to execute the update. - To - // apply a more disruptive action than is strictly necessary, set the minimal - // action to RESTART or REPLACE. For example, Compute Engine does not need to - // restart a VM to change its metadata. But if your application reads instance - // metadata only when a VM is restarted, you can set the minimal action to - // RESTART in order to pick up metadata changes. - // NONE: Do not perform any action. - // REFRESH: Do not stop the instance. - // REPLACE: (Default.) Replace the instance according to the replacement - // method option. - // RESTART: Stop the instance and start it again. - optional string minimal_action = 4 [json_name = "minimalAction"]; - - // Most disruptive action that is allowed to be taken on an instance. You can - // specify either NONE to forbid any actions, REFRESH to avoid restarting the - // VM and to limit disruption as much as possible. RESTART to allow actions - // that can be applied without instance replacing or REPLACE to allow all - // possible actions. If the Updater determines that the minimal update action - // needed is more disruptive than most disruptive allowed action you specify - // it will not perform the update at all. - // NONE: Do not perform any action. - // REFRESH: Do not stop the instance. - // REPLACE: (Default.) Replace the instance according to the replacement - // method option. - // RESTART: Stop the instance and start it again. - optional string most_disruptive_allowed_action = 5 - [json_name = "mostDisruptiveAllowedAction"]; - - // What action should be used to replace instances. See minimal_action.REPLACE - // RECREATE: Instances will be recreated (with the same name) - // SUBSTITUTE: Default option: instances will be deleted and created (with a - // new name) - optional string replacement_method = 6 [json_name = "replacementMethod"]; - - // The type of update process. You can specify either PROACTIVE so that the - // MIG automatically updates VMs to the latest configurations or OPPORTUNISTIC - // so that you can select the VMs that you want to update. - // OPPORTUNISTIC: MIG will apply new configurations to existing VMs only when - // you selectively target specific or all VMs to be updated. - // PROACTIVE: MIG will automatically apply new configurations to all or a - // subset of existing VMs and also to new VMs that are added to the group. - optional string type = 7 [json_name = "type"]; -} - -message InstanceGroupManagerVersion { - // The URL of the instance template that is specified for this managed - // instance group. The group uses this template to create new instances in the - // managed instance group until the `targetSize` for this version is reached. - // The templates for existing instances in the group do not change unless you - // run recreateInstances, run applyUpdatesToInstances, or set the group's - // updatePolicy.type to PROACTIVE; in those cases, existing instances are - // updated until the `targetSize` for this version is reached. - optional string instance_template = 1 [json_name = "instanceTemplate"]; - - // Name of the version. Unique among all versions in the scope of this managed - // instance group. - optional string name = 2 [json_name = "name"]; - - // Specifies the intended number of instances to be created from the - // instanceTemplate. The final number of instances created from the template - // will be equal to: - If expressed as a fixed number, the minimum of either - // targetSize.fixed or instanceGroupManager.targetSize is used. - if expressed - // as a percent, the targetSize would be (targetSize.percent/100 * - // InstanceGroupManager.targetSize) If there is a remainder, the number is - // rounded. If unset, this version will update any remaining instances not - // updated by another version. Read Starting a canary update for more - // information. - optional FixedOrPercent target_size = 3 [json_name = "targetSize"]; -} - -message InstanceManagedByIgmError { - // [Output Only] Contents of the error. - optional InstanceManagedByIgmErrorManagedInstanceError error = 1 - [json_name = "error"]; - - // [Output Only] Details of the instance action that triggered this error. May - // be null, if the error was not caused by an action on an instance. This - // field is optional. - optional InstanceManagedByIgmErrorInstanceActionDetails - instance_action_details = 2 [json_name = "instanceActionDetails"]; - - // [Output Only] The time that this error occurred. This value is in RFC3339 - // text format. - optional string timestamp = 3 [json_name = "timestamp"]; -} - -message InstanceManagedByIgmErrorInstanceActionDetails { - // [Output Only] Action that managed instance group was executing on the - // instance when the error occurred. Possible values: - // ABANDONING: The managed instance group is abandoning this instance. The - // instance will be removed from the instance group and from any target pools - // that are associated with this group. - // CREATING: The managed instance group is creating this instance. If the - // group fails to create this instance, it will try again until it is - // successful. - // CREATING_WITHOUT_RETRIES: The managed instance group is attempting to - // create this instance only once. If the group fails to create this instance, - // it does not try again and the group's targetSize value is decreased. - // DELETING: The managed instance group is permanently deleting this instance. - // NONE: The managed instance group has not scheduled any actions for this - // instance. - // RECREATING: The managed instance group is recreating this instance. - // REFRESHING: The managed instance group is applying configuration changes to - // the instance without stopping it. For example, the group can update the - // target pool list for an instance without stopping that instance. - // RESTARTING: The managed instance group is restarting this instance. - // RESUMING: The managed instance group is resuming this instance. - // STARTING: The managed instance group is starting this instance. - // STOPPING: The managed instance group is stopping this instance. - // SUSPENDING: The managed instance group is suspending this instance. - // VERIFYING: The managed instance group is verifying this already created - // instance. Verification happens every time the instance is (re)created or - // restarted and consists of: 1. Waiting until health check specified as part - // of this managed instance group's autohealing policy reports HEALTHY. Note: - // Applies only if autohealing policy has a health check specified 2. Waiting - // for addition verification steps performed as post-instance creation - // (subject to future extensions). - optional string action = 1 [json_name = "action"]; - - // [Output Only] The URL of the instance. The URL can be set even if the - // instance has not yet been created. - optional string instance = 2 [json_name = "instance"]; - - // [Output Only] Version this instance was created from, or was being created - // from, but the creation failed. Corresponds to one of the versions that were - // set on the Instance Group Manager resource at the time this instance was - // being created. - optional ManagedInstanceVersion version = 3 [json_name = "version"]; -} - -message InstanceManagedByIgmErrorManagedInstanceError { - // [Output Only] Error code. - optional string code = 1 [json_name = "code"]; - - // [Output Only] Error message. - optional string message = 2 [json_name = "message"]; -} - -// Represents the change that you want to make to the instance properties. -message InstancePropertiesPatch { - // The label key-value pairs that you want to patch onto the instance. - map labels = 1 [json_name = "labels"]; - - // The metadata key-value pairs that you want to patch onto the instance. For - // more information, see Project and instance metadata. - map metadata = 2 [json_name = "metadata"]; -} - -// A Managed Instance resource. -message ManagedInstance { - // [Output Only] The current action that the managed instance group has - // scheduled for the instance. Possible values: - NONE The instance is - // running, and the managed instance group does not have any scheduled actions - // for this instance. - CREATING The managed instance group is creating this - // instance. If the group fails to create this instance, it will try again - // until it is successful. - CREATING_WITHOUT_RETRIES The managed instance - // group is attempting to create this instance only once. If the group fails - // to create this instance, it does not try again and the group's targetSize - // value is decreased instead. - RECREATING The managed instance group is - // recreating this instance. - DELETING The managed instance group is - // permanently deleting this instance. - ABANDONING The managed instance group - // is abandoning this instance. The instance will be removed from the instance - // group and from any target pools that are associated with this group. - - // RESTARTING The managed instance group is restarting the instance. - - // REFRESHING The managed instance group is applying configuration changes to - // the instance without stopping it. For example, the group can update the - // target pool list for an instance without stopping that instance. - - // VERIFYING The managed instance group has created the instance and it is in - // the process of being verified. - // ABANDONING: The managed instance group is abandoning this instance. The - // instance will be removed from the instance group and from any target pools - // that are associated with this group. - // CREATING: The managed instance group is creating this instance. If the - // group fails to create this instance, it will try again until it is - // successful. - // CREATING_WITHOUT_RETRIES: The managed instance group is attempting to - // create this instance only once. If the group fails to create this instance, - // it does not try again and the group's targetSize value is decreased. - // DELETING: The managed instance group is permanently deleting this instance. - // NONE: The managed instance group has not scheduled any actions for this - // instance. - // RECREATING: The managed instance group is recreating this instance. - // REFRESHING: The managed instance group is applying configuration changes to - // the instance without stopping it. For example, the group can update the - // target pool list for an instance without stopping that instance. - // RESTARTING: The managed instance group is restarting this instance. - // RESUMING: The managed instance group is resuming this instance. - // STARTING: The managed instance group is starting this instance. - // STOPPING: The managed instance group is stopping this instance. - // SUSPENDING: The managed instance group is suspending this instance. - // VERIFYING: The managed instance group is verifying this already created - // instance. Verification happens every time the instance is (re)created or - // restarted and consists of: 1. Waiting until health check specified as part - // of this managed instance group's autohealing policy reports HEALTHY. Note: - // Applies only if autohealing policy has a health check specified 2. Waiting - // for addition verification steps performed as post-instance creation - // (subject to future extensions). - optional string current_action = 1 [json_name = "currentAction"]; - - // [Output only] The unique identifier for this resource. This field is empty - // when instance does not exist. - optional string id = 2 [json_name = "id"]; - - // [Output Only] The URL of the instance. The URL can exist even if the - // instance has not yet been created. - optional string instance = 3 [json_name = "instance"]; - - // [Output Only] Health state of the instance per health-check. - repeated ManagedInstanceInstanceHealth instance_health = 4 - [json_name = "instanceHealth"]; - - // [Output Only] The status of the instance. This field is empty when the - // instance does not exist. - // DEPROVISIONING: The instance is halted and we are performing tear down - // tasks like network deprogramming, releasing quota, IP, tearing down disks - // etc. - // PROVISIONING: Resources are being allocated for the instance. - // REPAIRING: The instance is in repair. - // RUNNING: The instance is running. - // STAGING: All required resources have been allocated and the instance is - // being started. - // STOPPED: The instance has stopped successfully. - // STOPPING: The instance is currently stopping (either being deleted or - // killed). - // SUSPENDED: The instance has suspended. - // SUSPENDING: The instance is suspending. - // TERMINATED: The instance has stopped (either by explicit action or - // underlying failure). - optional string instance_status = 5 [json_name = "instanceStatus"]; - - // [Output Only] Information about the last attempt to create or delete the - // instance. - optional ManagedInstanceLastAttempt last_attempt = 6 - [json_name = "lastAttempt"]; - - // [Output Only] The name of the instance. The name always exists even if the - // instance has not yet been created. - optional string name = 10 [json_name = "name"]; - - // [Output Only] Preserved state applied from per-instance config for this - // instance. - optional PreservedState preserved_state_from_config = 7 - [json_name = "preservedStateFromConfig"]; - - // [Output Only] Preserved state generated based on stateful policy for this - // instance. - optional PreservedState preserved_state_from_policy = 8 - [json_name = "preservedStateFromPolicy"]; - - // [Output Only] Intended version of this instance. - optional ManagedInstanceVersion version = 9 [json_name = "version"]; -} - -message ManagedInstanceInstanceHealth { - // [Output Only] The current detailed instance health state. - // DRAINING: The instance is being drained. The existing connections to the - // instance have time to complete, but the new ones are being refused. - // HEALTHY: The instance is reachable i.e. a connection to the application - // health checking endpoint can be established, and conforms to the - // requirements defined by the health check. - // TIMEOUT: The instance is unreachable i.e. a connection to the application - // health checking endpoint cannot be established, or the server does not - // respond within the specified timeout. - // UNHEALTHY: The instance is reachable, but does not conform to the - // requirements defined by the health check. - // UNKNOWN: The health checking system is aware of the instance but its health - // is not known at the moment. - optional string detailed_health_state = 1 [json_name = "detailedHealthState"]; - - // [Output Only] The URL for the health check that verifies whether the - // instance is healthy. - optional string health_check = 2 [json_name = "healthCheck"]; -} - -message ManagedInstanceLastAttempt { - message Errors { - message ErrorsItem { - // [Output Only] The error type identifier for this error. - optional string code = 1 [json_name = "code"]; - - message ErrorDetailsItem { - optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; - - optional Help help = 2 [json_name = "help"]; - - optional LocalizedMessage localized_message = 3 - [json_name = "localizedMessage"]; - - optional QuotaExceededInfo quota_info = 4 [json_name = "quotaInfo"]; - } - - // [Output Only] An optional list of messages that contain the error - // details. There is a set of defined message types to use for providing - // details.The syntax depends on the error code. For example, - // QuotaExceededInfo will have details when the error code is - // QUOTA_EXCEEDED. - repeated ErrorDetailsItem error_details = 2 [json_name = "errorDetails"]; - - // [Output Only] Indicates the field in the request that caused the error. - // This property is optional. - optional string location = 3 [json_name = "location"]; - - // [Output Only] An optional, human-readable error message. - optional string message = 4 [json_name = "message"]; - } - - // [Output Only] The array of errors encountered while processing this - // operation. - repeated ErrorsItem errors = 1 [json_name = "errors"]; - } - - // [Output Only] Encountered errors during the last attempt to create or - // delete the instance. - optional Errors errors = 1 [json_name = "errors"]; -} - -message ManagedInstanceVersion { - // [Output Only] The intended template of the instance. This field is empty - // when current_action is one of { DELETING, ABANDONING }. - optional string instance_template = 1 [json_name = "instanceTemplate"]; - - // [Output Only] Name of the version. - optional string name = 2 [json_name = "name"]; -} - -message PerInstanceConfig { - // Fingerprint of this per-instance config. This field can be used in - // optimistic locking. It is ignored when inserting a per-instance config. An - // up-to-date fingerprint must be provided in order to update an existing - // per-instance configuration or the field needs to be unset. - optional string fingerprint = 1 [json_name = "fingerprint"]; - - // The name of a per-instance configuration and its corresponding instance. - // Serves as a merge key during UpdatePerInstanceConfigs operations, that is, - // if a per-instance configuration with the same name exists then it will be - // updated, otherwise a new one will be created for the VM instance with the - // same name. An attempt to create a per-instance configconfiguration for a VM - // instance that either doesn't exist or is not part of the group will result - // in an error. - optional string name = 2 [json_name = "name"]; - - // The intended preserved state for the given instance. Does not contain - // preserved state generated from a stateful policy. - optional PreservedState preserved_state = 3 [json_name = "preservedState"]; - - // The status of applying this per-instance configuration on the corresponding - // managed instance. - // APPLYING: The per-instance configuration is being applied to the instance, - // but is not yet effective, possibly waiting for the instance to, for - // example, REFRESH. - // DELETING: The per-instance configuration deletion is being applied on the - // instance, possibly waiting for the instance to, for example, REFRESH. - // EFFECTIVE: The per-instance configuration is effective on the instance, - // meaning that all disks, ips and metadata specified in this configuration - // are attached or set on the instance. - // NONE: *[Default]* The default status, when no per-instance configuration - // exists. - // UNAPPLIED: The per-instance configuration is set on an instance but not - // been applied yet. - // UNAPPLIED_DELETION: The per-instance configuration has been deleted, but - // the deletion is not yet applied. - optional string status = 4 [json_name = "status"]; -} - -// Preserved state for a given instance. -message PreservedState { - // Preserved disks defined for this instance. This map is keyed with the - // device names of the disks. - map disks = 1 [json_name = "disks"]; - - // Preserved external IPs defined for this instance. This map is keyed with - // the name of the network interface. - map external_i_ps = 3 - [json_name = "externalIPs"]; - - // Preserved internal IPs defined for this instance. This map is keyed with - // the name of the network interface. - map internal_i_ps = 4 - [json_name = "internalIPs"]; - - // Preserved metadata defined for this instance. - map metadata = 2 [json_name = "metadata"]; -} - -message PreservedStatePreservedDisk { - // These stateful disks will never be deleted during autohealing, update, - // instance recreate operations. This flag is used to configure if the disk - // should be deleted after it is no longer used by the group, e.g. when the - // given instance or the whole MIG is deleted. Note: disks attached in - // READ_ONLY mode cannot be auto-deleted. - // NEVER: - // ON_PERMANENT_INSTANCE_DELETION: - optional string auto_delete = 1 [json_name = "autoDelete"]; - - // The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If - // not specified, the default is to attach the disk in READ_WRITE mode. - // READ_ONLY: Attaches this disk in read-only mode. Multiple VM instances can - // use a disk in READ_ONLY mode at a time. - // READ_WRITE: *[Default]* Attaches this disk in READ_WRITE mode. Only one VM - // instance at a time can be attached to a disk in READ_WRITE mode. - optional string mode = 2 [json_name = "mode"]; - - // The URL of the disk resource that is stateful and should be attached to the - // VM instance. - optional string source = 3 [json_name = "source"]; -} - -message PreservedStatePreservedNetworkIp { - // These stateful IPs will never be released during autohealing, update or VM - // instance recreate operations. This flag is used to configure if the IP - // reservation should be deleted after it is no longer used by the group, e.g. - // when the given instance or the whole group is deleted. - // NEVER: - // ON_PERMANENT_INSTANCE_DELETION: - optional string auto_delete = 1 [json_name = "autoDelete"]; - - // Ip address representation - optional PreservedStatePreservedNetworkIpIpAddress ip_address = 2 - [json_name = "ipAddress"]; -} - -message PreservedStatePreservedNetworkIpIpAddress { - // The URL of the reservation for this IP address. - optional string address = 1 [json_name = "address"]; - - // An IPv4 internal network address to assign to the instance for this network - // interface. - optional string literal = 2 [json_name = "literal"]; -} - -message StatefulPolicy { - optional StatefulPolicyPreservedState preserved_state = 1 - [json_name = "preservedState"]; -} - -// Configuration of preserved resources. -message StatefulPolicyPreservedState { - // Disks created on the instances that will be preserved on instance delete, - // update, etc. This map is keyed with the device names of the disks. - map disks = 1 - [json_name = "disks"]; - - // External network IPs assigned to the instances that will be preserved on - // instance delete, update, etc. This map is keyed with the network interface - // name. - map external_i_ps = 2 - [json_name = "externalIPs"]; - - // Internal network IPs assigned to the instances that will be preserved on - // instance delete, update, etc. This map is keyed with the network interface - // name. - map internal_i_ps = 3 - [json_name = "internalIPs"]; -} - -message StatefulPolicyPreservedStateDiskDevice { - // These stateful disks will never be deleted during autohealing, update or VM - // instance recreate operations. This flag is used to configure if the disk - // should be deleted after it is no longer used by the group, e.g. when the - // given instance or the whole group is deleted. Note: disks attached in - // READ_ONLY mode cannot be auto-deleted. - // NEVER: - // ON_PERMANENT_INSTANCE_DELETION: - optional string auto_delete = 1 [json_name = "autoDelete"]; -} - -message StatefulPolicyPreservedStateNetworkIp { - // These stateful IPs will never be released during autohealing, update or VM - // instance recreate operations. This flag is used to configure if the IP - // reservation should be deleted after it is no longer used by the group, e.g. - // when the given instance or the whole group is deleted. - // NEVER: - // ON_PERMANENT_INSTANCE_DELETION: - optional string auto_delete = 1 [json_name = "autoDelete"]; +// A Duration represents a fixed-length span of time represented as a count of +// seconds and fractions of seconds at nanosecond resolution. It is independent +// of any calendar and concepts like "day" or "month". Range is approximately +// 10,000 years. +message Duration { + // Span of time that's a fraction of a second at nanosecond resolution. + // Durations less than one second are represented with a 0 `seconds` field and + // a positive `nanos` field. Must be from 0 to 999,999,999 inclusive. + optional int32 nanos = 1 [json_name = "nanos"]; + + // Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 + // inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * + // 24 hr/day * 365.25 days/year * 10000 years + optional string seconds = 2 [json_name = "seconds"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_030.proto b/protos/google/cloud/compute/v1/internal/common_030.proto index acfdd29844b3f..2512edf0e9f4d 100644 --- a/protos/google/cloud/compute/v1/internal/common_030.proto +++ b/protos/google/cloud/compute/v1/internal/common_030.proto @@ -15,24 +15,504 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// A Duration represents a fixed-length span of time represented as a count of -// seconds and fractions of seconds at nanosecond resolution. It is independent -// of any calendar and concepts like "day" or "month". Range is approximately -// 10,000 years. -message Duration { - // Span of time that's a fraction of a second at nanosecond resolution. - // Durations less than one second are represented with a 0 `seconds` field and - // a positive `nanos` field. Must be from 0 to 999,999,999 inclusive. - optional int32 nanos = 1 [json_name = "nanos"]; - - // Span of time at a resolution of a second. Must be from 0 to 315,576,000,000 - // inclusive. Note: these bounds are computed from: 60 sec/min * 60 min/hr * - // 24 hr/day * 365.25 days/year * 10000 years - optional string seconds = 2 [json_name = "seconds"]; +import "google/cloud/compute/v1/internal/common_034.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; + +message ExchangedPeeringRoute { + // The destination range of the route. + optional string dest_range = 1 [json_name = "destRange"]; + + // True if the peering route has been imported from a peer. The actual import + // happens if the field networkPeering.importCustomRoutes is true for this + // network, and networkPeering.exportCustomRoutes is true for the peer + // network, and the import does not result in a route conflict. + optional bool imported = 2 [json_name = "imported"]; + + // The region of peering route next hop, only applies to dynamic routes. + optional string next_hop_region = 3 [json_name = "nextHopRegion"]; + + // The priority of the peering route. + optional uint32 priority = 4 [json_name = "priority"]; + + // The type of the peering route. + // DYNAMIC_PEERING_ROUTE: For routes exported from local network. + // STATIC_PEERING_ROUTE: The peering route. + // SUBNET_PEERING_ROUTE: The peering route corresponding to subnetwork range. + optional string type = 5 [json_name = "type"]; +} + +message ExchangedPeeringRoutesList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of ExchangedPeeringRoute resources. + repeated ExchangedPeeringRoute items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#exchangedPeeringRoutesList + // for exchanged peering routes lists. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +// Represents a VPC Network resource. Networks connect resources to each other +// and to the internet. For more information, read Virtual Private Cloud (VPC) +// Network. +message Network { + // Deprecated in favor of subnet mode networks. The range of internal + // addresses that are legal on this network. This range is a CIDR + // specification, for example: 192.168.0.0/16. Provided by the client when the + // network is created. + optional string i_pv4_range = 1 [json_name = "IPv4Range"]; + + // Must be set to create a VPC network. If not set, a legacy network is + // created. When set to true, the VPC network is created in auto mode. When + // set to false, the VPC network is created in custom mode. An auto mode VPC + // network starts with one subnet per region. Each subnet has a predetermined + // range as described in Auto mode VPC network IP ranges. For custom mode VPC + // networks, you can add subnets using the subnetworks insert method. + optional bool auto_create_subnetworks = 2 + [json_name = "autoCreateSubnetworks"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this field when you + // create the resource. + optional string description = 4 [json_name = "description"]; + + // Enable ULA internal ipv6 on this network. Enabling this feature will assign + // a /48 from google defined ULA prefix fd20::/20. . + optional bool enable_ula_internal_ipv6 = 5 + [json_name = "enableUlaInternalIpv6"]; + + // [Output Only] URL of the firewall policy the network is associated with. + optional string firewall_policy = 6 [json_name = "firewallPolicy"]; + + // [Output Only] The gateway address for default routing out of the network, + // selected by Google Cloud. + optional string gateway_i_pv4 = 7 [json_name = "gatewayIPv4"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 8 [json_name = "id"]; + + // When enabling ula internal ipv6, caller optionally can specify the /48 + // range they want from the google defined ULA prefix fd20::/20. The input + // must be a valid /48 ULA IPv6 address and must be within the fd20::/20. + // Operation will fail if the speficied /48 is already in used by another + // resource. If the field is not speficied, then a /48 range will be randomly + // allocated from fd20::/20 and returned via this field. . + optional string internal_ipv6_range = 9 [json_name = "internalIpv6Range"]; + + // [Output Only] Type of the resource. Always compute#network for networks. + optional string kind = 10 [json_name = "kind"]; + + // Maximum Transmission Unit in bytes. The minimum value for this field is + // 1300 and the maximum value is 8896. The suggested value is 1500, which is + // the default MTU used on the Internet, or 8896 if you want to use Jumbo + // frames. If unspecified, the value defaults to 1460. + optional int32 mtu = 11 [json_name = "mtu"]; + + // 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])?`. The first character must be a + // lowercase letter, and all following characters (except for the last + // character) must be a dash, lowercase letter, or digit. The last character + // must be a lowercase letter or digit. + optional string name = 12 [json_name = "name"]; + + // The network firewall policy enforcement order. Can be either + // AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to + // AFTER_CLASSIC_FIREWALL if the field is not specified. + // AFTER_CLASSIC_FIREWALL: + // BEFORE_CLASSIC_FIREWALL: + optional string network_firewall_policy_enforcement_order = 13 + [json_name = "networkFirewallPolicyEnforcementOrder"]; + + // [Output Only] A list of network peerings for the resource. + repeated NetworkPeering peerings = 14 [json_name = "peerings"]; + + // The network-level routing configuration for this network. Used by Cloud + // Router to determine what type of network-wide routing behavior to enforce. + optional NetworkRoutingConfig routing_config = 15 + [json_name = "routingConfig"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 16 [json_name = "selfLink"]; + + // [Output Only] Server-defined URL for this resource with the resource id. + optional string self_link_with_id = 17 [json_name = "selfLinkWithId"]; + + // [Output Only] Server-defined fully-qualified URLs for all subnetworks in + // this VPC network. + repeated string subnetworks = 18 [json_name = "subnetworks"]; +} + +// Contains a list of networks. +message NetworkList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of Network resources. + repeated Network items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#networkList for lists of + // networks. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +// A network peering attached to a network resource. The message includes the +// peering name, peer network, peering state, and a flag indicating whether +// Google Compute Engine should automatically create routes for the peering. +message NetworkPeering { + // This field will be deprecated soon. Use the exchange_subnet_routes field + // instead. Indicates whether full mesh connectivity is created and managed + // automatically between peered networks. Currently this field should always + // be true since Google Compute Engine will automatically create and manage + // subnetwork routes between two networks when peering state is ACTIVE. + optional bool auto_create_routes = 1 [json_name = "autoCreateRoutes"]; + + // Indicates whether full mesh connectivity is created and managed + // automatically between peered networks. Currently this field should always + // be true since Google Compute Engine will automatically create and manage + // subnetwork routes between two networks when peering state is ACTIVE. + optional bool exchange_subnet_routes = 2 [json_name = "exchangeSubnetRoutes"]; + + // Whether to export the custom routes to peer network. The default value is + // false. + optional bool export_custom_routes = 3 [json_name = "exportCustomRoutes"]; + + // Whether subnet routes with public IP range are exported. The default value + // is true, all subnet routes are exported. IPv4 special-use ranges are always + // exported to peers and are not controlled by this field. + optional bool export_subnet_routes_with_public_ip = 4 + [json_name = "exportSubnetRoutesWithPublicIp"]; + + // Whether to import the custom routes from peer network. The default value is + // false. + optional bool import_custom_routes = 5 [json_name = "importCustomRoutes"]; + + // Whether subnet routes with public IP range are imported. The default value + // is false. IPv4 special-use ranges are always imported from peers and are + // not controlled by this field. + optional bool import_subnet_routes_with_public_ip = 6 + [json_name = "importSubnetRoutesWithPublicIp"]; + + // Name of this peering. Provided by the client when the peering is created. + // The name must comply with RFC1035. Specifically, the name must be 1-63 + // characters long and match regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. + // The first character must be a lowercase letter, and all the following + // characters must be a dash, lowercase letter, or digit, except the last + // character, which cannot be a dash. + optional string name = 7 [json_name = "name"]; + + // The URL of the peer network. It can be either full URL or partial URL. The + // peer network may belong to a different project. If the partial URL does not + // contain project, it is assumed that the peer network is in the same project + // as the current network. + optional string network = 8 [json_name = "network"]; + + // Maximum Transmission Unit in bytes. + optional int32 peer_mtu = 9 [json_name = "peerMtu"]; + + // Which IP version(s) of traffic and routes are allowed to be imported or + // exported between peer networks. The default value is IPV4_ONLY. + // IPV4_IPV6: This Peering will allow IPv4 traffic and routes to be exchanged. + // Additionally if the matching peering is IPV4_IPV6, IPv6 traffic and routes + // will be exchanged as well. + // IPV4_ONLY: This Peering will only allow IPv4 traffic and routes to be + // exchanged, even if the matching peering is IPV4_IPV6. + optional string stack_type = 10 [json_name = "stackType"]; + + // [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The + // peering is `ACTIVE` when there's a matching configuration in the peer + // network. + // ACTIVE: Matching configuration exists on the peer. + // INACTIVE: There is no matching configuration on the peer, including the + // case when peer does not exist. + optional string state = 11 [json_name = "state"]; + + // [Output Only] Details about the current state of the peering. + optional string state_details = 12 [json_name = "stateDetails"]; +} + +// A routing configuration attached to a network resource. The message includes +// the list of routers associated with the network, and a flag indicating the +// type of routing behavior to enforce network-wide. +message NetworkRoutingConfig { + // The network-wide routing mode to use. If set to REGIONAL, this network's + // Cloud Routers will only advertise routes with subnets of this network in + // the same region as the router. If set to GLOBAL, this network's Cloud + // Routers will advertise routes with all subnets of this network, across + // regions. + // GLOBAL: + // REGIONAL: + optional string routing_mode = 1 [json_name = "routingMode"]; +} + +message NetworksAddPeeringRequest { + // This field will be deprecated soon. Use exchange_subnet_routes in + // network_peering instead. Indicates whether full mesh connectivity is + // created and managed automatically between peered networks. Currently this + // field should always be true since Google Compute Engine will automatically + // create and manage subnetwork routes between two networks when peering state + // is ACTIVE. + optional bool auto_create_routes = 1 [json_name = "autoCreateRoutes"]; + + // Name of the peering, which should conform to RFC1035. + optional string name = 2 [json_name = "name"]; + + // Network peering parameters. In order to specify route policies for peering + // using import and export custom routes, you must specify all peering related + // parameters (name, peer network, exchange_subnet_routes) in the + // network_peering field. The corresponding fields in + // NetworksAddPeeringRequest will be deprecated soon. + optional NetworkPeering network_peering = 3 [json_name = "networkPeering"]; + + // URL of the peer network. It can be either full URL or partial URL. The peer + // network may belong to a different project. If the partial URL does not + // contain project, it is assumed that the peer network is in the same project + // as the current network. + optional string peer_network = 4 [json_name = "peerNetwork"]; +} + +message NetworksGetEffectiveFirewallsResponse { + // [Output Only] Effective firewalls from firewall policy. It returns Global + // Network Firewall Policies and Hierarchical Firewall Policies. Use + // regionNetworkFirewallPolicies.getEffectiveFirewalls to get Regional Network + // Firewall Policies as well. + repeated NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy + firewall_policys = 1 [json_name = "firewallPolicys"]; + + // Effective firewalls on the network. + repeated Firewall firewalls = 2 [json_name = "firewalls"]; +} + +message NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy { + // [Output Only] Deprecated, please use short name instead. The display name + // of the firewall policy. + optional string display_name = 1 [json_name = "displayName"]; + + // [Output Only] The name of the firewall policy. + optional string name = 2 [json_name = "name"]; + + // [Output only] Priority of firewall policy association. Not applicable for + // type=HIERARCHY. + optional int32 priority = 6 [json_name = "priority"]; + + // [Output Only] The rules that apply to the network. + repeated FirewallPolicyRule rules = 3 [json_name = "rules"]; + + // [Output Only] The short name of the firewall policy. + optional string short_name = 4 [json_name = "shortName"]; + + // [Output Only] The type of the firewall policy. + // HIERARCHY: + // NETWORK: + // SYSTEM: + // UNSPECIFIED: + optional string type = 5 [json_name = "type"]; +} + +message NetworksRemovePeeringRequest { + // Name of the peering, which should conform to RFC1035. + optional string name = 1 [json_name = "name"]; +} + +message NetworksUpdatePeeringRequest { + optional NetworkPeering network_peering = 1 [json_name = "networkPeering"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_031.proto b/protos/google/cloud/compute/v1/internal/common_031.proto index b4f3bf2718969..9b89f52b2d34d 100644 --- a/protos/google/cloud/compute/v1/internal/common_031.proto +++ b/protos/google/cloud/compute/v1/internal/common_031.proto @@ -15,501 +15,42 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_035.proto"; -import "google/cloud/compute/v1/internal/common_039.proto"; - -message ExchangedPeeringRoute { - // The destination range of the route. - optional string dest_range = 1 [json_name = "destRange"]; - - // True if the peering route has been imported from a peer. The actual import - // happens if the field networkPeering.importCustomRoutes is true for this - // network, and networkPeering.exportCustomRoutes is true for the peer - // network, and the import does not result in a route conflict. - optional bool imported = 2 [json_name = "imported"]; - - // The region of peering route next hop, only applies to dynamic routes. - optional string next_hop_region = 3 [json_name = "nextHopRegion"]; - - // The priority of the peering route. - optional uint32 priority = 4 [json_name = "priority"]; - - // The type of the peering route. - // DYNAMIC_PEERING_ROUTE: For routes exported from local network. - // STATIC_PEERING_ROUTE: The peering route. - // SUBNET_PEERING_ROUTE: The peering route corresponding to subnetwork range. - optional string type = 5 [json_name = "type"]; -} - -message ExchangedPeeringRoutesList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of ExchangedPeeringRoute resources. - repeated ExchangedPeeringRoute items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#exchangedPeeringRoutesList - // for exchanged peering routes lists. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// Represents a VPC Network resource. Networks connect resources to each other -// and to the internet. For more information, read Virtual Private Cloud (VPC) -// Network. -message Network { - // Deprecated in favor of subnet mode networks. The range of internal - // addresses that are legal on this network. This range is a CIDR - // specification, for example: 192.168.0.0/16. Provided by the client when the - // network is created. - optional string i_pv4_range = 1 [json_name = "IPv4Range"]; - - // Must be set to create a VPC network. If not set, a legacy network is - // created. When set to true, the VPC network is created in auto mode. When - // set to false, the VPC network is created in custom mode. An auto mode VPC - // network starts with one subnet per region. Each subnet has a predetermined - // range as described in Auto mode VPC network IP ranges. For custom mode VPC - // networks, you can add subnets using the subnetworks insert method. - optional bool auto_create_subnetworks = 2 - [json_name = "autoCreateSubnetworks"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this field when you - // create the resource. - optional string description = 4 [json_name = "description"]; - - // Enable ULA internal ipv6 on this network. Enabling this feature will assign - // a /48 from google defined ULA prefix fd20::/20. . - optional bool enable_ula_internal_ipv6 = 5 - [json_name = "enableUlaInternalIpv6"]; - - // [Output Only] URL of the firewall policy the network is associated with. - optional string firewall_policy = 6 [json_name = "firewallPolicy"]; - - // [Output Only] The gateway address for default routing out of the network, - // selected by Google Cloud. - optional string gateway_i_pv4 = 7 [json_name = "gatewayIPv4"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 8 [json_name = "id"]; - - // When enabling ula internal ipv6, caller optionally can specify the /48 - // range they want from the google defined ULA prefix fd20::/20. The input - // must be a valid /48 ULA IPv6 address and must be within the fd20::/20. - // Operation will fail if the speficied /48 is already in used by another - // resource. If the field is not speficied, then a /48 range will be randomly - // allocated from fd20::/20 and returned via this field. . - optional string internal_ipv6_range = 9 [json_name = "internalIpv6Range"]; - - // [Output Only] Type of the resource. Always compute#network for networks. - optional string kind = 10 [json_name = "kind"]; - - // Maximum Transmission Unit in bytes. The minimum value for this field is - // 1300 and the maximum value is 8896. The suggested value is 1500, which is - // the default MTU used on the Internet, or 8896 if you want to use Jumbo - // frames. If unspecified, the value defaults to 1460. - optional int32 mtu = 11 [json_name = "mtu"]; - - // 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])?`. The first character must be a - // lowercase letter, and all following characters (except for the last - // character) must be a dash, lowercase letter, or digit. The last character - // must be a lowercase letter or digit. - optional string name = 12 [json_name = "name"]; - - // The network firewall policy enforcement order. Can be either - // AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to - // AFTER_CLASSIC_FIREWALL if the field is not specified. - // AFTER_CLASSIC_FIREWALL: - // BEFORE_CLASSIC_FIREWALL: - optional string network_firewall_policy_enforcement_order = 13 - [json_name = "networkFirewallPolicyEnforcementOrder"]; - - // [Output Only] A list of network peerings for the resource. - repeated NetworkPeering peerings = 14 [json_name = "peerings"]; - - // The network-level routing configuration for this network. Used by Cloud - // Router to determine what type of network-wide routing behavior to enforce. - optional NetworkRoutingConfig routing_config = 15 - [json_name = "routingConfig"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 16 [json_name = "selfLink"]; - - // [Output Only] Server-defined URL for this resource with the resource id. - optional string self_link_with_id = 17 [json_name = "selfLinkWithId"]; - - // [Output Only] Server-defined fully-qualified URLs for all subnetworks in - // this VPC network. - repeated string subnetworks = 18 [json_name = "subnetworks"]; -} - -// Contains a list of networks. -message NetworkList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of Network resources. - repeated Network items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#networkList for lists of - // networks. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// A network peering attached to a network resource. The message includes the -// peering name, peer network, peering state, and a flag indicating whether -// Google Compute Engine should automatically create routes for the peering. -message NetworkPeering { - // This field will be deprecated soon. Use the exchange_subnet_routes field - // instead. Indicates whether full mesh connectivity is created and managed - // automatically between peered networks. Currently this field should always - // be true since Google Compute Engine will automatically create and manage - // subnetwork routes between two networks when peering state is ACTIVE. - optional bool auto_create_routes = 1 [json_name = "autoCreateRoutes"]; - - // Indicates whether full mesh connectivity is created and managed - // automatically between peered networks. Currently this field should always - // be true since Google Compute Engine will automatically create and manage - // subnetwork routes between two networks when peering state is ACTIVE. - optional bool exchange_subnet_routes = 2 [json_name = "exchangeSubnetRoutes"]; - - // Whether to export the custom routes to peer network. The default value is - // false. - optional bool export_custom_routes = 3 [json_name = "exportCustomRoutes"]; - - // Whether subnet routes with public IP range are exported. The default value - // is true, all subnet routes are exported. IPv4 special-use ranges are always - // exported to peers and are not controlled by this field. - optional bool export_subnet_routes_with_public_ip = 4 - [json_name = "exportSubnetRoutesWithPublicIp"]; - - // Whether to import the custom routes from peer network. The default value is - // false. - optional bool import_custom_routes = 5 [json_name = "importCustomRoutes"]; - - // Whether subnet routes with public IP range are imported. The default value - // is false. IPv4 special-use ranges are always imported from peers and are - // not controlled by this field. - optional bool import_subnet_routes_with_public_ip = 6 - [json_name = "importSubnetRoutesWithPublicIp"]; - - // Name of this peering. Provided by the client when the peering is created. - // The name must comply with RFC1035. Specifically, the name must be 1-63 - // characters long and match regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. - // The first character must be a lowercase letter, and all the following - // characters must be a dash, lowercase letter, or digit, except the last - // character, which cannot be a dash. - optional string name = 7 [json_name = "name"]; - - // The URL of the peer network. It can be either full URL or partial URL. The - // peer network may belong to a different project. If the partial URL does not - // contain project, it is assumed that the peer network is in the same project - // as the current network. - optional string network = 8 [json_name = "network"]; - - // Maximum Transmission Unit in bytes. - optional int32 peer_mtu = 9 [json_name = "peerMtu"]; - - // Which IP version(s) of traffic and routes are allowed to be imported or - // exported between peer networks. The default value is IPV4_ONLY. - // IPV4_IPV6: This Peering will allow IPv4 traffic and routes to be exchanged. - // Additionally if the matching peering is IPV4_IPV6, IPv6 traffic and routes - // will be exchanged as well. - // IPV4_ONLY: This Peering will only allow IPv4 traffic and routes to be - // exchanged, even if the matching peering is IPV4_IPV6. - optional string stack_type = 10 [json_name = "stackType"]; - - // [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The - // peering is `ACTIVE` when there's a matching configuration in the peer - // network. - // ACTIVE: Matching configuration exists on the peer. - // INACTIVE: There is no matching configuration on the peer, including the - // case when peer does not exist. - optional string state = 11 [json_name = "state"]; - - // [Output Only] Details about the current state of the peering. - optional string state_details = 12 [json_name = "stateDetails"]; -} - -// A routing configuration attached to a network resource. The message includes -// the list of routers associated with the network, and a flag indicating the -// type of routing behavior to enforce network-wide. -message NetworkRoutingConfig { - // The network-wide routing mode to use. If set to REGIONAL, this network's - // Cloud Routers will only advertise routes with subnets of this network in - // the same region as the router. If set to GLOBAL, this network's Cloud - // Routers will advertise routes with all subnets of this network, across - // regions. - // GLOBAL: - // REGIONAL: - optional string routing_mode = 1 [json_name = "routingMode"]; -} - -message NetworksAddPeeringRequest { - // This field will be deprecated soon. Use exchange_subnet_routes in - // network_peering instead. Indicates whether full mesh connectivity is - // created and managed automatically between peered networks. Currently this - // field should always be true since Google Compute Engine will automatically - // create and manage subnetwork routes between two networks when peering state - // is ACTIVE. - optional bool auto_create_routes = 1 [json_name = "autoCreateRoutes"]; - - // Name of the peering, which should conform to RFC1035. - optional string name = 2 [json_name = "name"]; - - // Network peering parameters. In order to specify route policies for peering - // using import and export custom routes, you must specify all peering related - // parameters (name, peer network, exchange_subnet_routes) in the - // network_peering field. The corresponding fields in - // NetworksAddPeeringRequest will be deprecated soon. - optional NetworkPeering network_peering = 3 [json_name = "networkPeering"]; - - // URL of the peer network. It can be either full URL or partial URL. The peer - // network may belong to a different project. If the partial URL does not - // contain project, it is assumed that the peer network is in the same project - // as the current network. - optional string peer_network = 4 [json_name = "peerNetwork"]; -} - -message NetworksGetEffectiveFirewallsResponse { - // Effective firewalls from firewall policy. - repeated NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy - firewall_policys = 1 [json_name = "firewallPolicys"]; - - // Effective firewalls on the network. - repeated Firewall firewalls = 2 [json_name = "firewalls"]; -} - -message NetworksGetEffectiveFirewallsResponseEffectiveFirewallPolicy { - // [Output Only] Deprecated, please use short name instead. The display name - // of the firewall policy. - optional string display_name = 1 [json_name = "displayName"]; - - // [Output Only] The name of the firewall policy. - optional string name = 2 [json_name = "name"]; - - // [Output only] Priority of firewall policy association. Not applicable for - // type=HIERARCHY. - optional int32 priority = 6 [json_name = "priority"]; - - // The rules that apply to the network. - repeated FirewallPolicyRule rules = 3 [json_name = "rules"]; - - // [Output Only] The short name of the firewall policy. - optional string short_name = 4 [json_name = "shortName"]; - - // [Output Only] The type of the firewall policy. - // HIERARCHY: - // NETWORK: - // SYSTEM: - // UNSPECIFIED: - optional string type = 5 [json_name = "type"]; -} - -message NetworksRemovePeeringRequest { - // Name of the peering, which should conform to RFC1035. - optional string name = 1 [json_name = "name"]; -} - -message NetworksUpdatePeeringRequest { - optional NetworkPeering network_peering = 1 [json_name = "networkPeering"]; +// Represents a textual expression in the Common Expression Language (CEL) +// syntax. CEL is a C-like expression language. The syntax and semantics of CEL +// are documented at https://github.com/google/cel-spec. Example (Comparison): +// title: "Summary size limit" description: "Determines if a summary is less +// than 100 chars" expression: "document.summary.size() < 100" Example +// (Equality): title: "Requestor is owner" description: "Determines if requestor +// is the document owner" expression: "document.owner == +// request.auth.claims.email" Example (Logic): title: "Public documents" +// description: "Determine whether the document should be publicly visible" +// expression: "document.type != 'private' && document.type != 'internal'" +// Example (Data Manipulation): title: "Notification string" description: +// "Create a notification string with a timestamp." expression: "'New message +// received at ' + string(document.create_time)" The exact variables and +// functions that may be referenced within an expression are determined by the +// service that evaluates it. See the service documentation for additional +// information. +message Expr { + // Optional. Description of the expression. This is a longer text which + // describes the expression, e.g. when hovered over it in a UI. + optional string description = 1 [json_name = "description"]; + + // Textual representation of an expression in Common Expression Language + // syntax. + optional string expression = 2 [json_name = "expression"]; + + // Optional. String indicating the location of the expression for error + // reporting, e.g. a file name and a position in the file. + optional string location = 3 [json_name = "location"]; + + // Optional. Title for the expression, i.e. a short string describing its + // purpose. This can be used e.g. in UIs which allow to enter the expression. + optional string title = 4 [json_name = "title"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_032.proto b/protos/google/cloud/compute/v1/internal/common_032.proto index 27e1c77d2b4e3..5c5f0b6bcdf24 100644 --- a/protos/google/cloud/compute/v1/internal/common_032.proto +++ b/protos/google/cloud/compute/v1/internal/common_032.proto @@ -15,42 +15,223 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a textual expression in the Common Expression Language (CEL) -// syntax. CEL is a C-like expression language. The syntax and semantics of CEL -// are documented at https://github.com/google/cel-spec. Example (Comparison): -// title: "Summary size limit" description: "Determines if a summary is less -// than 100 chars" expression: "document.summary.size() < 100" Example -// (Equality): title: "Requestor is owner" description: "Determines if requestor -// is the document owner" expression: "document.owner == -// request.auth.claims.email" Example (Logic): title: "Public documents" -// description: "Determine whether the document should be publicly visible" -// expression: "document.type != 'private' && document.type != 'internal'" -// Example (Data Manipulation): title: "Notification string" description: -// "Create a notification string with a timestamp." expression: "'New message -// received at ' + string(document.create_time)" The exact variables and -// functions that may be referenced within an expression are determined by the -// service that evaluates it. See the service documentation for additional -// information. -message Expr { - // Optional. Description of the expression. This is a longer text which - // describes the expression, e.g. when hovered over it in a UI. - optional string description = 1 [json_name = "description"]; - - // Textual representation of an expression in Common Expression Language - // syntax. - optional string expression = 2 [json_name = "expression"]; - - // Optional. String indicating the location of the expression for error - // reporting, e.g. a file name and a position in the file. - optional string location = 3 [json_name = "location"]; - - // Optional. Title for the expression, i.e. a short string describing its - // purpose. This can be used e.g. in UIs which allow to enter the expression. - optional string title = 4 [json_name = "title"]; +// Represents an external VPN gateway. External VPN gateway is the on-premises +// VPN gateway(s) or another cloud provider's VPN gateway that connects to your +// Google Cloud VPN gateway. To create a highly available VPN from Google Cloud +// Platform to your VPN gateway or another cloud provider's VPN gateway, you +// must create a external VPN gateway resource with information about the other +// gateway. For more information about using external VPN gateways, see Creating +// an HA VPN gateway and tunnel pair to a peer VPN. +message ExternalVpnGateway { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 3 [json_name = "id"]; + + // A list of interfaces for this external VPN gateway. If your peer-side + // gateway is an on-premises gateway and non-AWS cloud providers' gateway, at + // most two interfaces can be provided for an external VPN gateway. If your + // peer side is an AWS virtual private gateway, four interfaces should be + // provided for an external VPN gateway. + repeated ExternalVpnGatewayInterface interfaces = 4 + [json_name = "interfaces"]; + + // [Output Only] Type of the resource. Always compute#externalVpnGateway for + // externalVpnGateways. + optional string kind = 5 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this ExternalVpnGateway, + // which is essentially a hash of the labels set used for optimistic locking. + // The fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels, otherwise + // the request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve an ExternalVpnGateway. + optional string label_fingerprint = 6 [json_name = "labelFingerprint"]; + + // Labels for this resource. These can only be added or modified by the + // setLabels method. Each label key/value pair must comply with RFC1035. Label + // values may be empty. + map labels = 7 [json_name = "labels"]; + + // 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. + optional string name = 8 [json_name = "name"]; + + // Indicates the user-supplied redundancy type of this external VPN gateway. + // FOUR_IPS_REDUNDANCY: The external VPN gateway has four public IP addresses; + // at the time of writing this API, the AWS virtual private gateway is an + // example which has four public IP addresses for high availability + // connections; there should be two VPN connections in the AWS virtual private + // gateway , each AWS VPN connection has two public IP addresses; please make + // sure to put two public IP addresses from one AWS VPN connection into + // interfaces 0 and 1 of this external VPN gateway, and put the other two + // public IP addresses from another AWS VPN connection into interfaces 2 and 3 + // of this external VPN gateway. When displaying highly available + // configuration status for the VPN tunnels connected to FOUR_IPS_REDUNDANCY + // external VPN gateway, Google will always detect whether interfaces 0 and 1 + // are connected on one interface of HA Cloud VPN gateway, and detect whether + // interfaces 2 and 3 are connected to another interface of the HA Cloud VPN + // gateway. + // SINGLE_IP_INTERNALLY_REDUNDANT: The external VPN gateway has only one + // public IP address which internally provide redundancy or failover. + // TWO_IPS_REDUNDANCY: The external VPN gateway has two public IP addresses + // which are redundant with each other, the following two types of setup on + // your on-premises side would have this type of redundancy: (1) Two separate + // on-premises gateways, each with one public IP address, the two on-premises + // gateways are redundant with each other. (2) A single on-premise gateway + // with two public IP addresses that are redundant with eatch other. + optional string redundancy_type = 9 [json_name = "redundancyType"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 10 [json_name = "selfLink"]; +} + +// The interface for the external VPN gateway. +message ExternalVpnGatewayInterface { + // The numeric ID of this interface. The allowed input values for this id for + // different redundancy types of external VPN gateway: - + // SINGLE_IP_INTERNALLY_REDUNDANT - 0 - TWO_IPS_REDUNDANCY - 0, 1 - + // FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 + optional uint32 id = 1 [json_name = "id"]; + + // IP address of the interface in the external VPN gateway. Only IPv4 is + // supported. This IP address can be either from your on-premise gateway or + // another Cloud provider's VPN gateway, it cannot be an IP address from + // Google Compute Engine. + optional string ip_address = 2 [json_name = "ipAddress"]; + + // IPv6 address of the interface in the external VPN gateway. This IPv6 + // address can be either from your on-premise gateway or another Cloud + // provider's VPN gateway, it cannot be an IP address from Google Compute + // Engine. Must specify an IPv6 address (not IPV4-mapped) using any format + // described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format is + // RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). + optional string ipv6_address = 3 [json_name = "ipv6Address"]; +} + +// Response to the list request, and contains a list of externalVpnGateways. +message ExternalVpnGatewayList { + optional string etag = 1 [json_name = "etag"]; + + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 2 [json_name = "id"]; + + // A list of ExternalVpnGateway resources. + repeated ExternalVpnGateway items = 3 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#externalVpnGatewayList for + // lists of externalVpnGateways. + optional string kind = 4 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 5 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_033.proto b/protos/google/cloud/compute/v1/internal/common_033.proto index 663e50bc8efca..6f3115807cc22 100644 --- a/protos/google/cloud/compute/v1/internal/common_033.proto +++ b/protos/google/cloud/compute/v1/internal/common_033.proto @@ -15,223 +15,35 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents an external VPN gateway. External VPN gateway is the on-premises -// VPN gateway(s) or another cloud provider's VPN gateway that connects to your -// Google Cloud VPN gateway. To create a highly available VPN from Google Cloud -// Platform to your VPN gateway or another cloud provider's VPN gateway, you -// must create a external VPN gateway resource with information about the other -// gateway. For more information about using external VPN gateways, see Creating -// an HA VPN gateway and tunnel pair to a peer VPN. -message ExternalVpnGateway { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; +message FileContentBuffer { + // The raw content in the secure keys file. + optional string content = 1 [json_name = "content"]; - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 3 [json_name = "id"]; - - // A list of interfaces for this external VPN gateway. If your peer-side - // gateway is an on-premises gateway and non-AWS cloud providers' gateway, at - // most two interfaces can be provided for an external VPN gateway. If your - // peer side is an AWS virtual private gateway, four interfaces should be - // provided for an external VPN gateway. - repeated ExternalVpnGatewayInterface interfaces = 4 - [json_name = "interfaces"]; - - // [Output Only] Type of the resource. Always compute#externalVpnGateway for - // externalVpnGateways. - optional string kind = 5 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this ExternalVpnGateway, - // which is essentially a hash of the labels set used for optimistic locking. - // The fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels, otherwise - // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve an ExternalVpnGateway. - optional string label_fingerprint = 6 [json_name = "labelFingerprint"]; - - // Labels for this resource. These can only be added or modified by the - // setLabels method. Each label key/value pair must comply with RFC1035. Label - // values may be empty. - map labels = 7 [json_name = "labels"]; - - // 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. - optional string name = 8 [json_name = "name"]; - - // Indicates the user-supplied redundancy type of this external VPN gateway. - // FOUR_IPS_REDUNDANCY: The external VPN gateway has four public IP addresses; - // at the time of writing this API, the AWS virtual private gateway is an - // example which has four public IP addresses for high availability - // connections; there should be two VPN connections in the AWS virtual private - // gateway , each AWS VPN connection has two public IP addresses; please make - // sure to put two public IP addresses from one AWS VPN connection into - // interfaces 0 and 1 of this external VPN gateway, and put the other two - // public IP addresses from another AWS VPN connection into interfaces 2 and 3 - // of this external VPN gateway. When displaying highly available - // configuration status for the VPN tunnels connected to FOUR_IPS_REDUNDANCY - // external VPN gateway, Google will always detect whether interfaces 0 and 1 - // are connected on one interface of HA Cloud VPN gateway, and detect whether - // interfaces 2 and 3 are connected to another interface of the HA Cloud VPN - // gateway. - // SINGLE_IP_INTERNALLY_REDUNDANT: The external VPN gateway has only one - // public IP address which internally provide redundancy or failover. - // TWO_IPS_REDUNDANCY: The external VPN gateway has two public IP addresses - // which are redundant with each other, the following two types of setup on - // your on-premises side would have this type of redundancy: (1) Two separate - // on-premises gateways, each with one public IP address, the two on-premises - // gateways are redundant with each other. (2) A single on-premise gateway - // with two public IP addresses that are redundant with eatch other. - optional string redundancy_type = 9 [json_name = "redundancyType"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 10 [json_name = "selfLink"]; -} - -// The interface for the external VPN gateway. -message ExternalVpnGatewayInterface { - // The numeric ID of this interface. The allowed input values for this id for - // different redundancy types of external VPN gateway: - - // SINGLE_IP_INTERNALLY_REDUNDANT - 0 - TWO_IPS_REDUNDANCY - 0, 1 - - // FOUR_IPS_REDUNDANCY - 0, 1, 2, 3 - optional uint32 id = 1 [json_name = "id"]; - - // IP address of the interface in the external VPN gateway. Only IPv4 is - // supported. This IP address can be either from your on-premise gateway or - // another Cloud provider's VPN gateway, it cannot be an IP address from - // Google Compute Engine. - optional string ip_address = 2 [json_name = "ipAddress"]; - - // IPv6 address of the interface in the external VPN gateway. This IPv6 - // address can be either from your on-premise gateway or another Cloud - // provider's VPN gateway, it cannot be an IP address from Google Compute - // Engine. Must specify an IPv6 address (not IPV4-mapped) using any format - // described in RFC 4291 (e.g. 2001:db8:0:0:2d9:51:0:0). The output format is - // RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). - optional string ipv6_address = 3 [json_name = "ipv6Address"]; + // The file type of source file. + // BIN: + // UNDEFINED: + // X509: + optional string file_type = 2 [json_name = "fileType"]; } -// Response to the list request, and contains a list of externalVpnGateways. -message ExternalVpnGatewayList { - optional string etag = 1 [json_name = "etag"]; - - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 2 [json_name = "id"]; - - // A list of ExternalVpnGateway resources. - repeated ExternalVpnGateway items = 3 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#externalVpnGatewayList for - // lists of externalVpnGateways. - optional string kind = 4 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 5 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 6 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } +// Initial State for shielded instance, these are public keys which are safe to +// store in public +message InitialStateConfig { + // The Key Database (db). + repeated FileContentBuffer dbs = 1 [json_name = "dbs"]; - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; + // The forbidden key database (dbx). + repeated FileContentBuffer dbxs = 2 [json_name = "dbxs"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // The Key Exchange Key (KEK). + repeated FileContentBuffer keks = 3 [json_name = "keks"]; - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + // The Platform Key (PK). + optional FileContentBuffer pk = 4 [json_name = "pk"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_034.proto b/protos/google/cloud/compute/v1/internal/common_034.proto index bc9d3c9168069..dc8ed3231e8cb 100644 --- a/protos/google/cloud/compute/v1/internal/common_034.proto +++ b/protos/google/cloud/compute/v1/internal/common_034.proto @@ -15,35 +15,184 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message FileContentBuffer { - // The raw content in the secure keys file. - optional string content = 1 [json_name = "content"]; +// Represents a Firewall Rule resource. Firewall rules allow or deny ingress +// traffic to, and egress traffic from your instances. For more information, +// read Firewall rules. +message Firewall { + message AllowedItem { + // The IP protocol to which this rule applies. The protocol type is required + // when creating a firewall rule. This value can either be one of the + // following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, + // sctp) or the IP protocol number. + optional string ip_protocol = 1 [json_name = "IPProtocol"]; - // The file type of source file. - // BIN: - // UNDEFINED: - // X509: - optional string file_type = 2 [json_name = "fileType"]; -} + // An optional list of ports to which this rule applies. This field is only + // applicable for the UDP or TCP protocol. Each entry must be either an + // integer or a range. If not specified, this rule applies to connections + // through any port. Example inputs include: ["22"], ["80","443"], and + // ["12345-12349"]. + repeated string ports = 2 [json_name = "ports"]; + } + + // The list of ALLOW rules specified by this firewall. Each rule specifies a + // protocol and port-range tuple that describes a permitted connection. + repeated AllowedItem allowed = 1 [json_name = "allowed"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + message DeniedItem { + // The IP protocol to which this rule applies. The protocol type is required + // when creating a firewall rule. This value can either be one of the + // following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, + // sctp) or the IP protocol number. + optional string ip_protocol = 1 [json_name = "IPProtocol"]; + + // An optional list of ports to which this rule applies. This field is only + // applicable for the UDP or TCP protocol. Each entry must be either an + // integer or a range. If not specified, this rule applies to connections + // through any port. Example inputs include: ["22"], ["80","443"], and + // ["12345-12349"]. + repeated string ports = 2 [json_name = "ports"]; + } + + // The list of DENY rules specified by this firewall. Each rule specifies a + // protocol and port-range tuple that describes a denied connection. + repeated DeniedItem denied = 3 [json_name = "denied"]; + + // An optional description of this resource. Provide this field when you + // create the resource. + optional string description = 4 [json_name = "description"]; + + // If destination ranges are specified, the firewall rule applies only to + // traffic that has destination IP address in these ranges. These ranges must + // be expressed in CIDR format. Both IPv4 and IPv6 are supported. + repeated string destination_ranges = 5 [json_name = "destinationRanges"]; + + // Direction of traffic to which this firewall applies, either `INGRESS` or + // `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot + // specify the sourceTags fields. + // EGRESS: Indicates that firewall should apply to outgoing traffic. + // INGRESS: Indicates that firewall should apply to incoming traffic. + optional string direction = 6 [json_name = "direction"]; + + // Denotes whether the firewall rule is disabled. When set to true, the + // firewall rule is not enforced and the network behaves as if it did not + // exist. If this is unspecified, the firewall rule will be enabled. + optional bool disabled = 7 [json_name = "disabled"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 8 [json_name = "id"]; -// Initial State for shielded instance, these are public keys which are safe to -// store in public -message InitialStateConfig { - // The Key Database (db). - repeated FileContentBuffer dbs = 1 [json_name = "dbs"]; + // [Output Only] Type of the resource. Always compute#firewall for firewall + // rules. + optional string kind = 9 [json_name = "kind"]; - // The forbidden key database (dbx). - repeated FileContentBuffer dbxs = 2 [json_name = "dbxs"]; + // This field denotes the logging options for a particular firewall rule. If + // logging is enabled, logs will be exported to Cloud Logging. + optional FirewallLogConfig log_config = 10 [json_name = "logConfig"]; + + // 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])?`. The first character must be a + // lowercase letter, and all following characters (except for the last + // character) must be a dash, lowercase letter, or digit. The last character + // must be a lowercase letter or digit. + optional string name = 11 [json_name = "name"]; + + // URL of the network resource for this firewall rule. If not specified when + // creating a firewall rule, the default network is used: + // global/networks/default If you choose to specify this field, you can + // specify the network as a full or partial URL. For example, the following + // are all valid URLs: - + // https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network + // - projects/myproject/global/networks/my-network - global/networks/default + optional string network = 12 [json_name = "network"]; + + // Priority for this rule. This is an integer between `0` and `65535`, both + // inclusive. The default value is `1000`. Relative priorities determine which + // rule takes effect if multiple rules apply. Lower values indicate higher + // priority. For example, a rule with priority `0` has higher precedence than + // a rule with priority `1`. DENY rules take precedence over ALLOW rules if + // they have equal priority. Note that VPC networks have implied rules with a + // priority of `65535`. To avoid conflicts with the implied rules, use a + // priority number less than `65535`. + optional int32 priority = 13 [json_name = "priority"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 14 [json_name = "selfLink"]; + + // If source ranges are specified, the firewall rule applies only to traffic + // that has a source IP address in these ranges. These ranges must be + // expressed in CIDR format. One or both of sourceRanges and sourceTags may be + // set. If both fields are set, the rule applies to traffic that has a source + // IP address within sourceRanges OR a source IP from a resource with a + // matching tag listed in the sourceTags field. The connection does not need + // to match both fields for the rule to apply. Both IPv4 and IPv6 are + // supported. + repeated string source_ranges = 15 [json_name = "sourceRanges"]; + + // If source service accounts are specified, the firewall rules apply only to + // traffic originating from an instance with a service account in this list. + // Source service accounts cannot be used to control traffic to an instance's + // external IP address because service accounts are associated with an + // instance, not an IP address. sourceRanges can be set at the same time as + // sourceServiceAccounts. If both are set, the firewall applies to traffic + // that has a source IP address within the sourceRanges OR a source IP that + // belongs to an instance with service account listed in sourceServiceAccount. + // The connection does not need to match both fields for the firewall to + // apply. sourceServiceAccounts cannot be used at the same time as sourceTags + // or targetTags. + repeated string source_service_accounts = 16 + [json_name = "sourceServiceAccounts"]; + + // If source tags are specified, the firewall rule applies only to traffic + // with source IPs that match the primary network interfaces of VM instances + // that have the tag and are in the same VPC network. Source tags cannot be + // used to control traffic to an instance's external IP address, it only + // applies to traffic between instances in the same virtual network. Because + // tags are associated with instances, not IP addresses. One or both of + // sourceRanges and sourceTags may be set. If both fields are set, the + // firewall applies to traffic that has a source IP address within + // sourceRanges OR a source IP from a resource with a matching tag listed in + // the sourceTags field. The connection does not need to match both fields for + // the firewall to apply. + repeated string source_tags = 17 [json_name = "sourceTags"]; + + // A list of service accounts indicating sets of instances located in the + // network that may make network connections as specified in allowed[]. + // targetServiceAccounts cannot be used at the same time as targetTags or + // sourceTags. If neither targetServiceAccounts nor targetTags are specified, + // the firewall rule applies to all instances on the specified network. + repeated string target_service_accounts = 18 + [json_name = "targetServiceAccounts"]; + + // A list of tags that controls which instances the firewall rule applies to. + // If targetTags are specified, then the firewall rule applies only to + // instances in the VPC network that have one of those tags. If no targetTags + // are specified, the firewall rule applies to all instances on the specified + // network. + repeated string target_tags = 19 [json_name = "targetTags"]; +} - // The Key Exchange Key (KEK). - repeated FileContentBuffer keks = 3 [json_name = "keks"]; +// The available logging options for a firewall rule. +message FirewallLogConfig { + // This field denotes whether to enable logging for a particular firewall + // rule. + optional bool enable = 1 [json_name = "enable"]; - // The Platform Key (PK). - optional FileContentBuffer pk = 4 [json_name = "pk"]; + // This field can only be specified for a particular firewall rule if logging + // is enabled for that rule. This field denotes whether to include or exclude + // metadata for firewall logs. + // EXCLUDE_ALL_METADATA: + // INCLUDE_ALL_METADATA: + optional string metadata = 2 [json_name = "metadata"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_035.proto b/protos/google/cloud/compute/v1/internal/common_035.proto index 56be129f211db..bac6057f319c9 100644 --- a/protos/google/cloud/compute/v1/internal/common_035.proto +++ b/protos/google/cloud/compute/v1/internal/common_035.proto @@ -15,184 +15,117 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Firewall Rule resource. Firewall rules allow or deny ingress -// traffic to, and egress traffic from your instances. For more information, -// read Firewall rules. -message Firewall { - message AllowedItem { - // The IP protocol to which this rule applies. The protocol type is required - // when creating a firewall rule. This value can either be one of the - // following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, - // sctp) or the IP protocol number. - optional string ip_protocol = 1 [json_name = "IPProtocol"]; - - // An optional list of ports to which this rule applies. This field is only - // applicable for the UDP or TCP protocol. Each entry must be either an - // integer or a range. If not specified, this rule applies to connections - // through any port. Example inputs include: ["22"], ["80","443"], and - // ["12345-12349"]. - repeated string ports = 2 [json_name = "ports"]; +import "google/cloud/compute/v1/internal/common_034.proto"; + +// Contains a list of firewalls. +message FirewallList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of Firewall resources. + repeated Firewall items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#firewallList for lists of + // firewalls. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; } - // The list of ALLOW rules specified by this firewall. Each rule specifies a - // protocol and port-range tuple that describes a permitted connection. - repeated AllowedItem allowed = 1 [json_name = "allowed"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - message DeniedItem { - // The IP protocol to which this rule applies. The protocol type is required - // when creating a firewall rule. This value can either be one of the - // following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, - // sctp) or the IP protocol number. - optional string ip_protocol = 1 [json_name = "IPProtocol"]; - - // An optional list of ports to which this rule applies. This field is only - // applicable for the UDP or TCP protocol. Each entry must be either an - // integer or a range. If not specified, this rule applies to connections - // through any port. Example inputs include: ["22"], ["80","443"], and - // ["12345-12349"]. - repeated string ports = 2 [json_name = "ports"]; - } - - // The list of DENY rules specified by this firewall. Each rule specifies a - // protocol and port-range tuple that describes a denied connection. - repeated DeniedItem denied = 3 [json_name = "denied"]; - - // An optional description of this resource. Provide this field when you - // create the resource. - optional string description = 4 [json_name = "description"]; - - // If destination ranges are specified, the firewall rule applies only to - // traffic that has destination IP address in these ranges. These ranges must - // be expressed in CIDR format. Both IPv4 and IPv6 are supported. - repeated string destination_ranges = 5 [json_name = "destinationRanges"]; - - // Direction of traffic to which this firewall applies, either `INGRESS` or - // `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot - // specify the sourceTags fields. - // EGRESS: Indicates that firewall should apply to outgoing traffic. - // INGRESS: Indicates that firewall should apply to incoming traffic. - optional string direction = 6 [json_name = "direction"]; - - // Denotes whether the firewall rule is disabled. When set to true, the - // firewall rule is not enforced and the network behaves as if it did not - // exist. If this is unspecified, the firewall rule will be enabled. - optional bool disabled = 7 [json_name = "disabled"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 8 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#firewall for firewall - // rules. - optional string kind = 9 [json_name = "kind"]; - - // This field denotes the logging options for a particular firewall rule. If - // logging is enabled, logs will be exported to Cloud Logging. - optional FirewallLogConfig log_config = 10 [json_name = "logConfig"]; - - // 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])?`. The first character must be a - // lowercase letter, and all following characters (except for the last - // character) must be a dash, lowercase letter, or digit. The last character - // must be a lowercase letter or digit. - optional string name = 11 [json_name = "name"]; - - // URL of the network resource for this firewall rule. If not specified when - // creating a firewall rule, the default network is used: - // global/networks/default If you choose to specify this field, you can - // specify the network as a full or partial URL. For example, the following - // are all valid URLs: - - // https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network - // - projects/myproject/global/networks/my-network - global/networks/default - optional string network = 12 [json_name = "network"]; - - // Priority for this rule. This is an integer between `0` and `65535`, both - // inclusive. The default value is `1000`. Relative priorities determine which - // rule takes effect if multiple rules apply. Lower values indicate higher - // priority. For example, a rule with priority `0` has higher precedence than - // a rule with priority `1`. DENY rules take precedence over ALLOW rules if - // they have equal priority. Note that VPC networks have implied rules with a - // priority of `65535`. To avoid conflicts with the implied rules, use a - // priority number less than `65535`. - optional int32 priority = 13 [json_name = "priority"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 14 [json_name = "selfLink"]; - - // If source ranges are specified, the firewall rule applies only to traffic - // that has a source IP address in these ranges. These ranges must be - // expressed in CIDR format. One or both of sourceRanges and sourceTags may be - // set. If both fields are set, the rule applies to traffic that has a source - // IP address within sourceRanges OR a source IP from a resource with a - // matching tag listed in the sourceTags field. The connection does not need - // to match both fields for the rule to apply. Both IPv4 and IPv6 are - // supported. - repeated string source_ranges = 15 [json_name = "sourceRanges"]; - - // If source service accounts are specified, the firewall rules apply only to - // traffic originating from an instance with a service account in this list. - // Source service accounts cannot be used to control traffic to an instance's - // external IP address because service accounts are associated with an - // instance, not an IP address. sourceRanges can be set at the same time as - // sourceServiceAccounts. If both are set, the firewall applies to traffic - // that has a source IP address within the sourceRanges OR a source IP that - // belongs to an instance with service account listed in sourceServiceAccount. - // The connection does not need to match both fields for the firewall to - // apply. sourceServiceAccounts cannot be used at the same time as sourceTags - // or targetTags. - repeated string source_service_accounts = 16 - [json_name = "sourceServiceAccounts"]; - - // If source tags are specified, the firewall rule applies only to traffic - // with source IPs that match the primary network interfaces of VM instances - // that have the tag and are in the same VPC network. Source tags cannot be - // used to control traffic to an instance's external IP address, it only - // applies to traffic between instances in the same virtual network. Because - // tags are associated with instances, not IP addresses. One or both of - // sourceRanges and sourceTags may be set. If both fields are set, the - // firewall applies to traffic that has a source IP address within - // sourceRanges OR a source IP from a resource with a matching tag listed in - // the sourceTags field. The connection does not need to match both fields for - // the firewall to apply. - repeated string source_tags = 17 [json_name = "sourceTags"]; - - // A list of service accounts indicating sets of instances located in the - // network that may make network connections as specified in allowed[]. - // targetServiceAccounts cannot be used at the same time as targetTags or - // sourceTags. If neither targetServiceAccounts nor targetTags are specified, - // the firewall rule applies to all instances on the specified network. - repeated string target_service_accounts = 18 - [json_name = "targetServiceAccounts"]; - - // A list of tags that controls which instances the firewall rule applies to. - // If targetTags are specified, then the firewall rule applies only to - // instances in the VPC network that have one of those tags. If no targetTags - // are specified, the firewall rule applies to all instances on the specified - // network. - repeated string target_tags = 19 [json_name = "targetTags"]; -} - -// The available logging options for a firewall rule. -message FirewallLogConfig { - // This field denotes whether to enable logging for a particular firewall - // rule. - optional bool enable = 1 [json_name = "enable"]; - - // This field can only be specified for a particular firewall rule if logging - // is enabled for that rule. This field denotes whether to include or exclude - // metadata for firewall logs. - // EXCLUDE_ALL_METADATA: - // INCLUDE_ALL_METADATA: - optional string metadata = 2 [json_name = "metadata"]; + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_036.proto b/protos/google/cloud/compute/v1/internal/common_036.proto index 8be07714f6478..a2e018ca9ef94 100644 --- a/protos/google/cloud/compute/v1/internal/common_036.proto +++ b/protos/google/cloud/compute/v1/internal/common_036.proto @@ -15,117 +15,37 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_035.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; +import "google/cloud/compute/v1/internal/common_037.proto"; -// Contains a list of firewalls. -message FirewallList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; +message FirewallPoliciesListAssociationsResponse { + // A list of associations. + repeated FirewallPolicyAssociation associations = 1 + [json_name = "associations"]; - // A list of Firewall resources. - repeated Firewall items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#firewallList for lists of - // firewalls. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // [Output Only] Type of firewallPolicy associations. Always + // compute#FirewallPoliciesListAssociations for lists of firewallPolicy + // associations. + optional string kind = 2 [json_name = "kind"]; +} - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; +message GlobalOrganizationSetPolicyRequest { + // Flatten Policy to create a backward compatible wire-format. Deprecated. Use + // 'policy' to specify bindings. + repeated Binding bindings = 1 [json_name = "bindings"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // Flatten Policy to create a backward compatible wire-format. Deprecated. Use + // 'policy' to specify the etag. + optional string etag = 2 [json_name = "etag"]; - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + // REQUIRED: The complete policy to be applied to the 'resource'. The size of + // the policy is limited to a few 10s of KB. An empty policy is in general a + // valid policy but certain services (like Projects) might reject them. + optional Policy policy = 3 [json_name = "policy"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_037.proto b/protos/google/cloud/compute/v1/internal/common_037.proto index 1c16300845f0a..1cb902a5ec990 100644 --- a/protos/google/cloud/compute/v1/internal/common_037.proto +++ b/protos/google/cloud/compute/v1/internal/common_037.proto @@ -15,37 +15,216 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_008.proto"; import "google/cloud/compute/v1/internal/common_038.proto"; -message FirewallPoliciesListAssociationsResponse { - // A list of associations. +// Represents a Firewall Policy resource. +message FirewallPolicy { + // A list of associations that belong to this firewall policy. repeated FirewallPolicyAssociation associations = 1 [json_name = "associations"]; - // [Output Only] Type of firewallPolicy associations. Always - // compute#FirewallPoliciesListAssociations for lists of firewallPolicy - // associations. - optional string kind = 2 [json_name = "kind"]; + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + // Deprecated, please use short name instead. User-provided name of the + // Organization firewall policy. The name should be unique in the organization + // in which the firewall policy is created. This field is not applicable to + // network firewall policies. This name must be set on creation and cannot be + // changed. 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. + optional string display_name = 4 [json_name = "displayName"]; + + // Specifies a fingerprint for this resource, which is essentially a hash of + // the metadata's contents and used for optimistic locking. The fingerprint is + // initially generated by Compute Engine and changes after every request to + // modify or update metadata. You must always provide an up-to-date + // fingerprint hash in order to update or change metadata, otherwise the + // request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make get() request to the firewall policy. + optional string fingerprint = 5 [json_name = "fingerprint"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // [Output only] Type of the resource. Always compute#firewallPolicyfor + // firewall policies + optional string kind = 7 [json_name = "kind"]; + + // Name of the resource. For Organization Firewall Policies it's a [Output + // Only] numeric ID allocated by Google Cloud which uniquely identifies the + // Organization Firewall Policy. + optional string name = 8 [json_name = "name"]; + + // [Output Only] The parent of the firewall policy. This field is not + // applicable to network firewall policies. + optional string parent = 9 [json_name = "parent"]; + + // [Output Only] URL of the region where the regional firewall policy resides. + // This field is not applicable to global firewall policies. You must specify + // this field as part of the HTTP request URL. It is not settable as a field + // in the request body. + optional string region = 10 [json_name = "region"]; + + // [Output Only] Total count of all firewall policy rule tuples. A firewall + // policy can not exceed a set number of tuples. + optional int32 rule_tuple_count = 11 [json_name = "ruleTupleCount"]; + + // A list of rules that belong to this policy. There must always be a default + // rule (rule with priority 2147483647 and match "*"). If no rules are + // provided when creating a firewall policy, a default rule with action + // "allow" will be added. + repeated FirewallPolicyRule rules = 12 [json_name = "rules"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 13 [json_name = "selfLink"]; + + // [Output Only] Server-defined URL for this resource with the resource id. + optional string self_link_with_id = 14 [json_name = "selfLinkWithId"]; + + // User-provided name of the Organization firewall policy. The name should be + // unique in the organization in which the firewall policy is created. This + // field is not applicable to network firewall policies. This name must be set + // on creation and cannot be changed. 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. + optional string short_name = 15 [json_name = "shortName"]; } -message GlobalOrganizationSetPolicyRequest { - // Flatten Policy to create a backward compatible wire-format. Deprecated. Use - // 'policy' to specify bindings. - repeated Binding bindings = 1 [json_name = "bindings"]; +message FirewallPolicyAssociation { + // The target that the firewall policy is attached to. + optional string attachment_target = 1 [json_name = "attachmentTarget"]; + + // [Output Only] Deprecated, please use short name instead. The display name + // of the firewall policy of the association. + optional string display_name = 2 [json_name = "displayName"]; + + // [Output Only] The firewall policy ID of the association. + optional string firewall_policy_id = 3 [json_name = "firewallPolicyId"]; + + // The name for an association. + optional string name = 4 [json_name = "name"]; + + // [Output Only] The short name of the firewall policy of the association. + optional string short_name = 5 [json_name = "shortName"]; +} + +message FirewallPolicyList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of FirewallPolicy resources. + repeated FirewallPolicy items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#firewallPolicyList for + // listsof FirewallPolicies + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; - // Flatten Policy to create a backward compatible wire-format. Deprecated. Use - // 'policy' to specify the etag. - optional string etag = 2 [json_name = "etag"]; + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // REQUIRED: The complete policy to be applied to the 'resource'. The size of - // the policy is limited to a few 10s of KB. An empty policy is in general a - // valid policy but certain services (like Projects) might reject them. - optional Policy policy = 3 [json_name = "policy"]; + // [Output Only] Informational warning message. + optional Warning warning = 5 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_038.proto b/protos/google/cloud/compute/v1/internal/common_038.proto index 7add96709eb81..77ee6c48f5426 100644 --- a/protos/google/cloud/compute/v1/internal/common_038.proto +++ b/protos/google/cloud/compute/v1/internal/common_038.proto @@ -15,216 +15,179 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_039.proto"; - -// Represents a Firewall Policy resource. -message FirewallPolicy { - // A list of associations that belong to this firewall policy. - repeated FirewallPolicyAssociation associations = 1 - [json_name = "associations"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; - - // Deprecated, please use short name instead. User-provided name of the - // Organization firewall policy. The name should be unique in the organization - // in which the firewall policy is created. This field is not applicable to - // network firewall policies. This name must be set on creation and cannot be - // changed. 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. - optional string display_name = 4 [json_name = "displayName"]; - - // Specifies a fingerprint for this resource, which is essentially a hash of - // the metadata's contents and used for optimistic locking. The fingerprint is - // initially generated by Compute Engine and changes after every request to - // modify or update metadata. You must always provide an up-to-date - // fingerprint hash in order to update or change metadata, otherwise the - // request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make get() request to the firewall policy. - optional string fingerprint = 5 [json_name = "fingerprint"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 6 [json_name = "id"]; - - // [Output only] Type of the resource. Always compute#firewallPolicyfor - // firewall policies - optional string kind = 7 [json_name = "kind"]; - - // Name of the resource. For Organization Firewall Policies it's a [Output - // Only] numeric ID allocated by Google Cloud which uniquely identifies the - // Organization Firewall Policy. - optional string name = 8 [json_name = "name"]; - - // [Output Only] The parent of the firewall policy. This field is not - // applicable to network firewall policies. - optional string parent = 9 [json_name = "parent"]; - - // [Output Only] URL of the region where the regional firewall policy resides. - // This field is not applicable to global firewall policies. You must specify - // this field as part of the HTTP request URL. It is not settable as a field - // in the request body. - optional string region = 10 [json_name = "region"]; - - // [Output Only] Total count of all firewall policy rule tuples. A firewall - // policy can not exceed a set number of tuples. - optional int32 rule_tuple_count = 11 [json_name = "ruleTupleCount"]; - - // A list of rules that belong to this policy. There must always be a default - // rule (rule with priority 2147483647 and match "*"). If no rules are - // provided when creating a firewall policy, a default rule with action - // "allow" will be added. - repeated FirewallPolicyRule rules = 12 [json_name = "rules"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 13 [json_name = "selfLink"]; - - // [Output Only] Server-defined URL for this resource with the resource id. - optional string self_link_with_id = 14 [json_name = "selfLinkWithId"]; - - // User-provided name of the Organization firewall policy. The name should be - // unique in the organization in which the firewall policy is created. This - // field is not applicable to network firewall policies. This name must be set - // on creation and cannot be changed. 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. - optional string short_name = 15 [json_name = "shortName"]; +// Represents a rule that describes one or more match conditions along with the +// action to be taken when traffic matches this condition (allow or deny). +message FirewallPolicyRule { + // The Action to perform when the client connection triggers the rule. Valid + // actions for firewall rules are: "allow", "deny", + // "apply_security_profile_group" and "goto_next". Valid actions for packet + // mirroring rules are: "mirror", "do_not_mirror" and "goto_next". + optional string action = 1 [json_name = "action"]; + + // An optional description for this resource. + optional string description = 2 [json_name = "description"]; + + // The direction in which this rule applies. + // EGRESS: + // INGRESS: + optional string direction = 3 [json_name = "direction"]; + + // Denotes whether the firewall policy rule is disabled. When set to true, the + // firewall policy rule is not enforced and traffic behaves as if it did not + // exist. If this is unspecified, the firewall policy rule will be enabled. + optional bool disabled = 4 [json_name = "disabled"]; + + // Denotes whether to enable logging for a particular rule. If logging is + // enabled, logs will be exported to the configured export destination in + // Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you cannot + // enable logging on "goto_next" rules. + optional bool enable_logging = 5 [json_name = "enableLogging"]; + + // [Output only] Type of the resource. Returns compute#firewallPolicyRule for + // firewall rules and compute#packetMirroringRule for packet mirroring rules. + optional string kind = 6 [json_name = "kind"]; + + // A match condition that incoming traffic is evaluated against. If it + // evaluates to true, the corresponding 'action' is enforced. + optional FirewallPolicyRuleMatcher match = 7 [json_name = "match"]; + + // An integer indicating the priority of a rule in the list. The priority must + // be a positive value between 0 and 2147483647. Rules are evaluated from + // highest to lowest priority where 0 is the highest priority and 2147483647 + // is the lowest priority. + optional int32 priority = 8 [json_name = "priority"]; + + // An optional name for the rule. This field is not a unique identifier and + // can be updated. + optional string rule_name = 9 [json_name = "ruleName"]; + + // [Output Only] Calculation of the complexity of a single firewall policy + // rule. + optional int32 rule_tuple_count = 10 [json_name = "ruleTupleCount"]; + + // A fully-qualified URL of a SecurityProfile resource instance. Example: + // https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group + // Must be specified if action is one of 'apply_security_profile_group' or + // 'mirror'. Cannot be specified for other actions. + optional string security_profile_group = 14 + [json_name = "securityProfileGroup"]; + + // A list of network resource URLs to which this rule applies. This field + // allows you to control which network's VMs get this rule. If this field is + // left blank, all VMs within the organization will receive the rule. + repeated string target_resources = 11 [json_name = "targetResources"]; + + // A list of secure tags that controls which instances the firewall rule + // applies to. If targetSecureTag are specified, then the firewall rule + // applies only to instances in the VPC network that have one of those + // EFFECTIVE secure tags, if all the target_secure_tag are in INEFFECTIVE + // state, then this rule will be ignored. targetSecureTag may not be set at + // the same time as targetServiceAccounts. If neither targetServiceAccounts + // nor targetSecureTag are specified, the firewall rule applies to all + // instances on the specified network. Maximum number of target label tags + // allowed is 256. + repeated FirewallPolicyRuleSecureTag target_secure_tags = 12 + [json_name = "targetSecureTags"]; + + // A list of service accounts indicating the sets of instances that are + // applied with this rule. + repeated string target_service_accounts = 13 + [json_name = "targetServiceAccounts"]; + + // Boolean flag indicating if the traffic should be TLS decrypted. Can be set + // only if action = 'apply_security_profile_group' and cannot be set for other + // actions. + optional bool tls_inspect = 15 [json_name = "tlsInspect"]; } -message FirewallPolicyAssociation { - // The target that the firewall policy is attached to. - optional string attachment_target = 1 [json_name = "attachmentTarget"]; - - // [Output Only] Deprecated, please use short name instead. The display name - // of the firewall policy of the association. - optional string display_name = 2 [json_name = "displayName"]; - - // [Output Only] The firewall policy ID of the association. - optional string firewall_policy_id = 3 [json_name = "firewallPolicyId"]; - - // The name for an association. - optional string name = 4 [json_name = "name"]; +// Represents a match condition that incoming traffic is evaluated against. +// Exactly one field must be specified. +message FirewallPolicyRuleMatcher { + // Address groups which should be matched against the traffic destination. + // Maximum number of destination address groups is 10. + repeated string dest_address_groups = 5 [json_name = "destAddressGroups"]; + + // Fully Qualified Domain Name (FQDN) which should be matched against traffic + // destination. Maximum number of destination fqdn allowed is 100. + repeated string dest_fqdns = 6 [json_name = "destFqdns"]; + + // CIDR IP address range. Maximum number of destination CIDR IP ranges allowed + // is 5000. + repeated string dest_ip_ranges = 1 [json_name = "destIpRanges"]; + + // Region codes whose IP addresses will be used to match for destination of + // traffic. Should be specified as 2 letter country code defined as per ISO + // 3166 alpha-2 country codes. ex."US" Maximum number of dest region codes + // allowed is 5000. + repeated string dest_region_codes = 7 [json_name = "destRegionCodes"]; + + // Names of Network Threat Intelligence lists. The IPs in these lists will be + // matched against traffic destination. + repeated string dest_threat_intelligences = 8 + [json_name = "destThreatIntelligences"]; + + // Pairs of IP protocols and ports that the rule should match. + repeated FirewallPolicyRuleMatcherLayer4Config layer4_configs = 2 + [json_name = "layer4Configs"]; + + // Address groups which should be matched against the traffic source. Maximum + // number of source address groups is 10. + repeated string src_address_groups = 9 [json_name = "srcAddressGroups"]; + + // Fully Qualified Domain Name (FQDN) which should be matched against traffic + // source. Maximum number of source fqdn allowed is 100. + repeated string src_fqdns = 10 [json_name = "srcFqdns"]; + + // CIDR IP address range. Maximum number of source CIDR IP ranges allowed is + // 5000. + repeated string src_ip_ranges = 3 [json_name = "srcIpRanges"]; + + // Region codes whose IP addresses will be used to match for source of + // traffic. Should be specified as 2 letter country code defined as per ISO + // 3166 alpha-2 country codes. ex."US" Maximum number of source region codes + // allowed is 5000. + repeated string src_region_codes = 11 [json_name = "srcRegionCodes"]; + + // List of secure tag values, which should be matched at the source of the + // traffic. For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, and + // there is no srcIpRange, this rule will be ignored. Maximum number of source + // tag values allowed is 256. + repeated FirewallPolicyRuleSecureTag src_secure_tags = 4 + [json_name = "srcSecureTags"]; + + // Names of Network Threat Intelligence lists. The IPs in these lists will be + // matched against traffic source. + repeated string src_threat_intelligences = 12 + [json_name = "srcThreatIntelligences"]; +} - // [Output Only] The short name of the firewall policy of the association. - optional string short_name = 5 [json_name = "shortName"]; +message FirewallPolicyRuleMatcherLayer4Config { + // The IP protocol to which this rule applies. The protocol type is required + // when creating a firewall rule. This value can either be one of the + // following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, + // sctp), or the IP protocol number. + optional string ip_protocol = 1 [json_name = "ipProtocol"]; + + // An optional list of ports to which this rule applies. This field is only + // applicable for UDP or TCP protocol. Each entry must be either an integer or + // a range. If not specified, this rule applies to connections through any + // port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. + repeated string ports = 2 [json_name = "ports"]; } -message FirewallPolicyList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of FirewallPolicy resources. - repeated FirewallPolicy items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#firewallPolicyList for - // listsof FirewallPolicies - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 5 [json_name = "warning"]; +message FirewallPolicyRuleSecureTag { + // Name of the secure tag, created with TagManager's TagValue API. + optional string name = 1 [json_name = "name"]; + + // [Output Only] State of the secure tag, either `EFFECTIVE` or `INEFFECTIVE`. + // A secure tag is `INEFFECTIVE` when it is deleted or its network is deleted. + // EFFECTIVE: + // INEFFECTIVE: + optional string state = 2 [json_name = "state"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_039.proto b/protos/google/cloud/compute/v1/internal/common_039.proto index 302dabb0528df..064f075886724 100644 --- a/protos/google/cloud/compute/v1/internal/common_039.proto +++ b/protos/google/cloud/compute/v1/internal/common_039.proto @@ -15,179 +15,26 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a rule that describes one or more match conditions along with the -// action to be taken when traffic matches this condition (allow or deny). -message FirewallPolicyRule { - // The Action to perform when the client connection triggers the rule. Valid - // actions for firewall rules are: "allow", "deny", - // "apply_security_profile_group" and "goto_next". Valid actions for packet - // mirroring rules are: "mirror", "do_not_mirror" and "goto_next". - optional string action = 1 [json_name = "action"]; - - // An optional description for this resource. - optional string description = 2 [json_name = "description"]; - - // The direction in which this rule applies. - // EGRESS: - // INGRESS: - optional string direction = 3 [json_name = "direction"]; - - // Denotes whether the firewall policy rule is disabled. When set to true, the - // firewall policy rule is not enforced and traffic behaves as if it did not - // exist. If this is unspecified, the firewall policy rule will be enabled. - optional bool disabled = 4 [json_name = "disabled"]; - - // Denotes whether to enable logging for a particular rule. If logging is - // enabled, logs will be exported to the configured export destination in - // Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you cannot - // enable logging on "goto_next" rules. - optional bool enable_logging = 5 [json_name = "enableLogging"]; - - // [Output only] Type of the resource. Returns compute#firewallPolicyRule for - // firewall rules and compute#packetMirroringRule for packet mirroring rules. - optional string kind = 6 [json_name = "kind"]; - - // A match condition that incoming traffic is evaluated against. If it - // evaluates to true, the corresponding 'action' is enforced. - optional FirewallPolicyRuleMatcher match = 7 [json_name = "match"]; - - // An integer indicating the priority of a rule in the list. The priority must - // be a positive value between 0 and 2147483647. Rules are evaluated from - // highest to lowest priority where 0 is the highest priority and 2147483647 - // is the lowest priority. - optional int32 priority = 8 [json_name = "priority"]; - - // An optional name for the rule. This field is not a unique identifier and - // can be updated. - optional string rule_name = 9 [json_name = "ruleName"]; - - // [Output Only] Calculation of the complexity of a single firewall policy - // rule. - optional int32 rule_tuple_count = 10 [json_name = "ruleTupleCount"]; - - // A fully-qualified URL of a SecurityProfile resource instance. Example: - // https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group - // Must be specified if action is one of 'apply_security_profile_group' or - // 'mirror'. Cannot be specified for other actions. - optional string security_profile_group = 14 - [json_name = "securityProfileGroup"]; - - // A list of network resource URLs to which this rule applies. This field - // allows you to control which network's VMs get this rule. If this field is - // left blank, all VMs within the organization will receive the rule. - repeated string target_resources = 11 [json_name = "targetResources"]; - - // A list of secure tags that controls which instances the firewall rule - // applies to. If targetSecureTag are specified, then the firewall rule - // applies only to instances in the VPC network that have one of those - // EFFECTIVE secure tags, if all the target_secure_tag are in INEFFECTIVE - // state, then this rule will be ignored. targetSecureTag may not be set at - // the same time as targetServiceAccounts. If neither targetServiceAccounts - // nor targetSecureTag are specified, the firewall rule applies to all - // instances on the specified network. Maximum number of target label tags - // allowed is 256. - repeated FirewallPolicyRuleSecureTag target_secure_tags = 12 - [json_name = "targetSecureTags"]; - - // A list of service accounts indicating the sets of instances that are - // applied with this rule. - repeated string target_service_accounts = 13 - [json_name = "targetServiceAccounts"]; - - // Boolean flag indicating if the traffic should be TLS decrypted. Can be set - // only if action = 'apply_security_profile_group' and cannot be set for other - // actions. - optional bool tls_inspect = 15 [json_name = "tlsInspect"]; -} - -// Represents a match condition that incoming traffic is evaluated against. -// Exactly one field must be specified. -message FirewallPolicyRuleMatcher { - // Address groups which should be matched against the traffic destination. - // Maximum number of destination address groups is 10. - repeated string dest_address_groups = 5 [json_name = "destAddressGroups"]; - - // Fully Qualified Domain Name (FQDN) which should be matched against traffic - // destination. Maximum number of destination fqdn allowed is 100. - repeated string dest_fqdns = 6 [json_name = "destFqdns"]; - - // CIDR IP address range. Maximum number of destination CIDR IP ranges allowed - // is 5000. - repeated string dest_ip_ranges = 1 [json_name = "destIpRanges"]; - - // Region codes whose IP addresses will be used to match for destination of - // traffic. Should be specified as 2 letter country code defined as per ISO - // 3166 alpha-2 country codes. ex."US" Maximum number of dest region codes - // allowed is 5000. - repeated string dest_region_codes = 7 [json_name = "destRegionCodes"]; - - // Names of Network Threat Intelligence lists. The IPs in these lists will be - // matched against traffic destination. - repeated string dest_threat_intelligences = 8 - [json_name = "destThreatIntelligences"]; - - // Pairs of IP protocols and ports that the rule should match. - repeated FirewallPolicyRuleMatcherLayer4Config layer4_configs = 2 - [json_name = "layer4Configs"]; - - // Address groups which should be matched against the traffic source. Maximum - // number of source address groups is 10. - repeated string src_address_groups = 9 [json_name = "srcAddressGroups"]; - - // Fully Qualified Domain Name (FQDN) which should be matched against traffic - // source. Maximum number of source fqdn allowed is 100. - repeated string src_fqdns = 10 [json_name = "srcFqdns"]; - - // CIDR IP address range. Maximum number of source CIDR IP ranges allowed is - // 5000. - repeated string src_ip_ranges = 3 [json_name = "srcIpRanges"]; - - // Region codes whose IP addresses will be used to match for source of - // traffic. Should be specified as 2 letter country code defined as per ISO - // 3166 alpha-2 country codes. ex."US" Maximum number of source region codes - // allowed is 5000. - repeated string src_region_codes = 11 [json_name = "srcRegionCodes"]; - - // List of secure tag values, which should be matched at the source of the - // traffic. For INGRESS rule, if all the srcSecureTag are INEFFECTIVE, and - // there is no srcIpRange, this rule will be ignored. Maximum number of source - // tag values allowed is 256. - repeated FirewallPolicyRuleSecureTag src_secure_tags = 4 - [json_name = "srcSecureTags"]; - - // Names of Network Threat Intelligence lists. The IPs in these lists will be - // matched against traffic source. - repeated string src_threat_intelligences = 12 - [json_name = "srcThreatIntelligences"]; -} - -message FirewallPolicyRuleMatcherLayer4Config { - // The IP protocol to which this rule applies. The protocol type is required - // when creating a firewall rule. This value can either be one of the - // following well known protocol strings (tcp, udp, icmp, esp, ah, ipip, - // sctp), or the IP protocol number. - optional string ip_protocol = 1 [json_name = "ipProtocol"]; - - // An optional list of ports to which this rule applies. This field is only - // applicable for UDP or TCP protocol. Each entry must be either an integer or - // a range. If not specified, this rule applies to connections through any - // port. Example inputs include: ["22"], ["80","443"], and ["12345-12349"]. - repeated string ports = 2 [json_name = "ports"]; -} - -message FirewallPolicyRuleSecureTag { - // Name of the secure tag, created with TagManager's TagValue API. - optional string name = 1 [json_name = "name"]; - - // [Output Only] State of the secure tag, either `EFFECTIVE` or `INEFFECTIVE`. - // A secure tag is `INEFFECTIVE` when it is deleted or its network is deleted. - // EFFECTIVE: - // INEFFECTIVE: - optional string state = 2 [json_name = "state"]; +// Encapsulates numeric value that can be either absolute or relative. +message FixedOrPercent { + // [Output Only] Absolute value of VM instances calculated based on the + // specific mode. - If the value is fixed, then the calculated value is equal + // to the fixed value. - If the value is a percent, then the calculated value + // is percent/100 * targetSize. For example, the calculated value of a 80% of + // a managed instance group with 150 instances would be (80/100 * 150) = 120 + // VM instances. If there is a remainder, the number is rounded. + optional int32 calculated = 1 [json_name = "calculated"]; + + // Specifies a fixed number of VM instances. This must be a positive integer. + optional int32 fixed = 2 [json_name = "fixed"]; + + // Specifies a percentage of instances between 0 to 100%, inclusive. For + // example, specify 80 for 80%. + optional int32 percent = 3 [json_name = "percent"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_040.proto b/protos/google/cloud/compute/v1/internal/common_040.proto index 9eb1a3f1a3832..e8af39822e8bc 100644 --- a/protos/google/cloud/compute/v1/internal/common_040.proto +++ b/protos/google/cloud/compute/v1/internal/common_040.proto @@ -15,26 +15,460 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Encapsulates numeric value that can be either absolute or relative. -message FixedOrPercent { - // [Output Only] Absolute value of VM instances calculated based on the - // specific mode. - If the value is fixed, then the calculated value is equal - // to the fixed value. - If the value is a percent, then the calculated value - // is percent/100 * targetSize. For example, the calculated value of a 80% of - // a managed instance group with 150 instances would be (80/100 * 150) = 120 - // VM instances. If there is a remainder, the number is rounded. - optional int32 calculated = 1 [json_name = "calculated"]; - - // Specifies a fixed number of VM instances. This must be a positive integer. - optional int32 fixed = 2 [json_name = "fixed"]; - - // Specifies a percentage of instances between 0 to 100%, inclusive. For - // example, specify 80 for 80%. - optional int32 percent = 3 [json_name = "percent"]; +import "google/cloud/compute/v1/internal/common_077.proto"; + +// Represents a Forwarding Rule resource. Forwarding rule resources in Google +// Cloud can be either regional or global in scope: * +// [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules) +// * +// [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules) +// A forwarding rule and its corresponding IP address represent the frontend +// configuration of a Google Cloud load balancer. Forwarding rules can also +// reference target instances and Cloud VPN Classic gateways (targetVpnGateway). +// For more information, read Forwarding rule concepts and Using protocol +// forwarding. +message ForwardingRule { + // IP address for which this forwarding rule accepts traffic. When a client + // sends traffic to this IP address, the forwarding rule directs the traffic + // to the referenced target or backendService. While creating a forwarding + // rule, specifying an IPAddress is required under the following + // circumstances: - When the target is set to targetGrpcProxy and + // validateForProxyless is set to true, the IPAddress should be set to + // 0.0.0.0. - When the target is a Private Service Connect Google APIs bundle, + // you must specify an IPAddress. Otherwise, you can optionally specify an IP + // address that references an existing static (reserved) IP address resource. + // When omitted, Google Cloud assigns an ephemeral IP address. Use one of the + // following formats to specify an IP address while creating a forwarding + // rule: * IP address number, as in `100.1.2.3` * IPv6 address range, as in + // `2600:1234::/96` * Full resource URL, as in + // https://www.googleapis.com/compute/v1/projects/ + // project_id/regions/region/addresses/address-name * Partial URL or by name, + // as in: - projects/project_id/regions/region/addresses/address-name - + // regions/region/addresses/address-name - global/addresses/address-name - + // address-name The forwarding rule's target or backendService, and in most + // cases, also the loadBalancingScheme, determine the type of IP address that + // you can use. For detailed information, see [IP address + // specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). + // When reading an IPAddress, the API always returns the IP address number. + optional string ip_address = 1 [json_name = "IPAddress"]; + + // The IP protocol to which this rule applies. For protocol forwarding, valid + // options are TCP, UDP, ESP, AH, SCTP, ICMP and L3_DEFAULT. The valid IP + // protocols are different for different load balancing products as described + // in [Load balancing + // features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). + // AH: + // ESP: + // ICMP: + // L3_DEFAULT: + // SCTP: + // TCP: + // UDP: + optional string ip_protocol = 2 [json_name = "IPProtocol"]; + + // The ports, portRange, and allPorts fields are mutually exclusive. Only + // packets addressed to ports in the specified range will be forwarded to the + // backends configured with this forwarding rule. The allPorts field has the + // following limitations: - It requires that the forwarding rule IPProtocol be + // TCP, UDP, SCTP, or L3_DEFAULT. - It's applicable only to the following + // products: internal passthrough Network Load Balancers, backend + // service-based external passthrough Network Load Balancers, and internal and + // external protocol forwarding. - Set this field to true to allow packets + // addressed to any port or packets lacking destination port information (for + // example, UDP fragments after the first fragment) to be forwarded to the + // backends configured with this forwarding rule. The L3_DEFAULT protocol + // requires allPorts be set to true. + optional bool all_ports = 3 [json_name = "allPorts"]; + + // If set to true, clients can access the internal passthrough Network Load + // Balancers, the regional internal Application Load Balancer, and the + // regional internal proxy Network Load Balancer from all regions. If false, + // only allows access from the local region the load balancer is located at. + // Note that for INTERNAL_MANAGED forwarding rules, this field cannot be + // changed after the forwarding rule is created. + optional bool allow_global_access = 4 [json_name = "allowGlobalAccess"]; + + // This is used in PSC consumer ForwardingRule to control whether the PSC + // endpoint can be accessed from another region. + optional bool allow_psc_global_access = 34 + [json_name = "allowPscGlobalAccess"]; + + // Identifies the backend service to which the forwarding rule sends traffic. + // Required for internal and external passthrough Network Load Balancers; must + // be omitted for all other load balancer types. + optional string backend_service = 5 [json_name = "backendService"]; + + // [Output Only] The URL for the corresponding base forwarding rule. By base + // forwarding rule, we mean the forwarding rule that has the same IP address, + // protocol, and port settings with the current forwarding rule, but without + // sourceIPRanges specified. Always empty if the current forwarding rule does + // not have sourceIPRanges specified. + optional string base_forwarding_rule = 6 [json_name = "baseForwardingRule"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 7 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 8 [json_name = "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 ForwardingRule. Include the fingerprint in patch request to + // ensure that you do not overwrite changes that were applied from another + // concurrent request. To see the latest fingerprint, make a get() request to + // retrieve a ForwardingRule. + optional string fingerprint = 9 [json_name = "fingerprint"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 10 [json_name = "id"]; + + // Resource reference of a PublicDelegatedPrefix. The PDP must be a sub-PDP in + // EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. Use one of the following + // formats to specify a sub-PDP when creating an IPv6 NetLB forwarding rule + // using BYOIP: Full resource URL, as in + // https://www.googleapis.com/compute/v1/projects/project_id/regions/region + // /publicDelegatedPrefixes/sub-pdp-name Partial URL, as in: - + // projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name - + // regions/region/publicDelegatedPrefixes/sub-pdp-name + optional string ip_collection = 35 [json_name = "ipCollection"]; + + // The IP Version that will be used by this forwarding rule. Valid options are + // IPV4 or IPV6. + // IPV4: + // IPV6: + // UNSPECIFIED_VERSION: + optional string ip_version = 11 [json_name = "ipVersion"]; + + // Indicates whether or not this load balancer can be used as a collector for + // packet mirroring. To prevent mirroring loops, instances behind this load + // balancer will not have their traffic mirrored even if a PacketMirroring + // rule applies to them. This can only be set to true for load balancers that + // have their loadBalancingScheme set to INTERNAL. + optional bool is_mirroring_collector = 12 + [json_name = "isMirroringCollector"]; + + // [Output Only] Type of the resource. Always compute#forwardingRule for + // forwarding rule resources. + optional string kind = 13 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this resource, which is + // essentially a hash of the labels set used for optimistic locking. The + // fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels, otherwise + // the request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve a ForwardingRule. + optional string label_fingerprint = 14 [json_name = "labelFingerprint"]; + + // Labels for this resource. These can only be added or modified by the + // setLabels method. Each label key/value pair must comply with RFC1035. Label + // values may be empty. + map labels = 15 [json_name = "labels"]; + + // Specifies the forwarding rule type. For more information about forwarding + // rules, refer to Forwarding rule concepts. + // EXTERNAL: + // EXTERNAL_MANAGED: + // INTERNAL: + // INTERNAL_MANAGED: + // INTERNAL_SELF_MANAGED: + // INVALID: + optional string load_balancing_scheme = 16 + [json_name = "loadBalancingScheme"]; + + // Opaque filter criteria used by load balancer to restrict routing + // configuration to a limited set of xDS compliant clients. In their xDS + // requests to load balancer, xDS clients present node metadata. When there is + // a match, the relevant configuration is made available to those proxies. + // Otherwise, all the resources (e.g. TargetHttpProxy, UrlMap) referenced by + // the ForwardingRule are not visible to those proxies. For each + // metadataFilter in this list, if its filterMatchCriteria is set to + // MATCH_ANY, at least one of the filterLabels must match the corresponding + // label provided in the metadata. If its filterMatchCriteria is set to + // MATCH_ALL, then all of its filterLabels must match with corresponding + // labels provided in the metadata. If multiple metadataFilters are specified, + // all of them need to be satisfied in order to be considered a match. + // metadataFilters specified here will be applifed before those specified in + // the UrlMap that this ForwardingRule references. metadataFilters only + // applies to Loadbalancers that have their loadBalancingScheme set to + // INTERNAL_SELF_MANAGED. + repeated MetadataFilter metadata_filters = 17 [json_name = "metadataFilters"]; + + // 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. For Private Service Connect forwarding rules that forward traffic to + // Google APIs, the forwarding rule name must be a 1-20 characters string with + // lowercase letters and numbers and must start with a letter. + optional string name = 18 [json_name = "name"]; + + // This field is not used for global external load balancing. For internal + // passthrough Network Load Balancers, this field identifies the network that + // the load balanced IP should belong to for this forwarding rule. If the + // subnetwork is specified, the network of the subnetwork will be used. If + // neither subnetwork nor this field is specified, the default network will be + // used. For Private Service Connect forwarding rules that forward traffic to + // Google APIs, a network must be provided. + optional string network = 19 [json_name = "network"]; + + // This signifies the networking tier used for configuring this load balancer + // and can only take the following values: PREMIUM, STANDARD. For regional + // ForwardingRule, the valid values are PREMIUM and STANDARD. For + // GlobalForwardingRule, the valid value is PREMIUM. If this field is not + // specified, it is assumed to be PREMIUM. If IPAddress is specified, this + // value must be equal to the networkTier of the Address. + // FIXED_STANDARD: Public internet quality with fixed bandwidth. + // PREMIUM: High quality, Google-grade network tier, support for all + // networking products. + // STANDARD: Public internet quality, only limited support for other + // networking products. + // STANDARD_OVERRIDES_FIXED_STANDARD: (Output only) Temporary tier for + // FIXED_STANDARD when fixed standard tier is expired or not configured. + optional string network_tier = 20 [json_name = "networkTier"]; + + // This is used in PSC consumer ForwardingRule to control whether it should + // try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use + // this field. Once set, this field is not mutable. + optional bool no_automate_dns_zone = 21 [json_name = "noAutomateDnsZone"]; + + // The ports, portRange, and allPorts fields are mutually exclusive. Only + // packets addressed to ports in the specified range will be forwarded to the + // backends configured with this forwarding rule. The portRange field has the + // following limitations: - It requires that the forwarding rule IPProtocol be + // TCP, UDP, or SCTP, and - It's applicable only to the following products: + // external passthrough Network Load Balancers, internal and external proxy + // Network Load Balancers, internal and external Application Load Balancers, + // external protocol forwarding, and Classic VPN. - Some products have + // restrictions on what ports can be used. See port specifications for + // details. For external forwarding rules, two or more forwarding rules cannot + // use the same [IPAddress, IPProtocol] pair, and cannot have overlapping + // portRanges. For internal forwarding rules within the same VPC network, two + // or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, + // and cannot have overlapping portRanges. @pattern: \\d+(?:-\\d+)? + optional string port_range = 22 [json_name = "portRange"]; + + // The ports, portRange, and allPorts fields are mutually exclusive. Only + // packets addressed to ports in the specified range will be forwarded to the + // backends configured with this forwarding rule. The ports field has the + // following limitations: - It requires that the forwarding rule IPProtocol be + // TCP, UDP, or SCTP, and - It's applicable only to the following products: + // internal passthrough Network Load Balancers, backend service-based external + // passthrough Network Load Balancers, and internal protocol forwarding. - You + // can specify a list of up to five ports by number, separated by commas. The + // ports can be contiguous or discontiguous. For external forwarding rules, + // two or more forwarding rules cannot use the same [IPAddress, IPProtocol] + // pair if they share at least one port number. For internal forwarding rules + // within the same VPC network, two or more forwarding rules cannot use the + // same [IPAddress, IPProtocol] pair if they share at least one port number. + // @pattern: \\d+(?:-\\d+)? + repeated string ports = 23 [json_name = "ports"]; + + // [Output Only] The PSC connection id of the PSC forwarding rule. + optional string psc_connection_id = 24 [json_name = "pscConnectionId"]; + + // ACCEPTED: The connection has been accepted by the producer. + // CLOSED: The connection has been closed by the producer and will not serve + // traffic going forward. + // NEEDS_ATTENTION: The connection has been accepted by the producer, but the + // producer needs to take further action before the forwarding rule can serve + // traffic. + // PENDING: The connection is pending acceptance by the producer. + // REJECTED: The connection has been rejected by the producer. + // STATUS_UNSPECIFIED: + optional string psc_connection_status = 25 + [json_name = "pscConnectionStatus"]; + + // [Output Only] URL of the region where the regional forwarding rule resides. + // This field is not applicable to global forwarding rules. You must specify + // this field as part of the HTTP request URL. It is not settable as a field + // in the request body. + optional string region = 26 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 27 [json_name = "selfLink"]; + + // Service Directory resources to register this forwarding rule with. + // Currently, only supports a single Service Directory resource. + repeated ForwardingRuleServiceDirectoryRegistration + service_directory_registrations = 28 + [json_name = "serviceDirectoryRegistrations"]; + + // An optional prefix to the service name for this forwarding rule. If + // specified, the prefix is the first label of the fully qualified service + // name. The label must be 1-63 characters long, and comply with RFC1035. + // Specifically, the label 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. This field is only used for internal load balancing. + optional string service_label = 29 [json_name = "serviceLabel"]; + + // [Output Only] The internal fully qualified service name for this forwarding + // rule. This field is only used for internal load balancing. + optional string service_name = 30 [json_name = "serviceName"]; + + // If not empty, this forwarding rule will only forward the traffic when the + // source IP address matches one of the IP addresses or CIDR ranges set here. + // Note that a forwarding rule can only have up to 64 source IP ranges, and + // this field can only be used with a regional forwarding rule whose scheme is + // EXTERNAL. Each source_ip_range entry should be either an IP address (for + // example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24). + repeated string source_ip_ranges = 31 [json_name = "sourceIpRanges"]; + + // This field identifies the subnetwork that the load balanced IP should + // belong to for this forwarding rule, used with internal load balancers and + // external passthrough Network Load Balancers with IPv6. If the network + // specified is in auto subnet mode, this field is optional. However, a + // subnetwork must be specified if the network is in custom subnet mode or + // when creating external forwarding rule with IPv6. + optional string subnetwork = 32 [json_name = "subnetwork"]; + + // The URL of the target resource to receive the matched traffic. For regional + // forwarding rules, this target must be in the same region as the forwarding + // rule. For global forwarding rules, this target must be a global load + // balancing resource. The forwarded traffic must be of a type appropriate to + // the target object. - For load balancers, see the "Target" column in [Port + // specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). + // - For Private Service Connect forwarding rules that forward traffic to + // Google APIs, provide the name of a supported Google API bundle: - vpc-sc - + // APIs that support VPC Service Controls. - all-apis - All supported Google + // APIs. - For Private Service Connect forwarding rules that forward traffic + // to managed services, the target must be a service attachment. The target is + // not mutable once set as a service attachment. + optional string target = 33 [json_name = "target"]; +} + +// Contains a list of ForwardingRule resources. +message ForwardingRuleList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of ForwardingRule resources. + repeated ForwardingRule items = 2 [json_name = "items"]; + + // Type of resource. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +// Describes the auto-registration of the forwarding rule to Service Directory. +// The region and project of the Service Directory resource generated from this +// registration will be the same as this forwarding rule. +message ForwardingRuleServiceDirectoryRegistration { + // Service Directory namespace to register the forwarding rule under. + optional string namespace = 1 [json_name = "namespace"]; + + // Service Directory service to register the forwarding rule under. + optional string service = 2 [json_name = "service"]; + + // [Optional] Service Directory region to register this global forwarding rule + // under. Default to "us-central1". Only used for PSC for Google APIs. All PSC + // for Google APIs forwarding rules on the same network should use the same + // Service Directory region. + optional string service_directory_region = 3 + [json_name = "serviceDirectoryRegion"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_041.proto b/protos/google/cloud/compute/v1/internal/common_041.proto index dc6c2ab030318..0e55bd05f5277 100644 --- a/protos/google/cloud/compute/v1/internal/common_041.proto +++ b/protos/google/cloud/compute/v1/internal/common_041.proto @@ -15,349 +15,23 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_079.proto"; +import "google/cloud/compute/v1/internal/common_040.proto"; -// Represents a Forwarding Rule resource. Forwarding rule resources in Google -// Cloud can be either regional or global in scope: * -// [Global](https://cloud.google.com/compute/docs/reference/rest/v1/globalForwardingRules) -// * -// [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/forwardingRules) -// A forwarding rule and its corresponding IP address represent the frontend -// configuration of a Google Cloud load balancer. Forwarding rules can also -// reference target instances and Cloud VPN Classic gateways (targetVpnGateway). -// For more information, read Forwarding rule concepts and Using protocol -// forwarding. -message ForwardingRule { - // IP address for which this forwarding rule accepts traffic. When a client - // sends traffic to this IP address, the forwarding rule directs the traffic - // to the referenced target or backendService. While creating a forwarding - // rule, specifying an IPAddress is required under the following - // circumstances: - When the target is set to targetGrpcProxy and - // validateForProxyless is set to true, the IPAddress should be set to - // 0.0.0.0. - When the target is a Private Service Connect Google APIs bundle, - // you must specify an IPAddress. Otherwise, you can optionally specify an IP - // address that references an existing static (reserved) IP address resource. - // When omitted, Google Cloud assigns an ephemeral IP address. Use one of the - // following formats to specify an IP address while creating a forwarding - // rule: * IP address number, as in `100.1.2.3` * IPv6 address range, as in - // `2600:1234::/96` * Full resource URL, as in - // https://www.googleapis.com/compute/v1/projects/ - // project_id/regions/region/addresses/address-name * Partial URL or by name, - // as in: - projects/project_id/regions/region/addresses/address-name - - // regions/region/addresses/address-name - global/addresses/address-name - - // address-name The forwarding rule's target or backendService, and in most - // cases, also the loadBalancingScheme, determine the type of IP address that - // you can use. For detailed information, see [IP address - // specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). - // When reading an IPAddress, the API always returns the IP address number. - optional string ip_address = 1 [json_name = "IPAddress"]; - - // The IP protocol to which this rule applies. For protocol forwarding, valid - // options are TCP, UDP, ESP, AH, SCTP, ICMP and L3_DEFAULT. The valid IP - // protocols are different for different load balancing products as described - // in [Load balancing - // features](https://cloud.google.com/load-balancing/docs/features#protocols_from_the_load_balancer_to_the_backends). - // AH: - // ESP: - // ICMP: - // L3_DEFAULT: - // SCTP: - // TCP: - // UDP: - optional string ip_protocol = 2 [json_name = "IPProtocol"]; - - // The ports, portRange, and allPorts fields are mutually exclusive. Only - // packets addressed to ports in the specified range will be forwarded to the - // backends configured with this forwarding rule. The allPorts field has the - // following limitations: - It requires that the forwarding rule IPProtocol be - // TCP, UDP, SCTP, or L3_DEFAULT. - It's applicable only to the following - // products: internal passthrough Network Load Balancers, backend - // service-based external passthrough Network Load Balancers, and internal and - // external protocol forwarding. - Set this field to true to allow packets - // addressed to any port or packets lacking destination port information (for - // example, UDP fragments after the first fragment) to be forwarded to the - // backends configured with this forwarding rule. The L3_DEFAULT protocol - // requires allPorts be set to true. - optional bool all_ports = 3 [json_name = "allPorts"]; - - // If set to true, clients can access the internal passthrough Network Load - // Balancers, the regional internal Application Load Balancer, and the - // regional internal proxy Network Load Balancer from all regions. If false, - // only allows access from the local region the load balancer is located at. - // Note that for INTERNAL_MANAGED forwarding rules, this field cannot be - // changed after the forwarding rule is created. - optional bool allow_global_access = 4 [json_name = "allowGlobalAccess"]; - - // This is used in PSC consumer ForwardingRule to control whether the PSC - // endpoint can be accessed from another region. - optional bool allow_psc_global_access = 34 - [json_name = "allowPscGlobalAccess"]; - - // Identifies the backend service to which the forwarding rule sends traffic. - // Required for internal and external passthrough Network Load Balancers; must - // be omitted for all other load balancer types. - optional string backend_service = 5 [json_name = "backendService"]; - - // [Output Only] The URL for the corresponding base forwarding rule. By base - // forwarding rule, we mean the forwarding rule that has the same IP address, - // protocol, and port settings with the current forwarding rule, but without - // sourceIPRanges specified. Always empty if the current forwarding rule does - // not have sourceIPRanges specified. - optional string base_forwarding_rule = 6 [json_name = "baseForwardingRule"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 7 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 8 [json_name = "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 ForwardingRule. Include the fingerprint in patch request to - // ensure that you do not overwrite changes that were applied from another - // concurrent request. To see the latest fingerprint, make a get() request to - // retrieve a ForwardingRule. - optional string fingerprint = 9 [json_name = "fingerprint"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 10 [json_name = "id"]; - - // Resource reference of a PublicDelegatedPrefix. The PDP must be a sub-PDP in - // EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode. Use one of the following - // formats to specify a sub-PDP when creating an IPv6 NetLB forwarding rule - // using BYOIP: Full resource URL, as in - // https://www.googleapis.com/compute/v1/projects/project_id/regions/region - // /publicDelegatedPrefixes/sub-pdp-name Partial URL, as in: - - // projects/project_id/regions/region/publicDelegatedPrefixes/sub-pdp-name - - // regions/region/publicDelegatedPrefixes/sub-pdp-name - optional string ip_collection = 35 [json_name = "ipCollection"]; - - // The IP Version that will be used by this forwarding rule. Valid options are - // IPV4 or IPV6. - // IPV4: - // IPV6: - // UNSPECIFIED_VERSION: - optional string ip_version = 11 [json_name = "ipVersion"]; - - // Indicates whether or not this load balancer can be used as a collector for - // packet mirroring. To prevent mirroring loops, instances behind this load - // balancer will not have their traffic mirrored even if a PacketMirroring - // rule applies to them. This can only be set to true for load balancers that - // have their loadBalancingScheme set to INTERNAL. - optional bool is_mirroring_collector = 12 - [json_name = "isMirroringCollector"]; - - // [Output Only] Type of the resource. Always compute#forwardingRule for - // forwarding rule resources. - optional string kind = 13 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this resource, which is - // essentially a hash of the labels set used for optimistic locking. The - // fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels, otherwise - // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve a ForwardingRule. - optional string label_fingerprint = 14 [json_name = "labelFingerprint"]; - - // Labels for this resource. These can only be added or modified by the - // setLabels method. Each label key/value pair must comply with RFC1035. Label - // values may be empty. - map labels = 15 [json_name = "labels"]; - - // Specifies the forwarding rule type. For more information about forwarding - // rules, refer to Forwarding rule concepts. - // EXTERNAL: - // EXTERNAL_MANAGED: - // INTERNAL: - // INTERNAL_MANAGED: - // INTERNAL_SELF_MANAGED: - // INVALID: - optional string load_balancing_scheme = 16 - [json_name = "loadBalancingScheme"]; - - // Opaque filter criteria used by load balancer to restrict routing - // configuration to a limited set of xDS compliant clients. In their xDS - // requests to load balancer, xDS clients present node metadata. When there is - // a match, the relevant configuration is made available to those proxies. - // Otherwise, all the resources (e.g. TargetHttpProxy, UrlMap) referenced by - // the ForwardingRule are not visible to those proxies. For each - // metadataFilter in this list, if its filterMatchCriteria is set to - // MATCH_ANY, at least one of the filterLabels must match the corresponding - // label provided in the metadata. If its filterMatchCriteria is set to - // MATCH_ALL, then all of its filterLabels must match with corresponding - // labels provided in the metadata. If multiple metadataFilters are specified, - // all of them need to be satisfied in order to be considered a match. - // metadataFilters specified here will be applifed before those specified in - // the UrlMap that this ForwardingRule references. metadataFilters only - // applies to Loadbalancers that have their loadBalancingScheme set to - // INTERNAL_SELF_MANAGED. - repeated MetadataFilter metadata_filters = 17 [json_name = "metadataFilters"]; - - // 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. For Private Service Connect forwarding rules that forward traffic to - // Google APIs, the forwarding rule name must be a 1-20 characters string with - // lowercase letters and numbers and must start with a letter. - optional string name = 18 [json_name = "name"]; - - // This field is not used for global external load balancing. For internal - // passthrough Network Load Balancers, this field identifies the network that - // the load balanced IP should belong to for this forwarding rule. If the - // subnetwork is specified, the network of the subnetwork will be used. If - // neither subnetwork nor this field is specified, the default network will be - // used. For Private Service Connect forwarding rules that forward traffic to - // Google APIs, a network must be provided. - optional string network = 19 [json_name = "network"]; - - // This signifies the networking tier used for configuring this load balancer - // and can only take the following values: PREMIUM, STANDARD. For regional - // ForwardingRule, the valid values are PREMIUM and STANDARD. For - // GlobalForwardingRule, the valid value is PREMIUM. If this field is not - // specified, it is assumed to be PREMIUM. If IPAddress is specified, this - // value must be equal to the networkTier of the Address. - // FIXED_STANDARD: Public internet quality with fixed bandwidth. - // PREMIUM: High quality, Google-grade network tier, support for all - // networking products. - // STANDARD: Public internet quality, only limited support for other - // networking products. - // STANDARD_OVERRIDES_FIXED_STANDARD: (Output only) Temporary tier for - // FIXED_STANDARD when fixed standard tier is expired or not configured. - optional string network_tier = 20 [json_name = "networkTier"]; - - // This is used in PSC consumer ForwardingRule to control whether it should - // try to auto-generate a DNS zone or not. Non-PSC forwarding rules do not use - // this field. Once set, this field is not mutable. - optional bool no_automate_dns_zone = 21 [json_name = "noAutomateDnsZone"]; - - // The ports, portRange, and allPorts fields are mutually exclusive. Only - // packets addressed to ports in the specified range will be forwarded to the - // backends configured with this forwarding rule. The portRange field has the - // following limitations: - It requires that the forwarding rule IPProtocol be - // TCP, UDP, or SCTP, and - It's applicable only to the following products: - // external passthrough Network Load Balancers, internal and external proxy - // Network Load Balancers, internal and external Application Load Balancers, - // external protocol forwarding, and Classic VPN. - Some products have - // restrictions on what ports can be used. See port specifications for - // details. For external forwarding rules, two or more forwarding rules cannot - // use the same [IPAddress, IPProtocol] pair, and cannot have overlapping - // portRanges. For internal forwarding rules within the same VPC network, two - // or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, - // and cannot have overlapping portRanges. @pattern: \\d+(?:-\\d+)? - optional string port_range = 22 [json_name = "portRange"]; - - // The ports, portRange, and allPorts fields are mutually exclusive. Only - // packets addressed to ports in the specified range will be forwarded to the - // backends configured with this forwarding rule. The ports field has the - // following limitations: - It requires that the forwarding rule IPProtocol be - // TCP, UDP, or SCTP, and - It's applicable only to the following products: - // internal passthrough Network Load Balancers, backend service-based external - // passthrough Network Load Balancers, and internal protocol forwarding. - You - // can specify a list of up to five ports by number, separated by commas. The - // ports can be contiguous or discontiguous. For external forwarding rules, - // two or more forwarding rules cannot use the same [IPAddress, IPProtocol] - // pair if they share at least one port number. For internal forwarding rules - // within the same VPC network, two or more forwarding rules cannot use the - // same [IPAddress, IPProtocol] pair if they share at least one port number. - // @pattern: \\d+(?:-\\d+)? - repeated string ports = 23 [json_name = "ports"]; - - // [Output Only] The PSC connection id of the PSC forwarding rule. - optional string psc_connection_id = 24 [json_name = "pscConnectionId"]; - - // ACCEPTED: The connection has been accepted by the producer. - // CLOSED: The connection has been closed by the producer and will not serve - // traffic going forward. - // NEEDS_ATTENTION: The connection has been accepted by the producer, but the - // producer needs to take further action before the forwarding rule can serve - // traffic. - // PENDING: The connection is pending acceptance by the producer. - // REJECTED: The connection has been rejected by the producer. - // STATUS_UNSPECIFIED: - optional string psc_connection_status = 25 - [json_name = "pscConnectionStatus"]; - - // [Output Only] URL of the region where the regional forwarding rule resides. - // This field is not applicable to global forwarding rules. You must specify - // this field as part of the HTTP request URL. It is not settable as a field - // in the request body. - optional string region = 26 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 27 [json_name = "selfLink"]; - - // Service Directory resources to register this forwarding rule with. - // Currently, only supports a single Service Directory resource. - repeated ForwardingRuleServiceDirectoryRegistration - service_directory_registrations = 28 - [json_name = "serviceDirectoryRegistrations"]; - - // An optional prefix to the service name for this forwarding rule. If - // specified, the prefix is the first label of the fully qualified service - // name. The label must be 1-63 characters long, and comply with RFC1035. - // Specifically, the label 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. This field is only used for internal load balancing. - optional string service_label = 29 [json_name = "serviceLabel"]; - - // [Output Only] The internal fully qualified service name for this forwarding - // rule. This field is only used for internal load balancing. - optional string service_name = 30 [json_name = "serviceName"]; - - // If not empty, this forwarding rule will only forward the traffic when the - // source IP address matches one of the IP addresses or CIDR ranges set here. - // Note that a forwarding rule can only have up to 64 source IP ranges, and - // this field can only be used with a regional forwarding rule whose scheme is - // EXTERNAL. Each source_ip_range entry should be either an IP address (for - // example, 1.2.3.4) or a CIDR range (for example, 1.2.3.0/24). - repeated string source_ip_ranges = 31 [json_name = "sourceIpRanges"]; - - // This field identifies the subnetwork that the load balanced IP should - // belong to for this forwarding rule, used with internal load balancers and - // external passthrough Network Load Balancers with IPv6. If the network - // specified is in auto subnet mode, this field is optional. However, a - // subnetwork must be specified if the network is in custom subnet mode or - // when creating external forwarding rule with IPv6. - optional string subnetwork = 32 [json_name = "subnetwork"]; - - // The URL of the target resource to receive the matched traffic. For regional - // forwarding rules, this target must be in the same region as the forwarding - // rule. For global forwarding rules, this target must be a global load - // balancing resource. The forwarded traffic must be of a type appropriate to - // the target object. - For load balancers, see the "Target" column in [Port - // specifications](https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts#ip_address_specifications). - // - For Private Service Connect forwarding rules that forward traffic to - // Google APIs, provide the name of a supported Google API bundle: - vpc-sc - - // APIs that support VPC Service Controls. - all-apis - All supported Google - // APIs. - For Private Service Connect forwarding rules that forward traffic - // to managed services, the target must be a service attachment. The target is - // not mutable once set as a service attachment. - optional string target = 33 [json_name = "target"]; -} - -// Contains a list of ForwardingRule resources. -message ForwardingRuleList { +message ForwardingRuleAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of ForwardingRule resources. - repeated ForwardingRule items = 2 [json_name = "items"]; + // A list of ForwardingRulesScopedList resources. + map items = 2 [json_name = "items"]; - // Type of resource. + // [Output Only] Type of resource. Always compute#forwardingRuleAggregatedList + // for lists of forwarding rules. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -370,6 +44,9 @@ message ForwardingRuleList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -452,23 +129,95 @@ message ForwardingRuleList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; } -// Describes the auto-registration of the forwarding rule to Service Directory. -// The region and project of the Service Directory resource generated from this -// registration will be the same as this forwarding rule. -message ForwardingRuleServiceDirectoryRegistration { - // Service Directory namespace to register the forwarding rule under. - optional string namespace = 1 [json_name = "namespace"]; +message ForwardingRulesScopedList { + // A list of forwarding rules contained in this scope. + repeated ForwardingRule forwarding_rules = 1 [json_name = "forwardingRules"]; - // Service Directory service to register the forwarding rule under. - optional string service = 2 [json_name = "service"]; + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // [Optional] Service Directory region to register this global forwarding rule - // under. Default to "us-central1". Only used for PSC for Google APIs. All PSC - // for Google APIs forwarding rules on the same network should use the same - // Service Directory region. - optional string service_directory_region = 3 - [json_name = "serviceDirectoryRegion"]; + // Informational warning which replaces the list of forwarding rules when the + // list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_042.proto b/protos/google/cloud/compute/v1/internal/common_042.proto index fd23745561e3f..0b2736d66fee6 100644 --- a/protos/google/cloud/compute/v1/internal/common_042.proto +++ b/protos/google/cloud/compute/v1/internal/common_042.proto @@ -15,23 +15,360 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_041.proto"; +message GRPCHealthCheck { + // The gRPC service name for the health check. This field is optional. The + // value of grpc_service_name has the following meanings by convention: - + // Empty service_name means the overall status of all services at the backend. + // - Non-empty service_name means the health of that gRPC service, as defined + // by the owner of the service. The grpc_service_name can only be ASCII. + optional string grpc_service_name = 1 [json_name = "grpcServiceName"]; -message ForwardingRuleAggregatedList { + // The TCP port number to which the health check prober sends packets. Valid + // values are 1 through 65535. + optional int32 port = 2 [json_name = "port"]; + + // Not supported. + optional string port_name = 3 [json_name = "portName"]; + + // Specifies how a port is selected for health checking. Can be one of the + // following values: USE_FIXED_PORT: Specifies a port number explicitly using + // the port field in the health check. Supported by backend services for + // passthrough load balancers and backend services for proxy load balancers. + // Not supported by target pools. The health check supports all backends + // supported by the backend service provided the backend can be health + // checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT + // network endpoint groups, and instance group backends. USE_NAMED_PORT: Not + // supported. USE_SERVING_PORT: Provides an indirect method of specifying the + // health check port by referring to the backend service. Only supported by + // backend services for proxy load balancers. Not supported by target pools. + // Not supported by backend services for passthrough load balancers. Supports + // all backends that can be health checked; for example, GCE_VM_IP_PORT + // network endpoint groups and instance group backends. For GCE_VM_IP_PORT + // network endpoint group backends, the health check uses the port number + // specified for each endpoint in the network endpoint group. For instance + // group backends, the health check uses the port number determined by looking + // up the backend service's named port in the instance group's list of named + // ports. + // USE_FIXED_PORT: The port number in the health check's port is used for + // health checking. Applies to network endpoint group and instance group + // backends. + // USE_NAMED_PORT: Not supported. + // USE_SERVING_PORT: For network endpoint group backends, the health check + // uses the port number specified on each endpoint in the network endpoint + // group. For instance group backends, the health check uses the port number + // specified for the backend service's named port defined in the instance + // group's named ports. + optional string port_specification = 4 [json_name = "portSpecification"]; +} + +message HTTP2HealthCheck { + // The value of the host header in the HTTP/2 health check request. If left + // empty (default value), the host header is set to the destination IP address + // to which health check packets are sent. The destination IP address depends + // on the type of load balancer. For details, see: + // https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + optional string host = 1 [json_name = "host"]; + + // The TCP port number to which the health check prober sends packets. The + // default value is 443. Valid values are 1 through 65535. + optional int32 port = 2 [json_name = "port"]; + + // Not supported. + optional string port_name = 3 [json_name = "portName"]; + + // Specifies how a port is selected for health checking. Can be one of the + // following values: USE_FIXED_PORT: Specifies a port number explicitly using + // the port field in the health check. Supported by backend services for + // passthrough load balancers and backend services for proxy load balancers. + // Not supported by target pools. The health check supports all backends + // supported by the backend service provided the backend can be health + // checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT + // network endpoint groups, and instance group backends. USE_NAMED_PORT: Not + // supported. USE_SERVING_PORT: Provides an indirect method of specifying the + // health check port by referring to the backend service. Only supported by + // backend services for proxy load balancers. Not supported by target pools. + // Not supported by backend services for passthrough load balancers. Supports + // all backends that can be health checked; for example, GCE_VM_IP_PORT + // network endpoint groups and instance group backends. For GCE_VM_IP_PORT + // network endpoint group backends, the health check uses the port number + // specified for each endpoint in the network endpoint group. For instance + // group backends, the health check uses the port number determined by looking + // up the backend service's named port in the instance group's list of named + // ports. + // USE_FIXED_PORT: The port number in the health check's port is used for + // health checking. Applies to network endpoint group and instance group + // backends. + // USE_NAMED_PORT: Not supported. + // USE_SERVING_PORT: For network endpoint group backends, the health check + // uses the port number specified on each endpoint in the network endpoint + // group. For instance group backends, the health check uses the port number + // specified for the backend service's named port defined in the instance + // group's named ports. + optional string port_specification = 4 [json_name = "portSpecification"]; + + // Specifies the type of proxy header to append before sending data to the + // backend, either NONE or PROXY_V1. The default is NONE. + // NONE: + // PROXY_V1: + optional string proxy_header = 5 [json_name = "proxyHeader"]; + + // The request path of the HTTP/2 health check request. The default value is + // /. Must comply with RFC3986. + optional string request_path = 6 [json_name = "requestPath"]; + + // Creates a content-based HTTP/2 health check. In addition to the required + // HTTP 200 (OK) status code, you can configure the health check to pass only + // when the backend sends this specific ASCII response string within the first + // 1024 bytes of the HTTP response body. For details, see: + // https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + optional string response = 7 [json_name = "response"]; +} + +message HTTPHealthCheck { + // The value of the host header in the HTTP health check request. If left + // empty (default value), the host header is set to the destination IP address + // to which health check packets are sent. The destination IP address depends + // on the type of load balancer. For details, see: + // https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + optional string host = 1 [json_name = "host"]; + + // The TCP port number to which the health check prober sends packets. The + // default value is 80. Valid values are 1 through 65535. + optional int32 port = 2 [json_name = "port"]; + + // Not supported. + optional string port_name = 3 [json_name = "portName"]; + + // Specifies how a port is selected for health checking. Can be one of the + // following values: USE_FIXED_PORT: Specifies a port number explicitly using + // the port field in the health check. Supported by backend services for + // passthrough load balancers and backend services for proxy load balancers. + // Also supported in legacy HTTP health checks for target pools. The health + // check supports all backends supported by the backend service provided the + // backend can be health checked. For example, GCE_VM_IP network endpoint + // groups, GCE_VM_IP_PORT network endpoint groups, and instance group + // backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an + // indirect method of specifying the health check port by referring to the + // backend service. Only supported by backend services for proxy load + // balancers. Not supported by target pools. Not supported by backend services + // for pass-through load balancers. Supports all backends that can be health + // checked; for example, GCE_VM_IP_PORT network endpoint groups and instance + // group backends. For GCE_VM_IP_PORT network endpoint group backends, the + // health check uses the port number specified for each endpoint in the + // network endpoint group. For instance group backends, the health check uses + // the port number determined by looking up the backend service's named port + // in the instance group's list of named ports. + // USE_FIXED_PORT: The port number in the health check's port is used for + // health checking. Applies to network endpoint group and instance group + // backends. + // USE_NAMED_PORT: Not supported. + // USE_SERVING_PORT: For network endpoint group backends, the health check + // uses the port number specified on each endpoint in the network endpoint + // group. For instance group backends, the health check uses the port number + // specified for the backend service's named port defined in the instance + // group's named ports. + optional string port_specification = 4 [json_name = "portSpecification"]; + + // Specifies the type of proxy header to append before sending data to the + // backend, either NONE or PROXY_V1. The default is NONE. + // NONE: + // PROXY_V1: + optional string proxy_header = 5 [json_name = "proxyHeader"]; + + // The request path of the HTTP health check request. The default value is /. + // Must comply with RFC3986. + optional string request_path = 6 [json_name = "requestPath"]; + + // Creates a content-based HTTP health check. In addition to the required HTTP + // 200 (OK) status code, you can configure the health check to pass only when + // the backend sends this specific ASCII response string within the first 1024 + // bytes of the HTTP response body. For details, see: + // https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + optional string response = 7 [json_name = "response"]; +} + +message HTTPSHealthCheck { + // The value of the host header in the HTTPS health check request. If left + // empty (default value), the host header is set to the destination IP address + // to which health check packets are sent. The destination IP address depends + // on the type of load balancer. For details, see: + // https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest + optional string host = 1 [json_name = "host"]; + + // The TCP port number to which the health check prober sends packets. The + // default value is 443. Valid values are 1 through 65535. + optional int32 port = 2 [json_name = "port"]; + + // Not supported. + optional string port_name = 3 [json_name = "portName"]; + + // Specifies how a port is selected for health checking. Can be one of the + // following values: USE_FIXED_PORT: Specifies a port number explicitly using + // the port field in the health check. Supported by backend services for + // passthrough load balancers and backend services for proxy load balancers. + // Not supported by target pools. The health check supports all backends + // supported by the backend service provided the backend can be health + // checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT + // network endpoint groups, and instance group backends. USE_NAMED_PORT: Not + // supported. USE_SERVING_PORT: Provides an indirect method of specifying the + // health check port by referring to the backend service. Only supported by + // backend services for proxy load balancers. Not supported by target pools. + // Not supported by backend services for passthrough load balancers. Supports + // all backends that can be health checked; for example, GCE_VM_IP_PORT + // network endpoint groups and instance group backends. For GCE_VM_IP_PORT + // network endpoint group backends, the health check uses the port number + // specified for each endpoint in the network endpoint group. For instance + // group backends, the health check uses the port number determined by looking + // up the backend service's named port in the instance group's list of named + // ports. + // USE_FIXED_PORT: The port number in the health check's port is used for + // health checking. Applies to network endpoint group and instance group + // backends. + // USE_NAMED_PORT: Not supported. + // USE_SERVING_PORT: For network endpoint group backends, the health check + // uses the port number specified on each endpoint in the network endpoint + // group. For instance group backends, the health check uses the port number + // specified for the backend service's named port defined in the instance + // group's named ports. + optional string port_specification = 4 [json_name = "portSpecification"]; + + // Specifies the type of proxy header to append before sending data to the + // backend, either NONE or PROXY_V1. The default is NONE. + // NONE: + // PROXY_V1: + optional string proxy_header = 5 [json_name = "proxyHeader"]; + + // The request path of the HTTPS health check request. The default value is /. + // Must comply with RFC3986. + optional string request_path = 6 [json_name = "requestPath"]; + + // Creates a content-based HTTPS health check. In addition to the required + // HTTP 200 (OK) status code, you can configure the health check to pass only + // when the backend sends this specific ASCII response string within the first + // 1024 bytes of the HTTP response body. For details, see: + // https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http + optional string response = 7 [json_name = "response"]; +} + +// Represents a health check resource. Google Compute Engine has two health +// check resources: * +// [Regional](/compute/docs/reference/rest/v1/regionHealthChecks) * +// [Global](/compute/docs/reference/rest/v1/healthChecks) These health check +// resources can be used for load balancing and for autohealing VMs in a managed +// instance group (MIG). **Load balancing** Health check requirements vary +// depending on the type of load balancer. For details about the type of health +// check supported for each load balancer and corresponding backend type, see +// Health checks overview: Load balancer guide. **Autohealing in MIGs** The +// health checks that you use for autohealing VMs in a MIG can be either +// regional or global. For more information, see Set up an application health +// check and autohealing. For more information, see Health checks overview. +message HealthCheck { + // How often (in seconds) to send a health check. The default value is 5 + // seconds. + optional int32 check_interval_sec = 1 [json_name = "checkIntervalSec"]; + + // [Output Only] Creation timestamp in 3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + optional GRPCHealthCheck grpc_health_check = 4 + [json_name = "grpcHealthCheck"]; + + // A so-far unhealthy instance will be marked healthy after this many + // consecutive successes. The default value is 2. + optional int32 healthy_threshold = 5 [json_name = "healthyThreshold"]; + + optional HTTP2HealthCheck http2_health_check = 6 + [json_name = "http2HealthCheck"]; + + optional HTTPHealthCheck http_health_check = 7 + [json_name = "httpHealthCheck"]; + + optional HTTPSHealthCheck https_health_check = 8 + [json_name = "httpsHealthCheck"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 9 [json_name = "id"]; + + // Type of the resource. + optional string kind = 10 [json_name = "kind"]; + + // Configure logging on this health check. + optional HealthCheckLogConfig log_config = 11 [json_name = "logConfig"]; + + // 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. For + // example, a name that is 1-63 characters long, matches the regular + // expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with + // RFC1035. This regular expression describes a name where the first character + // is a lowercase letter, and all following characters are a dash, lowercase + // letter, or digit, except the last character, which isn't a dash. + optional string name = 12 [json_name = "name"]; + + // [Output Only] Region where the health check resides. Not applicable to + // global health checks. + optional string region = 13 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 14 [json_name = "selfLink"]; + + // The list of cloud regions from which health checks are performed. If any + // regions are specified, then exactly 3 regions should be specified. The + // region names must be valid names of Google Cloud regions. This can only be + // set for global health check. If this list is non-empty, then there are + // restrictions on what other health check fields are supported and what other + // resources can use this health check: - SSL, HTTP2, and GRPC protocols are + // not supported. - The TCP request field is not supported. - The proxyHeader + // field for HTTP, HTTPS, and TCP is not supported. - The checkIntervalSec + // field must be at least 30. - The health check cannot be used with + // BackendService nor with managed instance group auto-healing. + repeated string source_regions = 20 [json_name = "sourceRegions"]; + + optional SSLHealthCheck ssl_health_check = 15 [json_name = "sslHealthCheck"]; + + optional TCPHealthCheck tcp_health_check = 16 [json_name = "tcpHealthCheck"]; + + // 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. + optional int32 timeout_sec = 17 [json_name = "timeoutSec"]; + + // Specifies the type of the healthCheck, either TCP, SSL, HTTP, HTTPS, HTTP2 + // or GRPC. Exactly one of the protocol-specific health check fields must be + // specified, which must match type field. + // GRPC: + // HTTP: + // HTTP2: + // HTTPS: + // INVALID: + // SSL: + // TCP: + optional string type = 18 [json_name = "type"]; + + // A so-far healthy instance will be marked unhealthy after this many + // consecutive failures. The default value is 2. + optional int32 unhealthy_threshold = 19 [json_name = "unhealthyThreshold"]; +} + +// Contains a list of HealthCheck resources. +message HealthCheckList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of ForwardingRulesScopedList resources. - map items = 2 [json_name = "items"]; + // A list of HealthCheck resources. + repeated HealthCheck items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#forwardingRuleAggregatedList - // for lists of forwarding rules. + // Type of resource. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -44,9 +381,6 @@ message ForwardingRuleAggregatedList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -129,95 +463,126 @@ message ForwardingRuleAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + optional Warning warning = 6 [json_name = "warning"]; } -message ForwardingRulesScopedList { - // A list of forwarding rules contained in this scope. - repeated ForwardingRule forwarding_rules = 1 [json_name = "forwardingRules"]; +// Configuration of logging on a health check. If logging is enabled, logs will +// be exported to Stackdriver. +message HealthCheckLogConfig { + // Indicates whether or not to export logs. This is false by default, which + // means no health check logging will be done. + optional bool enable = 1 [json_name = "enable"]; +} - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; +message SSLHealthCheck { + // The TCP port number to which the health check prober sends packets. The + // default value is 443. Valid values are 1 through 65535. + optional int32 port = 1 [json_name = "port"]; - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; + // Not supported. + optional string port_name = 2 [json_name = "portName"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // Specifies how a port is selected for health checking. Can be one of the + // following values: USE_FIXED_PORT: Specifies a port number explicitly using + // the port field in the health check. Supported by backend services for + // passthrough load balancers and backend services for proxy load balancers. + // Not supported by target pools. The health check supports all backends + // supported by the backend service provided the backend can be health + // checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT + // network endpoint groups, and instance group backends. USE_NAMED_PORT: Not + // supported. USE_SERVING_PORT: Provides an indirect method of specifying the + // health check port by referring to the backend service. Only supported by + // backend services for proxy load balancers. Not supported by target pools. + // Not supported by backend services for passthrough load balancers. Supports + // all backends that can be health checked; for example, GCE_VM_IP_PORT + // network endpoint groups and instance group backends. For GCE_VM_IP_PORT + // network endpoint group backends, the health check uses the port number + // specified for each endpoint in the network endpoint group. For instance + // group backends, the health check uses the port number determined by looking + // up the backend service's named port in the instance group's list of named + // ports. + // USE_FIXED_PORT: The port number in the health check's port is used for + // health checking. Applies to network endpoint group and instance group + // backends. + // USE_NAMED_PORT: Not supported. + // USE_SERVING_PORT: For network endpoint group backends, the health check + // uses the port number specified on each endpoint in the network endpoint + // group. For instance group backends, the health check uses the port number + // specified for the backend service's named port defined in the instance + // group's named ports. + optional string port_specification = 3 [json_name = "portSpecification"]; - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; + // Specifies the type of proxy header to append before sending data to the + // backend, either NONE or PROXY_V1. The default is NONE. + // NONE: + // PROXY_V1: + optional string proxy_header = 4 [json_name = "proxyHeader"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // Instructs the health check prober to send this exact ASCII string, up to + // 1024 bytes in length, after establishing the TCP connection and SSL + // handshake. + optional string request = 5 [json_name = "request"]; + + // Creates a content-based SSL health check. In addition to establishing a TCP + // connection and the TLS handshake, you can configure the health check to + // pass only when the backend sends this exact response ASCII string, up to + // 1024 bytes in length. For details, see: + // https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp + optional string response = 6 [json_name = "response"]; +} + +message TCPHealthCheck { + // The TCP port number to which the health check prober sends packets. The + // default value is 80. Valid values are 1 through 65535. + optional int32 port = 1 [json_name = "port"]; + + // Not supported. + optional string port_name = 2 [json_name = "portName"]; + + // Specifies how a port is selected for health checking. Can be one of the + // following values: USE_FIXED_PORT: Specifies a port number explicitly using + // the port field in the health check. Supported by backend services for + // passthrough load balancers and backend services for proxy load balancers. + // Not supported by target pools. The health check supports all backends + // supported by the backend service provided the backend can be health + // checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT + // network endpoint groups, and instance group backends. USE_NAMED_PORT: Not + // supported. USE_SERVING_PORT: Provides an indirect method of specifying the + // health check port by referring to the backend service. Only supported by + // backend services for proxy load balancers. Not supported by target pools. + // Not supported by backend services for passthrough load balancers. Supports + // all backends that can be health checked; for example, GCE_VM_IP_PORT + // network endpoint groups and instance group backends. For GCE_VM_IP_PORT + // network endpoint group backends, the health check uses the port number + // specified for each endpoint in the network endpoint group. For instance + // group backends, the health check uses the port number determined by looking + // up the backend service's named port in the instance group's list of named + // ports. + // USE_FIXED_PORT: The port number in the health check's port is used for + // health checking. Applies to network endpoint group and instance group + // backends. + // USE_NAMED_PORT: Not supported. + // USE_SERVING_PORT: For network endpoint group backends, the health check + // uses the port number specified on each endpoint in the network endpoint + // group. For instance group backends, the health check uses the port number + // specified for the backend service's named port defined in the instance + // group's named ports. + optional string port_specification = 3 [json_name = "portSpecification"]; + + // Specifies the type of proxy header to append before sending data to the + // backend, either NONE or PROXY_V1. The default is NONE. + // NONE: + // PROXY_V1: + optional string proxy_header = 4 [json_name = "proxyHeader"]; + + // Instructs the health check prober to send this exact ASCII string, up to + // 1024 bytes in length, after establishing the TCP connection. + optional string request = 5 [json_name = "request"]; - // Informational warning which replaces the list of forwarding rules when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // Creates a content-based TCP health check. In addition to establishing a TCP + // connection, you can configure the health check to pass only when the + // backend sends this exact response ASCII string, up to 1024 bytes in length. + // For details, see: + // https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp + optional string response = 6 [json_name = "response"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_043.proto b/protos/google/cloud/compute/v1/internal/common_043.proto index 7ebd6c54cf1a6..b589a25b2ed9e 100644 --- a/protos/google/cloud/compute/v1/internal/common_043.proto +++ b/protos/google/cloud/compute/v1/internal/common_043.proto @@ -15,598 +15,22 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_007.proto"; -import "google/cloud/compute/v1/internal/common_030.proto"; -import "google/cloud/compute/v1/internal/common_114.proto"; - -message FutureReservation { - reserved 14; - // Future timestamp when the FR auto-created reservations will be deleted by - // Compute Engine. Format of this field must be a valid - // href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339 value. - optional string auto_created_reservations_delete_time = 1 - [json_name = "autoCreatedReservationsDeleteTime"]; - - // Specifies the duration of auto-created reservations. It represents relative - // time to future reservation start_time when auto-created reservations will - // be automatically deleted by Compute Engine. Duration time unit is - // represented as a count of seconds and fractions of seconds at nanosecond - // resolution. - optional Duration auto_created_reservations_duration = 2 - [json_name = "autoCreatedReservationsDuration"]; - - // Setting for enabling or disabling automatic deletion for auto-created - // reservation. If set to true, auto-created reservations will be deleted at - // Future Reservation's end time (default) or at user's defined timestamp if - // any of the [auto_created_reservations_delete_time, - // auto_created_reservations_duration] values is specified. For keeping - // auto-created reservation indefinitely, this value should be set to false. - optional bool auto_delete_auto_created_reservations = 3 - [json_name = "autoDeleteAutoCreatedReservations"]; - - // [Output Only] The creation timestamp for this future reservation in RFC3339 - // text format. - optional string creation_timestamp = 4 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the future reservation. - optional string description = 5 [json_name = "description"]; - - // [Output Only] A unique identifier for this future reservation. The server - // defines this identifier. - optional string id = 6 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#futureReservation for - // future reservations. - optional string kind = 7 [json_name = "kind"]; - - // The name of the resource, provided by the client when initially creating - // the resource. The resource name must be 1-63 characters long, and comply - // with RFC1035. Specifically, the name must be 1-63 characters long and match - // the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first - // character must be a lowercase letter, and all following characters must be - // a dash, lowercase letter, or digit, except the last character, which cannot - // be a dash. - optional string name = 8 [json_name = "name"]; - - // Name prefix for the reservations to be created at the time of delivery. The - // name prefix must comply with RFC1035. Maximum allowed length for name - // prefix is 20. Automatically created reservations name format will be - // -date-####. - optional string name_prefix = 9 [json_name = "namePrefix"]; - - // Planning state before being submitted for evaluation - // DRAFT: Future Reservation is being drafted. - // PLANNING_STATUS_UNSPECIFIED: - // SUBMITTED: Future Reservation has been submitted for evaluation by GCP. - optional string planning_status = 10 [json_name = "planningStatus"]; - - // [Output Only] Server-defined fully-qualified URL for this resource. - optional string self_link = 11 [json_name = "selfLink"]; - - // [Output Only] Server-defined URL for this resource with the resource id. - optional string self_link_with_id = 12 [json_name = "selfLinkWithId"]; - - // List of Projects/Folders to share with. - optional ShareSettings share_settings = 13 [json_name = "shareSettings"]; - - // Future Reservation configuration to indicate instance properties and total - // count. - optional FutureReservationSpecificSKUProperties specific_sku_properties = 15 - [json_name = "specificSkuProperties"]; - - // [Output only] Status of the Future Reservation - optional FutureReservationStatus status = 16 [json_name = "status"]; - - // Time window for this Future Reservation. - optional FutureReservationTimeWindow time_window = 17 - [json_name = "timeWindow"]; - - // [Output Only] URL of the Zone where this future reservation resides. - optional string zone = 18 [json_name = "zone"]; -} - -message FutureReservationSpecificSKUProperties { - // Properties of the SKU instances being reserved. - optional AllocationSpecificSKUAllocationReservedInstanceProperties - instance_properties = 1 [json_name = "instanceProperties"]; - - // The instance template that will be used to populate the - // ReservedInstanceProperties of the future reservation - optional string source_instance_template = 2 - [json_name = "sourceInstanceTemplate"]; - - // Total number of instances for which capacity assurance is requested at a - // future time period. - optional string total_count = 3 [json_name = "totalCount"]; -} - -// [Output only] Represents status related to the future reservation. -message FutureReservationStatus { - // [Output Only] The current status of the requested amendment. - // AMENDMENT_APPROVED: The requested amendment to the Future Resevation has - // been approved and applied by GCP. - // AMENDMENT_DECLINED: The requested amendment to the Future Reservation has - // been declined by GCP and the original state was restored. - // AMENDMENT_IN_REVIEW: The requested amendment to the Future Reservation is - // currently being reviewd by GCP. - // AMENDMENT_STATUS_UNSPECIFIED: - optional string amendment_status = 1 [json_name = "amendmentStatus"]; - - // Fully qualified urls of the automatically created reservations at - // start_time. - repeated string auto_created_reservations = 2 - [json_name = "autoCreatedReservations"]; - - // [Output Only] Represents the existing matching usage for the future - // reservation. - optional FutureReservationStatusExistingMatchingUsageInfo - existing_matching_usage_info = 3 - [json_name = "existingMatchingUsageInfo"]; - - // This count indicates the fulfilled capacity so far. This is set during - // "PROVISIONING" state. This count also includes capacity delivered as part - // of existing matching reservations. - optional string fulfilled_count = 4 [json_name = "fulfilledCount"]; - - // [Output Only] This field represents the future reservation before an - // amendment was requested. If the amendment is declined, the Future - // Reservation will be reverted to the last known good state. The last known - // good state is not set when updating a future reservation whose Procurement - // Status is DRAFTING. - optional FutureReservationStatusLastKnownGoodState last_known_good_state = 5 - [json_name = "lastKnownGoodState"]; - - // Time when Future Reservation would become LOCKED, after which no - // modifications to Future Reservation will be allowed. Applicable only after - // the Future Reservation is in the APPROVED state. The lock_time is an - // RFC3339 string. The procurement_status will transition to PROCURING state - // at this time. - optional string lock_time = 6 [json_name = "lockTime"]; - - // Current state of this Future Reservation - // APPROVED: Future reservation is approved by GCP. - // CANCELLED: Future reservation is cancelled by the customer. - // COMMITTED: Future reservation is committed by the customer. - // DECLINED: Future reservation is rejected by GCP. - // DRAFTING: Related status for PlanningStatus.Draft. Transitions to - // PENDING_APPROVAL upon user submitting FR. - // FAILED: Future reservation failed. No additional reservations were - // provided. - // FAILED_PARTIALLY_FULFILLED: Future reservation is partially fulfilled. - // Additional reservations were provided but did not reach total_count - // reserved instance slots. - // FULFILLED: Future reservation is fulfilled completely. - // PENDING_AMENDMENT_APPROVAL: An Amendment to the Future Reservation has been - // requested. If the Amendment is declined, the Future Reservation will be - // restored to the last known good state. - // PENDING_APPROVAL: Future reservation is pending approval by GCP. - // PROCUREMENT_STATUS_UNSPECIFIED: - // PROCURING: Future reservation is being procured by GCP. Beyond this point, - // Future reservation is locked and no further modifications are allowed. - // PROVISIONING: Future reservation capacity is being provisioned. This state - // will be entered after start_time, while reservations are being created to - // provide total_count reserved instance slots. This state will not persist - // past start_time + 24h. - optional string procurement_status = 7 [json_name = "procurementStatus"]; - - optional FutureReservationStatusSpecificSKUProperties - specific_sku_properties = 8 [json_name = "specificSkuProperties"]; -} - -// [Output Only] Represents the existing matching usage for the future -// reservation. -message FutureReservationStatusExistingMatchingUsageInfo { - // Count to represent min(FR total_count, - // matching_reserved_capacity+matching_unreserved_instances) - optional string count = 1 [json_name = "count"]; - - // Timestamp when the matching usage was calculated - optional string timestamp = 2 [json_name = "timestamp"]; -} - -// The state that the future reservation will be reverted to should the -// amendment be declined. -message FutureReservationStatusLastKnownGoodState { - // [Output Only] The description of the FutureReservation before an amendment - // was requested. +message GlobalAddressesMoveRequest { + // An optional destination address description if intended to be different + // from the source. optional string description = 1 [json_name = "description"]; - // [Output Only] Represents the matching usage for the future reservation - // before an amendment was requested. - optional FutureReservationStatusExistingMatchingUsageInfo - existing_matching_usage_info = 2 - [json_name = "existingMatchingUsageInfo"]; - - optional FutureReservationStatusLastKnownGoodStateFutureReservationSpecs - future_reservation_specs = 3 [json_name = "futureReservationSpecs"]; - - // [Output Only] The lock time of the FutureReservation before an amendment - // was requested. - optional string lock_time = 4 [json_name = "lockTime"]; - - // [Output Only] The name prefix of the Future Reservation before an amendment - // was requested. - optional string name_prefix = 5 [json_name = "namePrefix"]; - - // [Output Only] The status of the last known good state for the Future - // Reservation. - // APPROVED: Future reservation is approved by GCP. - // CANCELLED: Future reservation is cancelled by the customer. - // COMMITTED: Future reservation is committed by the customer. - // DECLINED: Future reservation is rejected by GCP. - // DRAFTING: Related status for PlanningStatus.Draft. Transitions to - // PENDING_APPROVAL upon user submitting FR. - // FAILED: Future reservation failed. No additional reservations were - // provided. - // FAILED_PARTIALLY_FULFILLED: Future reservation is partially fulfilled. - // Additional reservations were provided but did not reach total_count - // reserved instance slots. - // FULFILLED: Future reservation is fulfilled completely. - // PENDING_AMENDMENT_APPROVAL: An Amendment to the Future Reservation has been - // requested. If the Amendment is declined, the Future Reservation will be - // restored to the last known good state. - // PENDING_APPROVAL: Future reservation is pending approval by GCP. - // PROCUREMENT_STATUS_UNSPECIFIED: - // PROCURING: Future reservation is being procured by GCP. Beyond this point, - // Future reservation is locked and no further modifications are allowed. - // PROVISIONING: Future reservation capacity is being provisioned. This state - // will be entered after start_time, while reservations are being created to - // provide total_count reserved instance slots. This state will not persist - // past start_time + 24h. - optional string procurement_status = 6 [json_name = "procurementStatus"]; -} - -// The properties of the last known good state for the Future Reservation. -message FutureReservationStatusLastKnownGoodStateFutureReservationSpecs { - // [Output Only] The previous share settings of the Future Reservation. - optional ShareSettings share_settings = 1 [json_name = "shareSettings"]; - - // [Output Only] The previous instance related properties of the Future - // Reservation. - optional FutureReservationSpecificSKUProperties specific_sku_properties = 2 - [json_name = "specificSkuProperties"]; - - // [Output Only] The previous time window of the Future Reservation. - optional FutureReservationTimeWindow time_window = 3 - [json_name = "timeWindow"]; -} - -// Properties to be set for the Future Reservation. -message FutureReservationStatusSpecificSKUProperties { - // ID of the instance template used to populate the Future Reservation - // properties. - optional string source_instance_template_id = 1 - [json_name = "sourceInstanceTemplateId"]; -} - -message FutureReservationTimeWindow { - optional Duration duration = 1 [json_name = "duration"]; - - optional string end_time = 2 [json_name = "endTime"]; - - // Start time of the Future Reservation. The start_time is an RFC3339 string. - optional string start_time = 3 [json_name = "startTime"]; -} - -// Contains a list of future reservations. -message FutureReservationsAggregatedListResponse { - optional string etag = 1 [json_name = "etag"]; - - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 2 [json_name = "id"]; - - // A list of Future reservation resources. - map items = 3 [json_name = "items"]; - - // [Output Only] Type of resource. Always - // compute#futureReservationsAggregatedListResponse for future resevation - // aggregated list response. - optional string kind = 4 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 5 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 6 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 7 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; -} - -message FutureReservationsListResponse { - optional string etag = 1 [json_name = "etag"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 2 [json_name = "id"]; - - // [Output Only] A list of future reservation resources. - repeated FutureReservation items = 3 [json_name = "items"]; - - // [Output Only] Type of resource.Always - // compute#FutureReservationsListResponse for lists of reservations - optional string kind = 4 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 5 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 6 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 7 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; -} - -message FutureReservationsScopedList { - // A list of future reservations contained in this scope. - repeated FutureReservation future_reservations = 1 - [json_name = "futureReservations"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of future reservations when - // the list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // The URL of the destination address to move to. This can be a full or + // partial URL. For example, the following are all valid URLs to a address: - + // https://www.googleapis.com/compute/v1/projects/project + // /global/addresses/address - projects/project/global/addresses/address Note + // that destination project must be different from the source project. So + // /global/addresses/address is not valid partial url. + optional string destination_address = 2 [json_name = "destinationAddress"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_044.proto b/protos/google/cloud/compute/v1/internal/common_044.proto index 197a849f143c0..b645e1c0c404c 100644 --- a/protos/google/cloud/compute/v1/internal/common_044.proto +++ b/protos/google/cloud/compute/v1/internal/common_044.proto @@ -15,574 +15,22 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message GRPCHealthCheck { - // The gRPC service name for the health check. This field is optional. The - // value of grpc_service_name has the following meanings by convention: - - // Empty service_name means the overall status of all services at the backend. - // - Non-empty service_name means the health of that gRPC service, as defined - // by the owner of the service. The grpc_service_name can only be ASCII. - optional string grpc_service_name = 1 [json_name = "grpcServiceName"]; +import "google/cloud/compute/v1/internal/common_012.proto"; - // The TCP port number to which the health check prober sends packets. Valid - // values are 1 through 65535. - optional int32 port = 2 [json_name = "port"]; - - // Not supported. - optional string port_name = 3 [json_name = "portName"]; - - // Specifies how a port is selected for health checking. Can be one of the - // following values: USE_FIXED_PORT: Specifies a port number explicitly using - // the port field in the health check. Supported by backend services for - // passthrough load balancers and backend services for proxy load balancers. - // Not supported by target pools. The health check supports all backends - // supported by the backend service provided the backend can be health - // checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT - // network endpoint groups, and instance group backends. USE_NAMED_PORT: Not - // supported. USE_SERVING_PORT: Provides an indirect method of specifying the - // health check port by referring to the backend service. Only supported by - // backend services for proxy load balancers. Not supported by target pools. - // Not supported by backend services for passthrough load balancers. Supports - // all backends that can be health checked; for example, GCE_VM_IP_PORT - // network endpoint groups and instance group backends. For GCE_VM_IP_PORT - // network endpoint group backends, the health check uses the port number - // specified for each endpoint in the network endpoint group. For instance - // group backends, the health check uses the port number determined by looking - // up the backend service's named port in the instance group's list of named - // ports. - // USE_FIXED_PORT: The port number in the health check's port is used for - // health checking. Applies to network endpoint group and instance group - // backends. - // USE_NAMED_PORT: Not supported. - // USE_SERVING_PORT: For network endpoint group backends, the health check - // uses the port number specified on each endpoint in the network endpoint - // group. For instance group backends, the health check uses the port number - // specified for the backend service's named port defined in the instance - // group's named ports. - optional string port_specification = 4 [json_name = "portSpecification"]; -} - -message HTTP2HealthCheck { - // The value of the host header in the HTTP/2 health check request. If left - // empty (default value), the host header is set to the destination IP address - // to which health check packets are sent. The destination IP address depends - // on the type of load balancer. For details, see: - // https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest - optional string host = 1 [json_name = "host"]; - - // The TCP port number to which the health check prober sends packets. The - // default value is 443. Valid values are 1 through 65535. - optional int32 port = 2 [json_name = "port"]; - - // Not supported. - optional string port_name = 3 [json_name = "portName"]; - - // Specifies how a port is selected for health checking. Can be one of the - // following values: USE_FIXED_PORT: Specifies a port number explicitly using - // the port field in the health check. Supported by backend services for - // passthrough load balancers and backend services for proxy load balancers. - // Not supported by target pools. The health check supports all backends - // supported by the backend service provided the backend can be health - // checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT - // network endpoint groups, and instance group backends. USE_NAMED_PORT: Not - // supported. USE_SERVING_PORT: Provides an indirect method of specifying the - // health check port by referring to the backend service. Only supported by - // backend services for proxy load balancers. Not supported by target pools. - // Not supported by backend services for passthrough load balancers. Supports - // all backends that can be health checked; for example, GCE_VM_IP_PORT - // network endpoint groups and instance group backends. For GCE_VM_IP_PORT - // network endpoint group backends, the health check uses the port number - // specified for each endpoint in the network endpoint group. For instance - // group backends, the health check uses the port number determined by looking - // up the backend service's named port in the instance group's list of named - // ports. - // USE_FIXED_PORT: The port number in the health check's port is used for - // health checking. Applies to network endpoint group and instance group - // backends. - // USE_NAMED_PORT: Not supported. - // USE_SERVING_PORT: For network endpoint group backends, the health check - // uses the port number specified on each endpoint in the network endpoint - // group. For instance group backends, the health check uses the port number - // specified for the backend service's named port defined in the instance - // group's named ports. - optional string port_specification = 4 [json_name = "portSpecification"]; - - // Specifies the type of proxy header to append before sending data to the - // backend, either NONE or PROXY_V1. The default is NONE. - // NONE: - // PROXY_V1: - optional string proxy_header = 5 [json_name = "proxyHeader"]; - - // The request path of the HTTP/2 health check request. The default value is - // /. Must comply with RFC3986. - optional string request_path = 6 [json_name = "requestPath"]; - - // Creates a content-based HTTP/2 health check. In addition to the required - // HTTP 200 (OK) status code, you can configure the health check to pass only - // when the backend sends this specific ASCII response string within the first - // 1024 bytes of the HTTP response body. For details, see: - // https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http - optional string response = 7 [json_name = "response"]; +message GlobalNetworkEndpointGroupsAttachEndpointsRequest { + // The list of network endpoints to be attached. + repeated NetworkEndpoint network_endpoints = 1 + [json_name = "networkEndpoints"]; } -message HTTPHealthCheck { - // The value of the host header in the HTTP health check request. If left - // empty (default value), the host header is set to the destination IP address - // to which health check packets are sent. The destination IP address depends - // on the type of load balancer. For details, see: - // https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest - optional string host = 1 [json_name = "host"]; - - // The TCP port number to which the health check prober sends packets. The - // default value is 80. Valid values are 1 through 65535. - optional int32 port = 2 [json_name = "port"]; - - // Not supported. - optional string port_name = 3 [json_name = "portName"]; - - // Specifies how a port is selected for health checking. Can be one of the - // following values: USE_FIXED_PORT: Specifies a port number explicitly using - // the port field in the health check. Supported by backend services for - // passthrough load balancers and backend services for proxy load balancers. - // Also supported in legacy HTTP health checks for target pools. The health - // check supports all backends supported by the backend service provided the - // backend can be health checked. For example, GCE_VM_IP network endpoint - // groups, GCE_VM_IP_PORT network endpoint groups, and instance group - // backends. USE_NAMED_PORT: Not supported. USE_SERVING_PORT: Provides an - // indirect method of specifying the health check port by referring to the - // backend service. Only supported by backend services for proxy load - // balancers. Not supported by target pools. Not supported by backend services - // for pass-through load balancers. Supports all backends that can be health - // checked; for example, GCE_VM_IP_PORT network endpoint groups and instance - // group backends. For GCE_VM_IP_PORT network endpoint group backends, the - // health check uses the port number specified for each endpoint in the - // network endpoint group. For instance group backends, the health check uses - // the port number determined by looking up the backend service's named port - // in the instance group's list of named ports. - // USE_FIXED_PORT: The port number in the health check's port is used for - // health checking. Applies to network endpoint group and instance group - // backends. - // USE_NAMED_PORT: Not supported. - // USE_SERVING_PORT: For network endpoint group backends, the health check - // uses the port number specified on each endpoint in the network endpoint - // group. For instance group backends, the health check uses the port number - // specified for the backend service's named port defined in the instance - // group's named ports. - optional string port_specification = 4 [json_name = "portSpecification"]; - - // Specifies the type of proxy header to append before sending data to the - // backend, either NONE or PROXY_V1. The default is NONE. - // NONE: - // PROXY_V1: - optional string proxy_header = 5 [json_name = "proxyHeader"]; - - // The request path of the HTTP health check request. The default value is /. - // Must comply with RFC3986. - optional string request_path = 6 [json_name = "requestPath"]; - - // Creates a content-based HTTP health check. In addition to the required HTTP - // 200 (OK) status code, you can configure the health check to pass only when - // the backend sends this specific ASCII response string within the first 1024 - // bytes of the HTTP response body. For details, see: - // https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http - optional string response = 7 [json_name = "response"]; -} - -message HTTPSHealthCheck { - // The value of the host header in the HTTPS health check request. If left - // empty (default value), the host header is set to the destination IP address - // to which health check packets are sent. The destination IP address depends - // on the type of load balancer. For details, see: - // https://cloud.google.com/load-balancing/docs/health-check-concepts#hc-packet-dest - optional string host = 1 [json_name = "host"]; - - // The TCP port number to which the health check prober sends packets. The - // default value is 443. Valid values are 1 through 65535. - optional int32 port = 2 [json_name = "port"]; - - // Not supported. - optional string port_name = 3 [json_name = "portName"]; - - // Specifies how a port is selected for health checking. Can be one of the - // following values: USE_FIXED_PORT: Specifies a port number explicitly using - // the port field in the health check. Supported by backend services for - // passthrough load balancers and backend services for proxy load balancers. - // Not supported by target pools. The health check supports all backends - // supported by the backend service provided the backend can be health - // checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT - // network endpoint groups, and instance group backends. USE_NAMED_PORT: Not - // supported. USE_SERVING_PORT: Provides an indirect method of specifying the - // health check port by referring to the backend service. Only supported by - // backend services for proxy load balancers. Not supported by target pools. - // Not supported by backend services for passthrough load balancers. Supports - // all backends that can be health checked; for example, GCE_VM_IP_PORT - // network endpoint groups and instance group backends. For GCE_VM_IP_PORT - // network endpoint group backends, the health check uses the port number - // specified for each endpoint in the network endpoint group. For instance - // group backends, the health check uses the port number determined by looking - // up the backend service's named port in the instance group's list of named - // ports. - // USE_FIXED_PORT: The port number in the health check's port is used for - // health checking. Applies to network endpoint group and instance group - // backends. - // USE_NAMED_PORT: Not supported. - // USE_SERVING_PORT: For network endpoint group backends, the health check - // uses the port number specified on each endpoint in the network endpoint - // group. For instance group backends, the health check uses the port number - // specified for the backend service's named port defined in the instance - // group's named ports. - optional string port_specification = 4 [json_name = "portSpecification"]; - - // Specifies the type of proxy header to append before sending data to the - // backend, either NONE or PROXY_V1. The default is NONE. - // NONE: - // PROXY_V1: - optional string proxy_header = 5 [json_name = "proxyHeader"]; - - // The request path of the HTTPS health check request. The default value is /. - // Must comply with RFC3986. - optional string request_path = 6 [json_name = "requestPath"]; - - // Creates a content-based HTTPS health check. In addition to the required - // HTTP 200 (OK) status code, you can configure the health check to pass only - // when the backend sends this specific ASCII response string within the first - // 1024 bytes of the HTTP response body. For details, see: - // https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-http - optional string response = 7 [json_name = "response"]; -} - -// Represents a health check resource. Google Compute Engine has two health -// check resources: * -// [Regional](/compute/docs/reference/rest/v1/regionHealthChecks) * -// [Global](/compute/docs/reference/rest/v1/healthChecks) These health check -// resources can be used for load balancing and for autohealing VMs in a managed -// instance group (MIG). **Load balancing** Health check requirements vary -// depending on the type of load balancer. For details about the type of health -// check supported for each load balancer and corresponding backend type, see -// Health checks overview: Load balancer guide. **Autohealing in MIGs** The -// health checks that you use for autohealing VMs in a MIG can be either -// regional or global. For more information, see Set up an application health -// check and autohealing. For more information, see Health checks overview. -message HealthCheck { - // How often (in seconds) to send a health check. The default value is 5 - // seconds. - optional int32 check_interval_sec = 1 [json_name = "checkIntervalSec"]; - - // [Output Only] Creation timestamp in 3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; - - optional GRPCHealthCheck grpc_health_check = 4 - [json_name = "grpcHealthCheck"]; - - // A so-far unhealthy instance will be marked healthy after this many - // consecutive successes. The default value is 2. - optional int32 healthy_threshold = 5 [json_name = "healthyThreshold"]; - - optional HTTP2HealthCheck http2_health_check = 6 - [json_name = "http2HealthCheck"]; - - optional HTTPHealthCheck http_health_check = 7 - [json_name = "httpHealthCheck"]; - - optional HTTPSHealthCheck https_health_check = 8 - [json_name = "httpsHealthCheck"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 9 [json_name = "id"]; - - // Type of the resource. - optional string kind = 10 [json_name = "kind"]; - - // Configure logging on this health check. - optional HealthCheckLogConfig log_config = 11 [json_name = "logConfig"]; - - // 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. For - // example, a name that is 1-63 characters long, matches the regular - // expression `[a-z]([-a-z0-9]*[a-z0-9])?`, and otherwise complies with - // RFC1035. This regular expression describes a name where the first character - // is a lowercase letter, and all following characters are a dash, lowercase - // letter, or digit, except the last character, which isn't a dash. - optional string name = 12 [json_name = "name"]; - - // [Output Only] Region where the health check resides. Not applicable to - // global health checks. - optional string region = 13 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 14 [json_name = "selfLink"]; - - // The list of cloud regions from which health checks are performed. If any - // regions are specified, then exactly 3 regions should be specified. The - // region names must be valid names of Google Cloud regions. This can only be - // set for global health check. If this list is non-empty, then there are - // restrictions on what other health check fields are supported and what other - // resources can use this health check: - SSL, HTTP2, and GRPC protocols are - // not supported. - The TCP request field is not supported. - The proxyHeader - // field for HTTP, HTTPS, and TCP is not supported. - The checkIntervalSec - // field must be at least 30. - The health check cannot be used with - // BackendService nor with managed instance group auto-healing. - repeated string source_regions = 20 [json_name = "sourceRegions"]; - - optional SSLHealthCheck ssl_health_check = 15 [json_name = "sslHealthCheck"]; - - optional TCPHealthCheck tcp_health_check = 16 [json_name = "tcpHealthCheck"]; - - // 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. - optional int32 timeout_sec = 17 [json_name = "timeoutSec"]; - - // Specifies the type of the healthCheck, either TCP, SSL, HTTP, HTTPS, HTTP2 - // or GRPC. Exactly one of the protocol-specific health check fields must be - // specified, which must match type field. - // GRPC: - // HTTP: - // HTTP2: - // HTTPS: - // INVALID: - // SSL: - // TCP: - optional string type = 18 [json_name = "type"]; - - // A so-far healthy instance will be marked unhealthy after this many - // consecutive failures. The default value is 2. - optional int32 unhealthy_threshold = 19 [json_name = "unhealthyThreshold"]; -} - -// Contains a list of HealthCheck resources. -message HealthCheckList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of HealthCheck resources. - repeated HealthCheck items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// Configuration of logging on a health check. If logging is enabled, logs will -// be exported to Stackdriver. -message HealthCheckLogConfig { - // Indicates whether or not to export logs. This is false by default, which - // means no health check logging will be done. - optional bool enable = 1 [json_name = "enable"]; -} - -message SSLHealthCheck { - // The TCP port number to which the health check prober sends packets. The - // default value is 443. Valid values are 1 through 65535. - optional int32 port = 1 [json_name = "port"]; - - // Not supported. - optional string port_name = 2 [json_name = "portName"]; - - // Specifies how a port is selected for health checking. Can be one of the - // following values: USE_FIXED_PORT: Specifies a port number explicitly using - // the port field in the health check. Supported by backend services for - // passthrough load balancers and backend services for proxy load balancers. - // Not supported by target pools. The health check supports all backends - // supported by the backend service provided the backend can be health - // checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT - // network endpoint groups, and instance group backends. USE_NAMED_PORT: Not - // supported. USE_SERVING_PORT: Provides an indirect method of specifying the - // health check port by referring to the backend service. Only supported by - // backend services for proxy load balancers. Not supported by target pools. - // Not supported by backend services for passthrough load balancers. Supports - // all backends that can be health checked; for example, GCE_VM_IP_PORT - // network endpoint groups and instance group backends. For GCE_VM_IP_PORT - // network endpoint group backends, the health check uses the port number - // specified for each endpoint in the network endpoint group. For instance - // group backends, the health check uses the port number determined by looking - // up the backend service's named port in the instance group's list of named - // ports. - // USE_FIXED_PORT: The port number in the health check's port is used for - // health checking. Applies to network endpoint group and instance group - // backends. - // USE_NAMED_PORT: Not supported. - // USE_SERVING_PORT: For network endpoint group backends, the health check - // uses the port number specified on each endpoint in the network endpoint - // group. For instance group backends, the health check uses the port number - // specified for the backend service's named port defined in the instance - // group's named ports. - optional string port_specification = 3 [json_name = "portSpecification"]; - - // Specifies the type of proxy header to append before sending data to the - // backend, either NONE or PROXY_V1. The default is NONE. - // NONE: - // PROXY_V1: - optional string proxy_header = 4 [json_name = "proxyHeader"]; - - // Instructs the health check prober to send this exact ASCII string, up to - // 1024 bytes in length, after establishing the TCP connection and SSL - // handshake. - optional string request = 5 [json_name = "request"]; - - // Creates a content-based SSL health check. In addition to establishing a TCP - // connection and the TLS handshake, you can configure the health check to - // pass only when the backend sends this exact response ASCII string, up to - // 1024 bytes in length. For details, see: - // https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp - optional string response = 6 [json_name = "response"]; -} - -message TCPHealthCheck { - // The TCP port number to which the health check prober sends packets. The - // default value is 80. Valid values are 1 through 65535. - optional int32 port = 1 [json_name = "port"]; - - // Not supported. - optional string port_name = 2 [json_name = "portName"]; - - // Specifies how a port is selected for health checking. Can be one of the - // following values: USE_FIXED_PORT: Specifies a port number explicitly using - // the port field in the health check. Supported by backend services for - // passthrough load balancers and backend services for proxy load balancers. - // Not supported by target pools. The health check supports all backends - // supported by the backend service provided the backend can be health - // checked. For example, GCE_VM_IP network endpoint groups, GCE_VM_IP_PORT - // network endpoint groups, and instance group backends. USE_NAMED_PORT: Not - // supported. USE_SERVING_PORT: Provides an indirect method of specifying the - // health check port by referring to the backend service. Only supported by - // backend services for proxy load balancers. Not supported by target pools. - // Not supported by backend services for passthrough load balancers. Supports - // all backends that can be health checked; for example, GCE_VM_IP_PORT - // network endpoint groups and instance group backends. For GCE_VM_IP_PORT - // network endpoint group backends, the health check uses the port number - // specified for each endpoint in the network endpoint group. For instance - // group backends, the health check uses the port number determined by looking - // up the backend service's named port in the instance group's list of named - // ports. - // USE_FIXED_PORT: The port number in the health check's port is used for - // health checking. Applies to network endpoint group and instance group - // backends. - // USE_NAMED_PORT: Not supported. - // USE_SERVING_PORT: For network endpoint group backends, the health check - // uses the port number specified on each endpoint in the network endpoint - // group. For instance group backends, the health check uses the port number - // specified for the backend service's named port defined in the instance - // group's named ports. - optional string port_specification = 3 [json_name = "portSpecification"]; - - // Specifies the type of proxy header to append before sending data to the - // backend, either NONE or PROXY_V1. The default is NONE. - // NONE: - // PROXY_V1: - optional string proxy_header = 4 [json_name = "proxyHeader"]; - - // Instructs the health check prober to send this exact ASCII string, up to - // 1024 bytes in length, after establishing the TCP connection. - optional string request = 5 [json_name = "request"]; - - // Creates a content-based TCP health check. In addition to establishing a TCP - // connection, you can configure the health check to pass only when the - // backend sends this exact response ASCII string, up to 1024 bytes in length. - // For details, see: - // https://cloud.google.com/load-balancing/docs/health-check-concepts#criteria-protocol-ssl-tcp - optional string response = 6 [json_name = "response"]; +message GlobalNetworkEndpointGroupsDetachEndpointsRequest { + // The list of network endpoints to be detached. + repeated NetworkEndpoint network_endpoints = 1 + [json_name = "networkEndpoints"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_045.proto b/protos/google/cloud/compute/v1/internal/common_045.proto index 3c09245508305..9580a0b750b5d 100644 --- a/protos/google/cloud/compute/v1/internal/common_045.proto +++ b/protos/google/cloud/compute/v1/internal/common_045.proto @@ -15,22 +15,23 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message GlobalAddressesMoveRequest { - // An optional destination address description if intended to be different - // from the source. - optional string description = 1 [json_name = "description"]; +message GlobalSetLabelsRequest { + // The fingerprint of the previous set of labels for this resource, used to + // detect conflicts. The fingerprint is initially generated by Compute Engine + // and changes after every request to modify or update labels. You must always + // provide an up-to-date fingerprint hash when updating or changing labels, + // otherwise the request will fail with error 412 conditionNotMet. Make a + // get() request to the resource to get the latest fingerprint. + optional string label_fingerprint = 1 [json_name = "labelFingerprint"]; - // The URL of the destination address to move to. This can be a full or - // partial URL. For example, the following are all valid URLs to a address: - - // https://www.googleapis.com/compute/v1/projects/project - // /global/addresses/address - projects/project/global/addresses/address Note - // that destination project must be different from the source project. So - // /global/addresses/address is not valid partial url. - optional string destination_address = 2 [json_name = "destinationAddress"]; + // A list of labels to apply for this resource. Each label must comply with + // the requirements for labels. For example, "webserver-frontend": "images". A + // label value can also be empty (e.g. "my-label": ""). + map labels = 2 [json_name = "labels"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_046.proto b/protos/google/cloud/compute/v1/internal/common_046.proto index 25810811a6650..48a23cb31e70f 100644 --- a/protos/google/cloud/compute/v1/internal/common_046.proto +++ b/protos/google/cloud/compute/v1/internal/common_046.proto @@ -15,22 +15,25 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_013.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; -message GlobalNetworkEndpointGroupsAttachEndpointsRequest { - // The list of network endpoints to be attached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; -} +message GlobalSetPolicyRequest { + // Flatten Policy to create a backward compatible wire-format. Deprecated. Use + // 'policy' to specify bindings. + repeated Binding bindings = 1 [json_name = "bindings"]; + + // Flatten Policy to create a backward compatible wire-format. Deprecated. Use + // 'policy' to specify the etag. + optional string etag = 2 [json_name = "etag"]; -message GlobalNetworkEndpointGroupsDetachEndpointsRequest { - // The list of network endpoints to be detached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; + // REQUIRED: The complete policy to be applied to the 'resource'. The size of + // the policy is limited to a few 10s of KB. An empty policy is in general a + // valid policy but certain services (like Projects) might reject them. + optional Policy policy = 3 [json_name = "policy"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_047.proto b/protos/google/cloud/compute/v1/internal/common_047.proto index b25e9dae5bfe4..e4cce19b4d684 100644 --- a/protos/google/cloud/compute/v1/internal/common_047.proto +++ b/protos/google/cloud/compute/v1/internal/common_047.proto @@ -15,23 +15,17 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message GlobalSetLabelsRequest { - // The fingerprint of the previous set of labels for this resource, used to - // detect conflicts. The fingerprint is initially generated by Compute Engine - // and changes after every request to modify or update labels. You must always - // provide an up-to-date fingerprint hash when updating or changing labels, - // otherwise the request will fail with error 412 conditionNotMet. Make a - // get() request to the resource to get the latest fingerprint. - optional string label_fingerprint = 1 [json_name = "labelFingerprint"]; - - // A list of labels to apply for this resource. Each label must comply with - // the requirements for labels. For example, "webserver-frontend": "images". A - // label value can also be empty (e.g. "my-label": ""). - map labels = 2 [json_name = "labels"]; +// A full or valid partial URL to a health check. For example, the following are +// valid URLs: - +// https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check +// - projects/project-id/global/httpHealthChecks/health-check - +// global/httpHealthChecks/health-check +message HealthCheckReference { + optional string health_check = 1 [json_name = "healthCheck"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_048.proto b/protos/google/cloud/compute/v1/internal/common_048.proto index da79f0f496f8d..57805d9aa4baa 100644 --- a/protos/google/cloud/compute/v1/internal/common_048.proto +++ b/protos/google/cloud/compute/v1/internal/common_048.proto @@ -15,25 +15,202 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_008.proto"; +// Represents a Health-Check as a Service resource. +message HealthCheckService { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; -message GlobalSetPolicyRequest { - // Flatten Policy to create a backward compatible wire-format. Deprecated. Use - // 'policy' to specify bindings. - repeated Binding bindings = 1 [json_name = "bindings"]; + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; - // Flatten Policy to create a backward compatible wire-format. Deprecated. Use - // 'policy' to specify the etag. - optional string etag = 2 [json_name = "etag"]; + // 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 HealthCheckService. An up-to-date fingerprint must be provided + // in order to patch/update the HealthCheckService; Otherwise, the request + // will fail with error 412 conditionNotMet. To see the latest fingerprint, + // make a get() request to retrieve the HealthCheckService. + optional string fingerprint = 3 [json_name = "fingerprint"]; - // REQUIRED: The complete policy to be applied to the 'resource'. The size of - // the policy is limited to a few 10s of KB. An empty policy is in general a - // valid policy but certain services (like Projects) might reject them. - optional Policy policy = 3 [json_name = "policy"]; + // A list of URLs to the HealthCheck resources. Must have at least one + // HealthCheck, and not more than 10 for regional HealthCheckService, and not + // more than 1 for global HealthCheckService. HealthCheck resources must have + // portSpecification=USE_SERVING_PORT or portSpecification=USE_FIXED_PORT. For + // regional HealthCheckService, the HealthCheck must be regional and in the + // same region. For global HealthCheckService, HealthCheck must be global. Mix + // of regional and global HealthChecks is not supported. Multiple regional + // HealthChecks must belong to the same region. Regional HealthChecks must + // belong to the same region as zones of NetworkEndpointGroups. For global + // HealthCheckService using global INTERNET_IP_PORT NetworkEndpointGroups, the + // global HealthChecks must specify sourceRegions, and HealthChecks that + // specify sourceRegions can only be used with global INTERNET_IP_PORT + // NetworkEndpointGroups. + repeated string health_checks = 4 [json_name = "healthChecks"]; + + // Optional. Policy for how the results from multiple health checks for the + // same endpoint are aggregated. Defaults to NO_AGGREGATION if unspecified. - + // NO_AGGREGATION. An EndpointHealth message is returned for each pair in the + // health check service. - AND. If any health check of an endpoint reports + // UNHEALTHY, then UNHEALTHY is the HealthState of the endpoint. If all health + // checks report HEALTHY, the HealthState of the endpoint is HEALTHY. . This + // is only allowed with regional HealthCheckService. + // AND: If any backend's health check reports UNHEALTHY, then UNHEALTHY is the + // HealthState of the entire health check service. If all backend's are + // healthy, the HealthState of the health check service is HEALTHY. + // NO_AGGREGATION: An EndpointHealth message is returned for each backend in + // the health check service. + optional string health_status_aggregation_policy = 5 + [json_name = "healthStatusAggregationPolicy"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // [Output only] Type of the resource. Always compute#healthCheckServicefor + // health check services. + optional string kind = 7 [json_name = "kind"]; + + // Name of the resource. 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. + optional string name = 8 [json_name = "name"]; + + // A list of URLs to the NetworkEndpointGroup resources. Must not have more + // than 100. For regional HealthCheckService, NEGs must be in zones in the + // region of the HealthCheckService. For global HealthCheckServices, the + // NetworkEndpointGroups must be global INTERNET_IP_PORT. + repeated string network_endpoint_groups = 9 + [json_name = "networkEndpointGroups"]; + + // A list of URLs to the NotificationEndpoint resources. Must not have more + // than 10. A list of endpoints for receiving notifications of change in + // health status. For regional HealthCheckService, NotificationEndpoint must + // be regional and in the same region. For global HealthCheckService, + // NotificationEndpoint must be global. + repeated string notification_endpoints = 10 + [json_name = "notificationEndpoints"]; + + // [Output Only] URL of the region where the health check service resides. + // This field is not applicable to global health check services. You must + // specify this field as part of the HTTP request URL. It is not settable as a + // field in the request body. + optional string region = 11 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 12 [json_name = "selfLink"]; +} + +message HealthCheckServicesList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of HealthCheckService resources. + repeated HealthCheckService items = 2 [json_name = "items"]; + + // [Output Only] Type of the resource. Always compute#healthCheckServicesList + // for lists of HealthCheckServices. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_049.proto b/protos/google/cloud/compute/v1/internal/common_049.proto index d10a4278f7dab..700f8063ef0e1 100644 --- a/protos/google/cloud/compute/v1/internal/common_049.proto +++ b/protos/google/cloud/compute/v1/internal/common_049.proto @@ -15,17 +15,208 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// A full or valid partial URL to a health check. For example, the following are -// valid URLs: - -// https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check -// - projects/project-id/global/httpHealthChecks/health-check - -// global/httpHealthChecks/health-check -message HealthCheckReference { - optional string health_check = 1 [json_name = "healthCheck"]; +import "google/cloud/compute/v1/internal/common_042.proto"; + +message HealthChecksAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of HealthChecksScopedList resources. + map items = 2 [json_name = "items"]; + + // Type of resource. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +message HealthChecksScopedList { + // A list of HealthChecks contained in this scope. + repeated HealthCheck health_checks = 1 [json_name = "healthChecks"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of backend services when the + // list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_050.proto b/protos/google/cloud/compute/v1/internal/common_050.proto index f0039cd7073b6..4b8f5f07db5c0 100644 --- a/protos/google/cloud/compute/v1/internal/common_050.proto +++ b/protos/google/cloud/compute/v1/internal/common_050.proto @@ -15,202 +15,64 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Health-Check as a Service resource. -message HealthCheckService { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "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 HealthCheckService. An up-to-date fingerprint must be provided - // in order to patch/update the HealthCheckService; Otherwise, the request - // will fail with error 412 conditionNotMet. To see the latest fingerprint, - // make a get() request to retrieve the HealthCheckService. - optional string fingerprint = 3 [json_name = "fingerprint"]; - - // A list of URLs to the HealthCheck resources. Must have at least one - // HealthCheck, and not more than 10 for regional HealthCheckService, and not - // more than 1 for global HealthCheckService. HealthCheck resources must have - // portSpecification=USE_SERVING_PORT or portSpecification=USE_FIXED_PORT. For - // regional HealthCheckService, the HealthCheck must be regional and in the - // same region. For global HealthCheckService, HealthCheck must be global. Mix - // of regional and global HealthChecks is not supported. Multiple regional - // HealthChecks must belong to the same region. Regional HealthChecks must - // belong to the same region as zones of NetworkEndpointGroups. For global - // HealthCheckService using global INTERNET_IP_PORT NetworkEndpointGroups, the - // global HealthChecks must specify sourceRegions, and HealthChecks that - // specify sourceRegions can only be used with global INTERNET_IP_PORT - // NetworkEndpointGroups. - repeated string health_checks = 4 [json_name = "healthChecks"]; - - // Optional. Policy for how the results from multiple health checks for the - // same endpoint are aggregated. Defaults to NO_AGGREGATION if unspecified. - - // NO_AGGREGATION. An EndpointHealth message is returned for each pair in the - // health check service. - AND. If any health check of an endpoint reports - // UNHEALTHY, then UNHEALTHY is the HealthState of the endpoint. If all health - // checks report HEALTHY, the HealthState of the endpoint is HEALTHY. . This - // is only allowed with regional HealthCheckService. - // AND: If any backend's health check reports UNHEALTHY, then UNHEALTHY is the - // HealthState of the entire health check service. If all backend's are - // healthy, the HealthState of the health check service is HEALTHY. - // NO_AGGREGATION: An EndpointHealth message is returned for each backend in - // the health check service. - optional string health_status_aggregation_policy = 5 - [json_name = "healthStatusAggregationPolicy"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 6 [json_name = "id"]; - - // [Output only] Type of the resource. Always compute#healthCheckServicefor - // health check services. - optional string kind = 7 [json_name = "kind"]; - - // Name of the resource. 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. - optional string name = 8 [json_name = "name"]; - - // A list of URLs to the NetworkEndpointGroup resources. Must not have more - // than 100. For regional HealthCheckService, NEGs must be in zones in the - // region of the HealthCheckService. For global HealthCheckServices, the - // NetworkEndpointGroups must be global INTERNET_IP_PORT. - repeated string network_endpoint_groups = 9 - [json_name = "networkEndpointGroups"]; - - // A list of URLs to the NotificationEndpoint resources. Must not have more - // than 10. A list of endpoints for receiving notifications of change in - // health status. For regional HealthCheckService, NotificationEndpoint must - // be regional and in the same region. For global HealthCheckService, - // NotificationEndpoint must be global. - repeated string notification_endpoints = 10 - [json_name = "notificationEndpoints"]; - - // [Output Only] URL of the region where the health check service resides. - // This field is not applicable to global health check services. You must - // specify this field as part of the HTTP request URL. It is not settable as a - // field in the request body. - optional string region = 11 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 12 [json_name = "selfLink"]; -} - -message HealthCheckServicesList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of HealthCheckService resources. - repeated HealthCheckService items = 2 [json_name = "items"]; - - // [Output Only] Type of the resource. Always compute#healthCheckServicesList - // for lists of HealthCheckServices. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; +message HealthStatus { + // Metadata defined as annotations for network endpoint. + map annotations = 1 [json_name = "annotations"]; + + // URL of the forwarding rule associated with the health status of the + // instance. + optional string forwarding_rule = 2 [json_name = "forwardingRule"]; + + // A forwarding rule IP address assigned to this instance. + optional string forwarding_rule_ip = 3 [json_name = "forwardingRuleIp"]; + + // Health state of the IPv4 address of the instance. + // HEALTHY: + // UNHEALTHY: + optional string health_state = 4 [json_name = "healthState"]; + + // URL of the instance resource. + optional string instance = 5 [json_name = "instance"]; + + // For target pool based Network Load Balancing, it indicates the forwarding + // rule's IP address assigned to this instance. For other types of load + // balancing, the field indicates VM internal ip. + optional string ip_address = 6 [json_name = "ipAddress"]; + + optional string ipv6_address = 10 [json_name = "ipv6Address"]; + + // Health state of the IPv6 address of the instance. + // HEALTHY: + // UNHEALTHY: + optional string ipv6_health_state = 11 [json_name = "ipv6HealthState"]; + + // The named port of the instance group, not necessarily the port that is + // health-checked. + optional int32 port = 7 [json_name = "port"]; + + optional string weight = 8 [json_name = "weight"]; + + // INVALID_WEIGHT: The response to a Health Check probe had the HTTP response + // header field X-Load-Balancing-Endpoint-Weight, but its content was invalid + // (i.e., not a non-negative single-precision floating-point number in decimal + // string representation). + // MISSING_WEIGHT: The response to a Health Check probe did not have the HTTP + // response header field X-Load-Balancing-Endpoint-Weight. + // UNAVAILABLE_WEIGHT: This is the value when the accompanied health status is + // either TIMEOUT (i.e.,the Health Check probe was not able to get a response + // in time) or UNKNOWN. For the latter, it should be typically because there + // has not been sufficient time to parse and report the weight for a new + // backend (which is with 0.0.0.0 ip address). However, it can be also due to + // an outage case for which the health status is explicitly reset to UNKNOWN. + // WEIGHT_NONE: This is the default value when WeightReportMode is DISABLE, + // and is also the initial value when WeightReportMode has just updated to + // ENABLE or DRY_RUN and there has not been sufficient time to parse and + // report the backend weight. + optional string weight_error = 9 [json_name = "weightError"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_051.proto b/protos/google/cloud/compute/v1/internal/common_051.proto index a3fb1560626c9..b7a23919552b5 100644 --- a/protos/google/cloud/compute/v1/internal/common_051.proto +++ b/protos/google/cloud/compute/v1/internal/common_051.proto @@ -15,20 +15,83 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_044.proto"; +// Represents a legacy HTTP Health Check resource. Legacy HTTP health checks are +// now only required by target pool-based network load balancers. For all other +// load balancers, including backend service-based network load balancers, and +// for managed instance group auto-healing, you must use modern (non-legacy) +// health checks. For more information, see Health checks overview . +message HttpHealthCheck { + // How often (in seconds) to send a health check. The default value is 5 + // seconds. + optional int32 check_interval_sec = 1 [json_name = "checkIntervalSec"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + // A so-far unhealthy instance will be marked healthy after this many + // consecutive successes. The default value is 2. + optional int32 healthy_threshold = 4 [json_name = "healthyThreshold"]; + + // 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. + optional string host = 5 [json_name = "host"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#httpHealthCheck for HTTP + // health checks. + optional string kind = 7 [json_name = "kind"]; + + // 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. + optional string name = 8 [json_name = "name"]; + + // The TCP port number for the HTTP health check request. The default value is + // 80. + optional int32 port = 9 [json_name = "port"]; + + // The request path of the HTTP health check request. The default value is /. + // This field does not support query parameters. Must comply with RFC3986. + optional string request_path = 10 [json_name = "requestPath"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 11 [json_name = "selfLink"]; + + // 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. + optional int32 timeout_sec = 12 [json_name = "timeoutSec"]; + + // A so-far healthy instance will be marked unhealthy after this many + // consecutive failures. The default value is 2. + optional int32 unhealthy_threshold = 13 [json_name = "unhealthyThreshold"]; +} -message HealthChecksAggregatedList { +// Contains a list of HttpHealthCheck resources. +message HttpHealthCheckList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of HealthChecksScopedList resources. - map items = 2 [json_name = "items"]; + // A list of HttpHealthCheck resources. + repeated HttpHealthCheck items = 2 [json_name = "items"]; // Type of resource. optional string kind = 3 [json_name = "kind"]; @@ -43,9 +106,6 @@ message HealthChecksAggregatedList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -128,95 +188,5 @@ message HealthChecksAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -message HealthChecksScopedList { - // A list of HealthChecks contained in this scope. - repeated HealthCheck health_checks = 1 [json_name = "healthChecks"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of backend services when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_052.proto b/protos/google/cloud/compute/v1/internal/common_052.proto index 34bb77bed2e3a..23df030536dd8 100644 --- a/protos/google/cloud/compute/v1/internal/common_052.proto +++ b/protos/google/cloud/compute/v1/internal/common_052.proto @@ -15,57 +15,178 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message HealthStatus { - // Metadata defined as annotations for network endpoint. - map annotations = 1 [json_name = "annotations"]; - - // URL of the forwarding rule associated with the health status of the - // instance. - optional string forwarding_rule = 2 [json_name = "forwardingRule"]; - - // A forwarding rule IP address assigned to this instance. - optional string forwarding_rule_ip = 3 [json_name = "forwardingRuleIp"]; - - // Health state of the IPv4 address of the instance. - // HEALTHY: - // UNHEALTHY: - optional string health_state = 4 [json_name = "healthState"]; - - // URL of the instance resource. - optional string instance = 5 [json_name = "instance"]; - - // For target pool based Network Load Balancing, it indicates the forwarding - // rule's IP address assigned to this instance. For other types of load - // balancing, the field indicates VM internal ip. - optional string ip_address = 6 [json_name = "ipAddress"]; - - // The named port of the instance group, not necessarily the port that is - // health-checked. - optional int32 port = 7 [json_name = "port"]; - - optional string weight = 8 [json_name = "weight"]; - - // INVALID_WEIGHT: The response to a Health Check probe had the HTTP response - // header field X-Load-Balancing-Endpoint-Weight, but its content was invalid - // (i.e., not a non-negative single-precision floating-point number in decimal - // string representation). - // MISSING_WEIGHT: The response to a Health Check probe did not have the HTTP - // response header field X-Load-Balancing-Endpoint-Weight. - // UNAVAILABLE_WEIGHT: This is the value when the accompanied health status is - // either TIMEOUT (i.e.,the Health Check probe was not able to get a response - // in time) or UNKNOWN. For the latter, it should be typically because there - // has not been sufficient time to parse and report the weight for a new - // backend (which is with 0.0.0.0 ip address). However, it can be also due to - // an outage case for which the health status is explicitly reset to UNKNOWN. - // WEIGHT_NONE: This is the default value when WeightReportMode is DISABLE, - // and is also the initial value when WeightReportMode has just updated to - // ENABLE or DRY_RUN and there has not been sufficient time to parse and - // report the backend weight. - optional string weight_error = 9 [json_name = "weightError"]; +// Represents a legacy HTTPS Health Check resource. Legacy HTTPS health checks +// have been deprecated. If you are using a target pool-based network load +// balancer, you must use a legacy HTTP (not HTTPS) health check. For all other +// load balancers, including backend service-based network load balancers, and +// for managed instance group auto-healing, you must use modern (non-legacy) +// health checks. For more information, see Health checks overview . +message HttpsHealthCheck { + // How often (in seconds) to send a health check. The default value is 5 + // seconds. + optional int32 check_interval_sec = 1 [json_name = "checkIntervalSec"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + // A so-far unhealthy instance will be marked healthy after this many + // consecutive successes. The default value is 2. + optional int32 healthy_threshold = 4 [json_name = "healthyThreshold"]; + + // The value of the host header in the HTTPS health check request. If left + // empty (default value), the public IP on behalf of which this health check + // is performed will be used. + optional string host = 5 [json_name = "host"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // Type of the resource. + optional string kind = 7 [json_name = "kind"]; + + // 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. + optional string name = 8 [json_name = "name"]; + + // The TCP port number for the HTTPS health check request. The default value + // is 443. + optional int32 port = 9 [json_name = "port"]; + + // The request path of the HTTPS health check request. The default value is + // "/". Must comply with RFC3986. + optional string request_path = 10 [json_name = "requestPath"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 11 [json_name = "selfLink"]; + + // How long (in seconds) to wait before claiming failure. The default value is + // 5 seconds. It is invalid for timeoutSec to have a greater value than + // checkIntervalSec. + optional int32 timeout_sec = 12 [json_name = "timeoutSec"]; + + // A so-far healthy instance will be marked unhealthy after this many + // consecutive failures. The default value is 2. + optional int32 unhealthy_threshold = 13 [json_name = "unhealthyThreshold"]; +} + +// Contains a list of HttpsHealthCheck resources. +message HttpsHealthCheckList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of HttpsHealthCheck resources. + repeated HttpsHealthCheck items = 2 [json_name = "items"]; + + // Type of resource. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_053.proto b/protos/google/cloud/compute/v1/internal/common_053.proto index 6bf9ccb0bdc17..cf0484a23d842 100644 --- a/protos/google/cloud/compute/v1/internal/common_053.proto +++ b/protos/google/cloud/compute/v1/internal/common_053.proto @@ -15,178 +15,218 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a legacy HTTP Health Check resource. Legacy HTTP health checks are -// now only required by target pool-based network load balancers. For all other -// load balancers, including backend service-based network load balancers, and -// for managed instance group auto-healing, you must use modern (non-legacy) -// health checks. For more information, see Health checks overview . -message HttpHealthCheck { - // How often (in seconds) to send a health check. The default value is 5 - // seconds. - optional int32 check_interval_sec = 1 [json_name = "checkIntervalSec"]; +import "google/cloud/compute/v1/internal/common_020.proto"; +import "google/cloud/compute/v1/internal/common_022.proto"; +import "google/cloud/compute/v1/internal/common_033.proto"; + +// Represents an Image resource. You can use images to create boot disks for +// your VM instances. For more information, read Images. +message Image { + // The architecture of the image. Valid values are ARM64 or X86_64. + // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. + // ARM64: Machines with architecture ARM64 + // X86_64: Machines with architecture X86_64 + optional string architecture = 1 [json_name = "architecture"]; + + // Size of the image tar.gz archive stored in Google Cloud Storage (in bytes). + optional string archive_size_bytes = 2 [json_name = "archiveSizeBytes"]; // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + + // The deprecation status associated with this image. + optional DeprecationStatus deprecated = 4 [json_name = "deprecated"]; // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 3 [json_name = "description"]; - - // A so-far unhealthy instance will be marked healthy after this many - // consecutive successes. The default value is 2. - optional int32 healthy_threshold = 4 [json_name = "healthyThreshold"]; - - // 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. - optional string host = 5 [json_name = "host"]; + optional string description = 5 [json_name = "description"]; + + // Size of the image when restored onto a persistent disk (in GB). + optional string disk_size_gb = 6 [json_name = "diskSizeGb"]; + + // Whether this image is created from a confidential compute mode disk. + // [Output Only]: This field is not set by user, but from source disk. + optional bool enable_confidential_compute = 33 + [json_name = "enableConfidentialCompute"]; + + // The name of the image family to which this image belongs. The image family + // name can be from a publicly managed image family provided by Compute + // Engine, or from a custom image family you create. For example, + // centos-stream-9 is a publicly available image family. For more information, + // see Image family best practices. When creating disks, you can specify an + // image family instead of a specific image name. The image family always + // returns its latest image that is not deprecated. The name of the image + // family must comply with RFC1035. + optional string family = 7 [json_name = "family"]; + + // A list of features to enable on the guest operating system. Applicable only + // for bootable images. To see a list of available options, see the + // guestOSfeatures[].type parameter. + repeated GuestOsFeature guest_os_features = 8 [json_name = "guestOsFeatures"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 6 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#httpHealthCheck for HTTP - // health checks. - optional string kind = 7 [json_name = "kind"]; - - // Name of the resource. Provided by the client when the resource is created. + optional string id = 9 [json_name = "id"]; + + // Encrypts the image using a customer-supplied encryption key. After you + // encrypt an image with a customer-supplied key, you must provide the same + // key if you use the image later (e.g. to create a disk from the image). + // Customer-supplied encryption keys do not protect access to metadata of the + // disk. If you do not provide an encryption key when creating the image, then + // the disk will be encrypted using an automatically generated key and you do + // not need to provide a key to use the image later. + optional CustomerEncryptionKey image_encryption_key = 10 + [json_name = "imageEncryptionKey"]; + + // [Output Only] Type of the resource. Always compute#image for images. + optional string kind = 11 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this image, which is + // essentially a hash of the labels used for optimistic locking. The + // fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels, otherwise + // the request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve an image. + optional string label_fingerprint = 12 [json_name = "labelFingerprint"]; + + // Labels to apply to this image. These can be later modified by the setLabels + // method. + map labels = 13 [json_name = "labels"]; + + // Integer license codes indicating which licenses are attached to this image. + repeated string license_codes = 14 [json_name = "licenseCodes"]; + + // Any applicable license URI. + repeated string licenses = 15 [json_name = "licenses"]; + + // 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. - optional string name = 8 [json_name = "name"]; - - // The TCP port number for the HTTP health check request. The default value is - // 80. - optional int32 port = 9 [json_name = "port"]; - - // The request path of the HTTP health check request. The default value is /. - // This field does not support query parameters. Must comply with RFC3986. - optional string request_path = 10 [json_name = "requestPath"]; + optional string name = 16 [json_name = "name"]; + + message RawDisk { + // The format used to encode and transmit the block device, which should be + // TAR. This is just a container and transmission format and not a runtime + // format. Provided by the client when the disk image is created. + // TAR: + optional string container_type = 1 [json_name = "containerType"]; + + // [Deprecated] This field is deprecated. An optional SHA1 checksum of the + // disk image before unpackaging provided by the client when the disk image + // is created. + optional string sha1_checksum = 2 [json_name = "sha1Checksum"]; + + // The full Google Cloud Storage URL where the raw disk image archive is + // stored. The following are valid formats for the URL: - + // https://storage.googleapis.com/bucket_name/image_archive_name - + // https://storage.googleapis.com/bucket_name/folder_name/ + // image_archive_name In order to create an image, you must provide the full + // or partial URL of one of the following: - The rawDisk.source URL - The + // sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + optional string source = 3 [json_name = "source"]; + } - // [Output Only] Server-defined URL for the resource. - optional string self_link = 11 [json_name = "selfLink"]; + // The parameters of the raw disk image. + optional RawDisk raw_disk = 17 [json_name = "rawDisk"]; - // 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. - optional int32 timeout_sec = 12 [json_name = "timeoutSec"]; + // Output only. Reserved for future use. + optional bool satisfies_pzi = 34 [json_name = "satisfiesPzi"]; - // A so-far healthy instance will be marked unhealthy after this many - // consecutive failures. The default value is 2. - optional int32 unhealthy_threshold = 13 [json_name = "unhealthyThreshold"]; -} + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 18 [json_name = "satisfiesPzs"]; -// Contains a list of HttpHealthCheck resources. -message HttpHealthCheckList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of HttpHealthCheck resources. - repeated HttpHealthCheck items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + // [Output Only] Server-defined URL for the resource. + optional string self_link = 19 [json_name = "selfLink"]; + + // Set the secure boot keys of shielded instance. + optional InitialStateConfig shielded_instance_initial_state = 20 + [json_name = "shieldedInstanceInitialState"]; + + // URL of the source disk used to create this image. For example, the + // following are valid values: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /disks/disk - projects/project/zones/zone/disks/disk - + // zones/zone/disks/disk In order to create an image, you must provide the + // full or partial URL of one of the following: - The rawDisk.source URL - The + // sourceDisk URL - The sourceImage URL - The sourceSnapshot URL + optional string source_disk = 21 [json_name = "sourceDisk"]; + + // The customer-supplied encryption key of the source disk. Required if the + // source disk is protected by a customer-supplied encryption key. + optional CustomerEncryptionKey source_disk_encryption_key = 22 + [json_name = "sourceDiskEncryptionKey"]; + + // [Output Only] 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. + optional string source_disk_id = 23 [json_name = "sourceDiskId"]; + + // URL of the source image used to create this image. The following are valid + // formats for the URL: - + // https://www.googleapis.com/compute/v1/projects/project_id/global/ + // images/image_name - projects/project_id/global/images/image_name In order + // to create an image, you must provide the full or partial URL of one of the + // following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage + // URL - The sourceSnapshot URL + optional string source_image = 24 [json_name = "sourceImage"]; + + // The customer-supplied encryption key of the source image. Required if the + // source image is protected by a customer-supplied encryption key. + optional CustomerEncryptionKey source_image_encryption_key = 25 + [json_name = "sourceImageEncryptionKey"]; + + // [Output Only] The ID value of the image 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 image name. + optional string source_image_id = 26 [json_name = "sourceImageId"]; + + // URL of the source snapshot used to create this image. The following are + // valid formats for the URL: - + // https://www.googleapis.com/compute/v1/projects/project_id/global/ + // snapshots/snapshot_name - + // projects/project_id/global/snapshots/snapshot_name In order to create an + // image, you must provide the full or partial URL of one of the following: - + // The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The + // sourceSnapshot URL + optional string source_snapshot = 27 [json_name = "sourceSnapshot"]; + + // The customer-supplied encryption key of the source snapshot. Required if + // the source snapshot is protected by a customer-supplied encryption key. + optional CustomerEncryptionKey source_snapshot_encryption_key = 28 + [json_name = "sourceSnapshotEncryptionKey"]; + + // [Output Only] The ID value of the snapshot used to create this image. This + // value may be used to determine whether the snapshot was taken from the + // current or a previous instance of a given snapshot name. + optional string source_snapshot_id = 29 [json_name = "sourceSnapshotId"]; + + // The type of the image used to create this disk. The default and only valid + // value is RAW. + // RAW: + optional string source_type = 30 [json_name = "sourceType"]; + + // [Output Only] The status of the image. An image can be used to create other + // resources, such as instances, only after the image has been successfully + // created and the status is set to READY. Possible values are FAILED, + // PENDING, or READY. + // DELETING: Image is deleting. + // FAILED: Image creation failed due to an error. + // PENDING: Image hasn't been created as yet. + // READY: Image has been successfully created. + optional string status = 31 [json_name = "status"]; + + // Cloud Storage bucket storage location of the image (regional or + // multi-regional). + repeated string storage_locations = 32 [json_name = "storageLocations"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_054.proto b/protos/google/cloud/compute/v1/internal/common_054.proto index 8d4983917acaa..fd719c68e0840 100644 --- a/protos/google/cloud/compute/v1/internal/common_054.proto +++ b/protos/google/cloud/compute/v1/internal/common_054.proto @@ -15,178 +15,16 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a legacy HTTPS Health Check resource. Legacy HTTPS health checks -// have been deprecated. If you are using a target pool-based network load -// balancer, you must use a legacy HTTP (not HTTPS) health check. For all other -// load balancers, including backend service-based network load balancers, and -// for managed instance group auto-healing, you must use modern (non-legacy) -// health checks. For more information, see Health checks overview . -message HttpsHealthCheck { - // How often (in seconds) to send a health check. The default value is 5 - // seconds. - optional int32 check_interval_sec = 1 [json_name = "checkIntervalSec"]; +import "google/cloud/compute/v1/internal/common_053.proto"; - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; - - // A so-far unhealthy instance will be marked healthy after this many - // consecutive successes. The default value is 2. - optional int32 healthy_threshold = 4 [json_name = "healthyThreshold"]; - - // The value of the host header in the HTTPS health check request. If left - // empty (default value), the public IP on behalf of which this health check - // is performed will be used. - optional string host = 5 [json_name = "host"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 6 [json_name = "id"]; - - // Type of the resource. - optional string kind = 7 [json_name = "kind"]; - - // 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. - optional string name = 8 [json_name = "name"]; - - // The TCP port number for the HTTPS health check request. The default value - // is 443. - optional int32 port = 9 [json_name = "port"]; - - // The request path of the HTTPS health check request. The default value is - // "/". Must comply with RFC3986. - optional string request_path = 10 [json_name = "requestPath"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 11 [json_name = "selfLink"]; - - // How long (in seconds) to wait before claiming failure. The default value is - // 5 seconds. It is invalid for timeoutSec to have a greater value than - // checkIntervalSec. - optional int32 timeout_sec = 12 [json_name = "timeoutSec"]; - - // A so-far healthy instance will be marked unhealthy after this many - // consecutive failures. The default value is 2. - optional int32 unhealthy_threshold = 13 [json_name = "unhealthyThreshold"]; -} - -// Contains a list of HttpsHealthCheck resources. -message HttpsHealthCheckList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of HttpsHealthCheck resources. - repeated HttpsHealthCheck items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; +message ImageFamilyView { + // The latest image that is part of the specified image family in the + // requested location, and that is not deprecated. + optional Image image = 1 [json_name = "image"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_055.proto b/protos/google/cloud/compute/v1/internal/common_055.proto index 74378702afd26..eb9aa0b68f463 100644 --- a/protos/google/cloud/compute/v1/internal/common_055.proto +++ b/protos/google/cloud/compute/v1/internal/common_055.proto @@ -15,218 +15,116 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_021.proto"; -import "google/cloud/compute/v1/internal/common_023.proto"; -import "google/cloud/compute/v1/internal/common_034.proto"; - -// Represents an Image resource. You can use images to create boot disks for -// your VM instances. For more information, read Images. -message Image { - // The architecture of the image. Valid values are ARM64 or X86_64. - // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. - // ARM64: Machines with architecture ARM64 - // X86_64: Machines with architecture X86_64 - optional string architecture = 1 [json_name = "architecture"]; - - // Size of the image tar.gz archive stored in Google Cloud Storage (in bytes). - optional string archive_size_bytes = 2 [json_name = "archiveSizeBytes"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; - - // The deprecation status associated with this image. - optional DeprecationStatus deprecated = 4 [json_name = "deprecated"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 5 [json_name = "description"]; - - // Size of the image when restored onto a persistent disk (in GB). - optional string disk_size_gb = 6 [json_name = "diskSizeGb"]; - - // Whether this image is created from a confidential compute mode disk. - // [Output Only]: This field is not set by user, but from source disk. - optional bool enable_confidential_compute = 33 - [json_name = "enableConfidentialCompute"]; - - // The name of the image family to which this image belongs. The image family - // name can be from a publicly managed image family provided by Compute - // Engine, or from a custom image family you create. For example, - // centos-stream-9 is a publicly available image family. For more information, - // see Image family best practices. When creating disks, you can specify an - // image family instead of a specific image name. The image family always - // returns its latest image that is not deprecated. The name of the image - // family must comply with RFC1035. - optional string family = 7 [json_name = "family"]; - - // A list of features to enable on the guest operating system. Applicable only - // for bootable images. To see a list of available options, see the - // guestOSfeatures[].type parameter. - repeated GuestOsFeature guest_os_features = 8 [json_name = "guestOsFeatures"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 9 [json_name = "id"]; - - // Encrypts the image using a customer-supplied encryption key. After you - // encrypt an image with a customer-supplied key, you must provide the same - // key if you use the image later (e.g. to create a disk from the image). - // Customer-supplied encryption keys do not protect access to metadata of the - // disk. If you do not provide an encryption key when creating the image, then - // the disk will be encrypted using an automatically generated key and you do - // not need to provide a key to use the image later. - optional CustomerEncryptionKey image_encryption_key = 10 - [json_name = "imageEncryptionKey"]; - - // [Output Only] Type of the resource. Always compute#image for images. - optional string kind = 11 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this image, which is - // essentially a hash of the labels used for optimistic locking. The - // fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels, otherwise - // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve an image. - optional string label_fingerprint = 12 [json_name = "labelFingerprint"]; - - // Labels to apply to this image. These can be later modified by the setLabels - // method. - map labels = 13 [json_name = "labels"]; - - // Integer license codes indicating which licenses are attached to this image. - repeated string license_codes = 14 [json_name = "licenseCodes"]; - - // Any applicable license URI. - repeated string licenses = 15 [json_name = "licenses"]; - - // 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. - optional string name = 16 [json_name = "name"]; - - message RawDisk { - // The format used to encode and transmit the block device, which should be - // TAR. This is just a container and transmission format and not a runtime - // format. Provided by the client when the disk image is created. - // TAR: - optional string container_type = 1 [json_name = "containerType"]; - - // [Deprecated] This field is deprecated. An optional SHA1 checksum of the - // disk image before unpackaging provided by the client when the disk image - // is created. - optional string sha1_checksum = 2 [json_name = "sha1Checksum"]; - - // The full Google Cloud Storage URL where the raw disk image archive is - // stored. The following are valid formats for the URL: - - // https://storage.googleapis.com/bucket_name/image_archive_name - - // https://storage.googleapis.com/bucket_name/folder_name/ - // image_archive_name In order to create an image, you must provide the full - // or partial URL of one of the following: - The rawDisk.source URL - The - // sourceDisk URL - The sourceImage URL - The sourceSnapshot URL - optional string source = 3 [json_name = "source"]; +import "google/cloud/compute/v1/internal/common_053.proto"; + +// Contains a list of images. +message ImageList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of Image resources. + repeated Image items = 2 [json_name = "items"]; + + // Type of resource. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; } - // The parameters of the raw disk image. - optional RawDisk raw_disk = 17 [json_name = "rawDisk"]; - - // Output only. Reserved for future use. - optional bool satisfies_pzi = 34 [json_name = "satisfiesPzi"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzs = 18 [json_name = "satisfiesPzs"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 19 [json_name = "selfLink"]; - - // Set the secure boot keys of shielded instance. - optional InitialStateConfig shielded_instance_initial_state = 20 - [json_name = "shieldedInstanceInitialState"]; - - // URL of the source disk used to create this image. For example, the - // following are valid values: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /disks/disk - projects/project/zones/zone/disks/disk - - // zones/zone/disks/disk In order to create an image, you must provide the - // full or partial URL of one of the following: - The rawDisk.source URL - The - // sourceDisk URL - The sourceImage URL - The sourceSnapshot URL - optional string source_disk = 21 [json_name = "sourceDisk"]; - - // The customer-supplied encryption key of the source disk. Required if the - // source disk is protected by a customer-supplied encryption key. - optional CustomerEncryptionKey source_disk_encryption_key = 22 - [json_name = "sourceDiskEncryptionKey"]; - - // [Output Only] 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. - optional string source_disk_id = 23 [json_name = "sourceDiskId"]; - - // URL of the source image used to create this image. The following are valid - // formats for the URL: - - // https://www.googleapis.com/compute/v1/projects/project_id/global/ - // images/image_name - projects/project_id/global/images/image_name In order - // to create an image, you must provide the full or partial URL of one of the - // following: - The rawDisk.source URL - The sourceDisk URL - The sourceImage - // URL - The sourceSnapshot URL - optional string source_image = 24 [json_name = "sourceImage"]; - - // The customer-supplied encryption key of the source image. Required if the - // source image is protected by a customer-supplied encryption key. - optional CustomerEncryptionKey source_image_encryption_key = 25 - [json_name = "sourceImageEncryptionKey"]; - - // [Output Only] The ID value of the image 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 image name. - optional string source_image_id = 26 [json_name = "sourceImageId"]; - - // URL of the source snapshot used to create this image. The following are - // valid formats for the URL: - - // https://www.googleapis.com/compute/v1/projects/project_id/global/ - // snapshots/snapshot_name - - // projects/project_id/global/snapshots/snapshot_name In order to create an - // image, you must provide the full or partial URL of one of the following: - - // The rawDisk.source URL - The sourceDisk URL - The sourceImage URL - The - // sourceSnapshot URL - optional string source_snapshot = 27 [json_name = "sourceSnapshot"]; - - // The customer-supplied encryption key of the source snapshot. Required if - // the source snapshot is protected by a customer-supplied encryption key. - optional CustomerEncryptionKey source_snapshot_encryption_key = 28 - [json_name = "sourceSnapshotEncryptionKey"]; - - // [Output Only] The ID value of the snapshot used to create this image. This - // value may be used to determine whether the snapshot was taken from the - // current or a previous instance of a given snapshot name. - optional string source_snapshot_id = 29 [json_name = "sourceSnapshotId"]; - - // The type of the image used to create this disk. The default and only valid - // value is RAW. - // RAW: - optional string source_type = 30 [json_name = "sourceType"]; - - // [Output Only] The status of the image. An image can be used to create other - // resources, such as instances, only after the image has been successfully - // created and the status is set to READY. Possible values are FAILED, - // PENDING, or READY. - // DELETING: Image is deleting. - // FAILED: Image creation failed due to an error. - // PENDING: Image hasn't been created as yet. - // READY: Image has been successfully created. - optional string status = 31 [json_name = "status"]; - - // Cloud Storage bucket storage location of the image (regional or - // multi-regional). - repeated string storage_locations = 32 [json_name = "storageLocations"]; + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_056.proto b/protos/google/cloud/compute/v1/internal/common_056.proto index 9fcfa5a44ea30..525760c146d9b 100644 --- a/protos/google/cloud/compute/v1/internal/common_056.proto +++ b/protos/google/cloud/compute/v1/internal/common_056.proto @@ -15,16 +15,665 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_055.proto"; +import "google/cloud/compute/v1/internal/common_001.proto"; +import "google/cloud/compute/v1/internal/common_029.proto"; +import "google/cloud/compute/v1/internal/common_073.proto"; +import "google/cloud/compute/v1/internal/common_112.proto"; +import "google/cloud/compute/v1/internal/common_138.proto"; -message ImageFamilyView { - // The latest image that is part of the specified image family in the - // requested location, and that is not deprecated. - optional Image image = 1 [json_name = "image"]; +message InstanceConsumptionData { + // Resources consumed by the instance. + optional InstanceConsumptionInfo consumption_info = 1 + [json_name = "consumptionInfo"]; + + // Server-defined URL for the instance. + optional string instance = 2 [json_name = "instance"]; +} + +message InstanceConsumptionInfo { + // The number of virtual CPUs that are available to the instance. + optional int32 guest_cpus = 1 [json_name = "guestCpus"]; + + // The amount of local SSD storage available to the instance, defined in GiB. + optional int32 local_ssd_gb = 2 [json_name = "localSsdGb"]; + + // The amount of physical memory available to the instance, defined in MiB. + optional int32 memory_mb = 3 [json_name = "memoryMb"]; + + // The minimal guaranteed number of virtual CPUs that are reserved. + optional int32 min_node_cpus = 4 [json_name = "minNodeCpus"]; +} + +// Represents a sole-tenant Node Group resource. A sole-tenant node is a +// physical server that is dedicated to hosting VM instances only for your +// specific project. Use sole-tenant nodes to keep your instances physically +// separated from instances in other projects, or to group your instances +// together on the same host hardware. For more information, read Sole-tenant +// nodes. +message NodeGroup { + // Specifies how autoscaling should behave. + optional NodeGroupAutoscalingPolicy autoscaling_policy = 1 + [json_name = "autoscalingPolicy"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + optional string fingerprint = 4 [json_name = "fingerprint"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 5 [json_name = "id"]; + + // [Output Only] The type of the resource. Always compute#nodeGroup for node + // group. + optional string kind = 6 [json_name = "kind"]; + + // An opaque location hint used to place the Node close to other resources. + // This field is for use by internal tools that use the public API. The + // location hint here on the NodeGroup overrides any location_hint present in + // the NodeTemplate. + optional string location_hint = 7 [json_name = "locationHint"]; + + // Specifies the frequency of planned maintenance events. The accepted values + // are: `AS_NEEDED` and `RECURRENT`. + // AS_NEEDED: VMs are eligible to receive infrastructure and hypervisor + // updates as they become available. This may result in more maintenance + // operations (live migrations or terminations) for the VM than the PERIODIC + // and RECURRENT options. + // RECURRENT: VMs receive infrastructure and hypervisor updates on a periodic + // basis, minimizing the number of maintenance operations (live migrations or + // terminations) on an individual VM. This may mean a VM will take longer to + // receive an update than if it was configured for AS_NEEDED. Security updates + // will still be applied as soon as they are available. RECURRENT is used for + // GEN3 and Slice of Hardware VMs. + optional string maintenance_interval = 17 [json_name = "maintenanceInterval"]; + + // Specifies how to handle instances when a node in the group undergoes + // maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or + // MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more + // information, see Maintenance policies. + // DEFAULT: Allow the node and corresponding instances to retain default + // maintenance behavior. + // MAINTENANCE_POLICY_UNSPECIFIED: + // MIGRATE_WITHIN_NODE_GROUP: When maintenance must be done on a node, the + // instances on that node will be moved to other nodes in the group. Instances + // with onHostMaintenance = MIGRATE will live migrate to their destinations + // while instances with onHostMaintenance = TERMINATE will terminate and then + // restart on their destination nodes if automaticRestart = true. + // RESTART_IN_PLACE: Instances in this group will restart on the same node + // when maintenance has completed. Instances must have onHostMaintenance = + // TERMINATE, and they will only restart if automaticRestart = true. + optional string maintenance_policy = 8 [json_name = "maintenancePolicy"]; + + optional NodeGroupMaintenanceWindow maintenance_window = 9 + [json_name = "maintenanceWindow"]; + + // The name of the resource, provided by the client when initially creating + // the resource. The resource name must be 1-63 characters long, and comply + // with RFC1035. Specifically, the name must be 1-63 characters long and match + // the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + // character must be a lowercase letter, and all following characters must be + // a dash, lowercase letter, or digit, except the last character, which cannot + // be a dash. + optional string name = 10 [json_name = "name"]; + + // URL of the node template to create the node group from. + optional string node_template = 11 [json_name = "nodeTemplate"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 12 [json_name = "selfLink"]; + + // Share-settings for the node group + optional ShareSettings share_settings = 13 [json_name = "shareSettings"]; + + // [Output Only] The total number of nodes in the node group. + optional int32 size = 14 [json_name = "size"]; + + // CREATING: + // DELETING: + // INVALID: + // READY: + optional string status = 15 [json_name = "status"]; + + // [Output Only] The name of the zone where the node group resides, such as + // us-central1-a. + optional string zone = 16 [json_name = "zone"]; +} + +message NodeGroupAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of NodeGroupsScopedList resources. + map items = 2 [json_name = "items"]; + + // [Output Only] Type of resource.Always compute#nodeGroupAggregatedList for + // aggregated lists of node groups. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +message NodeGroupAutoscalingPolicy { + // The maximum number of nodes that the group should have. Must be set if + // autoscaling is enabled. Maximum value allowed is 100. + optional int32 max_nodes = 1 [json_name = "maxNodes"]; + + // The minimum number of nodes that the group should have. + optional int32 min_nodes = 2 [json_name = "minNodes"]; + + // The autoscaling mode. Set to one of: ON, OFF, or ONLY_SCALE_OUT. For more + // information, see Autoscaler modes. + // MODE_UNSPECIFIED: + // OFF: Autoscaling is disabled. + // ON: Autocaling is fully enabled. + // ONLY_SCALE_OUT: Autoscaling will only scale out and will not remove nodes. + optional string mode = 3 [json_name = "mode"]; +} + +// Contains a list of nodeGroups. +message NodeGroupList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of NodeGroup resources. + repeated NodeGroup items = 2 [json_name = "items"]; + + // [Output Only] Type of resource.Always compute#nodeGroupList for lists of + // node groups. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +// Time window specified for daily maintenance operations. GCE's internal +// maintenance will be performed within this window. +message NodeGroupMaintenanceWindow { + // [Output only] A predetermined duration for the window, automatically chosen + // to be the smallest possible in the given scenario. + optional Duration maintenance_duration = 1 + [json_name = "maintenanceDuration"]; + + // Start time of the window. This must be in UTC format that resolves to one + // of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 + // and 08:00 are valid. + optional string start_time = 2 [json_name = "startTime"]; +} + +message NodeGroupNode { + // Accelerators for this node. + repeated AcceleratorConfig accelerators = 1 [json_name = "accelerators"]; + + // Node resources that are reserved by all instances. + optional InstanceConsumptionInfo consumed_resources = 2 + [json_name = "consumedResources"]; + + // CPU overcommit. + // CPU_OVERCOMMIT_TYPE_UNSPECIFIED: + // ENABLED: + // NONE: + optional string cpu_overcommit_type = 3 [json_name = "cpuOvercommitType"]; + + // Local disk configurations. + repeated LocalDisk disks = 4 [json_name = "disks"]; + + // Instance data that shows consumed resources on the node. + repeated InstanceConsumptionData instance_consumption_data = 5 + [json_name = "instanceConsumptionData"]; + + // Instances scheduled on this node. + repeated string instances = 6 [json_name = "instances"]; + + // The name of the node. + optional string name = 7 [json_name = "name"]; + + // The type of this node. + optional string node_type = 8 [json_name = "nodeType"]; + + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 9 [json_name = "satisfiesPzs"]; + + // Binding properties for the physical server. + optional ServerBinding server_binding = 10 [json_name = "serverBinding"]; + + // Server ID associated with this node. + optional string server_id = 11 [json_name = "serverId"]; + + // CREATING: + // DELETING: + // INVALID: + // READY: + // REPAIRING: + optional string status = 12 [json_name = "status"]; + + // Total amount of available resources on the node. + optional InstanceConsumptionInfo total_resources = 13 + [json_name = "totalResources"]; + + // [Output Only] The information about an upcoming maintenance event. + optional UpcomingMaintenance upcoming_maintenance = 14 + [json_name = "upcomingMaintenance"]; +} + +message NodeGroupsAddNodesRequest { + // Count of additional nodes to be added to the node group. + optional int32 additional_node_count = 1 [json_name = "additionalNodeCount"]; +} + +message NodeGroupsDeleteNodesRequest { + // Names of the nodes to delete. + repeated string nodes = 1 [json_name = "nodes"]; +} + +message NodeGroupsListNodes { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of Node resources. + repeated NodeGroupNode items = 2 [json_name = "items"]; + + // [Output Only] The resource type, which is always + // compute.nodeGroupsListNodes for the list of nodes in the specified node + // group. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message NodeGroupsPerformMaintenanceRequest { + // [Required] List of nodes affected by the call. + repeated string nodes = 1 [json_name = "nodes"]; + + // The start time of the schedule. The timestamp is an RFC3339 string. + optional string start_time = 2 [json_name = "startTime"]; +} + +message NodeGroupsScopedList { + // [Output Only] A list of node groups contained in this scope. + repeated NodeGroup node_groups = 1 [json_name = "nodeGroups"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] An informational warning that appears when the nodeGroup list + // is empty. + optional Warning warning = 2 [json_name = "warning"]; +} + +message NodeGroupsSetNodeTemplateRequest { + // Full or partial URL of the node template resource to be updated for this + // node group. + optional string node_template = 1 [json_name = "nodeTemplate"]; +} + +message NodeGroupsSimulateMaintenanceEventRequest { + // Names of the nodes to go under maintenance simulation. + repeated string nodes = 1 [json_name = "nodes"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_057.proto b/protos/google/cloud/compute/v1/internal/common_057.proto index 5f33e9399e772..dcea255bb6c95 100644 --- a/protos/google/cloud/compute/v1/internal/common_057.proto +++ b/protos/google/cloud/compute/v1/internal/common_057.proto @@ -15,116 +15,105 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_055.proto"; - -// Contains a list of images. -message ImageList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of Image resources. - repeated Image items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; +import "google/cloud/compute/v1/internal/common_078.proto"; + +// Represents an Instance Group resource. Instance Groups can be used to +// configure a target for load balancing. Instance groups can either be managed +// or unmanaged. To create managed instance groups, use the instanceGroupManager +// or regionInstanceGroupManager resource instead. Use zonal unmanaged instance +// groups if you need to apply load balancing to groups of heterogeneous +// instances or if you need to manage the instances yourself. You cannot create +// regional unmanaged instance groups. For more information, read Instance +// groups. +message InstanceGroup { + // [Output Only] The creation timestamp for this instance group in RFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; + + // [Output Only] The fingerprint of the named ports. The system uses this + // fingerprint to detect conflicts when multiple users change the named ports + // concurrently. + optional string fingerprint = 3 [json_name = "fingerprint"]; + + // [Output Only] A unique identifier for this instance group, generated by the + // server. + optional string id = 4 [json_name = "id"]; + + // [Output Only] The resource type, which is always compute#instanceGroup for + // instance groups. + optional string kind = 5 [json_name = "kind"]; + + // The name of the instance group. The name must be 1-63 characters long, and + // comply with RFC1035. + optional string name = 6 [json_name = "name"]; + + // Assigns a name to a port number. For example: {name: "http", port: 80} + // This allows the system to reference ports by the assigned name instead of a + // port number. Named ports can also contain multiple ports. For example: + // [{name: "app1", port: 8080}, {name: "app1", port: 8081}, {name: "app2", + // port: 8082}] Named ports apply to all instances in this instance group. + repeated NamedPort named_ports = 7 [json_name = "namedPorts"]; + + // [Output Only] The URL of the network to which all instances in the instance + // group belong. If your instance has multiple network interfaces, then the + // network and subnetwork fields only refer to the network and subnet used by + // your primary interface (nic0). + optional string network = 8 [json_name = "network"]; + + // [Output Only] The URL of the region where the instance group is located + // (for regional resources). + optional string region = 9 [json_name = "region"]; + + // [Output Only] The URL for this instance group. The server generates this + // URL. + optional string self_link = 10 [json_name = "selfLink"]; + + // [Output Only] The total number of instances in the instance group. + optional int32 size = 11 [json_name = "size"]; + + // [Output Only] The URL of the subnetwork to which all instances in the + // instance group belong. If your instance has multiple network interfaces, + // then the network and subnetwork fields only refer to the network and subnet + // used by your primary interface (nic0). + optional string subnetwork = 12 [json_name = "subnetwork"]; + + // [Output Only] The URL of the zone where the instance group is located (for + // zonal resources). + optional string zone = 13 [json_name = "zone"]; +} + +message InstanceWithNamedPorts { + // [Output Only] The URL of the instance. + optional string instance = 1 [json_name = "instance"]; + + // [Output Only] The named ports that belong to this instance group. + repeated NamedPort named_ports = 2 [json_name = "namedPorts"]; + + // [Output Only] The status of the instance. + // DEPROVISIONING: The instance is halted and we are performing tear down + // tasks like network deprogramming, releasing quota, IP, tearing down disks + // etc. + // PROVISIONING: Resources are being allocated for the instance. + // REPAIRING: The instance is in repair. + // RUNNING: The instance is running. + // STAGING: All required resources have been allocated and the instance is + // being started. + // STOPPED: The instance has stopped successfully. + // STOPPING: The instance is currently stopping (either being deleted or + // killed). + // SUSPENDED: The instance has suspended. + // SUSPENDING: The instance is suspending. + // TERMINATED: The instance has stopped (either by explicit action or + // underlying failure). + optional string status = 3 [json_name = "status"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_058.proto b/protos/google/cloud/compute/v1/internal/common_058.proto index 10ebde14d0cbf..4095bf12fd101 100644 --- a/protos/google/cloud/compute/v1/internal/common_058.proto +++ b/protos/google/cloud/compute/v1/internal/common_058.proto @@ -15,150 +15,26 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_001.proto"; -import "google/cloud/compute/v1/internal/common_030.proto"; -import "google/cloud/compute/v1/internal/common_075.proto"; -import "google/cloud/compute/v1/internal/common_114.proto"; -import "google/cloud/compute/v1/internal/common_140.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_061.proto"; +import "google/cloud/compute/v1/internal/common_078.proto"; -message InstanceConsumptionData { - // Resources consumed by the instance. - optional InstanceConsumptionInfo consumption_info = 1 - [json_name = "consumptionInfo"]; - - // Server-defined URL for the instance. - optional string instance = 2 [json_name = "instance"]; -} - -message InstanceConsumptionInfo { - // The number of virtual CPUs that are available to the instance. - optional int32 guest_cpus = 1 [json_name = "guestCpus"]; - - // The amount of local SSD storage available to the instance, defined in GiB. - optional int32 local_ssd_gb = 2 [json_name = "localSsdGb"]; - - // The amount of physical memory available to the instance, defined in MiB. - optional int32 memory_mb = 3 [json_name = "memoryMb"]; - - // The minimal guaranteed number of virtual CPUs that are reserved. - optional int32 min_node_cpus = 4 [json_name = "minNodeCpus"]; -} - -// Represents a sole-tenant Node Group resource. A sole-tenant node is a -// physical server that is dedicated to hosting VM instances only for your -// specific project. Use sole-tenant nodes to keep your instances physically -// separated from instances in other projects, or to group your instances -// together on the same host hardware. For more information, read Sole-tenant -// nodes. -message NodeGroup { - // Specifies how autoscaling should behave. - optional NodeGroupAutoscalingPolicy autoscaling_policy = 1 - [json_name = "autoscalingPolicy"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; - - optional string fingerprint = 4 [json_name = "fingerprint"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 5 [json_name = "id"]; - - // [Output Only] The type of the resource. Always compute#nodeGroup for node - // group. - optional string kind = 6 [json_name = "kind"]; - - // An opaque location hint used to place the Node close to other resources. - // This field is for use by internal tools that use the public API. The - // location hint here on the NodeGroup overrides any location_hint present in - // the NodeTemplate. - optional string location_hint = 7 [json_name = "locationHint"]; - - // Specifies the frequency of planned maintenance events. The accepted values - // are: `AS_NEEDED` and `RECURRENT`. - // AS_NEEDED: VMs are eligible to receive infrastructure and hypervisor - // updates as they become available. This may result in more maintenance - // operations (live migrations or terminations) for the VM than the PERIODIC - // and RECURRENT options. - // RECURRENT: VMs receive infrastructure and hypervisor updates on a periodic - // basis, minimizing the number of maintenance operations (live migrations or - // terminations) on an individual VM. This may mean a VM will take longer to - // receive an update than if it was configured for AS_NEEDED. Security updates - // will still be applied as soon as they are available. RECURRENT is used for - // GEN3 and Slice of Hardware VMs. - optional string maintenance_interval = 17 [json_name = "maintenanceInterval"]; - - // Specifies how to handle instances when a node in the group undergoes - // maintenance. Set to one of: DEFAULT, RESTART_IN_PLACE, or - // MIGRATE_WITHIN_NODE_GROUP. The default value is DEFAULT. For more - // information, see Maintenance policies. - // DEFAULT: Allow the node and corresponding instances to retain default - // maintenance behavior. - // MAINTENANCE_POLICY_UNSPECIFIED: - // MIGRATE_WITHIN_NODE_GROUP: When maintenance must be done on a node, the - // instances on that node will be moved to other nodes in the group. Instances - // with onHostMaintenance = MIGRATE will live migrate to their destinations - // while instances with onHostMaintenance = TERMINATE will terminate and then - // restart on their destination nodes if automaticRestart = true. - // RESTART_IN_PLACE: Instances in this group will restart on the same node - // when maintenance has completed. Instances must have onHostMaintenance = - // TERMINATE, and they will only restart if automaticRestart = true. - optional string maintenance_policy = 8 [json_name = "maintenancePolicy"]; - - optional NodeGroupMaintenanceWindow maintenance_window = 9 - [json_name = "maintenanceWindow"]; - - // The name of the resource, provided by the client when initially creating - // the resource. The resource name must be 1-63 characters long, and comply - // with RFC1035. Specifically, the name must be 1-63 characters long and match - // the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first - // character must be a lowercase letter, and all following characters must be - // a dash, lowercase letter, or digit, except the last character, which cannot - // be a dash. - optional string name = 10 [json_name = "name"]; - - // URL of the node template to create the node group from. - optional string node_template = 11 [json_name = "nodeTemplate"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 12 [json_name = "selfLink"]; - - // Share-settings for the node group - optional ShareSettings share_settings = 13 [json_name = "shareSettings"]; - - // [Output Only] The total number of nodes in the node group. - optional int32 size = 14 [json_name = "size"]; - - // CREATING: - // DELETING: - // INVALID: - // READY: - optional string status = 15 [json_name = "status"]; - - // [Output Only] The name of the zone where the node group resides, such as - // us-central1-a. - optional string zone = 16 [json_name = "zone"]; -} - -message NodeGroupAggregatedList { +message InstanceGroupAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of NodeGroupsScopedList resources. - map items = 2 [json_name = "items"]; + // A list of InstanceGroupsScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] Type of resource.Always compute#nodeGroupAggregatedList for - // aggregated lists of node groups. + // [Output Only] The resource type, which is always + // compute#instanceGroupAggregatedList for aggregated lists of instance + // groups. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -259,33 +135,16 @@ message NodeGroupAggregatedList { optional Warning warning = 7 [json_name = "warning"]; } -message NodeGroupAutoscalingPolicy { - // The maximum number of nodes that the group should have. Must be set if - // autoscaling is enabled. Maximum value allowed is 100. - optional int32 max_nodes = 1 [json_name = "maxNodes"]; - - // The minimum number of nodes that the group should have. - optional int32 min_nodes = 2 [json_name = "minNodes"]; - - // The autoscaling mode. Set to one of: ON, OFF, or ONLY_SCALE_OUT. For more - // information, see Autoscaler modes. - // MODE_UNSPECIFIED: - // OFF: Autoscaling is disabled. - // ON: Autocaling is fully enabled. - // ONLY_SCALE_OUT: Autoscaling will only scale out and will not remove nodes. - optional string mode = 3 [json_name = "mode"]; -} - -// Contains a list of nodeGroups. -message NodeGroupList { +// A list of InstanceGroup resources. +message InstanceGroupList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of NodeGroup resources. - repeated NodeGroup items = 2 [json_name = "items"]; + // A list of InstanceGroup resources. + repeated InstanceGroup items = 2 [json_name = "items"]; - // [Output Only] Type of resource.Always compute#nodeGroupList for lists of - // node groups. + // [Output Only] The resource type, which is always compute#instanceGroupList + // for instance group lists. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -383,95 +242,21 @@ message NodeGroupList { optional Warning warning = 6 [json_name = "warning"]; } -// Time window specified for daily maintenance operations. GCE's internal -// maintenance will be performed within this window. -message NodeGroupMaintenanceWindow { - // [Output only] A predetermined duration for the window, automatically chosen - // to be the smallest possible in the given scenario. - optional Duration maintenance_duration = 1 - [json_name = "maintenanceDuration"]; - - // Start time of the window. This must be in UTC format that resolves to one - // of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 - // and 08:00 are valid. - optional string start_time = 2 [json_name = "startTime"]; +message InstanceGroupsAddInstancesRequest { + // The list of instances to add to the instance group. + repeated InstanceReference instances = 1 [json_name = "instances"]; } -message NodeGroupNode { - // Accelerators for this node. - repeated AcceleratorConfig accelerators = 1 [json_name = "accelerators"]; - - // Node resources that are reserved by all instances. - optional InstanceConsumptionInfo consumed_resources = 2 - [json_name = "consumedResources"]; - - // CPU overcommit. - // CPU_OVERCOMMIT_TYPE_UNSPECIFIED: - // ENABLED: - // NONE: - optional string cpu_overcommit_type = 3 [json_name = "cpuOvercommitType"]; - - // Local disk configurations. - repeated LocalDisk disks = 4 [json_name = "disks"]; - - // Instance data that shows consumed resources on the node. - repeated InstanceConsumptionData instance_consumption_data = 5 - [json_name = "instanceConsumptionData"]; - - // Instances scheduled on this node. - repeated string instances = 6 [json_name = "instances"]; - - // The name of the node. - optional string name = 7 [json_name = "name"]; - - // The type of this node. - optional string node_type = 8 [json_name = "nodeType"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzs = 9 [json_name = "satisfiesPzs"]; - - // Binding properties for the physical server. - optional ServerBinding server_binding = 10 [json_name = "serverBinding"]; - - // Server ID associated with this node. - optional string server_id = 11 [json_name = "serverId"]; - - // CREATING: - // DELETING: - // INVALID: - // READY: - // REPAIRING: - optional string status = 12 [json_name = "status"]; - - // Total amount of available resources on the node. - optional InstanceConsumptionInfo total_resources = 13 - [json_name = "totalResources"]; - - // [Output Only] The information about an upcoming maintenance event. - optional UpcomingMaintenance upcoming_maintenance = 14 - [json_name = "upcomingMaintenance"]; -} - -message NodeGroupsAddNodesRequest { - // Count of additional nodes to be added to the node group. - optional int32 additional_node_count = 1 [json_name = "additionalNodeCount"]; -} - -message NodeGroupsDeleteNodesRequest { - // Names of the nodes to delete. - repeated string nodes = 1 [json_name = "nodes"]; -} - -message NodeGroupsListNodes { +message InstanceGroupsListInstances { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of Node resources. - repeated NodeGroupNode items = 2 [json_name = "items"]; + // A list of InstanceWithNamedPorts resources. + repeated InstanceWithNamedPorts items = 2 [json_name = "items"]; // [Output Only] The resource type, which is always - // compute.nodeGroupsListNodes for the list of nodes in the specified node - // group. + // compute#instanceGroupsListInstances for the list of instances in the + // specified instance group. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -569,17 +354,25 @@ message NodeGroupsListNodes { optional Warning warning = 6 [json_name = "warning"]; } -message NodeGroupsPerformMaintenanceRequest { - // [Required] List of nodes affected by the call. - repeated string nodes = 1 [json_name = "nodes"]; +message InstanceGroupsListInstancesRequest { + // 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. + // ALL: Includes all instances in the generated list regardless of their + // state. + // RUNNING: Includes instances in the generated list only if they have a + // RUNNING state. + optional string instance_state = 1 [json_name = "instanceState"]; +} - // The start time of the schedule. The timestamp is an RFC3339 string. - optional string start_time = 2 [json_name = "startTime"]; +message InstanceGroupsRemoveInstancesRequest { + // The list of instances to remove from the instance group. + repeated InstanceReference instances = 1 [json_name = "instances"]; } -message NodeGroupsScopedList { - // [Output Only] A list of node groups contained in this scope. - repeated NodeGroup node_groups = 1 [json_name = "nodeGroups"]; +message InstanceGroupsScopedList { + // [Output Only] The list of instance groups that are contained in this scope. + repeated InstanceGroup instance_groups = 1 [json_name = "instanceGroups"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -662,18 +455,21 @@ message NodeGroupsScopedList { optional string message = 3 [json_name = "message"]; } - // [Output Only] An informational warning that appears when the nodeGroup list - // is empty. + // [Output Only] An informational warning that replaces the list of instance + // groups when the list is empty. optional Warning warning = 2 [json_name = "warning"]; } -message NodeGroupsSetNodeTemplateRequest { - // Full or partial URL of the node template resource to be updated for this - // node group. - optional string node_template = 1 [json_name = "nodeTemplate"]; -} - -message NodeGroupsSimulateMaintenanceEventRequest { - // Names of the nodes to go under maintenance simulation. - repeated string nodes = 1 [json_name = "nodes"]; +message InstanceGroupsSetNamedPortsRequest { + // The fingerprint of the named ports information for this instance group. Use + // this optional property to prevent conflicts when multiple users change the + // named ports settings concurrently. Obtain the fingerprint with the + // instanceGroups.get method. Then, include the fingerprint in your request to + // ensure that you do not overwrite changes that were applied from another + // concurrent request. A request with an incorrect fingerprint will fail with + // error 412 conditionNotMet. + optional string fingerprint = 1 [json_name = "fingerprint"]; + + // The list of named ports to set for this instance group. + repeated NamedPort named_ports = 2 [json_name = "namedPorts"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_059.proto b/protos/google/cloud/compute/v1/internal/common_059.proto index fff56b3053445..7b424d68f9853 100644 --- a/protos/google/cloud/compute/v1/internal/common_059.proto +++ b/protos/google/cloud/compute/v1/internal/common_059.proto @@ -15,105 +15,565 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_080.proto"; - -// Represents an Instance Group resource. Instance Groups can be used to -// configure a target for load balancing. Instance groups can either be managed -// or unmanaged. To create managed instance groups, use the instanceGroupManager -// or regionInstanceGroupManager resource instead. Use zonal unmanaged instance -// groups if you need to apply load balancing to groups of heterogeneous -// instances or if you need to manage the instances yourself. You cannot create -// regional unmanaged instance groups. For more information, read Instance -// groups. -message InstanceGroup { - // [Output Only] The creation timestamp for this instance group in RFC3339 - // text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // [Output Only] The fingerprint of the named ports. The system uses this - // fingerprint to detect conflicts when multiple users change the named ports - // concurrently. - optional string fingerprint = 3 [json_name = "fingerprint"]; - - // [Output Only] A unique identifier for this instance group, generated by the - // server. - optional string id = 4 [json_name = "id"]; - - // [Output Only] The resource type, which is always compute#instanceGroup for - // instance groups. - optional string kind = 5 [json_name = "kind"]; - - // The name of the instance group. The name must be 1-63 characters long, and - // comply with RFC1035. - optional string name = 6 [json_name = "name"]; - - // Assigns a name to a port number. For example: {name: "http", port: 80} - // This allows the system to reference ports by the assigned name instead of a - // port number. Named ports can also contain multiple ports. For example: - // [{name: "app1", port: 8080}, {name: "app1", port: 8081}, {name: "app2", - // port: 8082}] Named ports apply to all instances in this instance group. - repeated NamedPort named_ports = 7 [json_name = "namedPorts"]; - - // [Output Only] The URL of the network to which all instances in the instance - // group belong. If your instance has multiple network interfaces, then the - // network and subnetwork fields only refer to the network and subnet used by - // your primary interface (nic0). - optional string network = 8 [json_name = "network"]; - - // [Output Only] The URL of the region where the instance group is located - // (for regional resources). - optional string region = 9 [json_name = "region"]; - - // [Output Only] The URL for this instance group. The server generates this - // URL. - optional string self_link = 10 [json_name = "selfLink"]; - - // [Output Only] The total number of instances in the instance group. - optional int32 size = 11 [json_name = "size"]; - - // [Output Only] The URL of the subnetwork to which all instances in the - // instance group belong. If your instance has multiple network interfaces, - // then the network and subnetwork fields only refer to the network and subnet - // used by your primary interface (nic0). - optional string subnetwork = 12 [json_name = "subnetwork"]; - - // [Output Only] The URL of the zone where the instance group is located (for - // zonal resources). - optional string zone = 13 [json_name = "zone"]; -} - -message InstanceWithNamedPorts { - // [Output Only] The URL of the instance. - optional string instance = 1 [json_name = "instance"]; - - // [Output Only] The named ports that belong to this instance group. - repeated NamedPort named_ports = 2 [json_name = "namedPorts"]; - - // [Output Only] The status of the instance. - // DEPROVISIONING: The instance is halted and we are performing tear down - // tasks like network deprogramming, releasing quota, IP, tearing down disks - // etc. - // PROVISIONING: Resources are being allocated for the instance. - // REPAIRING: The instance is in repair. - // RUNNING: The instance is running. - // STAGING: All required resources have been allocated and the instance is - // being started. - // STOPPED: The instance has stopped successfully. - // STOPPING: The instance is currently stopping (either being deleted or - // killed). - // SUSPENDED: The instance has suspended. - // SUSPENDING: The instance is suspending. - // TERMINATED: The instance has stopped (either by explicit action or - // underlying failure). - optional string status = 3 [json_name = "status"]; +import "google/cloud/compute/v1/internal/common_028.proto"; + +message InstanceGroupManagerAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of InstanceGroupManagersScopedList resources. + map items = 2 [json_name = "items"]; + + // [Output Only] The resource type, which is always + // compute#instanceGroupManagerAggregatedList for an aggregated list of + // managed instance groups. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +// [Output Only] A list of managed instance groups. +message InstanceGroupManagerList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of InstanceGroupManager resources. + repeated InstanceGroupManager items = 2 [json_name = "items"]; + + // [Output Only] The resource type, which is always + // compute#instanceGroupManagerList for a list of managed instance groups. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message InstanceGroupManagersAbandonInstancesRequest { + // The URLs of one or more instances to abandon. This can be a full URL or a + // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + repeated string instances = 1 [json_name = "instances"]; +} + +// InstanceGroupManagers.applyUpdatesToInstances +message InstanceGroupManagersApplyUpdatesRequest { + // Flag to update all instances instead of specified list of “instances”. + // If the flag is set to true then the instances may not be specified in the + // request. + optional bool all_instances = 1 [json_name = "allInstances"]; + + // The list of URLs of one or more instances for which you want to apply + // updates. Each URL can be a full URL or a partial URL, such as + // zones/[ZONE]/instances/[INSTANCE_NAME]. + repeated string instances = 2 [json_name = "instances"]; + + // The minimal action that you want to perform on each instance during the + // update: - REPLACE: At minimum, delete the instance and create it again. - + // RESTART: Stop the instance and start it again. - REFRESH: Do not stop the + // instance and limit disruption as much as possible. - NONE: Do not disrupt + // the instance at all. By default, the minimum action is NONE. If your update + // requires a more disruptive action than you set with this flag, the + // necessary action is performed to execute the update. + // NONE: Do not perform any action. + // REFRESH: Do not stop the instance. + // REPLACE: (Default.) Replace the instance according to the replacement + // method option. + // RESTART: Stop the instance and start it again. + optional string minimal_action = 3 [json_name = "minimalAction"]; + + // The most disruptive action that you want to perform on each instance during + // the update: - REPLACE: Delete the instance and create it again. - RESTART: + // Stop the instance and start it again. - REFRESH: Do not stop the instance + // and limit disruption as much as possible. - NONE: Do not disrupt the + // instance at all. By default, the most disruptive allowed action is REPLACE. + // If your update requires a more disruptive action than you set with this + // flag, the update request will fail. + // NONE: Do not perform any action. + // REFRESH: Do not stop the instance. + // REPLACE: (Default.) Replace the instance according to the replacement + // method option. + // RESTART: Stop the instance and start it again. + optional string most_disruptive_allowed_action = 4 + [json_name = "mostDisruptiveAllowedAction"]; +} + +// InstanceGroupManagers.createInstances +message InstanceGroupManagersCreateInstancesRequest { + // [Required] List of specifications of per-instance configs. + repeated PerInstanceConfig instances = 1 [json_name = "instances"]; +} + +message InstanceGroupManagersDeleteInstancesRequest { + // The URLs of one or more instances to delete. This can be a full URL or a + // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. Queued + // instances do not have URL and can be deleted only by name. One cannot + // specify both URLs and names in a single request. + repeated string instances = 1 [json_name = "instances"]; + + // Specifies whether the request should proceed despite the inclusion of + // instances that are not members of the group or that are already in the + // process of being deleted or abandoned. If this field is set to `false` and + // such an instance is specified in the request, the operation fails. The + // operation always fails if the request contains a malformed instance URL or + // a reference to an instance that exists in a zone or region other than the + // group's zone or region. + optional bool skip_instances_on_validation_error = 2 + [json_name = "skipInstancesOnValidationError"]; +} + +// InstanceGroupManagers.deletePerInstanceConfigs +message InstanceGroupManagersDeletePerInstanceConfigsReq { + // The list of instance names for which we want to delete per-instance configs + // on this managed instance group. + repeated string names = 1 [json_name = "names"]; +} + +message InstanceGroupManagersListErrorsResponse { + // [Output Only] The list of errors of the managed instance group. + repeated InstanceManagedByIgmError items = 1 [json_name = "items"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 2 [json_name = "nextPageToken"]; +} + +message InstanceGroupManagersListManagedInstancesResponse { + // [Output Only] The list of instances in the managed instance group. + repeated ManagedInstance managed_instances = 1 + [json_name = "managedInstances"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 2 [json_name = "nextPageToken"]; +} + +message InstanceGroupManagersListPerInstanceConfigsResp { + // [Output Only] The list of PerInstanceConfig. + repeated PerInstanceConfig items = 1 [json_name = "items"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 2 [json_name = "nextPageToken"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 3 [json_name = "warning"]; +} + +// InstanceGroupManagers.patchPerInstanceConfigs +message InstanceGroupManagersPatchPerInstanceConfigsReq { + // The list of per-instance configurations to insert or patch on this managed + // instance group. + repeated PerInstanceConfig per_instance_configs = 1 + [json_name = "perInstanceConfigs"]; +} + +message InstanceGroupManagersRecreateInstancesRequest { + // The URLs of one or more instances to recreate. This can be a full URL or a + // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + repeated string instances = 1 [json_name = "instances"]; +} + +message InstanceGroupManagersScopedList { + // [Output Only] The list of managed instance groups that are contained in the + // specified project and zone. + repeated InstanceGroupManager instance_group_managers = 1 + [json_name = "instanceGroupManagers"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] The warning that replaces the list of managed instance groups + // when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; +} + +message InstanceGroupManagersSetInstanceTemplateRequest { + // The URL of the instance template that is specified for this managed + // instance group. The group uses this template to create all new instances in + // the managed instance group. The templates for existing instances in the + // group do not change unless you run recreateInstances, run + // applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. + optional string instance_template = 1 [json_name = "instanceTemplate"]; +} + +message InstanceGroupManagersSetTargetPoolsRequest { + // The fingerprint of the target pools information. Use this optional property + // to prevent conflicts when multiple users change the target pools settings + // concurrently. Obtain the fingerprint with the instanceGroupManagers.get + // method. Then, include the fingerprint in your request to ensure that you do + // not overwrite changes that were applied from another concurrent request. + optional string fingerprint = 1 [json_name = "fingerprint"]; + + // The list of target pool URLs that instances in this managed instance group + // belong to. The managed instance group applies these target pools to all of + // the instances in the group. Existing instances and new instances in the + // group all receive these target pool settings. + repeated string target_pools = 2 [json_name = "targetPools"]; +} + +// InstanceGroupManagers.updatePerInstanceConfigs +message InstanceGroupManagersUpdatePerInstanceConfigsReq { + // The list of per-instance configurations to insert or patch on this managed + // instance group. + repeated PerInstanceConfig per_instance_configs = 1 + [json_name = "perInstanceConfigs"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_060.proto b/protos/google/cloud/compute/v1/internal/common_060.proto index b71ca881935d9..0e74e498868d8 100644 --- a/protos/google/cloud/compute/v1/internal/common_060.proto +++ b/protos/google/cloud/compute/v1/internal/common_060.proto @@ -15,248 +15,183 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_059.proto"; -import "google/cloud/compute/v1/internal/common_063.proto"; -import "google/cloud/compute/v1/internal/common_080.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_029.proto"; -message InstanceGroupAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; +// InstanceGroupManagerResizeRequest represents a request to create a number of +// VMs: either immediately or by queuing the request for the specified time. +// This resize request is nested under InstanceGroupManager and the VMs created +// by this request are added to the owning InstanceGroupManager. +message InstanceGroupManagerResizeRequest { + // [Output Only] The creation timestamp for this resize request in RFC3339 + // text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // An optional description of this resource. + optional string description = 2 [json_name = "description"]; - // A list of InstanceGroupsScopedList resources. - map items = 2 [json_name = "items"]; + // [Output Only] A unique identifier for this resource type. The server + // generates this identifier. + optional string id = 3 [json_name = "id"]; // [Output Only] The resource type, which is always - // compute#instanceGroupAggregatedList for aggregated lists of instance - // groups. - optional string kind = 3 [json_name = "kind"]; + // compute#instanceGroupManagerResizeRequest for resize requests. + optional string kind = 4 [json_name = "kind"]; + + // The name of this resize request. The name must be 1-63 characters long, and + // comply with RFC1035. + optional string name = 5 [json_name = "name"]; + + // Requested run duration for instances that will be created by this request. + // At the end of the run duration instance will be deleted. + optional Duration requested_run_duration = 6 + [json_name = "requestedRunDuration"]; + + // The number of instances to be created by this resize request. The group's + // target size will be increased by this number. This field cannot be used + // together with 'instances'. + optional int32 resize_by = 7 [json_name = "resizeBy"]; + + // [Output Only] The URL for this resize request. The server defines this URL. + optional string self_link = 8 [json_name = "selfLink"]; + + // [Output Only] Server-defined URL for this resource with the resource id. + optional string self_link_with_id = 9 [json_name = "selfLinkWithId"]; + + // [Output only] Current state of the request. + // ACCEPTED: The request was created successfully and was accepted for + // provisioning when the capacity becomes available. + // CANCELLED: The request is cancelled. + // CREATING: Resize request is being created and may still fail creation. + // FAILED: The request failed before or during provisioning. If the request + // fails during provisioning, any VMs that were created during provisioning + // are rolled back and removed from the MIG. + // STATE_UNSPECIFIED: Default value. This value should never be returned. + // SUCCEEDED: The request succeeded. + optional string state = 10 [json_name = "state"]; + + // [Output only] Status of the request. + optional InstanceGroupManagerResizeRequestStatus status = 11 + [json_name = "status"]; + + // [Output Only] The URL of a zone where the resize request is located. + // Populated only for zonal resize requests. + optional string zone = 12 [json_name = "zone"]; +} - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; +message InstanceGroupManagerResizeRequestStatus { + message Error { + message ErrorsItem { + // [Output Only] The error type identifier for this error. + optional string code = 1 [json_name = "code"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + message ErrorDetailsItem { + optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; + optional Help help = 2 [json_name = "help"]; - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; + optional LocalizedMessage localized_message = 3 + [json_name = "localizedMessage"]; - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; + optional QuotaExceededInfo quota_info = 4 [json_name = "quotaInfo"]; + } - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // [Output Only] An optional list of messages that contain the error + // details. There is a set of defined message types to use for providing + // details.The syntax depends on the error code. For example, + // QuotaExceededInfo will have details when the error code is + // QUOTA_EXCEEDED. + repeated ErrorDetailsItem error_details = 2 [json_name = "errorDetails"]; - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; + // [Output Only] Indicates the field in the request that caused the error. + // This property is optional. + optional string location = 3 [json_name = "location"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; + // [Output Only] An optional, human-readable error message. + optional string message = 4 [json_name = "message"]; + } + + // [Output Only] The array of errors encountered while processing this + // operation. + repeated ErrorsItem errors = 1 [json_name = "errors"]; } - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + // [Output only] Fatal errors encountered during the queueing or provisioning + // phases of the ResizeRequest that caused the transition to the FAILED state. + // Contrary to the last_attempt errors, this field is final and errors are + // never removed from here, as the ResizeRequest is not going to retry. + optional Error error = 1 [json_name = "error"]; + + // [Output only] Information about the last attempt to fulfill the request. + // The value is temporary since the ResizeRequest can retry, as long as it's + // still active and the last attempt value can either be cleared or replaced + // with a different error. Since ResizeRequest retries infrequently, the value + // may be stale and no longer show an active problem. The value is cleared + // when ResizeRequest transitions to the final state (becomes inactive). If + // the final state is FAILED the error describing it will be storred in the + // "error" field only. + optional InstanceGroupManagerResizeRequestStatusLastAttempt last_attempt = 2 + [json_name = "lastAttempt"]; } -// A list of InstanceGroup resources. -message InstanceGroupList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; +message InstanceGroupManagerResizeRequestStatusLastAttempt { + message Error { + message ErrorsItem { + // [Output Only] The error type identifier for this error. + optional string code = 1 [json_name = "code"]; - // A list of InstanceGroup resources. - repeated InstanceGroup items = 2 [json_name = "items"]; + message ErrorDetailsItem { + optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; - // [Output Only] The resource type, which is always compute#instanceGroupList - // for instance group lists. - optional string kind = 3 [json_name = "kind"]; + optional Help help = 2 [json_name = "help"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; + optional LocalizedMessage localized_message = 3 + [json_name = "localizedMessage"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + optional QuotaExceededInfo quota_info = 4 [json_name = "quotaInfo"]; + } - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; + // [Output Only] An optional list of messages that contain the error + // details. There is a set of defined message types to use for providing + // details.The syntax depends on the error code. For example, + // QuotaExceededInfo will have details when the error code is + // QUOTA_EXCEEDED. + repeated ErrorDetailsItem error_details = 2 [json_name = "errorDetails"]; - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; + // [Output Only] Indicates the field in the request that caused the error. + // This property is optional. + optional string location = 3 [json_name = "location"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; + // [Output Only] An optional, human-readable error message. + optional string message = 4 [json_name = "message"]; } - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; + // [Output Only] The array of errors encountered while processing this + // operation. + repeated ErrorsItem errors = 1 [json_name = "errors"]; } - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + // Errors that prevented the ResizeRequest to be fulfilled. + optional Error error = 1 [json_name = "error"]; } -message InstanceGroupsAddInstancesRequest { - // The list of instances to add to the instance group. - repeated InstanceReference instances = 1 [json_name = "instances"]; -} - -message InstanceGroupsListInstances { +// [Output Only] A list of resize requests. +message InstanceGroupManagerResizeRequestsListResponse { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of InstanceWithNamedPorts resources. - repeated InstanceWithNamedPorts items = 2 [json_name = "items"]; + // A list of resize request resources. + repeated InstanceGroupManagerResizeRequest items = 2 [json_name = "items"]; - // [Output Only] The resource type, which is always - // compute#instanceGroupsListInstances for the list of instances in the - // specified instance group. + // [Output Only] Type of the resource. Always + // compute#instanceGroupManagerResizeRequestList for a list of resize + // requests. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -353,123 +288,3 @@ message InstanceGroupsListInstances { // [Output Only] Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } - -message InstanceGroupsListInstancesRequest { - // 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. - // ALL: Includes all instances in the generated list regardless of their - // state. - // RUNNING: Includes instances in the generated list only if they have a - // RUNNING state. - optional string instance_state = 1 [json_name = "instanceState"]; -} - -message InstanceGroupsRemoveInstancesRequest { - // The list of instances to remove from the instance group. - repeated InstanceReference instances = 1 [json_name = "instances"]; -} - -message InstanceGroupsScopedList { - // [Output Only] The list of instance groups that are contained in this scope. - repeated InstanceGroup instance_groups = 1 [json_name = "instanceGroups"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] An informational warning that replaces the list of instance - // groups when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} - -message InstanceGroupsSetNamedPortsRequest { - // The fingerprint of the named ports information for this instance group. Use - // this optional property to prevent conflicts when multiple users change the - // named ports settings concurrently. Obtain the fingerprint with the - // instanceGroups.get method. Then, include the fingerprint in your request to - // ensure that you do not overwrite changes that were applied from another - // concurrent request. A request with an incorrect fingerprint will fail with - // error 412 conditionNotMet. - optional string fingerprint = 1 [json_name = "fingerprint"]; - - // The list of named ports to set for this instance group. - repeated NamedPort named_ports = 2 [json_name = "namedPorts"]; -} diff --git a/protos/google/cloud/compute/v1/internal/common_061.proto b/protos/google/cloud/compute/v1/internal/common_061.proto index f347c4f5b272a..1a3d9931e7163 100644 --- a/protos/google/cloud/compute/v1/internal/common_061.proto +++ b/protos/google/cloud/compute/v1/internal/common_061.proto @@ -15,565 +15,14 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_029.proto"; - -message InstanceGroupManagerAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of InstanceGroupManagersScopedList resources. - map items = 2 [json_name = "items"]; - - // [Output Only] The resource type, which is always - // compute#instanceGroupManagerAggregatedList for an aggregated list of - // managed instance groups. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -// [Output Only] A list of managed instance groups. -message InstanceGroupManagerList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of InstanceGroupManager resources. - repeated InstanceGroupManager items = 2 [json_name = "items"]; - - // [Output Only] The resource type, which is always - // compute#instanceGroupManagerList for a list of managed instance groups. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -message InstanceGroupManagersAbandonInstancesRequest { - // The URLs of one or more instances to abandon. This can be a full URL or a - // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 1 [json_name = "instances"]; -} - -// InstanceGroupManagers.applyUpdatesToInstances -message InstanceGroupManagersApplyUpdatesRequest { - // Flag to update all instances instead of specified list of “instances”. - // If the flag is set to true then the instances may not be specified in the - // request. - optional bool all_instances = 1 [json_name = "allInstances"]; - - // The list of URLs of one or more instances for which you want to apply - // updates. Each URL can be a full URL or a partial URL, such as - // zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 2 [json_name = "instances"]; - - // The minimal action that you want to perform on each instance during the - // update: - REPLACE: At minimum, delete the instance and create it again. - - // RESTART: Stop the instance and start it again. - REFRESH: Do not stop the - // instance and limit disruption as much as possible. - NONE: Do not disrupt - // the instance at all. By default, the minimum action is NONE. If your update - // requires a more disruptive action than you set with this flag, the - // necessary action is performed to execute the update. - // NONE: Do not perform any action. - // REFRESH: Do not stop the instance. - // REPLACE: (Default.) Replace the instance according to the replacement - // method option. - // RESTART: Stop the instance and start it again. - optional string minimal_action = 3 [json_name = "minimalAction"]; - - // The most disruptive action that you want to perform on each instance during - // the update: - REPLACE: Delete the instance and create it again. - RESTART: - // Stop the instance and start it again. - REFRESH: Do not stop the instance - // and limit disruption as much as possible. - NONE: Do not disrupt the - // instance at all. By default, the most disruptive allowed action is REPLACE. - // If your update requires a more disruptive action than you set with this - // flag, the update request will fail. - // NONE: Do not perform any action. - // REFRESH: Do not stop the instance. - // REPLACE: (Default.) Replace the instance according to the replacement - // method option. - // RESTART: Stop the instance and start it again. - optional string most_disruptive_allowed_action = 4 - [json_name = "mostDisruptiveAllowedAction"]; -} - -// InstanceGroupManagers.createInstances -message InstanceGroupManagersCreateInstancesRequest { - // [Required] List of specifications of per-instance configs. - repeated PerInstanceConfig instances = 1 [json_name = "instances"]; -} - -message InstanceGroupManagersDeleteInstancesRequest { - // The URLs of one or more instances to delete. This can be a full URL or a - // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. Queued - // instances do not have URL and can be deleted only by name. One cannot - // specify both URLs and names in a single request. - repeated string instances = 1 [json_name = "instances"]; - - // Specifies whether the request should proceed despite the inclusion of - // instances that are not members of the group or that are already in the - // process of being deleted or abandoned. If this field is set to `false` and - // such an instance is specified in the request, the operation fails. The - // operation always fails if the request contains a malformed instance URL or - // a reference to an instance that exists in a zone or region other than the - // group's zone or region. - optional bool skip_instances_on_validation_error = 2 - [json_name = "skipInstancesOnValidationError"]; -} - -// InstanceGroupManagers.deletePerInstanceConfigs -message InstanceGroupManagersDeletePerInstanceConfigsReq { - // The list of instance names for which we want to delete per-instance configs - // on this managed instance group. - repeated string names = 1 [json_name = "names"]; -} - -message InstanceGroupManagersListErrorsResponse { - // [Output Only] The list of errors of the managed instance group. - repeated InstanceManagedByIgmError items = 1 [json_name = "items"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 2 [json_name = "nextPageToken"]; -} - -message InstanceGroupManagersListManagedInstancesResponse { - // [Output Only] The list of instances in the managed instance group. - repeated ManagedInstance managed_instances = 1 - [json_name = "managedInstances"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 2 [json_name = "nextPageToken"]; -} - -message InstanceGroupManagersListPerInstanceConfigsResp { - // [Output Only] The list of PerInstanceConfig. - repeated PerInstanceConfig items = 1 [json_name = "items"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 2 [json_name = "nextPageToken"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 3 [json_name = "warning"]; -} - -// InstanceGroupManagers.patchPerInstanceConfigs -message InstanceGroupManagersPatchPerInstanceConfigsReq { - // The list of per-instance configurations to insert or patch on this managed - // instance group. - repeated PerInstanceConfig per_instance_configs = 1 - [json_name = "perInstanceConfigs"]; -} - -message InstanceGroupManagersRecreateInstancesRequest { - // The URLs of one or more instances to recreate. This can be a full URL or a - // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 1 [json_name = "instances"]; -} - -message InstanceGroupManagersScopedList { - // [Output Only] The list of managed instance groups that are contained in the - // specified project and zone. - repeated InstanceGroupManager instance_group_managers = 1 - [json_name = "instanceGroupManagers"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] The warning that replaces the list of managed instance groups - // when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} - -message InstanceGroupManagersSetInstanceTemplateRequest { - // The URL of the instance template that is specified for this managed - // instance group. The group uses this template to create all new instances in - // the managed instance group. The templates for existing instances in the - // group do not change unless you run recreateInstances, run - // applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE. - optional string instance_template = 1 [json_name = "instanceTemplate"]; -} - -message InstanceGroupManagersSetTargetPoolsRequest { - // The fingerprint of the target pools information. Use this optional property - // to prevent conflicts when multiple users change the target pools settings - // concurrently. Obtain the fingerprint with the instanceGroupManagers.get - // method. Then, include the fingerprint in your request to ensure that you do - // not overwrite changes that were applied from another concurrent request. - optional string fingerprint = 1 [json_name = "fingerprint"]; - - // The list of target pool URLs that instances in this managed instance group - // belong to. The managed instance group applies these target pools to all of - // the instances in the group. Existing instances and new instances in the - // group all receive these target pool settings. - repeated string target_pools = 2 [json_name = "targetPools"]; -} - -// InstanceGroupManagers.updatePerInstanceConfigs -message InstanceGroupManagersUpdatePerInstanceConfigsReq { - // The list of per-instance configurations to insert or patch on this managed - // instance group. - repeated PerInstanceConfig per_instance_configs = 1 - [json_name = "perInstanceConfigs"]; +message InstanceReference { + // The URL for a specific instance. @required + // compute.instancegroups.addInstances/removeInstances + optional string instance = 1 [json_name = "instance"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_062.proto b/protos/google/cloud/compute/v1/internal/common_062.proto index fc16f65247a10..91d8ccdc9a9c4 100644 --- a/protos/google/cloud/compute/v1/internal/common_062.proto +++ b/protos/google/cloud/compute/v1/internal/common_062.proto @@ -15,276 +15,45 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_030.proto"; - -// InstanceGroupManagerResizeRequest represents a request to create a number of -// VMs: either immediately or by queuing the request for the specified time. -// This resize request is nested under InstanceGroupManager and the VMs created -// by this request are added to the owning InstanceGroupManager. -message InstanceGroupManagerResizeRequest { - // [Output Only] The creation timestamp for this resize request in RFC3339 - // text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // An optional description of this resource. - optional string description = 2 [json_name = "description"]; - - // [Output Only] A unique identifier for this resource type. The server - // generates this identifier. - optional string id = 3 [json_name = "id"]; - - // [Output Only] The resource type, which is always - // compute#instanceGroupManagerResizeRequest for resize requests. - optional string kind = 4 [json_name = "kind"]; - - // The name of this resize request. The name must be 1-63 characters long, and - // comply with RFC1035. - optional string name = 5 [json_name = "name"]; - - // Requested run duration for instances that will be created by this request. - // At the end of the run duration instance will be deleted. - optional Duration requested_run_duration = 6 - [json_name = "requestedRunDuration"]; - - // The number of instances to be created by this resize request. The group's - // target size will be increased by this number. This field cannot be used - // together with 'instances'. - optional int32 resize_by = 7 [json_name = "resizeBy"]; - - // [Output Only] The URL for this resize request. The server defines this URL. - optional string self_link = 8 [json_name = "selfLink"]; - - // [Output Only] Server-defined URL for this resource with the resource id. - optional string self_link_with_id = 9 [json_name = "selfLinkWithId"]; - - // [Output only] Current state of the request. - // ACCEPTED: The request was created successfully and was accepted for - // provisioning when the capacity becomes available. - // CANCELLED: The request is cancelled. - // CREATING: Resize request is being created and may still fail creation. - // FAILED: The request failed before or during provisioning. If the request - // fails during provisioning, any VMs that were created during provisioning - // are rolled back and removed from the MIG. - // STATE_UNSPECIFIED: Default value. This value should never be returned. - // SUCCEEDED: The request succeeded. - optional string state = 10 [json_name = "state"]; - - // [Output only] Status of the request. - optional InstanceGroupManagerResizeRequestStatus status = 11 - [json_name = "status"]; - - // [Output Only] The URL of a zone where the resize request is located. - // Populated only for zonal resize requests. - optional string zone = 12 [json_name = "zone"]; -} - -message InstanceGroupManagerResizeRequestStatus { - message Error { - message ErrorsItem { - // [Output Only] The error type identifier for this error. - optional string code = 1 [json_name = "code"]; - - message ErrorDetailsItem { - optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; - - optional Help help = 2 [json_name = "help"]; - - optional LocalizedMessage localized_message = 3 - [json_name = "localizedMessage"]; - - optional QuotaExceededInfo quota_info = 4 [json_name = "quotaInfo"]; - } - - // [Output Only] An optional list of messages that contain the error - // details. There is a set of defined message types to use for providing - // details.The syntax depends on the error code. For example, - // QuotaExceededInfo will have details when the error code is - // QUOTA_EXCEEDED. - repeated ErrorDetailsItem error_details = 2 [json_name = "errorDetails"]; - - // [Output Only] Indicates the field in the request that caused the error. - // This property is optional. - optional string location = 3 [json_name = "location"]; - - // [Output Only] An optional, human-readable error message. - optional string message = 4 [json_name = "message"]; - } - - // [Output Only] The array of errors encountered while processing this - // operation. - repeated ErrorsItem errors = 1 [json_name = "errors"]; - } - - // [Output only] Fatal errors encountered during the queueing or provisioning - // phases of the ResizeRequest that caused the transition to the FAILED state. - // Contrary to the last_attempt errors, this field is final and errors are - // never removed from here, as the ResizeRequest is not going to retry. - optional Error error = 1 [json_name = "error"]; - - // [Output only] Information about the last attempt to fulfill the request. - // The value is temporary since the ResizeRequest can retry, as long as it's - // still active and the last attempt value can either be cleared or replaced - // with a different error. Since ResizeRequest retries infrequently, the value - // may be stale and no longer show an active problem. The value is cleared - // when ResizeRequest transitions to the final state (becomes inactive). If - // the final state is FAILED the error describing it will be storred in the - // "error" field only. - optional InstanceGroupManagerResizeRequestStatusLastAttempt last_attempt = 2 - [json_name = "lastAttempt"]; -} - -message InstanceGroupManagerResizeRequestStatusLastAttempt { - message Error { - message ErrorsItem { - // [Output Only] The error type identifier for this error. - optional string code = 1 [json_name = "code"]; - - message ErrorDetailsItem { - optional ErrorInfo error_info = 1 [json_name = "errorInfo"]; - - optional Help help = 2 [json_name = "help"]; - - optional LocalizedMessage localized_message = 3 - [json_name = "localizedMessage"]; - - optional QuotaExceededInfo quota_info = 4 [json_name = "quotaInfo"]; - } - - // [Output Only] An optional list of messages that contain the error - // details. There is a set of defined message types to use for providing - // details.The syntax depends on the error code. For example, - // QuotaExceededInfo will have details when the error code is - // QUOTA_EXCEEDED. - repeated ErrorDetailsItem error_details = 2 [json_name = "errorDetails"]; - - // [Output Only] Indicates the field in the request that caused the error. - // This property is optional. - optional string location = 3 [json_name = "location"]; - - // [Output Only] An optional, human-readable error message. - optional string message = 4 [json_name = "message"]; - } - - // [Output Only] The array of errors encountered while processing this - // operation. - repeated ErrorsItem errors = 1 [json_name = "errors"]; - } - - // Errors that prevented the ResizeRequest to be fulfilled. - optional Error error = 1 [json_name = "error"]; +// Represents a Instance Settings resource. You can use instance settings to +// configure default settings for Compute Engine VM instances. For example, you +// can use it to configure default machine type of Compute Engine VM instances. +message InstanceSettings { + // Specifies a fingerprint for instance settings, which is essentially a hash + // of the instance settings resource's contents and used for optimistic + // locking. The fingerprint is initially generated by Compute Engine and + // changes after every request to modify or update the instance settings + // resource. You must always provide an up-to-date fingerprint hash in order + // to update or change the resource, otherwise the request will fail with + // error 412 conditionNotMet. To see the latest fingerprint, make a get() + // request to retrieve the resource. + optional string fingerprint = 1 [json_name = "fingerprint"]; + + // [Output Only] Type of the resource. Always compute#instance_settings for + // instance settings. + optional string kind = 2 [json_name = "kind"]; + + // The metadata key/value pairs assigned to all the instances in the + // corresponding scope. + optional InstanceSettingsMetadata metadata = 3 [json_name = "metadata"]; + + // [Output Only] URL of the zone where the resource resides You must specify + // this field as part of the HTTP request URL. It is not settable as a field + // in the request body. + optional string zone = 4 [json_name = "zone"]; } -// [Output Only] A list of resize requests. -message InstanceGroupManagerResizeRequestsListResponse { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of resize request resources. - repeated InstanceGroupManagerResizeRequest items = 2 [json_name = "items"]; - - // [Output Only] Type of the resource. Always - // compute#instanceGroupManagerResizeRequestList for a list of resize - // requests. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +message InstanceSettingsMetadata { + // A metadata key/value items map. The total size of all keys and values must + // be less than 512KB. + map items = 1 [json_name = "items"]; - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + // [Output Only] Type of the resource. Always compute#metadata for metadata. + optional string kind = 2 [json_name = "kind"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_063.proto b/protos/google/cloud/compute/v1/internal/common_063.proto index dd47c86081961..72cb604db3c93 100644 --- a/protos/google/cloud/compute/v1/internal/common_063.proto +++ b/protos/google/cloud/compute/v1/internal/common_063.proto @@ -15,14 +15,208 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message InstanceReference { - // The URL for a specific instance. @required - // compute.instancegroups.addInstances/removeInstances - optional string instance = 1 [json_name = "instance"]; +import "google/cloud/compute/v1/internal/common_024.proto"; + +// Contains a list of InstanceTemplatesScopedList. +message InstanceTemplateAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of InstanceTemplatesScopedList resources. + map items = 2 [json_name = "items"]; + + // Type of resource. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message InstanceTemplatesScopedList { + // [Output Only] A list of instance templates that are contained within the + // specified project and zone. + repeated InstanceTemplate instance_templates = 1 + [json_name = "instanceTemplates"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] An informational warning that replaces the list of instance + // templates when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_064.proto b/protos/google/cloud/compute/v1/internal/common_064.proto index 3560b4e157aca..10e7be26066d4 100644 --- a/protos/google/cloud/compute/v1/internal/common_064.proto +++ b/protos/google/cloud/compute/v1/internal/common_064.proto @@ -15,45 +15,223 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Instance Settings resource. You can use instance settings to -// configure default settings for Compute Engine VM instances. For example, you -// can use it to configure default machine type of Compute Engine VM instances. -message InstanceSettings { - // Specifies a fingerprint for instance settings, which is essentially a hash - // of the instance settings resource's contents and used for optimistic - // locking. The fingerprint is initially generated by Compute Engine and - // changes after every request to modify or update the instance settings - // resource. You must always provide an up-to-date fingerprint hash in order - // to update or change the resource, otherwise the request will fail with - // error 412 conditionNotMet. To see the latest fingerprint, make a get() - // request to retrieve the resource. - optional string fingerprint = 1 [json_name = "fingerprint"]; - - // [Output Only] Type of the resource. Always compute#instance_settings for - // instance settings. - optional string kind = 2 [json_name = "kind"]; - - // The metadata key/value pairs assigned to all the instances in the - // corresponding scope. - optional InstanceSettingsMetadata metadata = 3 [json_name = "metadata"]; - - // [Output Only] URL of the zone where the resource resides You must specify - // this field as part of the HTTP request URL. It is not settable as a field - // in the request body. - optional string zone = 4 [json_name = "zone"]; +// Represents a InstantSnapshot resource. You can use instant snapshots to +// create disk rollback points quickly.. +message InstantSnapshot { + // [Output Only] The architecture of the instant snapshot. Valid values are + // ARM64 or X86_64. + // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. + // ARM64: Machines with architecture ARM64 + // X86_64: Machines with architecture X86_64 + optional string architecture = 1 [json_name = "architecture"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + // [Output Only] Size of the source disk, specified in GB. + optional string disk_size_gb = 4 [json_name = "diskSizeGb"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 5 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#instantSnapshot for + // InstantSnapshot resources. + optional string kind = 6 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this InstantSnapshot, which + // is essentially a hash of the labels set used for optimistic locking. The + // fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels, otherwise + // the request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve a InstantSnapshot. + optional string label_fingerprint = 7 [json_name = "labelFingerprint"]; + + // Labels to apply to this InstantSnapshot. These can be later modified by the + // setLabels method. Label values may be empty. + map labels = 8 [json_name = "labels"]; + + // 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. + optional string name = 9 [json_name = "name"]; + + // [Output Only] URL of the region where the instant snapshot resides. You + // must specify this field as part of the HTTP request URL. It is not settable + // as a field in the request body. + optional string region = 10 [json_name = "region"]; + + // [Output Only] Status information for the instant snapshot resource. + optional InstantSnapshotResourceStatus resource_status = 11 + [json_name = "resourceStatus"]; + + // Output only. Reserved for future use. + optional bool satisfies_pzi = 12 [json_name = "satisfiesPzi"]; + + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 13 [json_name = "satisfiesPzs"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 14 [json_name = "selfLink"]; + + // [Output Only] Server-defined URL for this resource's resource id. + optional string self_link_with_id = 15 [json_name = "selfLinkWithId"]; + + // URL of the source disk used to create this instant snapshot. Note that the + // source disk must be in the same zone/region as the instant snapshot to be + // created. This can be a full or valid partial URL. For example, the + // following are valid values: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /disks/disk - + // https://www.googleapis.com/compute/v1/projects/project/regions/region + // /disks/disk - projects/project/zones/zone/disks/disk - + // projects/project/regions/region/disks/disk - zones/zone/disks/disk - + // regions/region/disks/disk + optional string source_disk = 16 [json_name = "sourceDisk"]; + + // [Output Only] The ID value of the disk used to create this InstantSnapshot. + // This value may be used to determine whether the InstantSnapshot was taken + // from the current or a previous instance of a given disk name. + optional string source_disk_id = 17 [json_name = "sourceDiskId"]; + + // [Output Only] The status of the instantSnapshot. This can be CREATING, + // DELETING, FAILED, or READY. + // CREATING: InstantSnapshot creation is in progress. + // DELETING: InstantSnapshot is currently being deleted. + // FAILED: InstantSnapshot creation failed. + // READY: InstantSnapshot has been created successfully. + // UNAVAILABLE: InstantSnapshot is currently unavailable and cannot be used + // for Disk restoration + optional string status = 18 [json_name = "status"]; + + // [Output Only] URL of the zone where the instant snapshot resides. You must + // specify this field as part of the HTTP request URL. It is not settable as a + // field in the request body. + optional string zone = 19 [json_name = "zone"]; } -message InstanceSettingsMetadata { - // A metadata key/value items map. The total size of all keys and values must - // be less than 512KB. - map items = 1 [json_name = "items"]; +// Contains a list of InstantSnapshot resources. +message InstantSnapshotList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of InstantSnapshot resources. + repeated InstantSnapshot items = 2 [json_name = "items"]; + + // Type of resource. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} - // [Output Only] Type of the resource. Always compute#metadata for metadata. - optional string kind = 2 [json_name = "kind"]; +message InstantSnapshotResourceStatus { + // [Output Only] The storage size of this instant snapshot. + optional string storage_size_bytes = 1 [json_name = "storageSizeBytes"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_065.proto b/protos/google/cloud/compute/v1/internal/common_065.proto index 61d370680ff4c..cfde3a65001d8 100644 --- a/protos/google/cloud/compute/v1/internal/common_065.proto +++ b/protos/google/cloud/compute/v1/internal/common_065.proto @@ -15,23 +15,24 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_025.proto"; +import "google/cloud/compute/v1/internal/common_064.proto"; -// Contains a list of InstanceTemplatesScopedList. -message InstanceTemplateAggregatedList { +message InstantSnapshotAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of InstanceTemplatesScopedList resources. - map items = 2 [json_name = "items"]; + // A list of InstantSnapshotsScopedList resources. + map items = 2 [json_name = "items"]; - // Type of resource. + // [Output Only] Type of resource. Always + // compute#instantSnapshotAggregatedList for aggregated lists of + // instantSnapshots. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -44,6 +45,9 @@ message InstanceTemplateAggregatedList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -126,14 +130,13 @@ message InstanceTemplateAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; } -message InstanceTemplatesScopedList { - // [Output Only] A list of instance templates that are contained within the - // specified project and zone. - repeated InstanceTemplate instance_templates = 1 - [json_name = "instanceTemplates"]; +message InstantSnapshotsScopedList { + // [Output Only] A list of instantSnapshots contained in this scope. + repeated InstantSnapshot instant_snapshots = 1 + [json_name = "instantSnapshots"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -216,7 +219,7 @@ message InstanceTemplatesScopedList { optional string message = 3 [json_name = "message"]; } - // [Output Only] An informational warning that replaces the list of instance - // templates when the list is empty. + // [Output Only] Informational warning which replaces the list of + // instantSnapshots when the list is empty. optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_066.proto b/protos/google/cloud/compute/v1/internal/common_066.proto index 7f4780f20f6bb..839e8e65a5e71 100644 --- a/protos/google/cloud/compute/v1/internal/common_066.proto +++ b/protos/google/cloud/compute/v1/internal/common_066.proto @@ -15,125 +15,354 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a InstantSnapshot resource. You can use instant snapshots to -// create disk rollback points quickly.. -message InstantSnapshot { - // [Output Only] The architecture of the instant snapshot. Valid values are - // ARM64 or X86_64. - // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. - // ARM64: Machines with architecture ARM64 - // X86_64: Machines with architecture X86_64 - optional string architecture = 1 [json_name = "architecture"]; +// Represents an Interconnect resource. An Interconnect resource is a dedicated +// connection between the Google Cloud network and your on-premises network. For +// more information, read the Dedicated Interconnect Overview. +message Interconnect { + // Administrative status of the interconnect. When this is set to true, the + // Interconnect is functional and can carry traffic. When set to false, no + // packets can be carried over the interconnect and no BGP routes are + // exchanged over it. By default, the status is set to true. + optional bool admin_enabled = 1 [json_name = "adminEnabled"]; + + // [Output only] List of features available for this Interconnect connection, + // which can take one of the following values: - IF_MACSEC If present then the + // Interconnect connection is provisioned on MACsec capable hardware ports. If + // not present then the Interconnect connection is provisioned on non-MACsec + // capable ports and MACsec isn't supported and enabling MACsec fails. + repeated string available_features = 27 [json_name = "availableFeatures"]; + + // [Output Only] A list of CircuitInfo objects, that describe the individual + // circuits in this LAG. + repeated InterconnectCircuitInfo circuit_infos = 2 + [json_name = "circuitInfos"]; // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + + // Customer name, to put in the Letter of Authorization as the party + // authorized to request a crossconnect. + optional string customer_name = 4 [json_name = "customerName"]; // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 3 [json_name = "description"]; + optional string description = 5 [json_name = "description"]; - // [Output Only] Size of the source disk, specified in GB. - optional string disk_size_gb = 4 [json_name = "diskSizeGb"]; + // [Output Only] A list of outages expected for this Interconnect. + repeated InterconnectOutageNotification expected_outages = 6 + [json_name = "expectedOutages"]; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 5 [json_name = "id"]; + // [Output Only] IP address configured on the Google side of the Interconnect + // link. This can be used only for ping tests. + optional string google_ip_address = 7 [json_name = "googleIpAddress"]; - // [Output Only] Type of the resource. Always compute#instantSnapshot for - // InstantSnapshot resources. - optional string kind = 6 [json_name = "kind"]; + // [Output Only] Google reference ID to be used when raising support tickets + // with Google or otherwise to debug backend connectivity issues. + optional string google_reference_id = 8 [json_name = "googleReferenceId"]; - // A fingerprint for the labels being applied to this InstantSnapshot, which - // is essentially a hash of the labels set used for optimistic locking. The + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 9 [json_name = "id"]; + + // [Output Only] A list of the URLs of all InterconnectAttachments configured + // to use this Interconnect. + repeated string interconnect_attachments = 10 + [json_name = "interconnectAttachments"]; + + // Type of interconnect, which can take one of the following values: - + // PARTNER: A partner-managed interconnection shared between customers though + // a partner. - DEDICATED: A dedicated physical interconnection with the + // customer. Note that a value IT_PRIVATE has been deprecated in favor of + // DEDICATED. + // DEDICATED: A dedicated physical interconnection with the customer. + // IT_PRIVATE: [Deprecated] A private, physical interconnection with the + // customer. + // PARTNER: A partner-managed interconnection shared between customers via + // partner. + optional string interconnect_type = 11 [json_name = "interconnectType"]; + + // [Output Only] Type of the resource. Always compute#interconnect for + // interconnects. + optional string kind = 12 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this Interconnect, which is + // essentially a hash of the labels set used for optimistic locking. The // fingerprint is initially generated by Compute Engine and changes after // every request to modify or update labels. You must always provide an // up-to-date fingerprint hash in order to update or change labels, otherwise // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve a InstantSnapshot. - optional string label_fingerprint = 7 [json_name = "labelFingerprint"]; - - // Labels to apply to this InstantSnapshot. These can be later modified by the - // setLabels method. Label values may be empty. - map labels = 8 [json_name = "labels"]; - - // Name of the resource; provided by the client when the resource is created. + // fingerprint, make a get() request to retrieve an Interconnect. + optional string label_fingerprint = 24 [json_name = "labelFingerprint"]; + + // Labels for this resource. These can only be added or modified by the + // setLabels method. Each label key/value pair must comply with RFC1035. Label + // values may be empty. + map labels = 25 [json_name = "labels"]; + + // Type of link requested, which can take one of the following values: - + // LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - + // LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. Note that this + // field indicates the speed of each of the links in the bundle, not the speed + // of the entire bundle. + // LINK_TYPE_ETHERNET_100G_LR: 100G Ethernet, LR Optics. + // LINK_TYPE_ETHERNET_10G_LR: 10G Ethernet, LR Optics. [(rate_bps) = + // 10000000000]; + optional string link_type = 13 [json_name = "linkType"]; + + // URL of the InterconnectLocation object that represents where this + // connection is to be provisioned. + optional string location = 14 [json_name = "location"]; + + // Configuration that enables Media Access Control security (MACsec) on the + // Cloud Interconnect connection between Google and your on-premises router. + optional InterconnectMacsec macsec = 28 [json_name = "macsec"]; + + // Enable or disable MACsec on this Interconnect connection. MACsec enablement + // fails if the MACsec object is not specified. + optional bool macsec_enabled = 29 [json_name = "macsecEnabled"]; + + // 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. - optional string name = 9 [json_name = "name"]; + optional string name = 15 [json_name = "name"]; + + // Email address to contact the customer NOC for operations and maintenance + // notifications regarding this Interconnect. If specified, this will be used + // for notifications in addition to all other forms described, such as Cloud + // Monitoring logs alerting and Cloud Notifications. This field is required + // for users who sign up for Cloud Interconnect using workforce identity + // federation. + optional string noc_contact_email = 16 [json_name = "nocContactEmail"]; + + // [Output Only] The current status of this Interconnect's functionality, + // which can take one of the following values: - OS_ACTIVE: A valid + // Interconnect, which is turned up and is ready to use. Attachments may be + // provisioned on this Interconnect. - OS_UNPROVISIONED: An Interconnect that + // has not completed turnup. No attachments may be provisioned on this + // Interconnect. - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing + // internal maintenance. No attachments may be provisioned or updated on this + // Interconnect. + // OS_ACTIVE: The interconnect is valid, turned up, and ready to use. + // Attachments may be provisioned on this interconnect. + // OS_UNPROVISIONED: The interconnect has not completed turnup. No attachments + // may be provisioned on this interconnect. + optional string operational_status = 17 [json_name = "operationalStatus"]; + + // [Output Only] IP address configured on the customer side of the + // Interconnect link. The customer should configure this IP address during + // turnup when prompted by Google NOC. This can be used only for ping tests. + optional string peer_ip_address = 18 [json_name = "peerIpAddress"]; + + // [Output Only] Number of links actually provisioned in this interconnect. + optional int32 provisioned_link_count = 19 + [json_name = "provisionedLinkCount"]; + + // Indicates that this is a Cross-Cloud Interconnect. This field specifies the + // location outside of Google's network that the interconnect is connected to. + optional string remote_location = 26 [json_name = "remoteLocation"]; + + // Optional. List of features requested for this Interconnect connection, + // which can take one of the following values: - IF_MACSEC If specified then + // the connection is created on MACsec capable hardware ports. If not + // specified, the default value is false, which allocates non-MACsec capable + // ports first if available. This parameter can be provided only with + // Interconnect INSERT. It isn't valid for Interconnect PATCH. + repeated string requested_features = 30 [json_name = "requestedFeatures"]; + + // Target number of physical links in the link bundle, as requested by the + // customer. + optional int32 requested_link_count = 20 [json_name = "requestedLinkCount"]; - // [Output Only] URL of the region where the instant snapshot resides. You - // must specify this field as part of the HTTP request URL. It is not settable - // as a field in the request body. - optional string region = 10 [json_name = "region"]; + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 21 [json_name = "satisfiesPzs"]; - // [Output Only] Status information for the instant snapshot resource. - optional InstantSnapshotResourceStatus resource_status = 11 - [json_name = "resourceStatus"]; + // [Output Only] Server-defined URL for the resource. + optional string self_link = 22 [json_name = "selfLink"]; + + // [Output Only] The current state of Interconnect functionality, which can + // take one of the following values: - ACTIVE: The Interconnect is valid, + // turned up and ready to use. Attachments may be provisioned on this + // Interconnect. - UNPROVISIONED: The Interconnect has not completed turnup. + // No attachments may be provisioned on this Interconnect. - + // UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. No + // attachments may be provisioned or updated on this Interconnect. + // ACTIVE: The interconnect is valid, turned up, and ready to use. Attachments + // may be provisioned on this interconnect. + // UNPROVISIONED: The interconnect has not completed turnup. No attachments + // may be provisioned on this interconnect. + optional string state = 23 [json_name = "state"]; +} - // Output only. Reserved for future use. - optional bool satisfies_pzi = 12 [json_name = "satisfiesPzi"]; +// Describes a single physical circuit between the Customer and Google. +// CircuitInfo objects are created by Google, so all fields are output only. +message InterconnectCircuitInfo { + // Customer-side demarc ID for this circuit. + optional string customer_demarc_id = 1 [json_name = "customerDemarcId"]; - // [Output Only] Reserved for future use. - optional bool satisfies_pzs = 13 [json_name = "satisfiesPzs"]; + // Google-assigned unique ID for this circuit. Assigned at circuit turn-up. + optional string google_circuit_id = 2 [json_name = "googleCircuitId"]; - // [Output Only] Server-defined URL for the resource. - optional string self_link = 14 [json_name = "selfLink"]; - - // [Output Only] Server-defined URL for this resource's resource id. - optional string self_link_with_id = 15 [json_name = "selfLinkWithId"]; - - // URL of the source disk used to create this instant snapshot. Note that the - // source disk must be in the same zone/region as the instant snapshot to be - // created. This can be a full or valid partial URL. For example, the - // following are valid values: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /disks/disk - - // https://www.googleapis.com/compute/v1/projects/project/regions/region - // /disks/disk - projects/project/zones/zone/disks/disk - - // projects/project/regions/region/disks/disk - zones/zone/disks/disk - - // regions/region/disks/disk - optional string source_disk = 16 [json_name = "sourceDisk"]; - - // [Output Only] The ID value of the disk used to create this InstantSnapshot. - // This value may be used to determine whether the InstantSnapshot was taken - // from the current or a previous instance of a given disk name. - optional string source_disk_id = 17 [json_name = "sourceDiskId"]; - - // [Output Only] The status of the instantSnapshot. This can be CREATING, - // DELETING, FAILED, or READY. - // CREATING: InstantSnapshot creation is in progress. - // DELETING: InstantSnapshot is currently being deleted. - // FAILED: InstantSnapshot creation failed. - // READY: InstantSnapshot has been created successfully. - // UNAVAILABLE: InstantSnapshot is currently unavailable and cannot be used - // for Disk restoration - optional string status = 18 [json_name = "status"]; - - // [Output Only] URL of the zone where the instant snapshot resides. You must - // specify this field as part of the HTTP request URL. It is not settable as a - // field in the request body. - optional string zone = 19 [json_name = "zone"]; -} - -// Contains a list of InstantSnapshot resources. -message InstantSnapshotList { + // Google-side demarc ID for this circuit. Assigned at circuit turn-up and + // provided by Google to the customer in the LOA. + optional string google_demarc_id = 3 [json_name = "googleDemarcId"]; +} + +// Diagnostics information about the Interconnect connection, which contains +// detailed and current technical information about Google's side of the +// connection. +message InterconnectDiagnostics { + // A list of InterconnectDiagnostics.ARPEntry objects, describing individual + // neighbors currently seen by the Google router in the ARP cache for the + // Interconnect. This will be empty when the Interconnect is not bundled. + repeated InterconnectDiagnosticsARPEntry arp_caches = 1 + [json_name = "arpCaches"]; + + // The aggregation type of the bundle interface. + // BUNDLE_AGGREGATION_TYPE_LACP: LACP is enabled. + // BUNDLE_AGGREGATION_TYPE_STATIC: LACP is disabled. + optional string bundle_aggregation_type = 2 + [json_name = "bundleAggregationType"]; + + // The operational status of the bundle interface. + // BUNDLE_OPERATIONAL_STATUS_DOWN: If bundleAggregationType is LACP: LACP is + // not established and/or all links in the bundle have DOWN operational + // status. If bundleAggregationType is STATIC: one or more links in the bundle + // has DOWN operational status. + // BUNDLE_OPERATIONAL_STATUS_UP: If bundleAggregationType is LACP: LACP is + // established and at least one link in the bundle has UP operational status. + // If bundleAggregationType is STATIC: all links in the bundle (typically just + // one) have UP operational status. + optional string bundle_operational_status = 3 + [json_name = "bundleOperationalStatus"]; + + // A list of InterconnectDiagnostics.LinkStatus objects, describing the status + // for each link on the Interconnect. + repeated InterconnectDiagnosticsLinkStatus links = 4 [json_name = "links"]; + + // The MAC address of the Interconnect's bundle interface. + optional string mac_address = 5 [json_name = "macAddress"]; +} + +// Describing the ARP neighbor entries seen on this link +message InterconnectDiagnosticsARPEntry { + // The IP address of this ARP neighbor. + optional string ip_address = 1 [json_name = "ipAddress"]; + + // The MAC address of this ARP neighbor. + optional string mac_address = 2 [json_name = "macAddress"]; +} + +message InterconnectDiagnosticsLinkLACPStatus { + // System ID of the port on Google's side of the LACP exchange. + optional string google_system_id = 1 [json_name = "googleSystemId"]; + + // System ID of the port on the neighbor's side of the LACP exchange. + optional string neighbor_system_id = 2 [json_name = "neighborSystemId"]; + + // The state of a LACP link, which can take one of the following values: - + // ACTIVE: The link is configured and active within the bundle. - DETACHED: + // The link is not configured within the bundle. This means that the rest of + // the object should be empty. + // ACTIVE: The link is configured and active within the bundle. + // DETACHED: The link is not configured within the bundle, this means the rest + // of the object should be empty. + optional string state = 3 [json_name = "state"]; +} + +message InterconnectDiagnosticsLinkOpticalPower { + // The status of the current value when compared to the warning and alarm + // levels for the receiving or transmitting transceiver. Possible states + // include: - OK: The value has not crossed a warning threshold. - + // LOW_WARNING: The value has crossed below the low warning threshold. - + // HIGH_WARNING: The value has crossed above the high warning threshold. - + // LOW_ALARM: The value has crossed below the low alarm threshold. - + // HIGH_ALARM: The value has crossed above the high alarm threshold. + // HIGH_ALARM: The value has crossed above the high alarm threshold. + // HIGH_WARNING: The value of the current optical power has crossed above the + // high warning threshold. + // LOW_ALARM: The value of the current optical power has crossed below the low + // alarm threshold. + // LOW_WARNING: The value of the current optical power has crossed below the + // low warning threshold. + // OK: The value of the current optical power has not crossed a warning + // threshold. + optional string state = 1 [json_name = "state"]; + + // Value of the current receiving or transmitting optical power, read in dBm. + // Take a known good optical value, give it a 10% margin and trigger warnings + // relative to that value. In general, a -7dBm warning and a -11dBm alarm are + // good optical value estimates for most links. + optional float value = 2 [json_name = "value"]; +} + +message InterconnectDiagnosticsLinkStatus { + // A list of InterconnectDiagnostics.ARPEntry objects, describing the ARP + // neighbor entries seen on this link. This will be empty if the link is + // bundled + repeated InterconnectDiagnosticsARPEntry arp_caches = 1 + [json_name = "arpCaches"]; + + // The unique ID for this link assigned during turn up by Google. + optional string circuit_id = 2 [json_name = "circuitId"]; + + // The Demarc address assigned by Google and provided in the LoA. + optional string google_demarc = 3 [json_name = "googleDemarc"]; + + optional InterconnectDiagnosticsLinkLACPStatus lacp_status = 4 + [json_name = "lacpStatus"]; + + // Describes the status of MACsec encryption on this link. + optional InterconnectDiagnosticsMacsecStatus macsec = 8 + [json_name = "macsec"]; + + // The operational status of the link. + // LINK_OPERATIONAL_STATUS_DOWN: The interface is unable to communicate with + // the remote end. + // LINK_OPERATIONAL_STATUS_UP: The interface has low level communication with + // the remote end. + optional string operational_status = 5 [json_name = "operationalStatus"]; + + // An InterconnectDiagnostics.LinkOpticalPower object, describing the current + // value and status of the received light level. + optional InterconnectDiagnosticsLinkOpticalPower receiving_optical_power = 6 + [json_name = "receivingOpticalPower"]; + + // An InterconnectDiagnostics.LinkOpticalPower object, describing the current + // value and status of the transmitted light level. + optional InterconnectDiagnosticsLinkOpticalPower transmitting_optical_power = + 7 [json_name = "transmittingOpticalPower"]; +} + +// Describes the status of MACsec encryption on the link. +message InterconnectDiagnosticsMacsecStatus { + // Indicates the Connectivity Association Key Name (CKN) currently being used + // if MACsec is operational. + optional string ckn = 1 [json_name = "ckn"]; + + // Indicates whether or not MACsec is operational on this link. + optional bool operational = 2 [json_name = "operational"]; +} + +// Response to the list request, and contains a list of interconnects. +message InterconnectList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of InstantSnapshot resources. - repeated InstantSnapshot items = 2 [json_name = "items"]; + // A list of Interconnect resources. + repeated Interconnect items = 2 [json_name = "items"]; - // Type of resource. + // [Output Only] Type of resource. Always compute#interconnectList for lists + // of interconnects. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -231,7 +460,145 @@ message InstantSnapshotList { optional Warning warning = 6 [json_name = "warning"]; } -message InstantSnapshotResourceStatus { - // [Output Only] The storage size of this instant snapshot. - optional string storage_size_bytes = 1 [json_name = "storageSizeBytes"]; +// Configuration information for enabling Media Access Control security (MACsec) +// on this Cloud Interconnect connection between Google and your on-premises +// router. +message InterconnectMacsec { + // If set to true, the Interconnect connection is configured with a + // should-secure MACsec security policy, that allows the Google router to + // fallback to cleartext traffic if the MKA session cannot be established. By + // default, the Interconnect connection is configured with a must-secure + // security policy that drops all traffic if the MKA session cannot be + // established with your router. + optional bool fail_open = 1 [json_name = "failOpen"]; + + // Required. A keychain placeholder describing a set of named key objects + // along with their start times. A MACsec CKN/CAK is generated for each key in + // the key chain. Google router automatically picks the key with the most + // recent startTime when establishing or re-establishing a MACsec secure link. + repeated InterconnectMacsecPreSharedKey pre_shared_keys = 2 + [json_name = "preSharedKeys"]; +} + +// MACsec configuration information for the Interconnect connection. Contains +// the generated Connectivity Association Key Name (CKN) and the key (CAK) for +// this Interconnect connection. +message InterconnectMacsecConfig { + // A keychain placeholder describing a set of named key objects along with + // their start times. A MACsec CKN/CAK is generated for each key in the key + // chain. Google router automatically picks the key with the most recent + // startTime when establishing or re-establishing a MACsec secure link. + repeated InterconnectMacsecConfigPreSharedKey pre_shared_keys = 1 + [json_name = "preSharedKeys"]; +} + +// Describes a pre-shared key used to setup MACsec in static connectivity +// association key (CAK) mode. +message InterconnectMacsecConfigPreSharedKey { + // An auto-generated Connectivity Association Key (CAK) for this key. + optional string cak = 1 [json_name = "cak"]; + + // An auto-generated Connectivity Association Key Name (CKN) for this key. + optional string ckn = 2 [json_name = "ckn"]; + + // User provided name for this pre-shared key. + optional string name = 3 [json_name = "name"]; + + // User provided timestamp on or after which this key is valid. + optional string start_time = 4 [json_name = "startTime"]; +} + +// Describes a pre-shared key used to setup MACsec in static connectivity +// association key (CAK) mode. +message InterconnectMacsecPreSharedKey { + // Required. A name for this pre-shared key. 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. + optional string name = 1 [json_name = "name"]; + + // A RFC3339 timestamp on or after which the key is valid. startTime can be in + // the future. If the keychain has a single key, startTime can be omitted. If + // the keychain has multiple keys, startTime is mandatory for each key. The + // start times of keys must be in increasing order. The start times of two + // consecutive keys must be at least 6 hours apart. + optional string start_time = 2 [json_name = "startTime"]; +} + +// Description of a planned outage on this Interconnect. +message InterconnectOutageNotification { + // If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit IDs + // that will be affected. + repeated string affected_circuits = 1 [json_name = "affectedCircuits"]; + + // A description about the purpose of the outage. + optional string description = 2 [json_name = "description"]; + + // Scheduled end time for the outage (milliseconds since Unix epoch). + optional string end_time = 3 [json_name = "endTime"]; + + // Form this outage is expected to take, which can take one of the following + // values: - OUTAGE: The Interconnect may be completely out of service for + // some or all of the specified window. - PARTIAL_OUTAGE: Some circuits + // comprising the Interconnect as a whole should remain up, but with reduced + // bandwidth. Note that the versions of this enum prefixed with "IT_" have + // been deprecated in favor of the unprefixed values. + // IT_OUTAGE: [Deprecated] The Interconnect may be completely out of service + // for some or all of the specified window. + // IT_PARTIAL_OUTAGE: [Deprecated] Some circuits comprising the Interconnect + // will be out of service during the expected window. The interconnect as a + // whole should remain up, albeit with reduced bandwidth. + // OUTAGE: The Interconnect may be completely out of service for some or all + // of the specified window. + // PARTIAL_OUTAGE: Some circuits comprising the Interconnect will be out of + // service during the expected window. The interconnect as a whole should + // remain up, albeit with reduced bandwidth. + optional string issue_type = 4 [json_name = "issueType"]; + + // Unique identifier for this outage notification. + optional string name = 5 [json_name = "name"]; + + // The party that generated this notification, which can take the following + // value: - GOOGLE: this notification as generated by Google. Note that the + // value of NSRC_GOOGLE has been deprecated in favor of GOOGLE. + // GOOGLE: This notification was generated by Google. + // NSRC_GOOGLE: [Deprecated] This notification was generated by Google. + optional string source = 6 [json_name = "source"]; + + // Scheduled start time for the outage (milliseconds since Unix epoch). + optional string start_time = 7 [json_name = "startTime"]; + + // State of this notification, which can take one of the following values: - + // ACTIVE: This outage notification is active. The event could be in the past, + // present, or future. See start_time and end_time for scheduling. - + // CANCELLED: The outage associated with this notification was cancelled + // before the outage was due to start. - COMPLETED: The outage associated with + // this notification is complete. Note that the versions of this enum prefixed + // with "NS_" have been deprecated in favor of the unprefixed values. + // ACTIVE: This outage notification is active. The event could be in the + // future, present, or past. See start_time and end_time for scheduling. + // CANCELLED: The outage associated with this notification was cancelled + // before the outage was due to start. + // COMPLETED: The outage associated with this notification is complete. + // NS_ACTIVE: [Deprecated] This outage notification is active. The event could + // be in the future, present, or past. See start_time and end_time for + // scheduling. + // NS_CANCELED: [Deprecated] The outage associated with this notification was + // canceled before the outage was due to start. + optional string state = 8 [json_name = "state"]; +} + +// Response for the InterconnectsGetDiagnosticsRequest. +message InterconnectsGetDiagnosticsResponse { + optional InterconnectDiagnostics result = 1 [json_name = "result"]; +} + +// Response for the InterconnectsGetMacsecConfigRequest. +message InterconnectsGetMacsecConfigResponse { + // end_interface: MixerGetResponseWithEtagBuilder + optional string etag = 1 [json_name = "etag"]; + + optional InterconnectMacsecConfig result = 2 [json_name = "result"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_067.proto b/protos/google/cloud/compute/v1/internal/common_067.proto index f6d7fd9dc04d6..d9c2f44a3fc33 100644 --- a/protos/google/cloud/compute/v1/internal/common_067.proto +++ b/protos/google/cloud/compute/v1/internal/common_067.proto @@ -15,24 +15,335 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_066.proto"; +import "google/cloud/compute/v1/internal/common_068.proto"; -message InstantSnapshotAggregatedList { +// Represents an Interconnect Attachment (VLAN) resource. You can use +// Interconnect attachments (VLANS) to connect your Virtual Private Cloud +// networks to your on-premises networks through an Interconnect. For more +// information, read Creating VLAN Attachments. +message InterconnectAttachment { + // Determines whether this Attachment will carry packets. Not present for + // PARTNER_PROVIDER. + optional bool admin_enabled = 1 [json_name = "adminEnabled"]; + + // Provisioned bandwidth capacity for the interconnect attachment. For + // attachments of type DEDICATED, the user can set the bandwidth. For + // attachments of type PARTNER, the Google Partner that is operating the + // interconnect must set the bandwidth. Output only for PARTNER type, mutable + // for PARTNER_PROVIDER and DEDICATED, and can take one of the following + // values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s + // - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - + // BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s + // - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s + // BPS_100M: 100 Mbit/s + // BPS_10G: 10 Gbit/s + // BPS_1G: 1 Gbit/s + // BPS_200M: 200 Mbit/s + // BPS_20G: 20 Gbit/s + // BPS_2G: 2 Gbit/s + // BPS_300M: 300 Mbit/s + // BPS_400M: 400 Mbit/s + // BPS_500M: 500 Mbit/s + // BPS_50G: 50 Gbit/s + // BPS_50M: 50 Mbit/s + // BPS_5G: 5 Gbit/s + optional string bandwidth = 2 [json_name = "bandwidth"]; + + // This field is not available. + repeated string candidate_ipv6_subnets = 3 + [json_name = "candidateIpv6Subnets"]; + + // Up to 16 candidate prefixes that can be used to restrict the allocation of + // cloudRouterIpAddress and customerRouterIpAddress for this attachment. All + // prefixes must be within link-local address space (169.254.0.0/16) and must + // be /29 or shorter (/28, /27, etc). Google will attempt to select an unused + // /29 from the supplied candidate prefix(es). The request will fail if all + // possible /29s are in use on Google's edge. If not supplied, Google will + // randomly select an unused /29 from all of link-local space. + repeated string candidate_subnets = 4 [json_name = "candidateSubnets"]; + + // [Output Only] IPv4 address + prefix length to be configured on Cloud Router + // Interface for this interconnect attachment. + optional string cloud_router_ip_address = 5 + [json_name = "cloudRouterIpAddress"]; + + // [Output Only] IPv6 address + prefix length to be configured on Cloud Router + // Interface for this interconnect attachment. + optional string cloud_router_ipv6_address = 6 + [json_name = "cloudRouterIpv6Address"]; + + // This field is not available. + optional string cloud_router_ipv6_interface_id = 7 + [json_name = "cloudRouterIpv6InterfaceId"]; + + // [Output Only] Constraints for this attachment, if any. The attachment does + // not work if these constraints are not met. + optional InterconnectAttachmentConfigurationConstraints + configuration_constraints = 36 [json_name = "configurationConstraints"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 8 [json_name = "creationTimestamp"]; + + // [Output Only] IPv4 address + prefix length to be configured on the customer + // router subinterface for this interconnect attachment. + optional string customer_router_ip_address = 9 + [json_name = "customerRouterIpAddress"]; + + // [Output Only] IPv6 address + prefix length to be configured on the customer + // router subinterface for this interconnect attachment. + optional string customer_router_ipv6_address = 10 + [json_name = "customerRouterIpv6Address"]; + + // This field is not available. + optional string customer_router_ipv6_interface_id = 11 + [json_name = "customerRouterIpv6InterfaceId"]; + + // [Output Only] Dataplane version for this InterconnectAttachment. This field + // is only present for Dataplane version 2 and higher. Absence of this field + // in the API output indicates that the Dataplane is version 1. + optional int32 dataplane_version = 12 [json_name = "dataplaneVersion"]; + + // An optional description of this resource. + optional string description = 13 [json_name = "description"]; + + // Desired availability domain for the attachment. Only available for type + // PARTNER, at creation time, and can take one of the following values: - + // AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For + // improved reliability, customers should configure a pair of attachments, one + // per availability domain. The selected availability domain will be provided + // to the Partner via the pairing key, so that the provisioned circuit will + // lie in the specified domain. If not specified, the value will default to + // AVAILABILITY_DOMAIN_ANY. + // AVAILABILITY_DOMAIN_1: + // AVAILABILITY_DOMAIN_2: + // AVAILABILITY_DOMAIN_ANY: + optional string edge_availability_domain = 14 + [json_name = "edgeAvailabilityDomain"]; + + // Indicates the user-supplied encryption option of this VLAN attachment + // (interconnectAttachment). Can only be specified at attachment creation for + // PARTNER or DEDICATED attachments. Possible values are: - NONE - This is the + // default value, which means that the VLAN attachment carries unencrypted + // traffic. VMs are able to send traffic to, or receive traffic from, such a + // VLAN attachment. - IPSEC - The VLAN attachment carries only encrypted + // traffic that is encrypted by an IPsec device, such as an HA VPN gateway or + // third-party IPsec VPN. VMs cannot directly send traffic to, or receive + // traffic from, such a VLAN attachment. To use *HA VPN over Cloud + // Interconnect*, the VLAN attachment must be created with this option. + // IPSEC: The interconnect attachment will carry only encrypted traffic that + // is encrypted by an IPsec device such as HA VPN gateway; VMs cannot directly + // send traffic to or receive traffic from such an interconnect attachment. To + // use HA VPN over Cloud Interconnect, the interconnect attachment must be + // created with this option. + // NONE: This is the default value, which means the Interconnect Attachment + // will carry unencrypted traffic. VMs will be able to send traffic to or + // receive traffic from such interconnect attachment. + optional string encryption = 15 [json_name = "encryption"]; + + // [Output Only] Google reference ID, to be used when raising support tickets + // with Google or otherwise to debug backend connectivity issues. [Deprecated] + // This field is not used. + optional string google_reference_id = 16 [json_name = "googleReferenceId"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 17 [json_name = "id"]; + + // URL of the underlying Interconnect object that this attachment's traffic + // will traverse through. + optional string interconnect = 18 [json_name = "interconnect"]; + + // A list of URLs of addresses that have been reserved for the VLAN + // attachment. Used only for the VLAN attachment that has the encryption + // option as IPSEC. The addresses must be regional internal IP address ranges. + // When creating an HA VPN gateway over the VLAN attachment, if the attachment + // is configured to use a regional internal IP address, then the VPN gateway's + // IP address is allocated from the IP address range specified here. For + // example, if the HA VPN gateway's interface 0 is paired to this VLAN + // attachment, then a regional internal IP address for the VPN gateway + // interface 0 will be allocated from the IP address specified for this VLAN + // attachment. If this field is not specified when creating the VLAN + // attachment, then later on when creating an HA VPN gateway on this VLAN + // attachment, the HA VPN gateway's IP address is allocated from the regional + // external IP address pool. + repeated string ipsec_internal_addresses = 19 + [json_name = "ipsecInternalAddresses"]; + + // [Output Only] Type of the resource. Always compute#interconnectAttachment + // for interconnect attachments. + optional string kind = 20 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this InterconnectAttachment, + // which is essentially a hash of the labels set used for optimistic locking. + // The fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels, otherwise + // the request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve an InterconnectAttachment. + optional string label_fingerprint = 37 [json_name = "labelFingerprint"]; + + // Labels for this resource. These can only be added or modified by the + // setLabels method. Each label key/value pair must comply with RFC1035. Label + // values may be empty. + map labels = 38 [json_name = "labels"]; + + // Maximum Transmission Unit (MTU), in bytes, of packets passing through this + // interconnect attachment. Only 1440 and 1500 are allowed. If not specified, + // the value will default to 1440. + optional int32 mtu = 21 [json_name = "mtu"]; + + // 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. + optional string name = 22 [json_name = "name"]; + + // [Output Only] The current status of whether or not this interconnect + // attachment is functional, which can take one of the following values: - + // OS_ACTIVE: The attachment has been turned up and is ready to use. - + // OS_UNPROVISIONED: The attachment is not ready to use yet, because turnup is + // not complete. + // OS_ACTIVE: Indicates that attachment has been turned up and is ready to + // use. + // OS_UNPROVISIONED: Indicates that attachment is not ready to use yet, + // because turnup is not complete. + optional string operational_status = 23 [json_name = "operationalStatus"]; + + // [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not present + // for DEDICATED]. The opaque identifier of a PARTNER attachment used to + // initiate provisioning with a selected partner. Of the form + // "XXXXX/region/domain" + optional string pairing_key = 24 [json_name = "pairingKey"]; + + // Optional BGP ASN for the router supplied by a Layer 3 Partner if they + // configured BGP on behalf of the customer. Output only for PARTNER type, + // input only for PARTNER_PROVIDER, not available for DEDICATED. + optional string partner_asn = 25 [json_name = "partnerAsn"]; + + // Informational metadata about Partner attachments from Partners to display + // to customers. Output only for PARTNER type, mutable for PARTNER_PROVIDER, + // not available for DEDICATED. + optional InterconnectAttachmentPartnerMetadata partner_metadata = 26 + [json_name = "partnerMetadata"]; + + // [Output Only] Information specific to an InterconnectAttachment. This + // property is populated if the interconnect that this is attached to is of + // type DEDICATED. + optional InterconnectAttachmentPrivateInfo private_interconnect_info = 27 + [json_name = "privateInterconnectInfo"]; + + // [Output Only] URL of the region where the regional interconnect attachment + // resides. You must specify this field as part of the HTTP request URL. It is + // not settable as a field in the request body. + optional string region = 28 [json_name = "region"]; + + // [Output Only] If the attachment is on a Cross-Cloud Interconnect + // connection, this field contains the interconnect's remote location service + // provider. Example values: "Amazon Web Services" "Microsoft Azure". The + // field is set only for attachments on Cross-Cloud Interconnect connections. + // Its value is copied from the InterconnectRemoteLocation remoteService + // field. + optional string remote_service = 39 [json_name = "remoteService"]; + + // URL of the Cloud Router to be used for dynamic routing. This router must be + // in the same region as this InterconnectAttachment. The + // InterconnectAttachment will automatically connect the Interconnect to the + // network & region within which the Cloud Router is configured. + optional string router = 29 [json_name = "router"]; + + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 30 [json_name = "satisfiesPzs"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 31 [json_name = "selfLink"]; + + // The stack type for this interconnect attachment to identify whether the + // IPv6 feature is enabled or not. If not specified, IPV4_ONLY will be used. + // This field can be both set at interconnect attachments creation and update + // interconnect attachment operations. + // IPV4_IPV6: The interconnect attachment can have both IPv4 and IPv6 + // addresses. + // IPV4_ONLY: The interconnect attachment will only be assigned IPv4 + // addresses. + optional string stack_type = 32 [json_name = "stackType"]; + + // [Output Only] The current state of this attachment's functionality. Enum + // values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, PARTNER, + // and PARTNER_PROVIDER interconnect attachments, while enum values + // PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used + // for only PARTNER and PARTNER_PROVIDER interconnect attachments. This state + // can take one of the following values: - ACTIVE: The attachment has been + // turned up and is ready to use. - UNPROVISIONED: The attachment is not ready + // to use yet, because turnup is not complete. - PENDING_PARTNER: A + // newly-created PARTNER attachment that has not yet been configured on the + // Partner side. - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the + // process of provisioning after a PARTNER_PROVIDER attachment was created + // that references it. - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER + // attachment that is waiting for a customer to activate it. - DEFUNCT: The + // attachment was deleted externally and is no longer functional. This could + // be because the associated Interconnect was removed, or because the other + // side of a Partner attachment was deleted. + // ACTIVE: Indicates that attachment has been turned up and is ready to use. + // DEFUNCT: The attachment was deleted externally and is no longer functional. + // This could be because the associated Interconnect was wiped out, or because + // the other side of a Partner attachment was deleted. + // PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of + // provisioning after a PARTNER_PROVIDER attachment was created that + // references it. + // PENDING_CUSTOMER: PARTNER or PARTNER_PROVIDER attachment that is waiting + // for the customer to activate. + // PENDING_PARTNER: A newly created PARTNER attachment that has not yet been + // configured on the Partner side. + // STATE_UNSPECIFIED: + // UNPROVISIONED: Indicates that attachment is not ready to use yet, because + // turnup is not complete. + optional string state = 33 [json_name = "state"]; + + // Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The + // default value is 29, except for Cross-Cloud Interconnect connections that + // use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min + // equal to 30. For example, connections that use an Azure remote location + // fall into this category. In these cases, the default value is 30, and + // requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is + // preferred, because it gives Google Cloud Support more debugging visibility. + optional int32 subnet_length = 40 [json_name = "subnetLength"]; + + // The type of interconnect attachment this is, which can take one of the + // following values: - DEDICATED: an attachment to a Dedicated Interconnect. - + // PARTNER: an attachment to a Partner Interconnect, created by the customer. + // - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by the + // partner. + // DEDICATED: Attachment to a dedicated interconnect. + // PARTNER: Attachment to a partner interconnect, created by the customer. + // PARTNER_PROVIDER: Attachment to a partner interconnect, created by the + // partner. + optional string type = 34 [json_name = "type"]; + + // The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. Only + // specified at creation time. + optional int32 vlan_tag8021q = 35 [json_name = "vlanTag8021q"]; +} + +message InterconnectAttachmentAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of InstantSnapshotsScopedList resources. - map items = 2 [json_name = "items"]; + // A list of InterconnectAttachmentsScopedList resources. + map items = 2 + [json_name = "items"]; // [Output Only] Type of resource. Always - // compute#instantSnapshotAggregatedList for aggregated lists of - // instantSnapshots. + // compute#interconnectAttachmentAggregatedList for aggregated lists of + // interconnect attachments. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -133,10 +444,145 @@ message InstantSnapshotAggregatedList { optional Warning warning = 7 [json_name = "warning"]; } -message InstantSnapshotsScopedList { - // [Output Only] A list of instantSnapshots contained in this scope. - repeated InstantSnapshot instant_snapshots = 1 - [json_name = "instantSnapshots"]; +// Response to the list request, and contains a list of interconnect +// attachments. +message InterconnectAttachmentList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of InterconnectAttachment resources. + repeated InterconnectAttachment items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#interconnectAttachmentList + // for lists of interconnect attachments. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +// Informational metadata about Partner attachments from Partners to display to +// customers. These fields are propagated from PARTNER_PROVIDER attachments to +// their corresponding PARTNER attachments. +message InterconnectAttachmentPartnerMetadata { + // Plain text name of the Interconnect this attachment is connected to, as + // displayed in the Partner's portal. For instance "Chicago 1". This value may + // be validated to match approved Partner values. + optional string interconnect_name = 1 [json_name = "interconnectName"]; + + // Plain text name of the Partner providing this attachment. This value may be + // validated to match approved Partner values. + optional string partner_name = 2 [json_name = "partnerName"]; + + // URL of the Partner's portal for this Attachment. Partners may customise + // this to be a deep link to the specific resource on the Partner portal. This + // value may be validated to match approved Partner values. + optional string portal_url = 3 [json_name = "portalUrl"]; +} + +// Information for an interconnect attachment when this belongs to an +// interconnect of type DEDICATED. +message InterconnectAttachmentPrivateInfo { + // [Output Only] 802.1q encapsulation tag to be used for traffic between + // Google and the customer, going to and from this network and region. + optional uint32 tag8021q = 1 [json_name = "tag8021q"]; +} + +message InterconnectAttachmentsScopedList { + // A list of interconnect attachments contained in this scope. + repeated InterconnectAttachment interconnect_attachments = 1 + [json_name = "interconnectAttachments"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -219,7 +665,7 @@ message InstantSnapshotsScopedList { optional string message = 3 [json_name = "message"]; } - // [Output Only] Informational warning which replaces the list of - // instantSnapshots when the list is empty. + // Informational warning which replaces the list of addresses when the list is + // empty. optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_068.proto b/protos/google/cloud/compute/v1/internal/common_068.proto index c215208febc24..02d54f310d0a8 100644 --- a/protos/google/cloud/compute/v1/internal/common_068.proto +++ b/protos/google/cloud/compute/v1/internal/common_068.proto @@ -15,590 +15,40 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents an Interconnect resource. An Interconnect resource is a dedicated -// connection between the Google Cloud network and your on-premises network. For -// more information, read the Dedicated Interconnect Overview. -message Interconnect { - // Administrative status of the interconnect. When this is set to true, the - // Interconnect is functional and can carry traffic. When set to false, no - // packets can be carried over the interconnect and no BGP routes are - // exchanged over it. By default, the status is set to true. - optional bool admin_enabled = 1 [json_name = "adminEnabled"]; - - // [Output only] List of features available for this Interconnect connection, - // which can take one of the following values: - MACSEC If present then the - // Interconnect connection is provisioned on MACsec capable hardware ports. If - // not present then the Interconnect connection is provisioned on non-MACsec - // capable ports and MACsec isn't supported and enabling MACsec fails. - repeated string available_features = 27 [json_name = "availableFeatures"]; - - // [Output Only] A list of CircuitInfo objects, that describe the individual - // circuits in this LAG. - repeated InterconnectCircuitInfo circuit_infos = 2 - [json_name = "circuitInfos"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; - - // Customer name, to put in the Letter of Authorization as the party - // authorized to request a crossconnect. - optional string customer_name = 4 [json_name = "customerName"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 5 [json_name = "description"]; - - // [Output Only] A list of outages expected for this Interconnect. - repeated InterconnectOutageNotification expected_outages = 6 - [json_name = "expectedOutages"]; - - // [Output Only] IP address configured on the Google side of the Interconnect - // link. This can be used only for ping tests. - optional string google_ip_address = 7 [json_name = "googleIpAddress"]; - - // [Output Only] Google reference ID to be used when raising support tickets - // with Google or otherwise to debug backend connectivity issues. - optional string google_reference_id = 8 [json_name = "googleReferenceId"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 9 [json_name = "id"]; - - // [Output Only] A list of the URLs of all InterconnectAttachments configured - // to use this Interconnect. - repeated string interconnect_attachments = 10 - [json_name = "interconnectAttachments"]; - - // Type of interconnect, which can take one of the following values: - - // PARTNER: A partner-managed interconnection shared between customers though - // a partner. - DEDICATED: A dedicated physical interconnection with the - // customer. Note that a value IT_PRIVATE has been deprecated in favor of - // DEDICATED. - // DEDICATED: A dedicated physical interconnection with the customer. - // IT_PRIVATE: [Deprecated] A private, physical interconnection with the - // customer. - // PARTNER: A partner-managed interconnection shared between customers via - // partner. - optional string interconnect_type = 11 [json_name = "interconnectType"]; - - // [Output Only] Type of the resource. Always compute#interconnect for - // interconnects. - optional string kind = 12 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this Interconnect, which is - // essentially a hash of the labels set used for optimistic locking. The - // fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels, otherwise - // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve an Interconnect. - optional string label_fingerprint = 24 [json_name = "labelFingerprint"]; - - // Labels for this resource. These can only be added or modified by the - // setLabels method. Each label key/value pair must comply with RFC1035. Label - // values may be empty. - map labels = 25 [json_name = "labels"]; - - // Type of link requested, which can take one of the following values: - - // LINK_TYPE_ETHERNET_10G_LR: A 10G Ethernet with LR optics - - // LINK_TYPE_ETHERNET_100G_LR: A 100G Ethernet with LR optics. Note that this - // field indicates the speed of each of the links in the bundle, not the speed - // of the entire bundle. - // LINK_TYPE_ETHERNET_100G_LR: 100G Ethernet, LR Optics. - // LINK_TYPE_ETHERNET_10G_LR: 10G Ethernet, LR Optics. [(rate_bps) = - // 10000000000]; - optional string link_type = 13 [json_name = "linkType"]; - - // URL of the InterconnectLocation object that represents where this - // connection is to be provisioned. - optional string location = 14 [json_name = "location"]; - - // Configuration that enables Media Access Control security (MACsec) on the - // Cloud Interconnect connection between Google and your on-premises router. - optional InterconnectMacsec macsec = 28 [json_name = "macsec"]; - - // Enable or disable MACsec on this Interconnect connection. MACsec enablement - // fails if the MACsec object is not specified. - optional bool macsec_enabled = 29 [json_name = "macsecEnabled"]; - - // 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. - optional string name = 15 [json_name = "name"]; - - // Email address to contact the customer NOC for operations and maintenance - // notifications regarding this Interconnect. If specified, this will be used - // for notifications in addition to all other forms described, such as Cloud - // Monitoring logs alerting and Cloud Notifications. This field is required - // for users who sign up for Cloud Interconnect using workforce identity - // federation. - optional string noc_contact_email = 16 [json_name = "nocContactEmail"]; - - // [Output Only] The current status of this Interconnect's functionality, - // which can take one of the following values: - OS_ACTIVE: A valid - // Interconnect, which is turned up and is ready to use. Attachments may be - // provisioned on this Interconnect. - OS_UNPROVISIONED: An Interconnect that - // has not completed turnup. No attachments may be provisioned on this - // Interconnect. - OS_UNDER_MAINTENANCE: An Interconnect that is undergoing - // internal maintenance. No attachments may be provisioned or updated on this - // Interconnect. - // OS_ACTIVE: The interconnect is valid, turned up, and ready to use. - // Attachments may be provisioned on this interconnect. - // OS_UNPROVISIONED: The interconnect has not completed turnup. No attachments - // may be provisioned on this interconnect. - optional string operational_status = 17 [json_name = "operationalStatus"]; - - // [Output Only] IP address configured on the customer side of the - // Interconnect link. The customer should configure this IP address during - // turnup when prompted by Google NOC. This can be used only for ping tests. - optional string peer_ip_address = 18 [json_name = "peerIpAddress"]; - - // [Output Only] Number of links actually provisioned in this interconnect. - optional int32 provisioned_link_count = 19 - [json_name = "provisionedLinkCount"]; - - // Indicates that this is a Cross-Cloud Interconnect. This field specifies the - // location outside of Google's network that the interconnect is connected to. - optional string remote_location = 26 [json_name = "remoteLocation"]; - - // Optional. List of features requested for this Interconnect connection, - // which can take one of the following values: - MACSEC If specified then the - // connection is created on MACsec capable hardware ports. If not specified, - // the default value is false, which allocates non-MACsec capable ports first - // if available. This parameter can be provided only with Interconnect INSERT. - // It isn't valid for Interconnect PATCH. - repeated string requested_features = 30 [json_name = "requestedFeatures"]; - - // Target number of physical links in the link bundle, as requested by the - // customer. - optional int32 requested_link_count = 20 [json_name = "requestedLinkCount"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzs = 21 [json_name = "satisfiesPzs"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 22 [json_name = "selfLink"]; - - // [Output Only] The current state of Interconnect functionality, which can - // take one of the following values: - ACTIVE: The Interconnect is valid, - // turned up and ready to use. Attachments may be provisioned on this - // Interconnect. - UNPROVISIONED: The Interconnect has not completed turnup. - // No attachments may be provisioned on this Interconnect. - - // UNDER_MAINTENANCE: The Interconnect is undergoing internal maintenance. No - // attachments may be provisioned or updated on this Interconnect. - // ACTIVE: The interconnect is valid, turned up, and ready to use. Attachments - // may be provisioned on this interconnect. - // UNPROVISIONED: The interconnect has not completed turnup. No attachments - // may be provisioned on this interconnect. - optional string state = 23 [json_name = "state"]; -} - -// Describes a single physical circuit between the Customer and Google. -// CircuitInfo objects are created by Google, so all fields are output only. -message InterconnectCircuitInfo { - // Customer-side demarc ID for this circuit. - optional string customer_demarc_id = 1 [json_name = "customerDemarcId"]; - - // Google-assigned unique ID for this circuit. Assigned at circuit turn-up. - optional string google_circuit_id = 2 [json_name = "googleCircuitId"]; - - // Google-side demarc ID for this circuit. Assigned at circuit turn-up and - // provided by Google to the customer in the LOA. - optional string google_demarc_id = 3 [json_name = "googleDemarcId"]; -} - -// Diagnostics information about the Interconnect connection, which contains -// detailed and current technical information about Google's side of the -// connection. -message InterconnectDiagnostics { - // A list of InterconnectDiagnostics.ARPEntry objects, describing individual - // neighbors currently seen by the Google router in the ARP cache for the - // Interconnect. This will be empty when the Interconnect is not bundled. - repeated InterconnectDiagnosticsARPEntry arp_caches = 1 - [json_name = "arpCaches"]; - - // The aggregation type of the bundle interface. - // BUNDLE_AGGREGATION_TYPE_LACP: LACP is enabled. - // BUNDLE_AGGREGATION_TYPE_STATIC: LACP is disabled. - optional string bundle_aggregation_type = 2 - [json_name = "bundleAggregationType"]; - - // The operational status of the bundle interface. - // BUNDLE_OPERATIONAL_STATUS_DOWN: If bundleAggregationType is LACP: LACP is - // not established and/or all links in the bundle have DOWN operational - // status. If bundleAggregationType is STATIC: one or more links in the bundle - // has DOWN operational status. - // BUNDLE_OPERATIONAL_STATUS_UP: If bundleAggregationType is LACP: LACP is - // established and at least one link in the bundle has UP operational status. - // If bundleAggregationType is STATIC: all links in the bundle (typically just - // one) have UP operational status. - optional string bundle_operational_status = 3 - [json_name = "bundleOperationalStatus"]; - - // A list of InterconnectDiagnostics.LinkStatus objects, describing the status - // for each link on the Interconnect. - repeated InterconnectDiagnosticsLinkStatus links = 4 [json_name = "links"]; - - // The MAC address of the Interconnect's bundle interface. - optional string mac_address = 5 [json_name = "macAddress"]; -} - -// Describing the ARP neighbor entries seen on this link -message InterconnectDiagnosticsARPEntry { - // The IP address of this ARP neighbor. - optional string ip_address = 1 [json_name = "ipAddress"]; - - // The MAC address of this ARP neighbor. - optional string mac_address = 2 [json_name = "macAddress"]; -} - -message InterconnectDiagnosticsLinkLACPStatus { - // System ID of the port on Google's side of the LACP exchange. - optional string google_system_id = 1 [json_name = "googleSystemId"]; - - // System ID of the port on the neighbor's side of the LACP exchange. - optional string neighbor_system_id = 2 [json_name = "neighborSystemId"]; - - // The state of a LACP link, which can take one of the following values: - - // ACTIVE: The link is configured and active within the bundle. - DETACHED: - // The link is not configured within the bundle. This means that the rest of - // the object should be empty. - // ACTIVE: The link is configured and active within the bundle. - // DETACHED: The link is not configured within the bundle, this means the rest - // of the object should be empty. - optional string state = 3 [json_name = "state"]; -} - -message InterconnectDiagnosticsLinkOpticalPower { - // The status of the current value when compared to the warning and alarm - // levels for the receiving or transmitting transceiver. Possible states - // include: - OK: The value has not crossed a warning threshold. - - // LOW_WARNING: The value has crossed below the low warning threshold. - - // HIGH_WARNING: The value has crossed above the high warning threshold. - - // LOW_ALARM: The value has crossed below the low alarm threshold. - - // HIGH_ALARM: The value has crossed above the high alarm threshold. - // HIGH_ALARM: The value has crossed above the high alarm threshold. - // HIGH_WARNING: The value of the current optical power has crossed above the - // high warning threshold. - // LOW_ALARM: The value of the current optical power has crossed below the low - // alarm threshold. - // LOW_WARNING: The value of the current optical power has crossed below the - // low warning threshold. - // OK: The value of the current optical power has not crossed a warning - // threshold. - optional string state = 1 [json_name = "state"]; - - // Value of the current receiving or transmitting optical power, read in dBm. - // Take a known good optical value, give it a 10% margin and trigger warnings - // relative to that value. In general, a -7dBm warning and a -11dBm alarm are - // good optical value estimates for most links. - optional float value = 2 [json_name = "value"]; -} - -message InterconnectDiagnosticsLinkStatus { - // A list of InterconnectDiagnostics.ARPEntry objects, describing the ARP - // neighbor entries seen on this link. This will be empty if the link is - // bundled - repeated InterconnectDiagnosticsARPEntry arp_caches = 1 - [json_name = "arpCaches"]; - - // The unique ID for this link assigned during turn up by Google. - optional string circuit_id = 2 [json_name = "circuitId"]; - - // The Demarc address assigned by Google and provided in the LoA. - optional string google_demarc = 3 [json_name = "googleDemarc"]; - - optional InterconnectDiagnosticsLinkLACPStatus lacp_status = 4 - [json_name = "lacpStatus"]; - - // Describes the status of MACsec encryption on this link. - optional InterconnectDiagnosticsMacsecStatus macsec = 8 - [json_name = "macsec"]; - - // The operational status of the link. - // LINK_OPERATIONAL_STATUS_DOWN: The interface is unable to communicate with - // the remote end. - // LINK_OPERATIONAL_STATUS_UP: The interface has low level communication with - // the remote end. - optional string operational_status = 5 [json_name = "operationalStatus"]; - - // An InterconnectDiagnostics.LinkOpticalPower object, describing the current - // value and status of the received light level. - optional InterconnectDiagnosticsLinkOpticalPower receiving_optical_power = 6 - [json_name = "receivingOpticalPower"]; - - // An InterconnectDiagnostics.LinkOpticalPower object, describing the current - // value and status of the transmitted light level. - optional InterconnectDiagnosticsLinkOpticalPower transmitting_optical_power = - 7 [json_name = "transmittingOpticalPower"]; -} - -// Describes the status of MACsec encryption on the link. -message InterconnectDiagnosticsMacsecStatus { - // Indicates the Connectivity Association Key Name (CKN) currently being used - // if MACsec is operational. - optional string ckn = 1 [json_name = "ckn"]; - - // Indicates whether or not MACsec is operational on this link. - optional bool operational = 2 [json_name = "operational"]; -} - -// Response to the list request, and contains a list of interconnects. -message InterconnectList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of Interconnect resources. - repeated Interconnect items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#interconnectList for lists - // of interconnects. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// Configuration information for enabling Media Access Control security (MACsec) -// on this Cloud Interconnect connection between Google and your on-premises -// router. -message InterconnectMacsec { - // If set to true, the Interconnect connection is configured with a - // should-secure MACsec security policy, that allows the Google router to - // fallback to cleartext traffic if the MKA session cannot be established. By - // default, the Interconnect connection is configured with a must-secure - // security policy that drops all traffic if the MKA session cannot be - // established with your router. - optional bool fail_open = 1 [json_name = "failOpen"]; - - // Required. A keychain placeholder describing a set of named key objects - // along with their start times. A MACsec CKN/CAK is generated for each key in - // the key chain. Google router automatically picks the key with the most - // recent startTime when establishing or re-establishing a MACsec secure link. - repeated InterconnectMacsecPreSharedKey pre_shared_keys = 2 - [json_name = "preSharedKeys"]; -} - -// MACsec configuration information for the Interconnect connection. Contains -// the generated Connectivity Association Key Name (CKN) and the key (CAK) for -// this Interconnect connection. -message InterconnectMacsecConfig { - // A keychain placeholder describing a set of named key objects along with - // their start times. A MACsec CKN/CAK is generated for each key in the key - // chain. Google router automatically picks the key with the most recent - // startTime when establishing or re-establishing a MACsec secure link. - repeated InterconnectMacsecConfigPreSharedKey pre_shared_keys = 1 - [json_name = "preSharedKeys"]; -} - -// Describes a pre-shared key used to setup MACsec in static connectivity -// association key (CAK) mode. -message InterconnectMacsecConfigPreSharedKey { - // An auto-generated Connectivity Association Key (CAK) for this key. - optional string cak = 1 [json_name = "cak"]; - - // An auto-generated Connectivity Association Key Name (CKN) for this key. - optional string ckn = 2 [json_name = "ckn"]; - - // User provided name for this pre-shared key. - optional string name = 3 [json_name = "name"]; - - // User provided timestamp on or after which this key is valid. - optional string start_time = 4 [json_name = "startTime"]; -} - -// Describes a pre-shared key used to setup MACsec in static connectivity -// association key (CAK) mode. -message InterconnectMacsecPreSharedKey { - // Required. A name for this pre-shared key. 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. - optional string name = 1 [json_name = "name"]; - - // A RFC3339 timestamp on or after which the key is valid. startTime can be in - // the future. If the keychain has a single key, startTime can be omitted. If - // the keychain has multiple keys, startTime is mandatory for each key. The - // start times of keys must be in increasing order. The start times of two - // consecutive keys must be at least 6 hours apart. - optional string start_time = 2 [json_name = "startTime"]; -} - -// Description of a planned outage on this Interconnect. -message InterconnectOutageNotification { - // If issue_type is IT_PARTIAL_OUTAGE, a list of the Google-side circuit IDs - // that will be affected. - repeated string affected_circuits = 1 [json_name = "affectedCircuits"]; - - // A description about the purpose of the outage. - optional string description = 2 [json_name = "description"]; - - // Scheduled end time for the outage (milliseconds since Unix epoch). - optional string end_time = 3 [json_name = "endTime"]; - - // Form this outage is expected to take, which can take one of the following - // values: - OUTAGE: The Interconnect may be completely out of service for - // some or all of the specified window. - PARTIAL_OUTAGE: Some circuits - // comprising the Interconnect as a whole should remain up, but with reduced - // bandwidth. Note that the versions of this enum prefixed with "IT_" have - // been deprecated in favor of the unprefixed values. - // IT_OUTAGE: [Deprecated] The Interconnect may be completely out of service - // for some or all of the specified window. - // IT_PARTIAL_OUTAGE: [Deprecated] Some circuits comprising the Interconnect - // will be out of service during the expected window. The interconnect as a - // whole should remain up, albeit with reduced bandwidth. - // OUTAGE: The Interconnect may be completely out of service for some or all - // of the specified window. - // PARTIAL_OUTAGE: Some circuits comprising the Interconnect will be out of - // service during the expected window. The interconnect as a whole should - // remain up, albeit with reduced bandwidth. - optional string issue_type = 4 [json_name = "issueType"]; - - // Unique identifier for this outage notification. - optional string name = 5 [json_name = "name"]; - - // The party that generated this notification, which can take the following - // value: - GOOGLE: this notification as generated by Google. Note that the - // value of NSRC_GOOGLE has been deprecated in favor of GOOGLE. - // GOOGLE: This notification was generated by Google. - // NSRC_GOOGLE: [Deprecated] This notification was generated by Google. - optional string source = 6 [json_name = "source"]; - - // Scheduled start time for the outage (milliseconds since Unix epoch). - optional string start_time = 7 [json_name = "startTime"]; - - // State of this notification, which can take one of the following values: - - // ACTIVE: This outage notification is active. The event could be in the past, - // present, or future. See start_time and end_time for scheduling. - - // CANCELLED: The outage associated with this notification was cancelled - // before the outage was due to start. - COMPLETED: The outage associated with - // this notification is complete. Note that the versions of this enum prefixed - // with "NS_" have been deprecated in favor of the unprefixed values. - // ACTIVE: This outage notification is active. The event could be in the - // future, present, or past. See start_time and end_time for scheduling. - // CANCELLED: The outage associated with this notification was cancelled - // before the outage was due to start. - // COMPLETED: The outage associated with this notification is complete. - // NS_ACTIVE: [Deprecated] This outage notification is active. The event could - // be in the future, present, or past. See start_time and end_time for - // scheduling. - // NS_CANCELED: [Deprecated] The outage associated with this notification was - // canceled before the outage was due to start. - optional string state = 8 [json_name = "state"]; -} - -// Response for the InterconnectsGetDiagnosticsRequest. -message InterconnectsGetDiagnosticsResponse { - optional InterconnectDiagnostics result = 1 [json_name = "result"]; -} - -// Response for the InterconnectsGetMacsecConfigRequest. -message InterconnectsGetMacsecConfigResponse { - // end_interface: MixerGetResponseWithEtagBuilder - optional string etag = 1 [json_name = "etag"]; - - optional InterconnectMacsecConfig result = 2 [json_name = "result"]; +message InterconnectAttachmentConfigurationConstraints { + // [Output Only] Whether the attachment's BGP session + // requires/allows/disallows BGP MD5 authentication. This can take one of the + // following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. For example, + // a Cross-Cloud Interconnect connection to a remote cloud provider that + // requires BGP MD5 authentication has the interconnectRemoteLocation + // attachment_configuration_constraints.bgp_md5 field set to MD5_REQUIRED, and + // that property is propagated to the attachment. Similarly, if BGP MD5 is + // MD5_UNSUPPORTED, an error is returned if MD5 is requested. + // MD5_OPTIONAL: MD5_OPTIONAL: BGP MD5 authentication is supported and can + // optionally be configured. + // MD5_REQUIRED: MD5_REQUIRED: BGP MD5 authentication must be configured. + // MD5_UNSUPPORTED: MD5_UNSUPPORTED: BGP MD5 authentication must not be + // configured + optional string bgp_md5 = 1 [json_name = "bgpMd5"]; + + // [Output Only] List of ASN ranges that the remote location is known to + // support. Formatted as an array of inclusive ranges {min: min-value, max: + // max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] + // allows the peer ASN to be 123 or anything in the range 64512-65534. This + // field is only advisory. Although the API accepts other ranges, these are + // the ranges that we recommend. + repeated InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange + bgp_peer_asn_ranges = 2 [json_name = "bgpPeerAsnRanges"]; +} + +message InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange { + optional uint32 max = 1 [json_name = "max"]; + + optional uint32 min = 2 [json_name = "min"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_069.proto b/protos/google/cloud/compute/v1/internal/common_069.proto index 2d053d423293e..7679c5137a12f 100644 --- a/protos/google/cloud/compute/v1/internal/common_069.proto +++ b/protos/google/cloud/compute/v1/internal/common_069.proto @@ -15,446 +15,118 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_070.proto"; - -// Represents an Interconnect Attachment (VLAN) resource. You can use -// Interconnect attachments (VLANS) to connect your Virtual Private Cloud -// networks to your on-premises networks through an Interconnect. For more -// information, read Creating VLAN Attachments. -message InterconnectAttachment { - // Determines whether this Attachment will carry packets. Not present for - // PARTNER_PROVIDER. - optional bool admin_enabled = 1 [json_name = "adminEnabled"]; - - // Provisioned bandwidth capacity for the interconnect attachment. For - // attachments of type DEDICATED, the user can set the bandwidth. For - // attachments of type PARTNER, the Google Partner that is operating the - // interconnect must set the bandwidth. Output only for PARTNER type, mutable - // for PARTNER_PROVIDER and DEDICATED, and can take one of the following - // values: - BPS_50M: 50 Mbit/s - BPS_100M: 100 Mbit/s - BPS_200M: 200 Mbit/s - // - BPS_300M: 300 Mbit/s - BPS_400M: 400 Mbit/s - BPS_500M: 500 Mbit/s - - // BPS_1G: 1 Gbit/s - BPS_2G: 2 Gbit/s - BPS_5G: 5 Gbit/s - BPS_10G: 10 Gbit/s - // - BPS_20G: 20 Gbit/s - BPS_50G: 50 Gbit/s - // BPS_100M: 100 Mbit/s - // BPS_10G: 10 Gbit/s - // BPS_1G: 1 Gbit/s - // BPS_200M: 200 Mbit/s - // BPS_20G: 20 Gbit/s - // BPS_2G: 2 Gbit/s - // BPS_300M: 300 Mbit/s - // BPS_400M: 400 Mbit/s - // BPS_500M: 500 Mbit/s - // BPS_50G: 50 Gbit/s - // BPS_50M: 50 Mbit/s - // BPS_5G: 5 Gbit/s - optional string bandwidth = 2 [json_name = "bandwidth"]; - - // This field is not available. - repeated string candidate_ipv6_subnets = 3 - [json_name = "candidateIpv6Subnets"]; - - // Up to 16 candidate prefixes that can be used to restrict the allocation of - // cloudRouterIpAddress and customerRouterIpAddress for this attachment. All - // prefixes must be within link-local address space (169.254.0.0/16) and must - // be /29 or shorter (/28, /27, etc). Google will attempt to select an unused - // /29 from the supplied candidate prefix(es). The request will fail if all - // possible /29s are in use on Google's edge. If not supplied, Google will - // randomly select an unused /29 from all of link-local space. - repeated string candidate_subnets = 4 [json_name = "candidateSubnets"]; - - // [Output Only] IPv4 address + prefix length to be configured on Cloud Router - // Interface for this interconnect attachment. - optional string cloud_router_ip_address = 5 - [json_name = "cloudRouterIpAddress"]; - - // [Output Only] IPv6 address + prefix length to be configured on Cloud Router - // Interface for this interconnect attachment. - optional string cloud_router_ipv6_address = 6 - [json_name = "cloudRouterIpv6Address"]; - - // This field is not available. - optional string cloud_router_ipv6_interface_id = 7 - [json_name = "cloudRouterIpv6InterfaceId"]; - - // [Output Only] Constraints for this attachment, if any. The attachment does - // not work if these constraints are not met. - optional InterconnectAttachmentConfigurationConstraints - configuration_constraints = 36 [json_name = "configurationConstraints"]; +// Represents an Interconnect Attachment (VLAN) Location resource. You can use +// this resource to find location details about an Interconnect attachment +// (VLAN). For more information about interconnect attachments, read Creating +// VLAN Attachments. +message InterconnectLocation { + // [Output Only] The postal address of the Point of Presence, each line in the + // address is separated by a newline character. + optional string address = 1 [json_name = "address"]; + + // [Output Only] Availability zone for this InterconnectLocation. Within a + // metropolitan area (metro), maintenance will not be simultaneously scheduled + // in more than one availability zone. Example: "zone1" or "zone2". + optional string availability_zone = 2 [json_name = "availabilityZone"]; + + // [Output only] List of features available at this InterconnectLocation, + // which can take one of the following values: - MACSEC + repeated string available_features = 17 [json_name = "availableFeatures"]; + + // [Output only] List of link types available at this InterconnectLocation, + // which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR - + // LINK_TYPE_ETHERNET_100G_LR + repeated string available_link_types = 18 [json_name = "availableLinkTypes"]; + + // [Output Only] Metropolitan area designator that indicates which city an + // interconnect is located. For example: "Chicago, IL", "Amsterdam, + // Netherlands". + optional string city = 3 [json_name = "city"]; + + // [Output Only] Continent for this location, which can take one of the + // following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - + // SOUTH_AMERICA + // AFRICA: + // ASIA_PAC: + // C_AFRICA: + // C_ASIA_PAC: + // C_EUROPE: + // C_NORTH_AMERICA: + // C_SOUTH_AMERICA: + // EUROPE: + // NORTH_AMERICA: + // SOUTH_AMERICA: + optional string continent = 4 [json_name = "continent"]; // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 8 [json_name = "creationTimestamp"]; - - // [Output Only] IPv4 address + prefix length to be configured on the customer - // router subinterface for this interconnect attachment. - optional string customer_router_ip_address = 9 - [json_name = "customerRouterIpAddress"]; - - // [Output Only] IPv6 address + prefix length to be configured on the customer - // router subinterface for this interconnect attachment. - optional string customer_router_ipv6_address = 10 - [json_name = "customerRouterIpv6Address"]; - - // This field is not available. - optional string customer_router_ipv6_interface_id = 11 - [json_name = "customerRouterIpv6InterfaceId"]; - - // [Output Only] Dataplane version for this InterconnectAttachment. This field - // is only present for Dataplane version 2 and higher. Absence of this field - // in the API output indicates that the Dataplane is version 1. - optional int32 dataplane_version = 12 [json_name = "dataplaneVersion"]; - - // An optional description of this resource. - optional string description = 13 [json_name = "description"]; - - // Desired availability domain for the attachment. Only available for type - // PARTNER, at creation time, and can take one of the following values: - - // AVAILABILITY_DOMAIN_ANY - AVAILABILITY_DOMAIN_1 - AVAILABILITY_DOMAIN_2 For - // improved reliability, customers should configure a pair of attachments, one - // per availability domain. The selected availability domain will be provided - // to the Partner via the pairing key, so that the provisioned circuit will - // lie in the specified domain. If not specified, the value will default to - // AVAILABILITY_DOMAIN_ANY. - // AVAILABILITY_DOMAIN_1: - // AVAILABILITY_DOMAIN_2: - // AVAILABILITY_DOMAIN_ANY: - optional string edge_availability_domain = 14 - [json_name = "edgeAvailabilityDomain"]; - - // Indicates the user-supplied encryption option of this VLAN attachment - // (interconnectAttachment). Can only be specified at attachment creation for - // PARTNER or DEDICATED attachments. Possible values are: - NONE - This is the - // default value, which means that the VLAN attachment carries unencrypted - // traffic. VMs are able to send traffic to, or receive traffic from, such a - // VLAN attachment. - IPSEC - The VLAN attachment carries only encrypted - // traffic that is encrypted by an IPsec device, such as an HA VPN gateway or - // third-party IPsec VPN. VMs cannot directly send traffic to, or receive - // traffic from, such a VLAN attachment. To use *HA VPN over Cloud - // Interconnect*, the VLAN attachment must be created with this option. - // IPSEC: The interconnect attachment will carry only encrypted traffic that - // is encrypted by an IPsec device such as HA VPN gateway; VMs cannot directly - // send traffic to or receive traffic from such an interconnect attachment. To - // use HA VPN over Cloud Interconnect, the interconnect attachment must be - // created with this option. - // NONE: This is the default value, which means the Interconnect Attachment - // will carry unencrypted traffic. VMs will be able to send traffic to or - // receive traffic from such interconnect attachment. - optional string encryption = 15 [json_name = "encryption"]; - - // [Output Only] Google reference ID, to be used when raising support tickets - // with Google or otherwise to debug backend connectivity issues. [Deprecated] - // This field is not used. - optional string google_reference_id = 16 [json_name = "googleReferenceId"]; + optional string creation_timestamp = 5 [json_name = "creationTimestamp"]; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 17 [json_name = "id"]; - - // URL of the underlying Interconnect object that this attachment's traffic - // will traverse through. - optional string interconnect = 18 [json_name = "interconnect"]; - - // A list of URLs of addresses that have been reserved for the VLAN - // attachment. Used only for the VLAN attachment that has the encryption - // option as IPSEC. The addresses must be regional internal IP address ranges. - // When creating an HA VPN gateway over the VLAN attachment, if the attachment - // is configured to use a regional internal IP address, then the VPN gateway's - // IP address is allocated from the IP address range specified here. For - // example, if the HA VPN gateway's interface 0 is paired to this VLAN - // attachment, then a regional internal IP address for the VPN gateway - // interface 0 will be allocated from the IP address specified for this VLAN - // attachment. If this field is not specified when creating the VLAN - // attachment, then later on when creating an HA VPN gateway on this VLAN - // attachment, the HA VPN gateway's IP address is allocated from the regional - // external IP address pool. - repeated string ipsec_internal_addresses = 19 - [json_name = "ipsecInternalAddresses"]; - - // [Output Only] Type of the resource. Always compute#interconnectAttachment - // for interconnect attachments. - optional string kind = 20 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this InterconnectAttachment, - // which is essentially a hash of the labels set used for optimistic locking. - // The fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels, otherwise - // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve an InterconnectAttachment. - optional string label_fingerprint = 37 [json_name = "labelFingerprint"]; - - // Labels for this resource. These can only be added or modified by the - // setLabels method. Each label key/value pair must comply with RFC1035. Label - // values may be empty. - map labels = 38 [json_name = "labels"]; - - // Maximum Transmission Unit (MTU), in bytes, of packets passing through this - // interconnect attachment. Only 1440 and 1500 are allowed. If not specified, - // the value will default to 1440. - optional int32 mtu = 21 [json_name = "mtu"]; - - // 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. - optional string name = 22 [json_name = "name"]; - - // [Output Only] The current status of whether or not this interconnect - // attachment is functional, which can take one of the following values: - - // OS_ACTIVE: The attachment has been turned up and is ready to use. - - // OS_UNPROVISIONED: The attachment is not ready to use yet, because turnup is - // not complete. - // OS_ACTIVE: Indicates that attachment has been turned up and is ready to - // use. - // OS_UNPROVISIONED: Indicates that attachment is not ready to use yet, - // because turnup is not complete. - optional string operational_status = 23 [json_name = "operationalStatus"]; - - // [Output only for type PARTNER. Input only for PARTNER_PROVIDER. Not present - // for DEDICATED]. The opaque identifier of a PARTNER attachment used to - // initiate provisioning with a selected partner. Of the form - // "XXXXX/region/domain" - optional string pairing_key = 24 [json_name = "pairingKey"]; - - // Optional BGP ASN for the router supplied by a Layer 3 Partner if they - // configured BGP on behalf of the customer. Output only for PARTNER type, - // input only for PARTNER_PROVIDER, not available for DEDICATED. - optional string partner_asn = 25 [json_name = "partnerAsn"]; - - // Informational metadata about Partner attachments from Partners to display - // to customers. Output only for PARTNER type, mutable for PARTNER_PROVIDER, - // not available for DEDICATED. - optional InterconnectAttachmentPartnerMetadata partner_metadata = 26 - [json_name = "partnerMetadata"]; - - // [Output Only] Information specific to an InterconnectAttachment. This - // property is populated if the interconnect that this is attached to is of - // type DEDICATED. - optional InterconnectAttachmentPrivateInfo private_interconnect_info = 27 - [json_name = "privateInterconnectInfo"]; - - // [Output Only] URL of the region where the regional interconnect attachment - // resides. You must specify this field as part of the HTTP request URL. It is - // not settable as a field in the request body. - optional string region = 28 [json_name = "region"]; - - // [Output Only] If the attachment is on a Cross-Cloud Interconnect - // connection, this field contains the interconnect's remote location service - // provider. Example values: "Amazon Web Services" "Microsoft Azure". The - // field is set only for attachments on Cross-Cloud Interconnect connections. - // Its value is copied from the InterconnectRemoteLocation remoteService - // field. - optional string remote_service = 39 [json_name = "remoteService"]; - - // URL of the Cloud Router to be used for dynamic routing. This router must be - // in the same region as this InterconnectAttachment. The - // InterconnectAttachment will automatically connect the Interconnect to the - // network & region within which the Cloud Router is configured. - optional string router = 29 [json_name = "router"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzs = 30 [json_name = "satisfiesPzs"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 31 [json_name = "selfLink"]; - - // The stack type for this interconnect attachment to identify whether the - // IPv6 feature is enabled or not. If not specified, IPV4_ONLY will be used. - // This field can be both set at interconnect attachments creation and update - // interconnect attachment operations. - // IPV4_IPV6: The interconnect attachment can have both IPv4 and IPv6 - // addresses. - // IPV4_ONLY: The interconnect attachment will only be assigned IPv4 - // addresses. - optional string stack_type = 32 [json_name = "stackType"]; - - // [Output Only] The current state of this attachment's functionality. Enum - // values ACTIVE and UNPROVISIONED are shared by DEDICATED/PRIVATE, PARTNER, - // and PARTNER_PROVIDER interconnect attachments, while enum values - // PENDING_PARTNER, PARTNER_REQUEST_RECEIVED, and PENDING_CUSTOMER are used - // for only PARTNER and PARTNER_PROVIDER interconnect attachments. This state - // can take one of the following values: - ACTIVE: The attachment has been - // turned up and is ready to use. - UNPROVISIONED: The attachment is not ready - // to use yet, because turnup is not complete. - PENDING_PARTNER: A - // newly-created PARTNER attachment that has not yet been configured on the - // Partner side. - PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the - // process of provisioning after a PARTNER_PROVIDER attachment was created - // that references it. - PENDING_CUSTOMER: A PARTNER or PARTNER_PROVIDER - // attachment that is waiting for a customer to activate it. - DEFUNCT: The - // attachment was deleted externally and is no longer functional. This could - // be because the associated Interconnect was removed, or because the other - // side of a Partner attachment was deleted. - // ACTIVE: Indicates that attachment has been turned up and is ready to use. - // DEFUNCT: The attachment was deleted externally and is no longer functional. - // This could be because the associated Interconnect was wiped out, or because - // the other side of a Partner attachment was deleted. - // PARTNER_REQUEST_RECEIVED: A PARTNER attachment is in the process of - // provisioning after a PARTNER_PROVIDER attachment was created that - // references it. - // PENDING_CUSTOMER: PARTNER or PARTNER_PROVIDER attachment that is waiting - // for the customer to activate. - // PENDING_PARTNER: A newly created PARTNER attachment that has not yet been - // configured on the Partner side. - // STATE_UNSPECIFIED: - // UNPROVISIONED: Indicates that attachment is not ready to use yet, because - // turnup is not complete. - optional string state = 33 [json_name = "state"]; - - // Length of the IPv4 subnet mask. Allowed values: - 29 (default) - 30 The - // default value is 29, except for Cross-Cloud Interconnect connections that - // use an InterconnectRemoteLocation with a constraints.subnetLengthRange.min - // equal to 30. For example, connections that use an Azure remote location - // fall into this category. In these cases, the default value is 30, and - // requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is - // preferred, because it gives Google Cloud Support more debugging visibility. - optional int32 subnet_length = 40 [json_name = "subnetLength"]; - - // The type of interconnect attachment this is, which can take one of the - // following values: - DEDICATED: an attachment to a Dedicated Interconnect. - - // PARTNER: an attachment to a Partner Interconnect, created by the customer. - // - PARTNER_PROVIDER: an attachment to a Partner Interconnect, created by the - // partner. - // DEDICATED: Attachment to a dedicated interconnect. - // PARTNER: Attachment to a partner interconnect, created by the customer. - // PARTNER_PROVIDER: Attachment to a partner interconnect, created by the - // partner. - optional string type = 34 [json_name = "type"]; - - // The IEEE 802.1Q VLAN tag for this attachment, in the range 2-4093. Only - // specified at creation time. - optional int32 vlan_tag8021q = 35 [json_name = "vlanTag8021q"]; -} - -message InterconnectAttachmentAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of InterconnectAttachmentsScopedList resources. - map items = 2 - [json_name = "items"]; - - // [Output Only] Type of resource. Always - // compute#interconnectAttachmentAggregatedList for aggregated lists of - // interconnect attachments. - optional string kind = 3 [json_name = "kind"]; + // [Output Only] An optional description of the resource. + optional string description = 6 [json_name = "description"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; + // [Output Only] The name of the provider for this facility (e.g., EQUINIX). + optional string facility_provider = 7 [json_name = "facilityProvider"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // [Output Only] A provider-assigned Identifier for this facility (e.g., + // Ashburn-DC1). + optional string facility_provider_facility_id = 8 + [json_name = "facilityProviderFacilityId"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 9 [json_name = "id"]; - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; + // [Output Only] Type of the resource. Always compute#interconnectLocation for + // interconnect locations. + optional string kind = 10 [json_name = "kind"]; - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; + // [Output Only] Name of the resource. + optional string name = 11 [json_name = "name"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // [Output Only] The peeringdb identifier for this facility (corresponding + // with a netfac type in peeringdb). + optional string peeringdb_facility_id = 12 + [json_name = "peeringdbFacilityId"]; - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; + // [Output Only] A list of InterconnectLocation.RegionInfo objects, that + // describe parameters pertaining to the relation between this + // InterconnectLocation and various Google Cloud regions. + repeated InterconnectLocationRegionInfo region_infos = 13 + [json_name = "regionInfos"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // [Output Only] Server-defined URL for the resource. + optional string self_link = 14 [json_name = "selfLink"]; + + // [Output Only] The status of this InterconnectLocation, which can take one + // of the following values: - CLOSED: The InterconnectLocation is closed and + // is unavailable for provisioning new Interconnects. - AVAILABLE: The + // InterconnectLocation is available for provisioning new Interconnects. + // AVAILABLE: The InterconnectLocation is available for provisioning new + // Interconnects. + // CLOSED: The InterconnectLocation is closed for provisioning new + // Interconnects. + optional string status = 15 [json_name = "status"]; - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + // [Output Only] Reserved for future use. + optional bool supports_pzs = 16 [json_name = "supportsPzs"]; } -// Response to the list request, and contains a list of interconnect -// attachments. -message InterconnectAttachmentList { +// Response to the list request, and contains a list of interconnect locations. +message InterconnectLocationList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of InterconnectAttachment resources. - repeated InterconnectAttachment items = 2 [json_name = "items"]; + // A list of InterconnectLocation resources. + repeated InterconnectLocation items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#interconnectAttachmentList - // for lists of interconnect attachments. + // [Output Only] Type of resource. Always compute#interconnectLocationList for + // lists of interconnect locations. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -552,120 +224,24 @@ message InterconnectAttachmentList { optional Warning warning = 6 [json_name = "warning"]; } -// Informational metadata about Partner attachments from Partners to display to -// customers. These fields are propagated from PARTNER_PROVIDER attachments to -// their corresponding PARTNER attachments. -message InterconnectAttachmentPartnerMetadata { - // Plain text name of the Interconnect this attachment is connected to, as - // displayed in the Partner's portal. For instance "Chicago 1". This value may - // be validated to match approved Partner values. - optional string interconnect_name = 1 [json_name = "interconnectName"]; - - // Plain text name of the Partner providing this attachment. This value may be - // validated to match approved Partner values. - optional string partner_name = 2 [json_name = "partnerName"]; - - // URL of the Partner's portal for this Attachment. Partners may customise - // this to be a deep link to the specific resource on the Partner portal. This - // value may be validated to match approved Partner values. - optional string portal_url = 3 [json_name = "portalUrl"]; -} - -// Information for an interconnect attachment when this belongs to an -// interconnect of type DEDICATED. -message InterconnectAttachmentPrivateInfo { - // [Output Only] 802.1q encapsulation tag to be used for traffic between - // Google and the customer, going to and from this network and region. - optional uint32 tag8021q = 1 [json_name = "tag8021q"]; -} - -message InterconnectAttachmentsScopedList { - // A list of interconnect attachments contained in this scope. - repeated InterconnectAttachment interconnect_attachments = 1 - [json_name = "interconnectAttachments"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of addresses when the list is - // empty. - optional Warning warning = 2 [json_name = "warning"]; +// Information about any potential InterconnectAttachments between an +// Interconnect at a specific InterconnectLocation, and a specific Cloud Region. +message InterconnectLocationRegionInfo { + // Expected round-trip time in milliseconds, from this InterconnectLocation to + // a VM in this region. + optional string expected_rtt_ms = 1 [json_name = "expectedRttMs"]; + + // Identifies the network presence of this location. + // GLOBAL: This region is not in any common network presence with this + // InterconnectLocation. + // LOCAL_REGION: This region shares the same regional network presence as this + // InterconnectLocation. + // LP_GLOBAL: [Deprecated] This region is not in any common network presence + // with this InterconnectLocation. + // LP_LOCAL_REGION: [Deprecated] This region shares the same regional network + // presence as this InterconnectLocation. + optional string location_presence = 2 [json_name = "locationPresence"]; + + // URL for the region of this location. + optional string region = 3 [json_name = "region"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_070.proto b/protos/google/cloud/compute/v1/internal/common_070.proto index be27a0d491447..3acd6deb76c40 100644 --- a/protos/google/cloud/compute/v1/internal/common_070.proto +++ b/protos/google/cloud/compute/v1/internal/common_070.proto @@ -15,40 +15,283 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message InterconnectAttachmentConfigurationConstraints { - // [Output Only] Whether the attachment's BGP session - // requires/allows/disallows BGP MD5 authentication. This can take one of the - // following values: MD5_OPTIONAL, MD5_REQUIRED, MD5_UNSUPPORTED. For example, - // a Cross-Cloud Interconnect connection to a remote cloud provider that - // requires BGP MD5 authentication has the interconnectRemoteLocation - // attachment_configuration_constraints.bgp_md5 field set to MD5_REQUIRED, and - // that property is propagated to the attachment. Similarly, if BGP MD5 is - // MD5_UNSUPPORTED, an error is returned if MD5 is requested. - // MD5_OPTIONAL: MD5_OPTIONAL: BGP MD5 authentication is supported and can - // optionally be configured. - // MD5_REQUIRED: MD5_REQUIRED: BGP MD5 authentication must be configured. - // MD5_UNSUPPORTED: MD5_UNSUPPORTED: BGP MD5 authentication must not be - // configured - optional string bgp_md5 = 1 [json_name = "bgpMd5"]; - - // [Output Only] List of ASN ranges that the remote location is known to - // support. Formatted as an array of inclusive ranges {min: min-value, max: - // max-value}. For example, [{min: 123, max: 123}, {min: 64512, max: 65534}] - // allows the peer ASN to be 123 or anything in the range 64512-65534. This - // field is only advisory. Although the API accepts other ranges, these are - // the ranges that we recommend. - repeated InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange - bgp_peer_asn_ranges = 2 [json_name = "bgpPeerAsnRanges"]; +import "google/cloud/compute/v1/internal/common_068.proto"; + +// Represents a Cross-Cloud Interconnect Remote Location resource. You can use +// this resource to find remote location details about an Interconnect +// attachment (VLAN). +message InterconnectRemoteLocation { + // [Output Only] The postal address of the Point of Presence, each line in the + // address is separated by a newline character. + optional string address = 1 [json_name = "address"]; + + // [Output Only] Subset of fields from InterconnectAttachment's + // |configurationConstraints| field that apply to all attachments for this + // remote location. + optional InterconnectAttachmentConfigurationConstraints + attachment_configuration_constraints = 2 + [json_name = "attachmentConfigurationConstraints"]; + + // [Output Only] Metropolitan area designator that indicates which city an + // interconnect is located. For example: "Chicago, IL", "Amsterdam, + // Netherlands". + optional string city = 3 [json_name = "city"]; + + // [Output Only] Constraints on the parameters for creating Cross-Cloud + // Interconnect and associated InterconnectAttachments. + optional InterconnectRemoteLocationConstraints constraints = 4 + [json_name = "constraints"]; + + // [Output Only] Continent for this location, which can take one of the + // following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - + // SOUTH_AMERICA + // AFRICA: + // ASIA_PAC: + // EUROPE: + // NORTH_AMERICA: + // SOUTH_AMERICA: + optional string continent = 5 [json_name = "continent"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 6 [json_name = "creationTimestamp"]; + + // [Output Only] An optional description of the resource. + optional string description = 7 [json_name = "description"]; + + // [Output Only] The name of the provider for this facility (e.g., EQUINIX). + optional string facility_provider = 8 [json_name = "facilityProvider"]; + + // [Output Only] A provider-assigned Identifier for this facility (e.g., + // Ashburn-DC1). + optional string facility_provider_facility_id = 9 + [json_name = "facilityProviderFacilityId"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 10 [json_name = "id"]; + + // [Output Only] Type of the resource. Always + // compute#interconnectRemoteLocation for interconnect remote locations. + optional string kind = 11 [json_name = "kind"]; + + // [Output Only] Link Aggregation Control Protocol (LACP) constraints, which + // can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED + // LACP_SUPPORTED: LACP_SUPPORTED: LACP is supported, and enabled by default + // on the Cross-Cloud Interconnect. + // LACP_UNSUPPORTED: LACP_UNSUPPORTED: LACP is not supported and is not be + // enabled on this port. GetDiagnostics shows bundleAggregationType as + // "static". GCP does not support LAGs without LACP, so requestedLinkCount + // must be 1. + optional string lacp = 12 [json_name = "lacp"]; + + // [Output Only] The maximum number of 100 Gbps ports supported in a link + // aggregation group (LAG). When linkType is 100 Gbps, requestedLinkCount + // cannot exceed max_lag_size_100_gbps. + optional int32 max_lag_size100_gbps = 13 [json_name = "maxLagSize100Gbps"]; + + // [Output Only] The maximum number of 10 Gbps ports supported in a link + // aggregation group (LAG). When linkType is 10 Gbps, requestedLinkCount + // cannot exceed max_lag_size_10_gbps. + optional int32 max_lag_size10_gbps = 14 [json_name = "maxLagSize10Gbps"]; + + // [Output Only] Name of the resource. + optional string name = 15 [json_name = "name"]; + + // [Output Only] The peeringdb identifier for this facility (corresponding + // with a netfac type in peeringdb). + optional string peeringdb_facility_id = 16 + [json_name = "peeringdbFacilityId"]; + + // [Output Only] Permitted connections. + repeated InterconnectRemoteLocationPermittedConnections + permitted_connections = 17 [json_name = "permittedConnections"]; + + // [Output Only] Indicates the service provider present at the remote + // location. Example values: "Amazon Web Services", "Microsoft Azure". + optional string remote_service = 18 [json_name = "remoteService"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 19 [json_name = "selfLink"]; + + // [Output Only] The status of this InterconnectRemoteLocation, which can take + // one of the following values: - CLOSED: The InterconnectRemoteLocation is + // closed and is unavailable for provisioning new Cross-Cloud Interconnects. - + // AVAILABLE: The InterconnectRemoteLocation is available for provisioning new + // Cross-Cloud Interconnects. + // AVAILABLE: The InterconnectRemoteLocation is available for provisioning new + // Cross-Cloud Interconnects. + // CLOSED: The InterconnectRemoteLocation is closed for provisioning new + // Cross-Cloud Interconnects. + optional string status = 20 [json_name = "status"]; +} + +message InterconnectRemoteLocationConstraints { + // [Output Only] Port pair remote location constraints, which can take one of + // the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, + // PORT_PAIR_MATCHING_REMOTE_LOCATION. Google Cloud API refers only to + // individual ports, but the UI uses this field when ordering a pair of ports, + // to prevent users from accidentally ordering something that is incompatible + // with their cloud provider. Specifically, when ordering a redundant pair of + // Cross-Cloud Interconnect ports, and one of them uses a remote location with + // portPairMatchingRemoteLocation set to matching, the UI requires that both + // ports use the same remote location. + // PORT_PAIR_MATCHING_REMOTE_LOCATION: If PORT_PAIR_MATCHING_REMOTE_LOCATION, + // the remote cloud provider allocates ports in pairs, and the user should + // choose the same remote location for both ports. + // PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION: If + // PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, a user may opt to provision a + // redundant pair of Cross-Cloud Interconnects using two different remote + // locations in the same city. + optional string port_pair_remote_location = 1 + [json_name = "portPairRemoteLocation"]; + + // [Output Only] Port pair VLAN constraints, which can take one of the + // following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN + // PORT_PAIR_MATCHING_VLAN: If PORT_PAIR_MATCHING_VLAN, the Interconnect for + // this attachment is part of a pair of ports that should have matching VLAN + // allocations. This occurs with Cross-Cloud Interconnect to Azure remote + // locations. While GCP's API does not explicitly group pairs of ports, the UI + // uses this field to ensure matching VLAN ids when configuring a redundant + // VLAN pair. + // PORT_PAIR_UNCONSTRAINED_VLAN: PORT_PAIR_UNCONSTRAINED_VLAN means there is + // no constraint. + optional string port_pair_vlan = 2 [json_name = "portPairVlan"]; + + // [Output Only] [min-length, max-length] The minimum and maximum value + // (inclusive) for the IPv4 subnet length. For example, an + // interconnectRemoteLocation for Azure has {min: 30, max: 30} because Azure + // requires /30 subnets. This range specifies the values supported by both + // cloud providers. Interconnect currently supports /29 and /30 IPv4 subnet + // lengths. If a remote cloud has no constraint on IPv4 subnet length, the + // range would thus be {min: 29, max: 30}. + optional InterconnectRemoteLocationConstraintsSubnetLengthRange + subnet_length_range = 3 [json_name = "subnetLengthRange"]; } -message InterconnectAttachmentConfigurationConstraintsBgpPeerASNRange { - optional uint32 max = 1 [json_name = "max"]; +message InterconnectRemoteLocationConstraintsSubnetLengthRange { + optional int32 max = 1 [json_name = "max"]; + + optional int32 min = 2 [json_name = "min"]; +} + +// Response to the list request, and contains a list of interconnect remote +// locations. +message InterconnectRemoteLocationList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of InterconnectRemoteLocation resources. + repeated InterconnectRemoteLocation items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always + // compute#interconnectRemoteLocationList for lists of interconnect remote + // locations. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token lets you get the next page of results for list + // requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} - optional uint32 min = 2 [json_name = "min"]; +message InterconnectRemoteLocationPermittedConnections { + // [Output Only] URL of an Interconnect location that is permitted to connect + // to this Interconnect remote location. + optional string interconnect_location = 1 + [json_name = "interconnectLocation"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_071.proto b/protos/google/cloud/compute/v1/internal/common_071.proto index 1cd956b95bbb6..9de0c0a2e2ca6 100644 --- a/protos/google/cloud/compute/v1/internal/common_071.proto +++ b/protos/google/cloud/compute/v1/internal/common_071.proto @@ -15,129 +15,80 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents an Interconnect Attachment (VLAN) Location resource. You can use -// this resource to find location details about an Interconnect attachment -// (VLAN). For more information about interconnect attachments, read Creating -// VLAN Attachments. -message InterconnectLocation { - // [Output Only] The postal address of the Point of Presence, each line in the - // address is separated by a newline character. - optional string address = 1 [json_name = "address"]; - - // [Output Only] Availability zone for this InterconnectLocation. Within a - // metropolitan area (metro), maintenance will not be simultaneously scheduled - // in more than one availability zone. Example: "zone1" or "zone2". - optional string availability_zone = 2 [json_name = "availabilityZone"]; - - // [Output only] List of features available at this InterconnectLocation, - // which can take one of the following values: - MACSEC - repeated string available_features = 17 [json_name = "availableFeatures"]; - - // [Output only] List of link types available at this InterconnectLocation, - // which can take one of the following values: - LINK_TYPE_ETHERNET_10G_LR - - // LINK_TYPE_ETHERNET_100G_LR - repeated string available_link_types = 18 [json_name = "availableLinkTypes"]; - - // [Output Only] Metropolitan area designator that indicates which city an - // interconnect is located. For example: "Chicago, IL", "Amsterdam, - // Netherlands". - optional string city = 3 [json_name = "city"]; - - // [Output Only] Continent for this location, which can take one of the - // following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - - // SOUTH_AMERICA - // AFRICA: - // ASIA_PAC: - // C_AFRICA: - // C_ASIA_PAC: - // C_EUROPE: - // C_NORTH_AMERICA: - // C_SOUTH_AMERICA: - // EUROPE: - // NORTH_AMERICA: - // SOUTH_AMERICA: - optional string continent = 4 [json_name = "continent"]; +// Represents a License resource. A License represents billing and aggregate +// usage data for public and marketplace images. *Caution* This resource is +// intended for use only by third-party partners who are creating Cloud +// Marketplace images. +message License { + // [Output Only] Deprecated. This field no longer reflects whether a license + // charges a usage fee. + optional bool charges_use_fee = 1 [json_name = "chargesUseFee"]; // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 5 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - // [Output Only] An optional description of the resource. - optional string description = 6 [json_name = "description"]; - - // [Output Only] The name of the provider for this facility (e.g., EQUINIX). - optional string facility_provider = 7 [json_name = "facilityProvider"]; - - // [Output Only] A provider-assigned Identifier for this facility (e.g., - // Ashburn-DC1). - optional string facility_provider_facility_id = 8 - [json_name = "facilityProviderFacilityId"]; + // An optional textual description of the resource; provided by the client + // when the resource is created. + optional string description = 3 [json_name = "description"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 9 [json_name = "id"]; + optional string id = 4 [json_name = "id"]; - // [Output Only] Type of the resource. Always compute#interconnectLocation for - // interconnect locations. - optional string kind = 10 [json_name = "kind"]; + // [Output Only] Type of resource. Always compute#license for licenses. + optional string kind = 5 [json_name = "kind"]; - // [Output Only] Name of the resource. - optional string name = 11 [json_name = "name"]; + // [Output Only] The unique code used to attach this license to images, + // snapshots, and disks. + optional string license_code = 6 [json_name = "licenseCode"]; - // [Output Only] The peeringdb identifier for this facility (corresponding - // with a netfac type in peeringdb). - optional string peeringdb_facility_id = 12 - [json_name = "peeringdbFacilityId"]; + // Name of the resource. The name must be 1-63 characters long and comply with + // RFC1035. + optional string name = 7 [json_name = "name"]; - // [Output Only] A list of InterconnectLocation.RegionInfo objects, that - // describe parameters pertaining to the relation between this - // InterconnectLocation and various Google Cloud regions. - repeated InterconnectLocationRegionInfo region_infos = 13 - [json_name = "regionInfos"]; + optional LicenseResourceRequirements resource_requirements = 8 + [json_name = "resourceRequirements"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 14 [json_name = "selfLink"]; - - // [Output Only] The status of this InterconnectLocation, which can take one - // of the following values: - CLOSED: The InterconnectLocation is closed and - // is unavailable for provisioning new Interconnects. - AVAILABLE: The - // InterconnectLocation is available for provisioning new Interconnects. - // AVAILABLE: The InterconnectLocation is available for provisioning new - // Interconnects. - // CLOSED: The InterconnectLocation is closed for provisioning new - // Interconnects. - optional string status = 15 [json_name = "status"]; - - // [Output Only] Reserved for future use. - optional bool supports_pzs = 16 [json_name = "supportsPzs"]; + optional string self_link = 9 [json_name = "selfLink"]; + + // If false, licenses will not be copied from the source resource when + // creating an image from a disk, disk from snapshot, or snapshot from disk. + optional bool transferable = 10 [json_name = "transferable"]; } -// Response to the list request, and contains a list of interconnect locations. -message InterconnectLocationList { +message LicenseResourceRequirements { + // Minimum number of guest cpus required to use the Instance. Enforced at + // Instance creation and Instance start. + optional int32 min_guest_cpu_count = 1 [json_name = "minGuestCpuCount"]; + + // Minimum memory required to use the Instance. Enforced at Instance creation + // and Instance start. + optional int32 min_memory_mb = 2 [json_name = "minMemoryMb"]; +} + +message LicensesListResponse { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of InterconnectLocation resources. - repeated InterconnectLocation items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#interconnectLocationList for - // lists of interconnect locations. - optional string kind = 3 [json_name = "kind"]; + // A list of License resources. + repeated License items = 2 [json_name = "items"]; // [Output Only] This token allows you to get the next page of results for // list requests. If the number of results is larger than maxResults, use the // nextPageToken as a value for the query parameter pageToken in the next list // request. Subsequent list requests will have their own nextPageToken to // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; + optional string next_page_token = 3 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + optional string self_link = 4 [json_name = "selfLink"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -221,27 +172,5 @@ message InterconnectLocationList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// Information about any potential InterconnectAttachments between an -// Interconnect at a specific InterconnectLocation, and a specific Cloud Region. -message InterconnectLocationRegionInfo { - // Expected round-trip time in milliseconds, from this InterconnectLocation to - // a VM in this region. - optional string expected_rtt_ms = 1 [json_name = "expectedRttMs"]; - - // Identifies the network presence of this location. - // GLOBAL: This region is not in any common network presence with this - // InterconnectLocation. - // LOCAL_REGION: This region shares the same regional network presence as this - // InterconnectLocation. - // LP_GLOBAL: [Deprecated] This region is not in any common network presence - // with this InterconnectLocation. - // LP_LOCAL_REGION: [Deprecated] This region shares the same regional network - // presence as this InterconnectLocation. - optional string location_presence = 2 [json_name = "locationPresence"]; - - // URL for the region of this location. - optional string region = 3 [json_name = "region"]; + optional Warning warning = 5 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_072.proto b/protos/google/cloud/compute/v1/internal/common_072.proto index 2f04a0597eb78..6c5292ab846e1 100644 --- a/protos/google/cloud/compute/v1/internal/common_072.proto +++ b/protos/google/cloud/compute/v1/internal/common_072.proto @@ -15,283 +15,60 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_070.proto"; - -// Represents a Cross-Cloud Interconnect Remote Location resource. You can use -// this resource to find remote location details about an Interconnect -// attachment (VLAN). -message InterconnectRemoteLocation { - // [Output Only] The postal address of the Point of Presence, each line in the - // address is separated by a newline character. - optional string address = 1 [json_name = "address"]; - - // [Output Only] Subset of fields from InterconnectAttachment's - // |configurationConstraints| field that apply to all attachments for this - // remote location. - optional InterconnectAttachmentConfigurationConstraints - attachment_configuration_constraints = 2 - [json_name = "attachmentConfigurationConstraints"]; - - // [Output Only] Metropolitan area designator that indicates which city an - // interconnect is located. For example: "Chicago, IL", "Amsterdam, - // Netherlands". - optional string city = 3 [json_name = "city"]; - - // [Output Only] Constraints on the parameters for creating Cross-Cloud - // Interconnect and associated InterconnectAttachments. - optional InterconnectRemoteLocationConstraints constraints = 4 - [json_name = "constraints"]; - - // [Output Only] Continent for this location, which can take one of the - // following values: - AFRICA - ASIA_PAC - EUROPE - NORTH_AMERICA - - // SOUTH_AMERICA - // AFRICA: - // ASIA_PAC: - // EUROPE: - // NORTH_AMERICA: - // SOUTH_AMERICA: - optional string continent = 5 [json_name = "continent"]; - +// Represents a License Code resource. A License Code is a unique identifier +// used to represent a license resource. *Caution* This resource is intended for +// use only by third-party partners who are creating Cloud Marketplace images. +message LicenseCode { // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 6 [json_name = "creationTimestamp"]; - - // [Output Only] An optional description of the resource. - optional string description = 7 [json_name = "description"]; - - // [Output Only] The name of the provider for this facility (e.g., EQUINIX). - optional string facility_provider = 8 [json_name = "facilityProvider"]; + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // [Output Only] A provider-assigned Identifier for this facility (e.g., - // Ashburn-DC1). - optional string facility_provider_facility_id = 9 - [json_name = "facilityProviderFacilityId"]; + // [Output Only] Description of this License Code. + optional string description = 2 [json_name = "description"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 10 [json_name = "id"]; + optional string id = 3 [json_name = "id"]; - // [Output Only] Type of the resource. Always - // compute#interconnectRemoteLocation for interconnect remote locations. - optional string kind = 11 [json_name = "kind"]; + // [Output Only] Type of resource. Always compute#licenseCode for licenses. + optional string kind = 4 [json_name = "kind"]; - // [Output Only] Link Aggregation Control Protocol (LACP) constraints, which - // can take one of the following values: LACP_SUPPORTED, LACP_UNSUPPORTED - // LACP_SUPPORTED: LACP_SUPPORTED: LACP is supported, and enabled by default - // on the Cross-Cloud Interconnect. - // LACP_UNSUPPORTED: LACP_UNSUPPORTED: LACP is not supported and is not be - // enabled on this port. GetDiagnostics shows bundleAggregationType as - // "static". GCP does not support LAGs without LACP, so requestedLinkCount - // must be 1. - optional string lacp = 12 [json_name = "lacp"]; + // [Output Only] URL and description aliases of Licenses with the same License + // Code. + repeated LicenseCodeLicenseAlias license_alias = 5 + [json_name = "licenseAlias"]; - // [Output Only] The maximum number of 100 Gbps ports supported in a link - // aggregation group (LAG). When linkType is 100 Gbps, requestedLinkCount - // cannot exceed max_lag_size_100_gbps. - optional int32 max_lag_size100_gbps = 13 [json_name = "maxLagSize100Gbps"]; - - // [Output Only] The maximum number of 10 Gbps ports supported in a link - // aggregation group (LAG). When linkType is 10 Gbps, requestedLinkCount - // cannot exceed max_lag_size_10_gbps. - optional int32 max_lag_size10_gbps = 14 [json_name = "maxLagSize10Gbps"]; - - // [Output Only] Name of the resource. - optional string name = 15 [json_name = "name"]; - - // [Output Only] The peeringdb identifier for this facility (corresponding - // with a netfac type in peeringdb). - optional string peeringdb_facility_id = 16 - [json_name = "peeringdbFacilityId"]; - - // [Output Only] Permitted connections. - repeated InterconnectRemoteLocationPermittedConnections - permitted_connections = 17 [json_name = "permittedConnections"]; - - // [Output Only] Indicates the service provider present at the remote - // location. Example values: "Amazon Web Services", "Microsoft Azure". - optional string remote_service = 18 [json_name = "remoteService"]; + // [Output Only] Name of the resource. The name is 1-20 characters long and + // must be a valid 64 bit integer. + optional string name = 6 [json_name = "name"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 19 [json_name = "selfLink"]; - - // [Output Only] The status of this InterconnectRemoteLocation, which can take - // one of the following values: - CLOSED: The InterconnectRemoteLocation is - // closed and is unavailable for provisioning new Cross-Cloud Interconnects. - - // AVAILABLE: The InterconnectRemoteLocation is available for provisioning new - // Cross-Cloud Interconnects. - // AVAILABLE: The InterconnectRemoteLocation is available for provisioning new - // Cross-Cloud Interconnects. - // CLOSED: The InterconnectRemoteLocation is closed for provisioning new - // Cross-Cloud Interconnects. - optional string status = 20 [json_name = "status"]; -} - -message InterconnectRemoteLocationConstraints { - // [Output Only] Port pair remote location constraints, which can take one of - // the following values: PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, - // PORT_PAIR_MATCHING_REMOTE_LOCATION. Google Cloud API refers only to - // individual ports, but the UI uses this field when ordering a pair of ports, - // to prevent users from accidentally ordering something that is incompatible - // with their cloud provider. Specifically, when ordering a redundant pair of - // Cross-Cloud Interconnect ports, and one of them uses a remote location with - // portPairMatchingRemoteLocation set to matching, the UI requires that both - // ports use the same remote location. - // PORT_PAIR_MATCHING_REMOTE_LOCATION: If PORT_PAIR_MATCHING_REMOTE_LOCATION, - // the remote cloud provider allocates ports in pairs, and the user should - // choose the same remote location for both ports. - // PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION: If - // PORT_PAIR_UNCONSTRAINED_REMOTE_LOCATION, a user may opt to provision a - // redundant pair of Cross-Cloud Interconnects using two different remote - // locations in the same city. - optional string port_pair_remote_location = 1 - [json_name = "portPairRemoteLocation"]; - - // [Output Only] Port pair VLAN constraints, which can take one of the - // following values: PORT_PAIR_UNCONSTRAINED_VLAN, PORT_PAIR_MATCHING_VLAN - // PORT_PAIR_MATCHING_VLAN: If PORT_PAIR_MATCHING_VLAN, the Interconnect for - // this attachment is part of a pair of ports that should have matching VLAN - // allocations. This occurs with Cross-Cloud Interconnect to Azure remote - // locations. While GCP's API does not explicitly group pairs of ports, the UI - // uses this field to ensure matching VLAN ids when configuring a redundant - // VLAN pair. - // PORT_PAIR_UNCONSTRAINED_VLAN: PORT_PAIR_UNCONSTRAINED_VLAN means there is - // no constraint. - optional string port_pair_vlan = 2 [json_name = "portPairVlan"]; - - // [Output Only] [min-length, max-length] The minimum and maximum value - // (inclusive) for the IPv4 subnet length. For example, an - // interconnectRemoteLocation for Azure has {min: 30, max: 30} because Azure - // requires /30 subnets. This range specifies the values supported by both - // cloud providers. Interconnect currently supports /29 and /30 IPv4 subnet - // lengths. If a remote cloud has no constraint on IPv4 subnet length, the - // range would thus be {min: 29, max: 30}. - optional InterconnectRemoteLocationConstraintsSubnetLengthRange - subnet_length_range = 3 [json_name = "subnetLengthRange"]; -} - -message InterconnectRemoteLocationConstraintsSubnetLengthRange { - optional int32 max = 1 [json_name = "max"]; - - optional int32 min = 2 [json_name = "min"]; + optional string self_link = 7 [json_name = "selfLink"]; + + // [Output Only] Current state of this License Code. + // DISABLED: Machines are not allowed to attach boot disks with this License + // Code. Requests to create new resources with this license will be rejected. + // ENABLED: Use is allowed for anyone with USE_READ_ONLY access to this + // License Code. + // RESTRICTED: Use of this license is limited to a project whitelist. + // STATE_UNSPECIFIED: + // TERMINATED: Reserved state. + optional string state = 8 [json_name = "state"]; + + // [Output Only] If true, the license will remain attached when creating + // images or snapshots from disks. Otherwise, the license is not transferred. + optional bool transferable = 9 [json_name = "transferable"]; } -// Response to the list request, and contains a list of interconnect remote -// locations. -message InterconnectRemoteLocationList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of InterconnectRemoteLocation resources. - repeated InterconnectRemoteLocation items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always - // compute#interconnectRemoteLocationList for lists of interconnect remote - // locations. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token lets you get the next page of results for list - // requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} +message LicenseCodeLicenseAlias { + // [Output Only] Description of this License Code. + optional string description = 1 [json_name = "description"]; -message InterconnectRemoteLocationPermittedConnections { - // [Output Only] URL of an Interconnect location that is permitted to connect - // to this Interconnect remote location. - optional string interconnect_location = 1 - [json_name = "interconnectLocation"]; + // [Output Only] URL of license corresponding to this License Code. + optional string self_link = 2 [json_name = "selfLink"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_073.proto b/protos/google/cloud/compute/v1/internal/common_073.proto index 10cfd9fc0a959..de40839e10cb5 100644 --- a/protos/google/cloud/compute/v1/internal/common_073.proto +++ b/protos/google/cloud/compute/v1/internal/common_073.proto @@ -15,162 +15,30 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a License resource. A License represents billing and aggregate -// usage data for public and marketplace images. *Caution* This resource is -// intended for use only by third-party partners who are creating Cloud -// Marketplace images. -message License { - // [Output Only] Deprecated. This field no longer reflects whether a license - // charges a usage fee. - optional bool charges_use_fee = 1 [json_name = "chargesUseFee"]; +message LocalDisk { + // Specifies the number of such disks. + optional int32 disk_count = 1 [json_name = "diskCount"]; - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + // Specifies the size of the disk in base-2 GB. + optional int32 disk_size_gb = 2 [json_name = "diskSizeGb"]; - // An optional textual description of the resource; provided by the client - // when the resource is created. - optional string description = 3 [json_name = "description"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 4 [json_name = "id"]; - - // [Output Only] Type of resource. Always compute#license for licenses. - optional string kind = 5 [json_name = "kind"]; - - // [Output Only] The unique code used to attach this license to images, - // snapshots, and disks. - optional string license_code = 6 [json_name = "licenseCode"]; - - // Name of the resource. The name must be 1-63 characters long and comply with - // RFC1035. - optional string name = 7 [json_name = "name"]; - - optional LicenseResourceRequirements resource_requirements = 8 - [json_name = "resourceRequirements"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 9 [json_name = "selfLink"]; - - // If false, licenses will not be copied from the source resource when - // creating an image from a disk, disk from snapshot, or snapshot from disk. - optional bool transferable = 10 [json_name = "transferable"]; -} - -message LicenseResourceRequirements { - // Minimum number of guest cpus required to use the Instance. Enforced at - // Instance creation and Instance start. - optional int32 min_guest_cpu_count = 1 [json_name = "minGuestCpuCount"]; - - // Minimum memory required to use the Instance. Enforced at Instance creation - // and Instance start. - optional int32 min_memory_mb = 2 [json_name = "minMemoryMb"]; + // Specifies the desired disk type on the node. This disk type must be a local + // storage type (e.g.: local-ssd). Note that for nodeTemplates, this should be + // the name of the disk type and not its URL. + optional string disk_type = 3 [json_name = "diskType"]; } -message LicensesListResponse { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of License resources. - repeated License items = 2 [json_name = "items"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 3 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 4 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 5 [json_name = "warning"]; +message ServerBinding { + // RESTART_NODE_ON_ANY_SERVER: Node may associate with any physical server + // over its lifetime. + // RESTART_NODE_ON_MINIMAL_SERVERS: Node may associate with minimal physical + // servers over its lifetime. + // SERVER_BINDING_TYPE_UNSPECIFIED: + optional string type = 1 [json_name = "type"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_074.proto b/protos/google/cloud/compute/v1/internal/common_074.proto index eb47436ce5fd6..637d7f1fae813 100644 --- a/protos/google/cloud/compute/v1/internal/common_074.proto +++ b/protos/google/cloud/compute/v1/internal/common_074.proto @@ -15,60 +15,414 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a License Code resource. A License Code is a unique identifier -// used to represent a license resource. *Caution* This resource is intended for -// use only by third-party partners who are creating Cloud Marketplace images. -message LicenseCode { - // [Output Only] Creation timestamp in RFC3339 text format. +import "google/cloud/compute/v1/internal/common_001.proto"; +import "google/cloud/compute/v1/internal/common_003.proto"; +import "google/cloud/compute/v1/internal/common_020.proto"; +import "google/cloud/compute/v1/internal/common_076.proto"; + +// Represents a machine image resource. A machine image is a Compute Engine +// resource that stores all the configuration, metadata, permissions, and data +// from one or more disks required to create a Virtual machine (VM) instance. +// For more information, see Machine images. +message MachineImage { + // [Output Only] The creation timestamp for this machine image in RFC3339 text + // format. optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // [Output Only] Description of this License Code. + // An optional description of this resource. Provide this property when you + // create the resource. optional string description = 2 [json_name = "description"]; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 3 [json_name = "id"]; - - // [Output Only] Type of resource. Always compute#licenseCode for licenses. - optional string kind = 4 [json_name = "kind"]; - - // [Output Only] URL and description aliases of Licenses with the same License - // Code. - repeated LicenseCodeLicenseAlias license_alias = 5 - [json_name = "licenseAlias"]; - - // [Output Only] Name of the resource. The name is 1-20 characters long and - // must be a valid 64 bit integer. - optional string name = 6 [json_name = "name"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 7 [json_name = "selfLink"]; - - // [Output Only] Current state of this License Code. - // DISABLED: Machines are not allowed to attach boot disks with this License - // Code. Requests to create new resources with this license will be rejected. - // ENABLED: Use is allowed for anyone with USE_READ_ONLY access to this - // License Code. - // RESTRICTED: Use of this license is limited to a project whitelist. - // STATE_UNSPECIFIED: - // TERMINATED: Reserved state. - optional string state = 8 [json_name = "state"]; - - // [Output Only] If true, the license will remain attached when creating - // images or snapshots from disks. Otherwise, the license is not transferred. - optional bool transferable = 9 [json_name = "transferable"]; + // [Input Only] Whether to attempt an application consistent machine image by + // informing the OS to prepare for the snapshot process. + optional bool guest_flush = 3 [json_name = "guestFlush"]; + + // [Output Only] A unique identifier for this machine image. The server + // defines this identifier. + optional string id = 4 [json_name = "id"]; + + // [Output Only] Properties of source instance + optional InstanceProperties instance_properties = 5 + [json_name = "instanceProperties"]; + + // [Output Only] The resource type, which is always compute#machineImage for + // machine image. + optional string kind = 6 [json_name = "kind"]; + + // Encrypts the machine image using a customer-supplied encryption key. After + // you encrypt a machine image using a customer-supplied key, you must provide + // the same key if you use the machine image later. For example, you must + // provide the encryption key when you create an instance from the encrypted + // machine image in a future request. Customer-supplied encryption keys do not + // protect access to metadata of the machine image. If you do not provide an + // encryption key when creating the machine image, then the machine image will + // be encrypted using an automatically generated key and you do not need to + // provide a key to use the machine image later. + optional CustomerEncryptionKey machine_image_encryption_key = 7 + [json_name = "machineImageEncryptionKey"]; + + // 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. + optional string name = 8 [json_name = "name"]; + + // Output only. Reserved for future use. + optional bool satisfies_pzi = 18 [json_name = "satisfiesPzi"]; + + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 9 [json_name = "satisfiesPzs"]; + + // An array of Machine Image specific properties for disks attached to the + // source instance + repeated SavedDisk saved_disks = 10 [json_name = "savedDisks"]; + + // [Output Only] The URL for this machine image. The server defines this URL. + optional string self_link = 11 [json_name = "selfLink"]; + + // [Input Only] The customer-supplied encryption key of the disks attached to + // the source instance. Required if the source disk is protected by a + // customer-supplied encryption key. + repeated SourceDiskEncryptionKey source_disk_encryption_keys = 12 + [json_name = "sourceDiskEncryptionKeys"]; + + // The source instance used to create the machine image. You can provide this + // as a partial or full URL to the resource. For example, the following are + // valid values: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /instances/instance - projects/project/zones/zone/instances/instance + optional string source_instance = 13 [json_name = "sourceInstance"]; + + // [Output Only] DEPRECATED: Please use instance_properties instead for source + // instance related properties. New properties will not be added to this + // field. + optional SourceInstanceProperties source_instance_properties = 14 + [json_name = "sourceInstanceProperties"]; + + // [Output Only] The status of the machine image. One of the following values: + // INVALID, CREATING, READY, DELETING, and UPLOADING. + // CREATING: + // DELETING: + // INVALID: + // READY: + // UPLOADING: + optional string status = 15 [json_name = "status"]; + + // The regional or multi-regional Cloud Storage bucket location where the + // machine image is stored. + repeated string storage_locations = 16 [json_name = "storageLocations"]; + + // [Output Only] Total size of the storage used by the machine image. + optional string total_storage_bytes = 17 [json_name = "totalStorageBytes"]; +} + +// A list of machine images. +message MachineImageList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of MachineImage resources. + repeated MachineImage items = 2 [json_name = "items"]; + + // [Output Only] The resource type, which is always + // compute#machineImagesListResponse for machine image lists. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +// DEPRECATED: Please use compute#savedDisk instead. An instance-attached disk +// resource. +message SavedAttachedDisk { + // Specifies whether the disk will be auto-deleted when the instance is + // deleted (but not when the disk is detached from the instance). + optional bool auto_delete = 1 [json_name = "autoDelete"]; + + // Indicates that this is a boot disk. The virtual machine will use the first + // partition of the disk for its root filesystem. + optional bool boot = 2 [json_name = "boot"]; + + // Specifies the name of the disk attached to the source instance. + optional string device_name = 3 [json_name = "deviceName"]; + + // The encryption key for the disk. + optional CustomerEncryptionKey disk_encryption_key = 4 + [json_name = "diskEncryptionKey"]; + + // The size of the disk in base-2 GB. + optional string disk_size_gb = 5 [json_name = "diskSizeGb"]; + + // [Output Only] URL of the disk type resource. For example: projects/project + // /zones/zone/diskTypes/pd-standard or pd-ssd + optional string disk_type = 6 [json_name = "diskType"]; + + // A list of features to enable on the guest operating system. Applicable only + // for bootable images. Read Enabling guest operating system features to see a + // list of available options. + repeated GuestOsFeature guest_os_features = 7 [json_name = "guestOsFeatures"]; + + // Specifies zero-based index of the disk that is attached to the source + // instance. + optional int32 index = 8 [json_name = "index"]; + + // Specifies the disk interface to use for attaching this disk, which is + // either SCSI or NVME. + // NVME: + // SCSI: + optional string interface = 9 [json_name = "interface"]; + + // [Output Only] Type of the resource. Always compute#attachedDisk for + // attached disks. + optional string kind = 10 [json_name = "kind"]; + + // [Output Only] Any valid publicly visible licenses. + repeated string licenses = 11 [json_name = "licenses"]; + + // The mode in which this disk is attached to the source instance, either + // READ_WRITE or READ_ONLY. + // READ_ONLY: Attaches this disk in read-only mode. Multiple virtual machines + // can use a disk in read-only mode at a time. + // READ_WRITE: *[Default]* Attaches this disk in read-write mode. Only one + // virtual machine at a time can be attached to a disk in read-write mode. + optional string mode = 12 [json_name = "mode"]; + + // Specifies a URL of the disk attached to the source instance. + optional string source = 13 [json_name = "source"]; + + // [Output Only] A size of the storage used by the disk's snapshot by this + // machine image. + optional string storage_bytes = 14 [json_name = "storageBytes"]; + + // [Output Only] An indicator whether storageBytes is in a stable state or it + // is being adjusted as a result of shared storage reallocation. This status + // can either be UPDATING, meaning the size of the snapshot is being updated, + // or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + // UPDATING: + // UP_TO_DATE: + optional string storage_bytes_status = 15 [json_name = "storageBytesStatus"]; + + // Specifies the type of the attached disk, either SCRATCH or PERSISTENT. + // PERSISTENT: + // SCRATCH: + optional string type = 16 [json_name = "type"]; } -message LicenseCodeLicenseAlias { - // [Output Only] Description of this License Code. - optional string description = 1 [json_name = "description"]; +// An instance-attached disk resource. +message SavedDisk { + // [Output Only] The architecture of the attached disk. + // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. + // ARM64: Machines with architecture ARM64 + // X86_64: Machines with architecture X86_64 + optional string architecture = 1 [json_name = "architecture"]; + + // [Output Only] Type of the resource. Always compute#savedDisk for attached + // disks. + optional string kind = 2 [json_name = "kind"]; + + // Specifies a URL of the disk attached to the source instance. + optional string source_disk = 3 [json_name = "sourceDisk"]; + + // [Output Only] Size of the individual disk snapshot used by this machine + // image. + optional string storage_bytes = 4 [json_name = "storageBytes"]; + + // [Output Only] An indicator whether storageBytes is in a stable state or it + // is being adjusted as a result of shared storage reallocation. This status + // can either be UPDATING, meaning the size of the snapshot is being updated, + // or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + // UPDATING: + // UP_TO_DATE: + optional string storage_bytes_status = 5 [json_name = "storageBytesStatus"]; +} + +message SourceDiskEncryptionKey { + // The customer-supplied encryption key of the source disk. Required if the + // source disk is protected by a customer-supplied encryption key. + optional CustomerEncryptionKey disk_encryption_key = 1 + [json_name = "diskEncryptionKey"]; + + // URL of the disk attached to the source instance. This can be a full or + // valid partial URL. For example, the following are valid values: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /disks/disk - projects/project/zones/zone/disks/disk - + // zones/zone/disks/disk + optional string source_disk = 2 [json_name = "sourceDisk"]; +} + +// DEPRECATED: Please use compute#instanceProperties instead. New properties +// will not be added to this field. +message SourceInstanceProperties { + // Enables instances created based on this machine image to send packets with + // source IP addresses other than their own and receive packets with + // destination IP addresses other than their own. If these instances will be + // used as an IP gateway or it will be set as the next-hop in a Route + // resource, specify true. If unsure, leave this set to false. See the Enable + // IP forwarding documentation for more information. + optional bool can_ip_forward = 1 [json_name = "canIpForward"]; + + // Whether the instance created from this machine image should be protected + // against deletion. + optional bool deletion_protection = 2 [json_name = "deletionProtection"]; + + // An optional text description for the instances that are created from this + // machine image. + optional string description = 3 [json_name = "description"]; + + // An array of disks that are associated with the instances that are created + // from this machine image. + repeated SavedAttachedDisk disks = 4 [json_name = "disks"]; + + // A list of guest accelerator cards' type and count to use for instances + // created from this machine image. + repeated AcceleratorConfig guest_accelerators = 5 + [json_name = "guestAccelerators"]; + + // KeyRevocationActionType of the instance. Supported options are "STOP" and + // "NONE". The default value is "NONE" if it is not specified. + // KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED: Default value. This value is + // unused. + // NONE: Indicates user chose no operation. + // STOP: Indicates user chose to opt for VM shutdown on key revocation. + optional string key_revocation_action_type = 6 + [json_name = "keyRevocationActionType"]; + + // Labels to apply to instances that are created from this machine image. + map labels = 7 [json_name = "labels"]; + + // The machine type to use for instances that are created from this machine + // image. + optional string machine_type = 8 [json_name = "machineType"]; + + // The metadata key/value pairs to assign to instances that are created from + // this machine image. These pairs can consist of custom metadata or + // predefined keys. See Project and instance metadata for more information. + optional Metadata metadata = 9 [json_name = "metadata"]; + + // Minimum cpu/platform to be used by instances created from this machine + // image. The instance may be scheduled on the specified or newer + // cpu/platform. Applicable values are the friendly names of CPU platforms, + // such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy + // Bridge". For more information, read Specifying a Minimum CPU Platform. + optional string min_cpu_platform = 10 [json_name = "minCpuPlatform"]; + + // An array of network access configurations for this interface. + repeated NetworkInterface network_interfaces = 11 + [json_name = "networkInterfaces"]; + + // Specifies the scheduling options for the instances that are created from + // this machine image. + optional Scheduling scheduling = 12 [json_name = "scheduling"]; + + // A list of service accounts with specified scopes. Access tokens for these + // service accounts are available to the instances that are created from this + // machine image. Use metadata queries to obtain the access tokens for these + // instances. + repeated ServiceAccount service_accounts = 13 [json_name = "serviceAccounts"]; - // [Output Only] URL of license corresponding to this License Code. - optional string self_link = 2 [json_name = "selfLink"]; + // A list of tags to apply to the instances that are created from this machine + // image. The tags identify valid sources or targets for network firewalls. + // The setTags method can modify this list of tags. Each tag within the list + // must comply with RFC1035. + optional Tags tags = 14 [json_name = "tags"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_075.proto b/protos/google/cloud/compute/v1/internal/common_075.proto index 8a1dc773d9a7d..383eba6475020 100644 --- a/protos/google/cloud/compute/v1/internal/common_075.proto +++ b/protos/google/cloud/compute/v1/internal/common_075.proto @@ -15,30 +15,401 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message LocalDisk { - // Specifies the number of such disks. - optional int32 disk_count = 1 [json_name = "diskCount"]; +import "google/cloud/compute/v1/internal/common_022.proto"; - // Specifies the size of the disk in base-2 GB. - optional int32 disk_size_gb = 2 [json_name = "diskSizeGb"]; +// Represents a Machine Type resource. You can use specific machine types for +// your VM instances based on performance and pricing requirements. For more +// information, read Machine Types. +message MachineType { + message AcceleratorsItem { + // Number of accelerator cards exposed to the guest. + optional int32 guest_accelerator_count = 1 + [json_name = "guestAcceleratorCount"]; - // Specifies the desired disk type on the node. This disk type must be a local - // storage type (e.g.: local-ssd). Note that for nodeTemplates, this should be - // the name of the disk type and not its URL. - optional string disk_type = 3 [json_name = "diskType"]; + // The accelerator type resource name, not a full URL, e.g. nvidia-tesla-t4. + optional string guest_accelerator_type = 2 + [json_name = "guestAcceleratorType"]; + } + + // [Output Only] A list of accelerator configurations assigned to this machine + // type. + repeated AcceleratorsItem accelerators = 1 [json_name = "accelerators"]; + + // [Output Only] The architecture of the machine type. + // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. + // ARM64: Machines with architecture ARM64 + // X86_64: Machines with architecture X86_64 + optional string architecture = 17 [json_name = "architecture"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // [Output Only] The deprecation status associated with this machine type. + // Only applicable if the machine type is unavailable. + optional DeprecationStatus deprecated = 3 [json_name = "deprecated"]; + + // [Output Only] An optional textual description of the resource. + optional string description = 4 [json_name = "description"]; + + // [Output Only] The number of virtual CPUs that are available to the + // instance. + optional int32 guest_cpus = 5 [json_name = "guestCpus"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // [Deprecated] This property is deprecated and will never be populated with + // any relevant values. + optional int32 image_space_gb = 7 [json_name = "imageSpaceGb"]; + + // [Output Only] Whether this machine type has a shared CPU. See Shared-core + // machine types for more information. + optional bool is_shared_cpu = 8 [json_name = "isSharedCpu"]; + + // [Output Only] The type of the resource. Always compute#machineType for + // machine types. + optional string kind = 9 [json_name = "kind"]; + + // [Output Only] Maximum persistent disks allowed. + optional int32 maximum_persistent_disks = 10 + [json_name = "maximumPersistentDisks"]; + + // [Output Only] Maximum total persistent disks size (GB) allowed. + optional string maximum_persistent_disks_size_gb = 11 + [json_name = "maximumPersistentDisksSizeGb"]; + + // [Output Only] The amount of physical memory available to the instance, + // defined in MB. + optional int32 memory_mb = 12 [json_name = "memoryMb"]; + + // [Output Only] Name of the resource. + optional string name = 13 [json_name = "name"]; + + message ScratchDisksItem { + // Size of the scratch disk, defined in GB. + optional int32 disk_gb = 1 [json_name = "diskGb"]; + } + + // [Output Only] A list of extended scratch disks assigned to the instance. + repeated ScratchDisksItem scratch_disks = 14 [json_name = "scratchDisks"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 15 [json_name = "selfLink"]; + + // [Output Only] The name of the zone where the machine type resides, such as + // us-central1-a. + optional string zone = 16 [json_name = "zone"]; } -message ServerBinding { - // RESTART_NODE_ON_ANY_SERVER: Node may associate with any physical server - // over its lifetime. - // RESTART_NODE_ON_MINIMAL_SERVERS: Node may associate with minimal physical - // servers over its lifetime. - // SERVER_BINDING_TYPE_UNSPECIFIED: - optional string type = 1 [json_name = "type"]; +message MachineTypeAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of MachineTypesScopedList resources. + map items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#machineTypeAggregatedList + // for aggregated lists of machine types. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +// Contains a list of machine types. +message MachineTypeList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of MachineType resources. + repeated MachineType items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#machineTypeList for lists of + // machine types. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message MachineTypesScopedList { + // [Output Only] A list of machine types contained in this scope. + repeated MachineType machine_types = 1 [json_name = "machineTypes"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] An informational warning that appears when the machine types + // list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_076.proto b/protos/google/cloud/compute/v1/internal/common_076.proto index 766c8a0e4b76a..1d428f0b3998d 100644 --- a/protos/google/cloud/compute/v1/internal/common_076.proto +++ b/protos/google/cloud/compute/v1/internal/common_076.proto @@ -15,414 +15,42 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_001.proto"; -import "google/cloud/compute/v1/internal/common_003.proto"; -import "google/cloud/compute/v1/internal/common_021.proto"; -import "google/cloud/compute/v1/internal/common_078.proto"; - -// Represents a machine image resource. A machine image is a Compute Engine -// resource that stores all the configuration, metadata, permissions, and data -// from one or more disks required to create a Virtual machine (VM) instance. -// For more information, see Machine images. -message MachineImage { - // [Output Only] The creation timestamp for this machine image in RFC3339 text - // format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // [Input Only] Whether to attempt an application consistent machine image by - // informing the OS to prepare for the snapshot process. - optional bool guest_flush = 3 [json_name = "guestFlush"]; - - // [Output Only] A unique identifier for this machine image. The server - // defines this identifier. - optional string id = 4 [json_name = "id"]; - - // [Output Only] Properties of source instance - optional InstanceProperties instance_properties = 5 - [json_name = "instanceProperties"]; - - // [Output Only] The resource type, which is always compute#machineImage for - // machine image. - optional string kind = 6 [json_name = "kind"]; - - // Encrypts the machine image using a customer-supplied encryption key. After - // you encrypt a machine image using a customer-supplied key, you must provide - // the same key if you use the machine image later. For example, you must - // provide the encryption key when you create an instance from the encrypted - // machine image in a future request. Customer-supplied encryption keys do not - // protect access to metadata of the machine image. If you do not provide an - // encryption key when creating the machine image, then the machine image will - // be encrypted using an automatically generated key and you do not need to - // provide a key to use the machine image later. - optional CustomerEncryptionKey machine_image_encryption_key = 7 - [json_name = "machineImageEncryptionKey"]; - - // 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. - optional string name = 8 [json_name = "name"]; - - // Output only. Reserved for future use. - optional bool satisfies_pzi = 18 [json_name = "satisfiesPzi"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzs = 9 [json_name = "satisfiesPzs"]; - - // An array of Machine Image specific properties for disks attached to the - // source instance - repeated SavedDisk saved_disks = 10 [json_name = "savedDisks"]; - - // [Output Only] The URL for this machine image. The server defines this URL. - optional string self_link = 11 [json_name = "selfLink"]; - - // [Input Only] The customer-supplied encryption key of the disks attached to - // the source instance. Required if the source disk is protected by a - // customer-supplied encryption key. - repeated SourceDiskEncryptionKey source_disk_encryption_keys = 12 - [json_name = "sourceDiskEncryptionKeys"]; - - // The source instance used to create the machine image. You can provide this - // as a partial or full URL to the resource. For example, the following are - // valid values: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /instances/instance - projects/project/zones/zone/instances/instance - optional string source_instance = 13 [json_name = "sourceInstance"]; - - // [Output Only] DEPRECATED: Please use instance_properties instead for source - // instance related properties. New properties will not be added to this - // field. - optional SourceInstanceProperties source_instance_properties = 14 - [json_name = "sourceInstanceProperties"]; - - // [Output Only] The status of the machine image. One of the following values: - // INVALID, CREATING, READY, DELETING, and UPLOADING. - // CREATING: - // DELETING: - // INVALID: - // READY: - // UPLOADING: - optional string status = 15 [json_name = "status"]; - - // The regional or multi-regional Cloud Storage bucket location where the - // machine image is stored. - repeated string storage_locations = 16 [json_name = "storageLocations"]; - - // [Output Only] Total size of the storage used by the machine image. - optional string total_storage_bytes = 17 [json_name = "totalStorageBytes"]; -} - -// A list of machine images. -message MachineImageList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of MachineImage resources. - repeated MachineImage items = 2 [json_name = "items"]; - - // [Output Only] The resource type, which is always - // compute#machineImagesListResponse for machine image lists. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; +// A metadata key/value entry. +message Metadata { + // Specifies a fingerprint for this request, which is essentially a hash of + // the metadata's contents and used for optimistic locking. The fingerprint is + // initially generated by Compute Engine and changes after every request to + // modify or update metadata. You must always provide an up-to-date + // fingerprint hash in order to update or change metadata, otherwise the + // request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve the resource. + optional string fingerprint = 1 [json_name = "fingerprint"]; + + message ItemsItem { + // Key for the metadata entry. Keys must conform to the following regexp: + // [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is reflected + // as part of a URL in the metadata server. Additionally, to avoid + // ambiguity, keys must not conflict with any other metadata keys for the + // project. + optional string key = 1 [json_name = "key"]; + + // Value for the metadata entry. These are free-form strings, and only have + // meaning as interpreted by the image running in the instance. The only + // restriction placed on values is that their size must be less than or + // equal to 262144 bytes (256 KiB). + optional string value = 2 [json_name = "value"]; } - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// DEPRECATED: Please use compute#savedDisk instead. An instance-attached disk -// resource. -message SavedAttachedDisk { - // Specifies whether the disk will be auto-deleted when the instance is - // deleted (but not when the disk is detached from the instance). - optional bool auto_delete = 1 [json_name = "autoDelete"]; - - // Indicates that this is a boot disk. The virtual machine will use the first - // partition of the disk for its root filesystem. - optional bool boot = 2 [json_name = "boot"]; - - // Specifies the name of the disk attached to the source instance. - optional string device_name = 3 [json_name = "deviceName"]; - - // The encryption key for the disk. - optional CustomerEncryptionKey disk_encryption_key = 4 - [json_name = "diskEncryptionKey"]; - - // The size of the disk in base-2 GB. - optional string disk_size_gb = 5 [json_name = "diskSizeGb"]; + // Array of key/value pairs. The total size of all keys and values must be + // less than 512 KB. + repeated ItemsItem items = 2 [json_name = "items"]; - // [Output Only] URL of the disk type resource. For example: projects/project - // /zones/zone/diskTypes/pd-standard or pd-ssd - optional string disk_type = 6 [json_name = "diskType"]; - - // A list of features to enable on the guest operating system. Applicable only - // for bootable images. Read Enabling guest operating system features to see a - // list of available options. - repeated GuestOsFeature guest_os_features = 7 [json_name = "guestOsFeatures"]; - - // Specifies zero-based index of the disk that is attached to the source - // instance. - optional int32 index = 8 [json_name = "index"]; - - // Specifies the disk interface to use for attaching this disk, which is - // either SCSI or NVME. - // NVME: - // SCSI: - optional string interface = 9 [json_name = "interface"]; - - // [Output Only] Type of the resource. Always compute#attachedDisk for - // attached disks. - optional string kind = 10 [json_name = "kind"]; - - // [Output Only] Any valid publicly visible licenses. - repeated string licenses = 11 [json_name = "licenses"]; - - // The mode in which this disk is attached to the source instance, either - // READ_WRITE or READ_ONLY. - // READ_ONLY: Attaches this disk in read-only mode. Multiple virtual machines - // can use a disk in read-only mode at a time. - // READ_WRITE: *[Default]* Attaches this disk in read-write mode. Only one - // virtual machine at a time can be attached to a disk in read-write mode. - optional string mode = 12 [json_name = "mode"]; - - // Specifies a URL of the disk attached to the source instance. - optional string source = 13 [json_name = "source"]; - - // [Output Only] A size of the storage used by the disk's snapshot by this - // machine image. - optional string storage_bytes = 14 [json_name = "storageBytes"]; - - // [Output Only] An indicator whether storageBytes is in a stable state or it - // is being adjusted as a result of shared storage reallocation. This status - // can either be UPDATING, meaning the size of the snapshot is being updated, - // or UP_TO_DATE, meaning the size of the snapshot is up-to-date. - // UPDATING: - // UP_TO_DATE: - optional string storage_bytes_status = 15 [json_name = "storageBytesStatus"]; - - // Specifies the type of the attached disk, either SCRATCH or PERSISTENT. - // PERSISTENT: - // SCRATCH: - optional string type = 16 [json_name = "type"]; -} - -// An instance-attached disk resource. -message SavedDisk { - // [Output Only] The architecture of the attached disk. - // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. - // ARM64: Machines with architecture ARM64 - // X86_64: Machines with architecture X86_64 - optional string architecture = 1 [json_name = "architecture"]; - - // [Output Only] Type of the resource. Always compute#savedDisk for attached - // disks. - optional string kind = 2 [json_name = "kind"]; - - // Specifies a URL of the disk attached to the source instance. - optional string source_disk = 3 [json_name = "sourceDisk"]; - - // [Output Only] Size of the individual disk snapshot used by this machine - // image. - optional string storage_bytes = 4 [json_name = "storageBytes"]; - - // [Output Only] An indicator whether storageBytes is in a stable state or it - // is being adjusted as a result of shared storage reallocation. This status - // can either be UPDATING, meaning the size of the snapshot is being updated, - // or UP_TO_DATE, meaning the size of the snapshot is up-to-date. - // UPDATING: - // UP_TO_DATE: - optional string storage_bytes_status = 5 [json_name = "storageBytesStatus"]; -} - -message SourceDiskEncryptionKey { - // The customer-supplied encryption key of the source disk. Required if the - // source disk is protected by a customer-supplied encryption key. - optional CustomerEncryptionKey disk_encryption_key = 1 - [json_name = "diskEncryptionKey"]; - - // URL of the disk attached to the source instance. This can be a full or - // valid partial URL. For example, the following are valid values: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /disks/disk - projects/project/zones/zone/disks/disk - - // zones/zone/disks/disk - optional string source_disk = 2 [json_name = "sourceDisk"]; -} - -// DEPRECATED: Please use compute#instanceProperties instead. New properties -// will not be added to this field. -message SourceInstanceProperties { - // Enables instances created based on this machine image to send packets with - // source IP addresses other than their own and receive packets with - // destination IP addresses other than their own. If these instances will be - // used as an IP gateway or it will be set as the next-hop in a Route - // resource, specify true. If unsure, leave this set to false. See the Enable - // IP forwarding documentation for more information. - optional bool can_ip_forward = 1 [json_name = "canIpForward"]; - - // Whether the instance created from this machine image should be protected - // against deletion. - optional bool deletion_protection = 2 [json_name = "deletionProtection"]; - - // An optional text description for the instances that are created from this - // machine image. - optional string description = 3 [json_name = "description"]; - - // An array of disks that are associated with the instances that are created - // from this machine image. - repeated SavedAttachedDisk disks = 4 [json_name = "disks"]; - - // A list of guest accelerator cards' type and count to use for instances - // created from this machine image. - repeated AcceleratorConfig guest_accelerators = 5 - [json_name = "guestAccelerators"]; - - // KeyRevocationActionType of the instance. Supported options are "STOP" and - // "NONE". The default value is "NONE" if it is not specified. - // KEY_REVOCATION_ACTION_TYPE_UNSPECIFIED: Default value. This value is - // unused. - // NONE: Indicates user chose no operation. - // STOP: Indicates user chose to opt for VM shutdown on key revocation. - optional string key_revocation_action_type = 6 - [json_name = "keyRevocationActionType"]; - - // Labels to apply to instances that are created from this machine image. - map labels = 7 [json_name = "labels"]; - - // The machine type to use for instances that are created from this machine - // image. - optional string machine_type = 8 [json_name = "machineType"]; - - // The metadata key/value pairs to assign to instances that are created from - // this machine image. These pairs can consist of custom metadata or - // predefined keys. See Project and instance metadata for more information. - optional Metadata metadata = 9 [json_name = "metadata"]; - - // Minimum cpu/platform to be used by instances created from this machine - // image. The instance may be scheduled on the specified or newer - // cpu/platform. Applicable values are the friendly names of CPU platforms, - // such as minCpuPlatform: "Intel Haswell" or minCpuPlatform: "Intel Sandy - // Bridge". For more information, read Specifying a Minimum CPU Platform. - optional string min_cpu_platform = 10 [json_name = "minCpuPlatform"]; - - // An array of network access configurations for this interface. - repeated NetworkInterface network_interfaces = 11 - [json_name = "networkInterfaces"]; - - // Specifies the scheduling options for the instances that are created from - // this machine image. - optional Scheduling scheduling = 12 [json_name = "scheduling"]; - - // A list of service accounts with specified scopes. Access tokens for these - // service accounts are available to the instances that are created from this - // machine image. Use metadata queries to obtain the access tokens for these - // instances. - repeated ServiceAccount service_accounts = 13 [json_name = "serviceAccounts"]; - - // A list of tags to apply to the instances that are created from this machine - // image. The tags identify valid sources or targets for network firewalls. - // The setTags method can modify this list of tags. Each tag within the list - // must comply with RFC1035. - optional Tags tags = 14 [json_name = "tags"]; + // [Output Only] Type of the resource. Always compute#metadata for metadata. + optional string kind = 3 [json_name = "kind"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_077.proto b/protos/google/cloud/compute/v1/internal/common_077.proto index a7e3a4a68d756..a6b85a13ac101 100644 --- a/protos/google/cloud/compute/v1/internal/common_077.proto +++ b/protos/google/cloud/compute/v1/internal/common_077.proto @@ -15,401 +15,54 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; - -// Represents a Machine Type resource. You can use specific machine types for -// your VM instances based on performance and pricing requirements. For more -// information, read Machine Types. -message MachineType { - message AcceleratorsItem { - // Number of accelerator cards exposed to the guest. - optional int32 guest_accelerator_count = 1 - [json_name = "guestAcceleratorCount"]; - - // The accelerator type resource name, not a full URL, e.g. nvidia-tesla-t4. - optional string guest_accelerator_type = 2 - [json_name = "guestAcceleratorType"]; - } - - // [Output Only] A list of accelerator configurations assigned to this machine - // type. - repeated AcceleratorsItem accelerators = 1 [json_name = "accelerators"]; - - // [Output Only] The architecture of the machine type. - // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. - // ARM64: Machines with architecture ARM64 - // X86_64: Machines with architecture X86_64 - optional string architecture = 17 [json_name = "architecture"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // [Output Only] The deprecation status associated with this machine type. - // Only applicable if the machine type is unavailable. - optional DeprecationStatus deprecated = 3 [json_name = "deprecated"]; - - // [Output Only] An optional textual description of the resource. - optional string description = 4 [json_name = "description"]; - - // [Output Only] The number of virtual CPUs that are available to the - // instance. - optional int32 guest_cpus = 5 [json_name = "guestCpus"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 6 [json_name = "id"]; - - // [Deprecated] This property is deprecated and will never be populated with - // any relevant values. - optional int32 image_space_gb = 7 [json_name = "imageSpaceGb"]; - - // [Output Only] Whether this machine type has a shared CPU. See Shared-core - // machine types for more information. - optional bool is_shared_cpu = 8 [json_name = "isSharedCpu"]; - - // [Output Only] The type of the resource. Always compute#machineType for - // machine types. - optional string kind = 9 [json_name = "kind"]; - - // [Output Only] Maximum persistent disks allowed. - optional int32 maximum_persistent_disks = 10 - [json_name = "maximumPersistentDisks"]; - - // [Output Only] Maximum total persistent disks size (GB) allowed. - optional string maximum_persistent_disks_size_gb = 11 - [json_name = "maximumPersistentDisksSizeGb"]; - - // [Output Only] The amount of physical memory available to the instance, - // defined in MB. - optional int32 memory_mb = 12 [json_name = "memoryMb"]; - - // [Output Only] Name of the resource. - optional string name = 13 [json_name = "name"]; - - message ScratchDisksItem { - // Size of the scratch disk, defined in GB. - optional int32 disk_gb = 1 [json_name = "diskGb"]; - } - - // [Output Only] A list of extended scratch disks assigned to the instance. - repeated ScratchDisksItem scratch_disks = 14 [json_name = "scratchDisks"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 15 [json_name = "selfLink"]; - - // [Output Only] The name of the zone where the machine type resides, such as - // us-central1-a. - optional string zone = 16 [json_name = "zone"]; -} - -message MachineTypeAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of MachineTypesScopedList resources. - map items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#machineTypeAggregatedList - // for aggregated lists of machine types. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; +// Opaque filter criteria used by load balancers to restrict routing +// configuration to a limited set of load balancing proxies. Proxies and +// sidecars involved in load balancing would typically present metadata to the +// load balancers that need to match criteria specified here. If a match takes +// place, the relevant configuration is made available to those proxies. For +// each metadataFilter in this list, if its filterMatchCriteria is set to +// MATCH_ANY, at least one of the filterLabels must match the corresponding +// label provided in the metadata. If its filterMatchCriteria is set to +// MATCH_ALL, then all of its filterLabels must match with corresponding labels +// provided in the metadata. An example for using metadataFilters would be: if +// load balancing involves Envoys, they receive routing configuration when +// values in metadataFilters match values supplied in of their XDS requests to +// loadbalancers. +message MetadataFilter { + // The list of label value pairs that must match labels in the provided + // metadata based on filterMatchCriteria This list must not be empty and can + // have at the most 64 entries. + repeated MetadataFilterLabelMatch filter_labels = 1 + [json_name = "filterLabels"]; + + // Specifies how individual filter label matches within the list of + // filterLabels and contributes toward the overall metadataFilter match. + // Supported values are: - MATCH_ANY: at least one of the filterLabels must + // have a matching label in the provided metadata. - MATCH_ALL: all + // filterLabels must have matching labels in the provided metadata. + // MATCH_ALL: Specifies that all filterLabels must match for the + // metadataFilter to be considered a match. + // MATCH_ANY: Specifies that any filterLabel must match for the metadataFilter + // to be considered a match. + // NOT_SET: Indicates that the match criteria was not set. A metadataFilter + // must never be created with this value. + optional string filter_match_criteria = 2 [json_name = "filterMatchCriteria"]; } -// Contains a list of machine types. -message MachineTypeList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of MachineType resources. - repeated MachineType items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#machineTypeList for lists of - // machine types. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -message MachineTypesScopedList { - // [Output Only] A list of machine types contained in this scope. - repeated MachineType machine_types = 1 [json_name = "machineTypes"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +// MetadataFilter label name value pairs that are expected to match +// corresponding labels presented as metadata to the load balancer. +message MetadataFilterLabelMatch { + // Name of metadata label. The name can have a maximum length of 1024 + // characters and must be at least 1 character long. + optional string name = 1 [json_name = "name"]; - // [Output Only] An informational warning that appears when the machine types - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // The value of the label must match the specified value. value can have a + // maximum length of 1024 characters. + optional string value = 2 [json_name = "value"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_078.proto b/protos/google/cloud/compute/v1/internal/common_078.proto index eac44bac19bd0..4ed3a308ec84b 100644 --- a/protos/google/cloud/compute/v1/internal/common_078.proto +++ b/protos/google/cloud/compute/v1/internal/common_078.proto @@ -15,42 +15,18 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// A metadata key/value entry. -message Metadata { - // Specifies a fingerprint for this request, which is essentially a hash of - // the metadata's contents and used for optimistic locking. The fingerprint is - // initially generated by Compute Engine and changes after every request to - // modify or update metadata. You must always provide an up-to-date - // fingerprint hash in order to update or change metadata, otherwise the - // request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve the resource. - optional string fingerprint = 1 [json_name = "fingerprint"]; +// The named port. For example: <"http", 80>. +message NamedPort { + // The name for this named port. The name must be 1-63 characters long, and + // comply with RFC1035. + optional string name = 1 [json_name = "name"]; - message ItemsItem { - // Key for the metadata entry. Keys must conform to the following regexp: - // [a-zA-Z0-9-_]+, and be less than 128 bytes in length. This is reflected - // as part of a URL in the metadata server. Additionally, to avoid - // ambiguity, keys must not conflict with any other metadata keys for the - // project. - optional string key = 1 [json_name = "key"]; - - // Value for the metadata entry. These are free-form strings, and only have - // meaning as interpreted by the image running in the instance. The only - // restriction placed on values is that their size must be less than or - // equal to 262144 bytes (256 KiB). - optional string value = 2 [json_name = "value"]; - } - - // Array of key/value pairs. The total size of all keys and values must be - // less than 512 KB. - repeated ItemsItem items = 2 [json_name = "items"]; - - // [Output Only] Type of the resource. Always compute#metadata for metadata. - optional string kind = 3 [json_name = "kind"]; + // The port number, which can be a value between 1 and 65535. + optional int32 port = 2 [json_name = "port"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_079.proto b/protos/google/cloud/compute/v1/internal/common_079.proto index 085b44d48421a..3f790221a13a0 100644 --- a/protos/google/cloud/compute/v1/internal/common_079.proto +++ b/protos/google/cloud/compute/v1/internal/common_079.proto @@ -15,54 +15,423 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Opaque filter criteria used by load balancers to restrict routing -// configuration to a limited set of load balancing proxies. Proxies and -// sidecars involved in load balancing would typically present metadata to the -// load balancers that need to match criteria specified here. If a match takes -// place, the relevant configuration is made available to those proxies. For -// each metadataFilter in this list, if its filterMatchCriteria is set to -// MATCH_ANY, at least one of the filterLabels must match the corresponding -// label provided in the metadata. If its filterMatchCriteria is set to -// MATCH_ALL, then all of its filterLabels must match with corresponding labels -// provided in the metadata. An example for using metadataFilters would be: if -// load balancing involves Envoys, they receive routing configuration when -// values in metadataFilters match values supplied in of their XDS requests to -// loadbalancers. -message MetadataFilter { - // The list of label value pairs that must match labels in the provided - // metadata based on filterMatchCriteria This list must not be empty and can - // have at the most 64 entries. - repeated MetadataFilterLabelMatch filter_labels = 1 - [json_name = "filterLabels"]; - - // Specifies how individual filter label matches within the list of - // filterLabels and contributes toward the overall metadataFilter match. - // Supported values are: - MATCH_ANY: at least one of the filterLabels must - // have a matching label in the provided metadata. - MATCH_ALL: all - // filterLabels must have matching labels in the provided metadata. - // MATCH_ALL: Specifies that all filterLabels must match for the - // metadataFilter to be considered a match. - // MATCH_ANY: Specifies that any filterLabel must match for the metadataFilter - // to be considered a match. - // NOT_SET: Indicates that the match criteria was not set. A metadataFilter - // must never be created with this value. - optional string filter_match_criteria = 2 [json_name = "filterMatchCriteria"]; +// NetworkAttachments A network attachment resource ... +message NetworkAttachment { + // [Output Only] An array of connections for all the producers connected to + // this network attachment. + repeated NetworkAttachmentConnectedEndpoint connection_endpoints = 1 + [json_name = "connectionEndpoints"]; + + // ACCEPT_AUTOMATIC: + // ACCEPT_MANUAL: + // INVALID: + optional string connection_preference = 2 + [json_name = "connectionPreference"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 4 [json_name = "description"]; + + // Fingerprint of this resource. A hash of the contents stored in this object. + // This field is used in optimistic locking. An up-to-date fingerprint must be + // provided in order to patch. + optional string fingerprint = 5 [json_name = "fingerprint"]; + + // [Output Only] The unique identifier for the resource type. The server + // generates this identifier. + optional string id = 6 [json_name = "id"]; + + // [Output Only] Type of the resource. + optional string kind = 7 [json_name = "kind"]; + + // 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. + optional string name = 8 [json_name = "name"]; + + // [Output Only] The URL of the network which the Network Attachment belongs + // to. Practically it is inferred by fetching the network of the first + // subnetwork associated. Because it is required that all the subnetworks must + // be from the same network, it is assured that the Network Attachment belongs + // to the same network as all the subnetworks. + optional string network = 9 [json_name = "network"]; + + // Projects that are allowed to connect to this network attachment. The + // project can be specified using its id or number. + repeated string producer_accept_lists = 10 + [json_name = "producerAcceptLists"]; + + // Projects that are not allowed to connect to this network attachment. The + // project can be specified using its id or number. + repeated string producer_reject_lists = 11 + [json_name = "producerRejectLists"]; + + // [Output Only] URL of the region where the network attachment resides. This + // field applies only to the region resource. You must specify this field as + // part of the HTTP request URL. It is not settable as a field in the request + // body. + optional string region = 12 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 13 [json_name = "selfLink"]; + + // [Output Only] Server-defined URL for this resource's resource id. + optional string self_link_with_id = 14 [json_name = "selfLinkWithId"]; + + // An array of URLs where each entry is the URL of a subnet provided by the + // service consumer to use for endpoints in the producers that connect to this + // network attachment. + repeated string subnetworks = 15 [json_name = "subnetworks"]; +} + +// Contains a list of NetworkAttachmentsScopedList. +message NetworkAttachmentAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of NetworkAttachmentsScopedList resources. + map items = 2 [json_name = "items"]; + + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } -// MetadataFilter label name value pairs that are expected to match -// corresponding labels presented as metadata to the load balancer. -message MetadataFilterLabelMatch { - // Name of metadata label. The name can have a maximum length of 1024 - // characters and must be at least 1 character long. - optional string name = 1 [json_name = "name"]; +// [Output Only] A connection connected to this network attachment. +message NetworkAttachmentConnectedEndpoint { + // The IPv4 address assigned to the producer instance network interface. This + // value will be a range in case of Serverless. + optional string ip_address = 1 [json_name = "ipAddress"]; + + // The IPv6 address assigned to the producer instance network interface. This + // is only assigned when the stack types of both the instance network + // interface and the consumer subnet are IPv4_IPv6. + optional string ipv6_address = 6 [json_name = "ipv6Address"]; + + // The project id or number of the interface to which the IP was assigned. + optional string project_id_or_num = 2 [json_name = "projectIdOrNum"]; + + // Alias IP ranges from the same subnetwork. + repeated string secondary_ip_cidr_ranges = 3 + [json_name = "secondaryIpCidrRanges"]; + + // The status of a connected endpoint to this network attachment. + // ACCEPTED: The consumer allows traffic from the producer to reach its VPC. + // CLOSED: The consumer network attachment no longer exists. + // NEEDS_ATTENTION: The consumer needs to take further action before traffic + // can be served. + // PENDING: The consumer neither allows nor prohibits traffic from the + // producer to reach its VPC. + // REJECTED: The consumer prohibits traffic from the producer to reach its + // VPC. + // STATUS_UNSPECIFIED: + optional string status = 4 [json_name = "status"]; + + // The subnetwork used to assign the IP to the producer instance network + // interface. + optional string subnetwork = 5 [json_name = "subnetwork"]; + + // [Output Only] The CIDR range of the subnet from which the IPv4 internal IP + // was allocated from. + optional string subnetwork_cidr_range = 7 [json_name = "subnetworkCidrRange"]; +} + +message NetworkAttachmentList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of NetworkAttachment resources. + repeated NetworkAttachment items = 2 [json_name = "items"]; + + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message NetworkAttachmentsScopedList { + // A list of NetworkAttachments contained in this scope. + repeated NetworkAttachment network_attachments = 1 + [json_name = "networkAttachments"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // The value of the label must match the specified value. value can have a - // maximum length of 1024 characters. - optional string value = 2 [json_name = "value"]; + // Informational warning which replaces the list of network attachments when + // the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_080.proto b/protos/google/cloud/compute/v1/internal/common_080.proto index beed3c434bfa8..6b138be82be54 100644 --- a/protos/google/cloud/compute/v1/internal/common_080.proto +++ b/protos/google/cloud/compute/v1/internal/common_080.proto @@ -15,18 +15,262 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// The named port. For example: <"http", 80>. -message NamedPort { - // The name for this named port. The name must be 1-63 characters long, and - // comply with RFC1035. - optional string name = 1 [json_name = "name"]; +// Represents a Google Cloud Armor network edge security service resource. +message NetworkEdgeSecurityService { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // The port number, which can be a value between 1 and 65535. - optional int32 port = 2 [json_name = "port"]; + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "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 NetworkEdgeSecurityService. An up-to-date fingerprint must be + // provided in order to update the NetworkEdgeSecurityService, otherwise the + // request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve a NetworkEdgeSecurityService. + optional string fingerprint = 3 [json_name = "fingerprint"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // [Output only] Type of the resource. Always + // compute#networkEdgeSecurityService for NetworkEdgeSecurityServices + optional string kind = 5 [json_name = "kind"]; + + // 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. + optional string name = 6 [json_name = "name"]; + + // [Output Only] URL of the region where the resource resides. You must + // specify this field as part of the HTTP request URL. It is not settable as a + // field in the request body. + optional string region = 7 [json_name = "region"]; + + // The resource URL for the network edge security service associated with this + // network edge security service. + optional string security_policy = 8 [json_name = "securityPolicy"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 9 [json_name = "selfLink"]; + + // [Output Only] Server-defined URL for this resource with the resource id. + optional string self_link_with_id = 10 [json_name = "selfLinkWithId"]; +} + +message NetworkEdgeSecurityServiceAggregatedList { + optional string etag = 1 [json_name = "etag"]; + + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 2 [json_name = "id"]; + + // A list of NetworkEdgeSecurityServicesScopedList resources. + map items = 3 + [json_name = "items"]; + + // [Output Only] Type of resource. Always + // compute#networkEdgeSecurityServiceAggregatedList for lists of Network Edge + // Security Services. + optional string kind = 4 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 5 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 7 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 8 [json_name = "warning"]; +} + +message NetworkEdgeSecurityServicesScopedList { + // A list of NetworkEdgeSecurityServices contained in this scope. + repeated NetworkEdgeSecurityService network_edge_security_services = 1 + [json_name = "networkEdgeSecurityServices"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of security policies when the + // list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_081.proto b/protos/google/cloud/compute/v1/internal/common_081.proto index be32de3adc461..d6ffc05a79fef 100644 --- a/protos/google/cloud/compute/v1/internal/common_081.proto +++ b/protos/google/cloud/compute/v1/internal/common_081.proto @@ -15,96 +15,24 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// NetworkAttachments A network attachment resource ... -message NetworkAttachment { - // [Output Only] An array of connections for all the producers connected to - // this network attachment. - repeated NetworkAttachmentConnectedEndpoint connection_endpoints = 1 - [json_name = "connectionEndpoints"]; +import "google/cloud/compute/v1/internal/common_012.proto"; - // ACCEPT_AUTOMATIC: - // ACCEPT_MANUAL: - // INVALID: - optional string connection_preference = 2 - [json_name = "connectionPreference"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 4 [json_name = "description"]; - - // Fingerprint of this resource. A hash of the contents stored in this object. - // This field is used in optimistic locking. An up-to-date fingerprint must be - // provided in order to patch. - optional string fingerprint = 5 [json_name = "fingerprint"]; - - // [Output Only] The unique identifier for the resource type. The server - // generates this identifier. - optional string id = 6 [json_name = "id"]; - - // [Output Only] Type of the resource. - optional string kind = 7 [json_name = "kind"]; - - // 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. - optional string name = 8 [json_name = "name"]; - - // [Output Only] The URL of the network which the Network Attachment belongs - // to. Practically it is inferred by fetching the network of the first - // subnetwork associated. Because it is required that all the subnetworks must - // be from the same network, it is assured that the Network Attachment belongs - // to the same network as all the subnetworks. - optional string network = 9 [json_name = "network"]; - - // Projects that are allowed to connect to this network attachment. The - // project can be specified using its id or number. - repeated string producer_accept_lists = 10 - [json_name = "producerAcceptLists"]; - - // Projects that are not allowed to connect to this network attachment. The - // project can be specified using its id or number. - repeated string producer_reject_lists = 11 - [json_name = "producerRejectLists"]; - - // [Output Only] URL of the region where the network attachment resides. This - // field applies only to the region resource. You must specify this field as - // part of the HTTP request URL. It is not settable as a field in the request - // body. - optional string region = 12 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 13 [json_name = "selfLink"]; - - // [Output Only] Server-defined URL for this resource's resource id. - optional string self_link_with_id = 14 [json_name = "selfLinkWithId"]; - - // An array of URLs where each entry is the URL of a subnet provided by the - // service consumer to use for endpoints in the producers that connect to this - // network attachment. - repeated string subnetworks = 15 [json_name = "subnetworks"]; -} - -// Contains a list of NetworkAttachmentsScopedList. -message NetworkAttachmentAggregatedList { +message NetworkEndpointGroupAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of NetworkAttachmentsScopedList resources. - map items = 2 [json_name = "items"]; + // A list of NetworkEndpointGroupsScopedList resources. + map items = 2 [json_name = "items"]; + // [Output Only] The resource type, which is always + // compute#networkEndpointGroupAggregatedList for aggregated lists of network + // endpoint groups. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -117,6 +45,9 @@ message NetworkAttachmentAggregatedList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -199,156 +130,36 @@ message NetworkAttachmentAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; } -// [Output Only] A connection connected to this network attachment. -message NetworkAttachmentConnectedEndpoint { - // The IPv4 address assigned to the producer instance network interface. This - // value will be a range in case of Serverless. - optional string ip_address = 1 [json_name = "ipAddress"]; - - // The IPv6 address assigned to the producer instance network interface. This - // is only assigned when the stack types of both the instance network - // interface and the consumer subnet are IPv4_IPv6. - optional string ipv6_address = 6 [json_name = "ipv6Address"]; - - // The project id or number of the interface to which the IP was assigned. - optional string project_id_or_num = 2 [json_name = "projectIdOrNum"]; - - // Alias IP ranges from the same subnetwork. - repeated string secondary_ip_cidr_ranges = 3 - [json_name = "secondaryIpCidrRanges"]; - - // The status of a connected endpoint to this network attachment. - // ACCEPTED: The consumer allows traffic from the producer to reach its VPC. - // CLOSED: The consumer network attachment no longer exists. - // NEEDS_ATTENTION: The consumer needs to take further action before traffic - // can be served. - // PENDING: The consumer neither allows nor prohibits traffic from the - // producer to reach its VPC. - // REJECTED: The consumer prohibits traffic from the producer to reach its - // VPC. - // STATUS_UNSPECIFIED: - optional string status = 4 [json_name = "status"]; - - // The subnetwork used to assign the IP to the producer instance network - // interface. - optional string subnetwork = 5 [json_name = "subnetwork"]; - - // [Output Only] The CIDR range of the subnet from which the IPv4 internal IP - // was allocated from. - optional string subnetwork_cidr_range = 7 [json_name = "subnetworkCidrRange"]; +message NetworkEndpointGroupsAttachEndpointsRequest { + // The list of network endpoints to be attached. + repeated NetworkEndpoint network_endpoints = 1 + [json_name = "networkEndpoints"]; } -message NetworkAttachmentList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of NetworkAttachment resources. - repeated NetworkAttachment items = 2 [json_name = "items"]; - - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +message NetworkEndpointGroupsDetachEndpointsRequest { + // The list of network endpoints to be detached. + repeated NetworkEndpoint network_endpoints = 1 + [json_name = "networkEndpoints"]; +} - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; +message NetworkEndpointGroupsListEndpointsRequest { + // Optional query parameter for showing the health status of each network + // endpoint. Valid options are SKIP or SHOW. If you don't specify this + // parameter, the health status of network endpoints will not be provided. + // SHOW: Show the health status for each network endpoint. Impacts latency of + // the call. + // SKIP: Health status for network endpoints will not be provided. + optional string health_status = 1 [json_name = "healthStatus"]; } -message NetworkAttachmentsScopedList { - // A list of NetworkAttachments contained in this scope. - repeated NetworkAttachment network_attachments = 1 - [json_name = "networkAttachments"]; +message NetworkEndpointGroupsScopedList { + // [Output Only] The list of network endpoint groups that are contained in + // this scope. + repeated NetworkEndpointGroup network_endpoint_groups = 1 + [json_name = "networkEndpointGroups"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -431,7 +242,7 @@ message NetworkAttachmentsScopedList { optional string message = 3 [json_name = "message"]; } - // Informational warning which replaces the list of network attachments when - // the list is empty. + // [Output Only] An informational warning that replaces the list of network + // endpoint groups when the list is empty. optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_082.proto b/protos/google/cloud/compute/v1/internal/common_082.proto index 2378ed2816662..a9d8a250d3b4d 100644 --- a/protos/google/cloud/compute/v1/internal/common_082.proto +++ b/protos/google/cloud/compute/v1/internal/common_082.proto @@ -15,89 +15,113 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Google Cloud Armor network edge security service resource. -message NetworkEdgeSecurityService { +import "google/cloud/compute/v1/internal/common_001.proto"; +import "google/cloud/compute/v1/internal/common_073.proto"; + +// Represent a sole-tenant Node Template resource. You can use a template to +// define properties for nodes in a node group. For more information, read +// Creating node groups and instances. +message NodeTemplate { + repeated AcceleratorConfig accelerators = 1 [json_name = "accelerators"]; + + // CPU overcommit. + // CPU_OVERCOMMIT_TYPE_UNSPECIFIED: + // ENABLED: + // NONE: + optional string cpu_overcommit_type = 2 [json_name = "cpuOvercommitType"]; + // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 2 [json_name = "description"]; + optional string description = 4 [json_name = "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 NetworkEdgeSecurityService. An up-to-date fingerprint must be - // provided in order to update the NetworkEdgeSecurityService, otherwise the - // request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve a NetworkEdgeSecurityService. - optional string fingerprint = 3 [json_name = "fingerprint"]; + repeated LocalDisk disks = 5 [json_name = "disks"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 4 [json_name = "id"]; - - // [Output only] Type of the resource. Always - // compute#networkEdgeSecurityService for NetworkEdgeSecurityServices - optional string kind = 5 [json_name = "kind"]; - - // 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. - optional string name = 6 [json_name = "name"]; - - // [Output Only] URL of the region where the resource resides. You must - // specify this field as part of the HTTP request URL. It is not settable as a - // field in the request body. - optional string region = 7 [json_name = "region"]; - - // The resource URL for the network edge security service associated with this - // network edge security service. - optional string security_policy = 8 [json_name = "securityPolicy"]; + optional string id = 6 [json_name = "id"]; - // [Output Only] Server-defined URL for the resource. - optional string self_link = 9 [json_name = "selfLink"]; + // [Output Only] The type of the resource. Always compute#nodeTemplate for + // node templates. + optional string kind = 7 [json_name = "kind"]; - // [Output Only] Server-defined URL for this resource with the resource id. - optional string self_link_with_id = 10 [json_name = "selfLinkWithId"]; -} + // The name of the resource, provided by the client when initially creating + // the resource. The resource name must be 1-63 characters long, and comply + // with RFC1035. Specifically, the name must be 1-63 characters long and match + // the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + // character must be a lowercase letter, and all following characters must be + // a dash, lowercase letter, or digit, except the last character, which cannot + // be a dash. + optional string name = 8 [json_name = "name"]; + + // Labels to use for node affinity, which will be used in instance scheduling. + map node_affinity_labels = 9 + [json_name = "nodeAffinityLabels"]; + + // The node type to use for nodes group that are created from this template. + optional string node_type = 10 [json_name = "nodeType"]; -message NetworkEdgeSecurityServiceAggregatedList { - optional string etag = 1 [json_name = "etag"]; + // Do not use. Instead, use the node_type property. + optional NodeTemplateNodeTypeFlexibility node_type_flexibility = 11 + [json_name = "nodeTypeFlexibility"]; + // [Output Only] The name of the region where the node template resides, such + // as us-central1. + optional string region = 12 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 13 [json_name = "selfLink"]; + + // Sets the binding properties for the physical server. Valid values include: + // - *[Default]* RESTART_NODE_ON_ANY_SERVER: Restarts VMs on any available + // physical server - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same + // physical server whenever possible See Sole-tenant node options for more + // information. + optional ServerBinding server_binding = 14 [json_name = "serverBinding"]; + + // [Output Only] The status of the node template. One of the following values: + // CREATING, READY, and DELETING. + // CREATING: Resources are being allocated. + // DELETING: The node template is currently being deleted. + // INVALID: Invalid status. + // READY: The node template is ready. + optional string status = 15 [json_name = "status"]; + + // [Output Only] An optional, human-readable explanation of the status. + optional string status_message = 16 [json_name = "statusMessage"]; +} + +message NodeTemplateAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 2 [json_name = "id"]; + optional string id = 1 [json_name = "id"]; - // A list of NetworkEdgeSecurityServicesScopedList resources. - map items = 3 - [json_name = "items"]; + // A list of NodeTemplatesScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always - // compute#networkEdgeSecurityServiceAggregatedList for lists of Network Edge - // Security Services. - optional string kind = 4 [json_name = "kind"]; + // [Output Only] Type of resource.Always compute#nodeTemplateAggregatedList + // for aggregated lists of node templates. + optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for // list requests. If the number of results is larger than maxResults, use the // nextPageToken as a value for the query parameter pageToken in the next list // request. Subsequent list requests will have their own nextPageToken to // continue paging through the results. - optional string next_page_token = 5 [json_name = "nextPageToken"]; + optional string next_page_token = 4 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. - optional string self_link = 6 [json_name = "selfLink"]; + optional string self_link = 5 [json_name = "selfLink"]; // [Output Only] Unreachable resources. - repeated string unreachables = 7 [json_name = "unreachables"]; + repeated string unreachables = 6 [json_name = "unreachables"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -181,13 +205,127 @@ message NetworkEdgeSecurityServiceAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; +} + +// Contains a list of node templates. +message NodeTemplateList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of NodeTemplate resources. + repeated NodeTemplate items = 2 [json_name = "items"]; + + // [Output Only] Type of resource.Always compute#nodeTemplateList for lists of + // node templates. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message NodeTemplateNodeTypeFlexibility { + optional string cpus = 1 [json_name = "cpus"]; + + optional string local_ssd = 2 [json_name = "localSsd"]; + + optional string memory = 3 [json_name = "memory"]; } -message NetworkEdgeSecurityServicesScopedList { - // A list of NetworkEdgeSecurityServices contained in this scope. - repeated NetworkEdgeSecurityService network_edge_security_services = 1 - [json_name = "networkEdgeSecurityServices"]; +message NodeTemplatesScopedList { + // [Output Only] A list of node templates contained in this scope. + repeated NodeTemplate node_templates = 1 [json_name = "nodeTemplates"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -270,7 +408,7 @@ message NetworkEdgeSecurityServicesScopedList { optional string message = 3 [json_name = "message"]; } - // Informational warning which replaces the list of security policies when the + // [Output Only] An informational warning that appears when the node templates // list is empty. optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_083.proto b/protos/google/cloud/compute/v1/internal/common_083.proto index 0c0f6e0cb53fd..cea49d909c000 100644 --- a/protos/google/cloud/compute/v1/internal/common_083.proto +++ b/protos/google/cloud/compute/v1/internal/common_083.proto @@ -15,24 +15,71 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_013.proto"; +import "google/cloud/compute/v1/internal/common_022.proto"; -message NetworkEndpointGroupAggregatedList { +// Represent a sole-tenant Node Type resource. Each node within a node group +// must have a node type. A node type specifies the total amount of cores and +// memory for that node. Currently, the only available node type is +// n1-node-96-624 node type that has 96 vCPUs and 624 GB of memory, available in +// multiple zones. For more information read Node types. +message NodeType { + // [Output Only] The CPU platform used by this node type. + optional string cpu_platform = 1 [json_name = "cpuPlatform"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // [Output Only] The deprecation status associated with this node type. + optional DeprecationStatus deprecated = 3 [json_name = "deprecated"]; + + // [Output Only] An optional textual description of the resource. + optional string description = 4 [json_name = "description"]; + + // [Output Only] The number of virtual CPUs that are available to the node + // type. + optional int32 guest_cpus = 5 [json_name = "guestCpus"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // [Output Only] The type of the resource. Always compute#nodeType for node + // types. + optional string kind = 7 [json_name = "kind"]; + + // [Output Only] Local SSD available to the node type, defined in GB. + optional int32 local_ssd_gb = 8 [json_name = "localSsdGb"]; + + // [Output Only] The amount of physical memory available to the node type, + // defined in MB. + optional int32 memory_mb = 9 [json_name = "memoryMb"]; + + // [Output Only] Name of the resource. + optional string name = 10 [json_name = "name"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 11 [json_name = "selfLink"]; + + // [Output Only] The name of the zone where the node type resides, such as + // us-central1-a. + optional string zone = 12 [json_name = "zone"]; +} + +message NodeTypeAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of NetworkEndpointGroupsScopedList resources. - map items = 2 [json_name = "items"]; + // A list of NodeTypesScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] The resource type, which is always - // compute#networkEndpointGroupAggregatedList for aggregated lists of network - // endpoint groups. + // [Output Only] Type of resource.Always compute#nodeTypeAggregatedList for + // aggregated lists of node types. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -133,33 +180,116 @@ message NetworkEndpointGroupAggregatedList { optional Warning warning = 7 [json_name = "warning"]; } -message NetworkEndpointGroupsAttachEndpointsRequest { - // The list of network endpoints to be attached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; -} +// Contains a list of node types. +message NodeTypeList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; -message NetworkEndpointGroupsDetachEndpointsRequest { - // The list of network endpoints to be detached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; -} + // A list of NodeType resources. + repeated NodeType items = 2 [json_name = "items"]; + + // [Output Only] Type of resource.Always compute#nodeTypeList for lists of + // node types. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; -message NetworkEndpointGroupsListEndpointsRequest { - // Optional query parameter for showing the health status of each network - // endpoint. Valid options are SKIP or SHOW. If you don't specify this - // parameter, the health status of network endpoints will not be provided. - // SHOW: Show the health status for each network endpoint. Impacts latency of - // the call. - // SKIP: Health status for network endpoints will not be provided. - optional string health_status = 1 [json_name = "healthStatus"]; + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } -message NetworkEndpointGroupsScopedList { - // [Output Only] The list of network endpoint groups that are contained in - // this scope. - repeated NetworkEndpointGroup network_endpoint_groups = 1 - [json_name = "networkEndpointGroups"]; +message NodeTypesScopedList { + // [Output Only] A list of node types contained in this scope. + repeated NodeType node_types = 1 [json_name = "nodeTypes"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -242,7 +372,7 @@ message NetworkEndpointGroupsScopedList { optional string message = 3 [json_name = "message"]; } - // [Output Only] An informational warning that replaces the list of network - // endpoint groups when the list is empty. + // [Output Only] An informational warning that appears when the node types + // list is empty. optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_084.proto b/protos/google/cloud/compute/v1/internal/common_084.proto index 79bd3647b477e..645f6363e1db6 100644 --- a/protos/google/cloud/compute/v1/internal/common_084.proto +++ b/protos/google/cloud/compute/v1/internal/common_084.proto @@ -15,209 +15,95 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_001.proto"; -import "google/cloud/compute/v1/internal/common_075.proto"; - -// Represent a sole-tenant Node Template resource. You can use a template to -// define properties for nodes in a node group. For more information, read -// Creating node groups and instances. -message NodeTemplate { - repeated AcceleratorConfig accelerators = 1 [json_name = "accelerators"]; - - // CPU overcommit. - // CPU_OVERCOMMIT_TYPE_UNSPECIFIED: - // ENABLED: - // NONE: - optional string cpu_overcommit_type = 2 [json_name = "cpuOvercommitType"]; +import "google/cloud/compute/v1/internal/common_029.proto"; +// Represents a notification endpoint. A notification endpoint resource defines +// an endpoint to receive notifications when there are status changes detected +// by the associated health check service. For more information, see Health +// checks overview. +message NotificationEndpoint { // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 4 [json_name = "description"]; - - repeated LocalDisk disks = 5 [json_name = "disks"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 6 [json_name = "id"]; - - // [Output Only] The type of the resource. Always compute#nodeTemplate for - // node templates. - optional string kind = 7 [json_name = "kind"]; - - // The name of the resource, provided by the client when initially creating - // the resource. The resource name must be 1-63 characters long, and comply - // with RFC1035. Specifically, the name must be 1-63 characters long and match - // the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first - // character must be a lowercase letter, and all following characters must be - // a dash, lowercase letter, or digit, except the last character, which cannot - // be a dash. - optional string name = 8 [json_name = "name"]; - - // Labels to use for node affinity, which will be used in instance scheduling. - map node_affinity_labels = 9 - [json_name = "nodeAffinityLabels"]; - - // The node type to use for nodes group that are created from this template. - optional string node_type = 10 [json_name = "nodeType"]; - - // Do not use. Instead, use the node_type property. - optional NodeTemplateNodeTypeFlexibility node_type_flexibility = 11 - [json_name = "nodeTypeFlexibility"]; - - // [Output Only] The name of the region where the node template resides, such - // as us-central1. - optional string region = 12 [json_name = "region"]; + optional string description = 2 [json_name = "description"]; + + // Settings of the gRPC notification endpoint including the endpoint URL and + // the retry duration. + optional NotificationEndpointGrpcSettings grpc_settings = 3 + [json_name = "grpcSettings"]; + + // [Output Only] A unique identifier for this resource type. The server + // generates this identifier. + optional string id = 4 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#notificationEndpoint for + // notification endpoints. + optional string kind = 5 [json_name = "kind"]; + + // 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. + optional string name = 6 [json_name = "name"]; + + // [Output Only] URL of the region where the notification endpoint resides. + // This field applies only to the regional resource. You must specify this + // field as part of the HTTP request URL. It is not settable as a field in the + // request body. + optional string region = 7 [json_name = "region"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 13 [json_name = "selfLink"]; - - // Sets the binding properties for the physical server. Valid values include: - // - *[Default]* RESTART_NODE_ON_ANY_SERVER: Restarts VMs on any available - // physical server - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same - // physical server whenever possible See Sole-tenant node options for more - // information. - optional ServerBinding server_binding = 14 [json_name = "serverBinding"]; - - // [Output Only] The status of the node template. One of the following values: - // CREATING, READY, and DELETING. - // CREATING: Resources are being allocated. - // DELETING: The node template is currently being deleted. - // INVALID: Invalid status. - // READY: The node template is ready. - optional string status = 15 [json_name = "status"]; - - // [Output Only] An optional, human-readable explanation of the status. - optional string status_message = 16 [json_name = "statusMessage"]; + optional string self_link = 8 [json_name = "selfLink"]; } -message NodeTemplateAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of NodeTemplatesScopedList resources. - map items = 2 [json_name = "items"]; - - // [Output Only] Type of resource.Always compute#nodeTemplateAggregatedList - // for aggregated lists of node templates. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; +// Represents a gRPC setting that describes one gRPC notification endpoint and +// the retry duration attempting to send notification to this endpoint. +message NotificationEndpointGrpcSettings { + // Optional. If specified, this field is used to set the authority header by + // the sender of notifications. See + // https://tools.ietf.org/html/rfc7540#section-8.1.2.3 + optional string authority = 1 [json_name = "authority"]; + + // Endpoint to which gRPC notifications are sent. This must be a valid gRPCLB + // DNS name. + optional string endpoint = 2 [json_name = "endpoint"]; + + // Optional. If specified, this field is used to populate the "name" field in + // gRPC requests. + optional string payload_name = 3 [json_name = "payloadName"]; + + // Optional. This field is used to configure how often to send a full update + // of all non-healthy backends. If unspecified, full updates are not sent. If + // specified, must be in the range between 600 seconds to 3600 seconds. Nanos + // are disallowed. Can only be set for regional notification endpoints. + optional Duration resend_interval = 4 [json_name = "resendInterval"]; + + // How much time (in seconds) is spent attempting notification retries until a + // successful response is received. Default is 30s. Limit is 20m (1200s). Must + // be a positive number. + optional uint32 retry_duration_sec = 5 [json_name = "retryDurationSec"]; } -// Contains a list of node templates. -message NodeTemplateList { +message NotificationEndpointList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of NodeTemplate resources. - repeated NodeTemplate items = 2 [json_name = "items"]; + // A list of NotificationEndpoint resources. + repeated NotificationEndpoint items = 2 [json_name = "items"]; - // [Output Only] Type of resource.Always compute#nodeTemplateList for lists of - // node templates. + // [Output Only] Type of the resource. Always compute#notificationEndpoint for + // notification endpoints. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -314,101 +200,3 @@ message NodeTemplateList { // [Output Only] Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } - -message NodeTemplateNodeTypeFlexibility { - optional string cpus = 1 [json_name = "cpus"]; - - optional string local_ssd = 2 [json_name = "localSsd"]; - - optional string memory = 3 [json_name = "memory"]; -} - -message NodeTemplatesScopedList { - // [Output Only] A list of node templates contained in this scope. - repeated NodeTemplate node_templates = 1 [json_name = "nodeTemplates"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] An informational warning that appears when the node templates - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} diff --git a/protos/google/cloud/compute/v1/internal/common_085.proto b/protos/google/cloud/compute/v1/internal/common_085.proto index be4e704e85b03..bafd7d7cbefac 100644 --- a/protos/google/cloud/compute/v1/internal/common_085.proto +++ b/protos/google/cloud/compute/v1/internal/common_085.proto @@ -15,78 +15,31 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; - -// Represent a sole-tenant Node Type resource. Each node within a node group -// must have a node type. A node type specifies the total amount of cores and -// memory for that node. Currently, the only available node type is -// n1-node-96-624 node type that has 96 vCPUs and 624 GB of memory, available in -// multiple zones. For more information read Node types. -message NodeType { - // [Output Only] The CPU platform used by this node type. - optional string cpu_platform = 1 [json_name = "cpuPlatform"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // [Output Only] The deprecation status associated with this node type. - optional DeprecationStatus deprecated = 3 [json_name = "deprecated"]; - - // [Output Only] An optional textual description of the resource. - optional string description = 4 [json_name = "description"]; - - // [Output Only] The number of virtual CPUs that are available to the node - // type. - optional int32 guest_cpus = 5 [json_name = "guestCpus"]; +import "google/cloud/compute/v1/internal/common_016.proto"; +message OperationAggregatedList { // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 6 [json_name = "id"]; - - // [Output Only] The type of the resource. Always compute#nodeType for node - // types. - optional string kind = 7 [json_name = "kind"]; - - // [Output Only] Local SSD available to the node type, defined in GB. - optional int32 local_ssd_gb = 8 [json_name = "localSsdGb"]; - - // [Output Only] The amount of physical memory available to the node type, - // defined in MB. - optional int32 memory_mb = 9 [json_name = "memoryMb"]; - - // [Output Only] Name of the resource. - optional string name = 10 [json_name = "name"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 11 [json_name = "selfLink"]; - - // [Output Only] The name of the zone where the node type resides, such as - // us-central1-a. - optional string zone = 12 [json_name = "zone"]; -} - -message NodeTypeAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of NodeTypesScopedList resources. - map items = 2 [json_name = "items"]; + // [Output Only] A map of scoped operation lists. + map items = 2 [json_name = "items"]; - // [Output Only] Type of resource.Always compute#nodeTypeAggregatedList for - // aggregated lists of node types. + // [Output Only] Type of resource. Always `compute#operationAggregatedList` + // for aggregated lists of operations. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. + // list requests. If the number of results is larger than `maxResults`, use + // the `nextPageToken` as a value for the query parameter `pageToken` in the + // next list request. Subsequent list requests will have their own + // `nextPageToken` to continue paging through the results. optional string next_page_token = 4 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. @@ -180,116 +133,9 @@ message NodeTypeAggregatedList { optional Warning warning = 7 [json_name = "warning"]; } -// Contains a list of node types. -message NodeTypeList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of NodeType resources. - repeated NodeType items = 2 [json_name = "items"]; - - // [Output Only] Type of resource.Always compute#nodeTypeList for lists of - // node types. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -message NodeTypesScopedList { - // [Output Only] A list of node types contained in this scope. - repeated NodeType node_types = 1 [json_name = "nodeTypes"]; +message OperationsScopedList { + // [Output Only] A list of operations contained in this scope. + repeated Operation operations = 1 [json_name = "operations"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -372,7 +218,7 @@ message NodeTypesScopedList { optional string message = 3 [json_name = "message"]; } - // [Output Only] An informational warning that appears when the node types - // list is empty. + // [Output Only] Informational warning which replaces the list of operations + // when the list is empty. optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_086.proto b/protos/google/cloud/compute/v1/internal/common_086.proto index 5b36e2c66beb8..e7de989f407b1 100644 --- a/protos/google/cloud/compute/v1/internal/common_086.proto +++ b/protos/google/cloud/compute/v1/internal/common_086.proto @@ -15,102 +15,32 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_030.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; -// Represents a notification endpoint. A notification endpoint resource defines -// an endpoint to receive notifications when there are status changes detected -// by the associated health check service. For more information, see Health -// checks overview. -message NotificationEndpoint { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // Settings of the gRPC notification endpoint including the endpoint URL and - // the retry duration. - optional NotificationEndpointGrpcSettings grpc_settings = 3 - [json_name = "grpcSettings"]; - - // [Output Only] A unique identifier for this resource type. The server - // generates this identifier. - optional string id = 4 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#notificationEndpoint for - // notification endpoints. - optional string kind = 5 [json_name = "kind"]; - - // 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. - optional string name = 6 [json_name = "name"]; - - // [Output Only] URL of the region where the notification endpoint resides. - // This field applies only to the regional resource. You must specify this - // field as part of the HTTP request URL. It is not settable as a field in the - // request body. - optional string region = 7 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 8 [json_name = "selfLink"]; -} - -// Represents a gRPC setting that describes one gRPC notification endpoint and -// the retry duration attempting to send notification to this endpoint. -message NotificationEndpointGrpcSettings { - // Optional. If specified, this field is used to set the authority header by - // the sender of notifications. See - // https://tools.ietf.org/html/rfc7540#section-8.1.2.3 - optional string authority = 1 [json_name = "authority"]; - - // Endpoint to which gRPC notifications are sent. This must be a valid gRPCLB - // DNS name. - optional string endpoint = 2 [json_name = "endpoint"]; - - // Optional. If specified, this field is used to populate the "name" field in - // gRPC requests. - optional string payload_name = 3 [json_name = "payloadName"]; - - // Optional. This field is used to configure how often to send a full update - // of all non-healthy backends. If unspecified, full updates are not sent. If - // specified, must be in the range between 600 seconds to 3600 seconds. Nanos - // are disallowed. Can only be set for regional notification endpoints. - optional Duration resend_interval = 4 [json_name = "resendInterval"]; - - // How much time (in seconds) is spent attempting notification retries until a - // successful response is received. Default is 30s. Limit is 20m (1200s). Must - // be a positive number. - optional uint32 retry_duration_sec = 5 [json_name = "retryDurationSec"]; -} - -message NotificationEndpointList { - // [Output Only] Unique identifier for the resource; defined by the server. +// Contains a list of Operation resources. +message OperationList { + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. optional string id = 1 [json_name = "id"]; - // A list of NotificationEndpoint resources. - repeated NotificationEndpoint items = 2 [json_name = "items"]; + // [Output Only] A list of Operation resources. + repeated Operation items = 2 [json_name = "items"]; - // [Output Only] Type of the resource. Always compute#notificationEndpoint for - // notification endpoints. + // [Output Only] Type of resource. Always `compute#operations` for Operations + // resource. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. + // list requests. If the number of results is larger than `maxResults`, use + // the `nextPageToken` as a value for the query parameter `pageToken` in the + // next list request. Subsequent list requests will have their own + // `nextPageToken` to continue paging through the results. optional string next_page_token = 4 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. diff --git a/protos/google/cloud/compute/v1/internal/common_087.proto b/protos/google/cloud/compute/v1/internal/common_087.proto index 51d9b24ba2f43..b18c8ad659295 100644 --- a/protos/google/cloud/compute/v1/internal/common_087.proto +++ b/protos/google/cloud/compute/v1/internal/common_087.proto @@ -15,31 +15,98 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_017.proto"; +// Represents a Packet Mirroring resource. Packet Mirroring clones the traffic +// of specified instances in your Virtual Private Cloud (VPC) network and +// forwards it to a collector destination, such as an instance group of an +// internal TCP/UDP load balancer, for analysis or examination. For more +// information about setting up Packet Mirroring, see Using Packet Mirroring. +message PacketMirroring { + // The Forwarding Rule resource of type loadBalancingScheme=INTERNAL that will + // be used as collector for mirrored traffic. The specified forwarding rule + // must have isMirroringCollector set to true. + optional PacketMirroringForwardingRuleInfo collector_ilb = 1 + [json_name = "collectorIlb"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + // Indicates whether or not this packet mirroring takes effect. If set to + // FALSE, this packet mirroring policy will not be enforced on the network. + // The default is TRUE. + // FALSE: + // TRUE: + optional string enable = 4 [json_name = "enable"]; + + // Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored. + optional PacketMirroringFilter filter = 5 [json_name = "filter"]; -message OperationAggregatedList { // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. + optional string id = 6 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#packetMirroring for + // packet mirrorings. + optional string kind = 7 [json_name = "kind"]; + + // PacketMirroring mirroredResourceInfos. MirroredResourceInfo specifies a set + // of mirrored VM instances, subnetworks and/or tags for which traffic from/to + // all VM instances will be mirrored. + optional PacketMirroringMirroredResourceInfo mirrored_resources = 8 + [json_name = "mirroredResources"]; + + // 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. + optional string name = 9 [json_name = "name"]; + + // Specifies the mirrored VPC network. Only packets in this network will be + // mirrored. All mirrored VMs should have a NIC in the given network. All + // mirrored subnetworks should belong to the given network. + optional PacketMirroringNetworkInfo network = 10 [json_name = "network"]; + + // The priority of applying this configuration. Priority is used to break ties + // in cases where there is more than one matching rule. In the case of two + // rules that apply for a given Instance, the one with the lowest-numbered + // priority value wins. Default value is 1000. Valid range is 0 through 65535. + optional uint32 priority = 11 [json_name = "priority"]; + + // [Output Only] URI of the region where the packetMirroring resides. + optional string region = 12 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 13 [json_name = "selfLink"]; +} + +// Contains a list of packetMirrorings. +message PacketMirroringAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // [Output Only] A map of scoped operation lists. - map items = 2 [json_name = "items"]; + // A list of PacketMirroring resources. + map items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always `compute#operationAggregatedList` - // for aggregated lists of operations. + // Type of resource. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than `maxResults`, use - // the `nextPageToken` as a value for the query parameter `pageToken` in the - // next list request. Subsequent list requests will have their own - // `nextPageToken` to continue paging through the results. + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. optional string next_page_token = 4 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. @@ -133,9 +200,195 @@ message OperationAggregatedList { optional Warning warning = 7 [json_name = "warning"]; } -message OperationsScopedList { - // [Output Only] A list of operations contained in this scope. - repeated Operation operations = 1 [json_name = "operations"]; +message PacketMirroringFilter { + // Protocols that apply as filter on mirrored traffic. If no protocols are + // specified, all traffic that matches the specified CIDR ranges is mirrored. + // If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is + // mirrored. + repeated string ip_protocols = 1 [json_name = "IPProtocols"]; + + // One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source + // (ingress) or destination (egress) IP in the IP header. If no ranges are + // specified, all IPv4 traffic that matches the specified IPProtocols is + // mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 + // traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use + // "0.0.0.0/0,::/0". + repeated string cidr_ranges = 2 [json_name = "cidrRanges"]; + + // Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. The + // default is BOTH. + // BOTH: Default, both directions are mirrored. + // EGRESS: Only egress traffic is mirrored. + // INGRESS: Only ingress traffic is mirrored. + optional string direction = 3 [json_name = "direction"]; +} + +message PacketMirroringForwardingRuleInfo { + // [Output Only] Unique identifier for the forwarding rule; defined by the + // server. + optional string canonical_url = 1 [json_name = "canonicalUrl"]; + + // Resource URL to the forwarding rule representing the ILB configured as + // destination of the mirrored traffic. + optional string url = 2 [json_name = "url"]; +} + +// Contains a list of PacketMirroring resources. +message PacketMirroringList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of PacketMirroring resources. + repeated PacketMirroring items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#packetMirroring for + // packetMirrorings. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message PacketMirroringMirroredResourceInfo { + // A set of virtual machine instances that are being mirrored. They must live + // in zones contained in the same region as this packetMirroring. Note that + // this config will apply only to those network interfaces of the Instances + // that belong to the network specified in this packetMirroring. You may + // specify a maximum of 50 Instances. + repeated PacketMirroringMirroredResourceInfoInstanceInfo instances = 1 + [json_name = "instances"]; + + // A set of subnetworks for which traffic from/to all VM instances will be + // mirrored. They must live in the same region as this packetMirroring. You + // may specify a maximum of 5 subnetworks. + repeated PacketMirroringMirroredResourceInfoSubnetInfo subnetworks = 2 + [json_name = "subnetworks"]; + + // A set of mirrored tags. Traffic from/to all VM instances that have one or + // more of these tags will be mirrored. + repeated string tags = 3 [json_name = "tags"]; +} + +message PacketMirroringMirroredResourceInfoInstanceInfo { + // [Output Only] Unique identifier for the instance; defined by the server. + optional string canonical_url = 1 [json_name = "canonicalUrl"]; + + // Resource URL to the virtual machine instance which is being mirrored. + optional string url = 2 [json_name = "url"]; +} + +message PacketMirroringMirroredResourceInfoSubnetInfo { + // [Output Only] Unique identifier for the subnetwork; defined by the server. + optional string canonical_url = 1 [json_name = "canonicalUrl"]; + + // Resource URL to the subnetwork for which traffic from/to all VM instances + // will be mirrored. + optional string url = 2 [json_name = "url"]; +} + +message PacketMirroringNetworkInfo { + // [Output Only] Unique identifier for the network; defined by the server. + optional string canonical_url = 1 [json_name = "canonicalUrl"]; + + // URL of the network resource. + optional string url = 2 [json_name = "url"]; +} + +message PacketMirroringsScopedList { + // A list of packetMirrorings contained in this scope. + repeated PacketMirroring packet_mirrorings = 1 + [json_name = "packetMirrorings"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -218,7 +471,7 @@ message OperationsScopedList { optional string message = 3 [json_name = "message"]; } - // [Output Only] Informational warning which replaces the list of operations - // when the list is empty. + // Informational warning which replaces the list of packetMirrorings when the + // list is empty. optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_088.proto b/protos/google/cloud/compute/v1/internal/common_088.proto index be133e890b77e..b494cd82617d9 100644 --- a/protos/google/cloud/compute/v1/internal/common_088.proto +++ b/protos/google/cloud/compute/v1/internal/common_088.proto @@ -15,36 +15,44 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_017.proto"; +import "google/cloud/compute/v1/internal/common_109.proto"; -// Contains a list of Operation resources. -message OperationList { - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 1 [json_name = "id"]; +message PreconfiguredWafSet { + // List of entities that are currently supported for WAF rules. + repeated WafExpressionSet expression_sets = 1 [json_name = "expressionSets"]; +} + +message SecurityPoliciesAggregatedList { + optional string etag = 1 [json_name = "etag"]; + + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 2 [json_name = "id"]; - // [Output Only] A list of Operation resources. - repeated Operation items = 2 [json_name = "items"]; + // A list of SecurityPoliciesScopedList resources. + map items = 3 [json_name = "items"]; - // [Output Only] Type of resource. Always `compute#operations` for Operations - // resource. - optional string kind = 3 [json_name = "kind"]; + // [Output Only] Type of resource. Always compute#securityPolicyAggregatedList + // for lists of Security Policies. + optional string kind = 4 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than `maxResults`, use - // the `nextPageToken` as a value for the query parameter `pageToken` in the - // next list request. Subsequent list requests will have their own - // `nextPageToken` to continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 5 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + optional string self_link = 6 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 7 [json_name = "unreachables"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -128,5 +136,135 @@ message OperationList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 8 [json_name = "warning"]; +} + +message SecurityPoliciesListPreconfiguredExpressionSetsResponse { + optional SecurityPoliciesWafConfig preconfigured_expression_sets = 1 + [json_name = "preconfiguredExpressionSets"]; +} + +message SecurityPoliciesScopedList { + // A list of SecurityPolicies contained in this scope. + repeated SecurityPolicy security_policies = 1 + [json_name = "securityPolicies"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of security policies when the + // list is empty. + optional Warning warning = 2 [json_name = "warning"]; +} + +message SecurityPoliciesWafConfig { + optional PreconfiguredWafSet waf_rules = 1 [json_name = "wafRules"]; +} + +message WafExpressionSet { + // A list of alternate IDs. The format should be: - E.g. XSS-stable Generic + // suffix like "stable" is particularly useful if a policy likes to avail + // newer set of expressions without having to change the policy. A given alias + // name can't be used for more than one entity set. + repeated string aliases = 1 [json_name = "aliases"]; + + // List of available expressions. + repeated WafExpressionSetExpression expressions = 2 + [json_name = "expressions"]; + + // Google specified expression set ID. The format should be: - E.g. + // XSS-20170329 required + optional string id = 3 [json_name = "id"]; +} + +message WafExpressionSetExpression { + // Expression ID should uniquely identify the origin of the expression. E.g. + // owasp-crs-v020901-id973337 identifies Owasp core rule set version 2.9.1 + // rule id 973337. The ID could be used to determine the individual attack + // definition that has been detected. It could also be used to exclude it from + // the policy in case of false positive. required + optional string id = 1 [json_name = "id"]; + + // The sensitivity value associated with the WAF rule ID. This corresponds to + // the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for + // opt-in only rules. + optional int32 sensitivity = 2 [json_name = "sensitivity"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_089.proto b/protos/google/cloud/compute/v1/internal/common_089.proto index 03d1f9f73f692..54f84c7ebe4eb 100644 --- a/protos/google/cloud/compute/v1/internal/common_089.proto +++ b/protos/google/cloud/compute/v1/internal/common_089.proto @@ -15,234 +15,119 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Packet Mirroring resource. Packet Mirroring clones the traffic -// of specified instances in your Virtual Private Cloud (VPC) network and -// forwards it to a collector destination, such as an instance group of an -// internal TCP/UDP load balancer, for analysis or examination. For more -// information about setting up Packet Mirroring, see Using Packet Mirroring. -message PacketMirroring { - // The Forwarding Rule resource of type loadBalancingScheme=INTERNAL that will - // be used as collector for mirrored traffic. The specified forwarding rule - // must have isMirroringCollector set to true. - optional PacketMirroringForwardingRuleInfo collector_ilb = 1 - [json_name = "collectorIlb"]; +// A public advertised prefix represents an aggregated IP prefix or netblock +// which customers bring to cloud. The IP prefix is a single unit of route +// advertisement and is announced globally to the internet. +message PublicAdvertisedPrefix { + // [Output Only] The version of BYOIP API. + // V1: This public advertised prefix can be used to create both regional and + // global public delegated prefixes. It usually takes 4 weeks to create or + // delete a public delegated prefix. The BGP status cannot be changed. + // V2: This public advertised prefix can only be used to create regional + // public delegated prefixes. Public delegated prefix creation and deletion + // takes minutes and the BGP status can be modified. + optional string byoip_api_version = 13 [json_name = "byoipApiVersion"]; // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 3 [json_name = "description"]; + optional string description = 2 [json_name = "description"]; - // Indicates whether or not this packet mirroring takes effect. If set to - // FALSE, this packet mirroring policy will not be enforced on the network. - // The default is TRUE. - // FALSE: - // TRUE: - optional string enable = 4 [json_name = "enable"]; + // The address to be used for reverse DNS verification. + optional string dns_verification_ip = 3 [json_name = "dnsVerificationIp"]; - // Filter for mirrored traffic. If unspecified, all IPv4 traffic is mirrored. - optional PacketMirroringFilter filter = 5 [json_name = "filter"]; + // 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 new PublicAdvertisedPrefix. An up-to-date fingerprint must be + // provided in order to update the PublicAdvertisedPrefix, otherwise the + // request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve a PublicAdvertisedPrefix. + optional string fingerprint = 4 [json_name = "fingerprint"]; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 6 [json_name = "id"]; + // [Output Only] The unique identifier for the resource type. The server + // generates this identifier. + optional string id = 5 [json_name = "id"]; - // [Output Only] Type of the resource. Always compute#packetMirroring for - // packet mirrorings. - optional string kind = 7 [json_name = "kind"]; + // The address range, in CIDR format, represented by this public advertised + // prefix. + optional string ip_cidr_range = 6 [json_name = "ipCidrRange"]; - // PacketMirroring mirroredResourceInfos. MirroredResourceInfo specifies a set - // of mirrored VM instances, subnetworks and/or tags for which traffic from/to - // all VM instances will be mirrored. - optional PacketMirroringMirroredResourceInfo mirrored_resources = 8 - [json_name = "mirroredResources"]; + // [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix + // for public advertised prefixes. + optional string kind = 7 [json_name = "kind"]; - // Name of the resource; provided by the client when the resource is created. + // 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. - optional string name = 9 [json_name = "name"]; - - // Specifies the mirrored VPC network. Only packets in this network will be - // mirrored. All mirrored VMs should have a NIC in the given network. All - // mirrored subnetworks should belong to the given network. - optional PacketMirroringNetworkInfo network = 10 [json_name = "network"]; - - // The priority of applying this configuration. Priority is used to break ties - // in cases where there is more than one matching rule. In the case of two - // rules that apply for a given Instance, the one with the lowest-numbered - // priority value wins. Default value is 1000. Valid range is 0 through 65535. - optional uint32 priority = 11 [json_name = "priority"]; - - // [Output Only] URI of the region where the packetMirroring resides. - optional string region = 12 [json_name = "region"]; + optional string name = 8 [json_name = "name"]; + + // Specifies how child public delegated prefix will be scoped. It could be one + // of following values: - `REGIONAL`: The public delegated prefix is regional + // only. The provisioning will take a few minutes. - `GLOBAL`: The public + // delegated prefix is global only. The provisioning will take ~4 weeks. - + // `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is BYOIP + // V1 legacy prefix. This is output only value and no longer supported in + // BYOIP V2. + // GLOBAL: The public delegated prefix is global only. The provisioning will + // take ~4 weeks. + // GLOBAL_AND_REGIONAL: The public delegated prefixes is BYOIP V1 legacy + // prefix. This is output only value and no longer supported in BYOIP V2. + // REGIONAL: The public delegated prefix is regional only. The provisioning + // will take a few minutes. + optional string pdp_scope = 14 [json_name = "pdpScope"]; + + // [Output Only] The list of public delegated prefixes that exist for this + // public advertised prefix. + repeated PublicAdvertisedPrefixPublicDelegatedPrefix + public_delegated_prefixs = 9 [json_name = "publicDelegatedPrefixs"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 13 [json_name = "selfLink"]; -} - -// Contains a list of packetMirrorings. -message PacketMirroringAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of PacketMirroring resources. - map items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + optional string self_link = 10 [json_name = "selfLink"]; + + // [Output Only] The shared secret to be used for reverse DNS verification. + optional string shared_secret = 11 [json_name = "sharedSecret"]; + + // The status of the public advertised prefix. Possible values include: - + // `INITIAL`: RPKI validation is complete. - `PTR_CONFIGURED`: User has + // configured the PTR. - `VALIDATED`: Reverse DNS lookup is successful. - + // `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. - + // `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being configured. - + // `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. - + // `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. + // ANNOUNCED_TO_INTERNET: The prefix is announced to Internet. + // INITIAL: RPKI validation is complete. + // PREFIX_CONFIGURATION_COMPLETE: The prefix is fully configured. + // PREFIX_CONFIGURATION_IN_PROGRESS: The prefix is being configured. + // PREFIX_REMOVAL_IN_PROGRESS: The prefix is being removed. + // PTR_CONFIGURED: User has configured the PTR. + // READY_TO_ANNOUNCE: The prefix is currently withdrawn but ready to be + // announced. + // REVERSE_DNS_LOOKUP_FAILED: Reverse DNS lookup failed. + // VALIDATED: Reverse DNS lookup is successful. + optional string status = 12 [json_name = "status"]; } -message PacketMirroringFilter { - // Protocols that apply as filter on mirrored traffic. If no protocols are - // specified, all traffic that matches the specified CIDR ranges is mirrored. - // If neither cidrRanges nor IPProtocols is specified, all IPv4 traffic is - // mirrored. - repeated string ip_protocols = 1 [json_name = "IPProtocols"]; - - // One or more IPv4 or IPv6 CIDR ranges that apply as filters on the source - // (ingress) or destination (egress) IP in the IP header. If no ranges are - // specified, all IPv4 traffic that matches the specified IPProtocols is - // mirrored. If neither cidrRanges nor IPProtocols is specified, all IPv4 - // traffic is mirrored. To mirror all IPv4 and IPv6 traffic, use - // "0.0.0.0/0,::/0". - repeated string cidr_ranges = 2 [json_name = "cidrRanges"]; - - // Direction of traffic to mirror, either INGRESS, EGRESS, or BOTH. The - // default is BOTH. - // BOTH: Default, both directions are mirrored. - // EGRESS: Only egress traffic is mirrored. - // INGRESS: Only ingress traffic is mirrored. - optional string direction = 3 [json_name = "direction"]; -} - -message PacketMirroringForwardingRuleInfo { - // [Output Only] Unique identifier for the forwarding rule; defined by the - // server. - optional string canonical_url = 1 [json_name = "canonicalUrl"]; - - // Resource URL to the forwarding rule representing the ILB configured as - // destination of the mirrored traffic. - optional string url = 2 [json_name = "url"]; -} - -// Contains a list of PacketMirroring resources. -message PacketMirroringList { +message PublicAdvertisedPrefixList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of PacketMirroring resources. - repeated PacketMirroring items = 2 [json_name = "items"]; + // A list of PublicAdvertisedPrefix resources. + repeated PublicAdvertisedPrefix items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#packetMirroring for - // packetMirrorings. + // [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix + // for public advertised prefixes. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -340,138 +225,24 @@ message PacketMirroringList { optional Warning warning = 6 [json_name = "warning"]; } -message PacketMirroringMirroredResourceInfo { - // A set of virtual machine instances that are being mirrored. They must live - // in zones contained in the same region as this packetMirroring. Note that - // this config will apply only to those network interfaces of the Instances - // that belong to the network specified in this packetMirroring. You may - // specify a maximum of 50 Instances. - repeated PacketMirroringMirroredResourceInfoInstanceInfo instances = 1 - [json_name = "instances"]; - - // A set of subnetworks for which traffic from/to all VM instances will be - // mirrored. They must live in the same region as this packetMirroring. You - // may specify a maximum of 5 subnetworks. - repeated PacketMirroringMirroredResourceInfoSubnetInfo subnetworks = 2 - [json_name = "subnetworks"]; - - // A set of mirrored tags. Traffic from/to all VM instances that have one or - // more of these tags will be mirrored. - repeated string tags = 3 [json_name = "tags"]; -} - -message PacketMirroringMirroredResourceInfoInstanceInfo { - // [Output Only] Unique identifier for the instance; defined by the server. - optional string canonical_url = 1 [json_name = "canonicalUrl"]; - - // Resource URL to the virtual machine instance which is being mirrored. - optional string url = 2 [json_name = "url"]; -} - -message PacketMirroringMirroredResourceInfoSubnetInfo { - // [Output Only] Unique identifier for the subnetwork; defined by the server. - optional string canonical_url = 1 [json_name = "canonicalUrl"]; - - // Resource URL to the subnetwork for which traffic from/to all VM instances - // will be mirrored. - optional string url = 2 [json_name = "url"]; -} - -message PacketMirroringNetworkInfo { - // [Output Only] Unique identifier for the network; defined by the server. - optional string canonical_url = 1 [json_name = "canonicalUrl"]; - - // URL of the network resource. - optional string url = 2 [json_name = "url"]; -} - -message PacketMirroringsScopedList { - // A list of packetMirrorings contained in this scope. - repeated PacketMirroring packet_mirrorings = 1 - [json_name = "packetMirrorings"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; +// Represents a CIDR range which can be used to assign addresses. +message PublicAdvertisedPrefixPublicDelegatedPrefix { + // The IP address range of the public delegated prefix + optional string ip_range = 1 [json_name = "ipRange"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // The name of the public delegated prefix + optional string name = 2 [json_name = "name"]; - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; + // The project number of the public delegated prefix + optional string project = 3 [json_name = "project"]; - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } + // The region of the public delegated prefix if it is regional. If absent, the + // prefix is global. + optional string region = 4 [json_name = "region"]; - // Informational warning which replaces the list of packetMirrorings when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // The status of the public delegated prefix. Possible values are: + // INITIALIZING: The public delegated prefix is being initialized and + // addresses cannot be created yet. ANNOUNCED: The public delegated prefix is + // active. + optional string status = 5 [json_name = "status"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_090.proto b/protos/google/cloud/compute/v1/internal/common_090.proto index edc4c961466f0..85daeccfc59ba 100644 --- a/protos/google/cloud/compute/v1/internal/common_090.proto +++ b/protos/google/cloud/compute/v1/internal/common_090.proto @@ -15,44 +15,136 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_111.proto"; - -message PreconfiguredWafSet { - // List of entities that are currently supported for WAF rules. - repeated WafExpressionSet expression_sets = 1 [json_name = "expressionSets"]; +// A PublicDelegatedPrefix resource represents an IP block within a +// PublicAdvertisedPrefix that is configured within a single cloud scope (global +// or region). IPs in the block can be allocated to resources within that scope. +// Public delegated prefixes may be further broken up into smaller IP blocks in +// the same scope as the parent block. +message PublicDelegatedPrefix { + // The allocatable prefix length supported by this public delegated prefix. + // This field is optional and cannot be set for prefixes in DELEGATION mode. + // It cannot be set for IPv4 prefixes either, and it always defaults to 32. + optional int32 allocatable_prefix_length = 15 + [json_name = "allocatablePrefixLength"]; + + // [Output Only] The version of BYOIP API. + // V1: This public delegated prefix usually takes 4 weeks to delete, and the + // BGP status cannot be changed. Announce and Withdraw APIs can not be used on + // this prefix. + // V2: This public delegated prefix takes minutes to delete. Announce and + // Withdraw APIs can be used on this prefix to change the BGP status. + optional string byoip_api_version = 14 [json_name = "byoipApiVersion"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "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 new PublicDelegatedPrefix. An up-to-date fingerprint must be + // provided in order to update the PublicDelegatedPrefix, otherwise the + // request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve a PublicDelegatedPrefix. + optional string fingerprint = 3 [json_name = "fingerprint"]; + + // [Output Only] The unique identifier for the resource type. The server + // generates this identifier. + optional string id = 4 [json_name = "id"]; + + // The IP address range, in CIDR format, represented by this public delegated + // prefix. + optional string ip_cidr_range = 5 [json_name = "ipCidrRange"]; + + // If true, the prefix will be live migrated. + optional bool is_live_migration = 6 [json_name = "isLiveMigration"]; + + // [Output Only] Type of the resource. Always compute#publicDelegatedPrefix + // for public delegated prefixes. + optional string kind = 7 [json_name = "kind"]; + + // The public delegated prefix mode for IPv6 only. + // DELEGATION: The public delegated prefix is used for further sub-delegation + // only. Such prefixes cannot set allocatablePrefixLength. + // EXTERNAL_IPV6_FORWARDING_RULE_CREATION: The public delegated prefix is used + // for creating forwarding rules only. Such prefixes cannot set + // publicDelegatedSubPrefixes. + optional string mode = 16 [json_name = "mode"]; + + // 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. + optional string name = 8 [json_name = "name"]; + + // The URL of parent prefix. Either PublicAdvertisedPrefix or + // PublicDelegatedPrefix. + optional string parent_prefix = 9 [json_name = "parentPrefix"]; + + // The list of sub public delegated prefixes that exist for this public + // delegated prefix. + repeated PublicDelegatedPrefixPublicDelegatedSubPrefix + public_delegated_sub_prefixs = 10 + [json_name = "publicDelegatedSubPrefixs"]; + + // [Output Only] URL of the region where the public delegated prefix resides. + // This field applies only to the region resource. You must specify this field + // as part of the HTTP request URL. It is not settable as a field in the + // request body. + optional string region = 11 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 12 [json_name = "selfLink"]; + + // [Output Only] The status of the public delegated prefix, which can be one + // of following values: - `INITIALIZING` The public delegated prefix is being + // initialized and addresses cannot be created yet. - `READY_TO_ANNOUNCE` The + // public delegated prefix is a live migration prefix and is active. - + // `ANNOUNCED` The public delegated prefix is active. - `DELETING` The public + // delegated prefix is being deprovsioned. + // ANNOUNCED: The public delegated prefix is active. + // ANNOUNCED_TO_GOOGLE: The prefix is announced within Google network. + // ANNOUNCED_TO_INTERNET: The prefix is announced to Internet and within + // Google. + // DELETING: The public delegated prefix is being deprovsioned. + // INITIALIZING: The public delegated prefix is being initialized and + // addresses cannot be created yet. + // READY_TO_ANNOUNCE: The public delegated prefix is currently withdrawn but + // ready to be announced. + optional string status = 13 [json_name = "status"]; } -message SecurityPoliciesAggregatedList { - optional string etag = 1 [json_name = "etag"]; - +message PublicDelegatedPrefixList { // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 2 [json_name = "id"]; + optional string id = 1 [json_name = "id"]; - // A list of SecurityPoliciesScopedList resources. - map items = 3 [json_name = "items"]; + // A list of PublicDelegatedPrefix resources. + repeated PublicDelegatedPrefix items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#securityPolicyAggregatedList - // for lists of Security Policies. - optional string kind = 4 [json_name = "kind"]; + // [Output Only] Type of the resource. Always + // compute#publicDelegatedPrefixList for public delegated prefixes. + optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for // list requests. If the number of results is larger than maxResults, use the // nextPageToken as a value for the query parameter pageToken in the next list // request. Subsequent list requests will have their own nextPageToken to // continue paging through the results. - optional string next_page_token = 5 [json_name = "nextPageToken"]; + optional string next_page_token = 4 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. - optional string self_link = 6 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 7 [json_name = "unreachables"]; + optional string self_link = 5 [json_name = "selfLink"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -136,135 +228,47 @@ message SecurityPoliciesAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; -} - -message SecurityPoliciesListPreconfiguredExpressionSetsResponse { - optional SecurityPoliciesWafConfig preconfigured_expression_sets = 1 - [json_name = "preconfiguredExpressionSets"]; -} - -message SecurityPoliciesScopedList { - // A list of SecurityPolicies contained in this scope. - repeated SecurityPolicy security_policies = 1 - [json_name = "securityPolicies"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of security policies when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} - -message SecurityPoliciesWafConfig { - optional PreconfiguredWafSet waf_rules = 1 [json_name = "wafRules"]; + optional Warning warning = 6 [json_name = "warning"]; } -message WafExpressionSet { - // A list of alternate IDs. The format should be: - E.g. XSS-stable Generic - // suffix like "stable" is particularly useful if a policy likes to avail - // newer set of expressions without having to change the policy. A given alias - // name can't be used for more than one entity set. - repeated string aliases = 1 [json_name = "aliases"]; - - // List of available expressions. - repeated WafExpressionSetExpression expressions = 2 - [json_name = "expressions"]; - - // Google specified expression set ID. The format should be: - E.g. - // XSS-20170329 required - optional string id = 3 [json_name = "id"]; -} - -message WafExpressionSetExpression { - // Expression ID should uniquely identify the origin of the expression. E.g. - // owasp-crs-v020901-id973337 identifies Owasp core rule set version 2.9.1 - // rule id 973337. The ID could be used to determine the individual attack - // definition that has been detected. It could also be used to exclude it from - // the policy in case of false positive. required - optional string id = 1 [json_name = "id"]; - - // The sensitivity value associated with the WAF rule ID. This corresponds to - // the ModSecurity paranoia level, ranging from 1 to 4. 0 is reserved for - // opt-in only rules. - optional int32 sensitivity = 2 [json_name = "sensitivity"]; +// Represents a sub PublicDelegatedPrefix. +message PublicDelegatedPrefixPublicDelegatedSubPrefix { + // The allocatable prefix length supported by this PublicDelegatedSubPrefix. + optional int32 allocatable_prefix_length = 8 + [json_name = "allocatablePrefixLength"]; + + // Name of the project scoping this PublicDelegatedSubPrefix. + optional string delegatee_project = 1 [json_name = "delegateeProject"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; + + // The IP address range, in CIDR format, represented by this sub public + // delegated prefix. + optional string ip_cidr_range = 3 [json_name = "ipCidrRange"]; + + // Whether the sub prefix is delegated to create Address resources in the + // delegatee project. + optional bool is_address = 4 [json_name = "isAddress"]; + + // The PublicDelegatedSubPrefix mode for IPv6 only. + // DELEGATION: The public delegated prefix is used for further sub-delegation + // only. Such prefixes cannot set allocatablePrefixLength. + // EXTERNAL_IPV6_FORWARDING_RULE_CREATION: The public delegated prefix is used + // for creating forwarding rules only. Such prefixes cannot set + // publicDelegatedSubPrefixes. + optional string mode = 9 [json_name = "mode"]; + + // The name of the sub public delegated prefix. + optional string name = 5 [json_name = "name"]; + + // [Output Only] The region of the sub public delegated prefix if it is + // regional. If absent, the sub prefix is global. + optional string region = 6 [json_name = "region"]; + + // [Output Only] The status of the sub public delegated prefix. + // ACTIVE: + // INACTIVE: + optional string status = 7 [json_name = "status"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_091.proto b/protos/google/cloud/compute/v1/internal/common_091.proto index 23421c50fc779..42bbd67d39301 100644 --- a/protos/google/cloud/compute/v1/internal/common_091.proto +++ b/protos/google/cloud/compute/v1/internal/common_091.proto @@ -15,119 +15,25 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// A public advertised prefix represents an aggregated IP prefix or netblock -// which customers bring to cloud. The IP prefix is a single unit of route -// advertisement and is announced globally to the internet. -message PublicAdvertisedPrefix { - // [Output Only] The version of BYOIP API. - // V1: This public advertised prefix can be used to create both regional and - // global public delegated prefixes. It usually takes 4 weeks to create or - // delete a public delegated prefix. The BGP status cannot be changed. - // V2: This public advertised prefix can only be used to create regional - // public delegated prefixes. Public delegated prefix creation and deletion - // takes minutes and the BGP status can be modified. - optional string byoip_api_version = 13 [json_name = "byoipApiVersion"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // The address to be used for reverse DNS verification. - optional string dns_verification_ip = 3 [json_name = "dnsVerificationIp"]; - - // 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 new PublicAdvertisedPrefix. An up-to-date fingerprint must be - // provided in order to update the PublicAdvertisedPrefix, otherwise the - // request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve a PublicAdvertisedPrefix. - optional string fingerprint = 4 [json_name = "fingerprint"]; - - // [Output Only] The unique identifier for the resource type. The server - // generates this identifier. - optional string id = 5 [json_name = "id"]; - - // The address range, in CIDR format, represented by this public advertised - // prefix. - optional string ip_cidr_range = 6 [json_name = "ipCidrRange"]; - - // [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix - // for public advertised prefixes. - optional string kind = 7 [json_name = "kind"]; - - // 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. - optional string name = 8 [json_name = "name"]; - - // Specifies how child public delegated prefix will be scoped. It could be one - // of following values: - `REGIONAL`: The public delegated prefix is regional - // only. The provisioning will take a few minutes. - `GLOBAL`: The public - // delegated prefix is global only. The provisioning will take ~4 weeks. - - // `GLOBAL_AND_REGIONAL` [output only]: The public delegated prefixes is BYOIP - // V1 legacy prefix. This is output only value and no longer supported in - // BYOIP V2. - // GLOBAL: The public delegated prefix is global only. The provisioning will - // take ~4 weeks. - // GLOBAL_AND_REGIONAL: The public delegated prefixes is BYOIP V1 legacy - // prefix. This is output only value and no longer supported in BYOIP V2. - // REGIONAL: The public delegated prefix is regional only. The provisioning - // will take a few minutes. - optional string pdp_scope = 14 [json_name = "pdpScope"]; - - // [Output Only] The list of public delegated prefixes that exist for this - // public advertised prefix. - repeated PublicAdvertisedPrefixPublicDelegatedPrefix - public_delegated_prefixs = 9 [json_name = "publicDelegatedPrefixs"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 10 [json_name = "selfLink"]; - - // [Output Only] The shared secret to be used for reverse DNS verification. - optional string shared_secret = 11 [json_name = "sharedSecret"]; - - // The status of the public advertised prefix. Possible values include: - - // `INITIAL`: RPKI validation is complete. - `PTR_CONFIGURED`: User has - // configured the PTR. - `VALIDATED`: Reverse DNS lookup is successful. - - // `REVERSE_DNS_LOOKUP_FAILED`: Reverse DNS lookup failed. - - // `PREFIX_CONFIGURATION_IN_PROGRESS`: The prefix is being configured. - - // `PREFIX_CONFIGURATION_COMPLETE`: The prefix is fully configured. - - // `PREFIX_REMOVAL_IN_PROGRESS`: The prefix is being removed. - // ANNOUNCED_TO_INTERNET: The prefix is announced to Internet. - // INITIAL: RPKI validation is complete. - // PREFIX_CONFIGURATION_COMPLETE: The prefix is fully configured. - // PREFIX_CONFIGURATION_IN_PROGRESS: The prefix is being configured. - // PREFIX_REMOVAL_IN_PROGRESS: The prefix is being removed. - // PTR_CONFIGURED: User has configured the PTR. - // READY_TO_ANNOUNCE: The prefix is currently withdrawn but ready to be - // announced. - // REVERSE_DNS_LOOKUP_FAILED: Reverse DNS lookup failed. - // VALIDATED: Reverse DNS lookup is successful. - optional string status = 12 [json_name = "status"]; -} +import "google/cloud/compute/v1/internal/common_090.proto"; -message PublicAdvertisedPrefixList { +message PublicDelegatedPrefixAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of PublicAdvertisedPrefix resources. - repeated PublicAdvertisedPrefix items = 2 [json_name = "items"]; + // A list of PublicDelegatedPrefixesScopedList resources. + map items = 2 + [json_name = "items"]; - // [Output Only] Type of the resource. Always compute#publicAdvertisedPrefix - // for public advertised prefixes. + // [Output Only] Type of the resource. Always + // compute#publicDelegatedPrefixAggregatedList for aggregated lists of public + // delegated prefixes. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -140,6 +46,9 @@ message PublicAdvertisedPrefixList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -222,27 +131,96 @@ message PublicAdvertisedPrefixList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; } -// Represents a CIDR range which can be used to assign addresses. -message PublicAdvertisedPrefixPublicDelegatedPrefix { - // The IP address range of the public delegated prefix - optional string ip_range = 1 [json_name = "ipRange"]; +message PublicDelegatedPrefixesScopedList { + // [Output Only] A list of PublicDelegatedPrefixes contained in this scope. + repeated PublicDelegatedPrefix public_delegated_prefixes = 1 + [json_name = "publicDelegatedPrefixes"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; - // The name of the public delegated prefix - optional string name = 2 [json_name = "name"]; + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } - // The project number of the public delegated prefix - optional string project = 3 [json_name = "project"]; + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; - // The region of the public delegated prefix if it is regional. If absent, the - // prefix is global. - optional string region = 4 [json_name = "region"]; + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // The status of the public delegated prefix. Possible values are: - // INITIALIZING: The public delegated prefix is being initialized and - // addresses cannot be created yet. ANNOUNCED: The public delegated prefix is - // active. - optional string status = 5 [json_name = "status"]; + // [Output Only] Informational warning which replaces the list of public + // delegated prefixes when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_092.proto b/protos/google/cloud/compute/v1/internal/common_092.proto index dd8c12f7e0f6a..7dba62d5e9b42 100644 --- a/protos/google/cloud/compute/v1/internal/common_092.proto +++ b/protos/google/cloud/compute/v1/internal/common_092.proto @@ -15,260 +15,188 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// A PublicDelegatedPrefix resource represents an IP block within a -// PublicAdvertisedPrefix that is configured within a single cloud scope (global -// or region). IPs in the block can be allocated to resources within that scope. -// Public delegated prefixes may be further broken up into smaller IP blocks in -// the same scope as the parent block. -message PublicDelegatedPrefix { - // The allocatable prefix length supported by this public delegated prefix. - // This field is optional and cannot be set for prefixes in DELEGATION mode. - // It cannot be set for IPv4 prefixes either, and it always defaults to 32. - optional int32 allocatable_prefix_length = 15 - [json_name = "allocatablePrefixLength"]; - - // [Output Only] The version of BYOIP API. - // V1: This public delegated prefix usually takes 4 weeks to delete, and the - // BGP status cannot be changed. Announce and Withdraw APIs can not be used on - // this prefix. - // V2: This public delegated prefix takes minutes to delete. Announce and - // Withdraw APIs can be used on this prefix to change the BGP status. - optional string byoip_api_version = 14 [json_name = "byoipApiVersion"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "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 new PublicDelegatedPrefix. An up-to-date fingerprint must be - // provided in order to update the PublicDelegatedPrefix, otherwise the - // request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve a PublicDelegatedPrefix. - optional string fingerprint = 3 [json_name = "fingerprint"]; - - // [Output Only] The unique identifier for the resource type. The server - // generates this identifier. - optional string id = 4 [json_name = "id"]; - - // The IP address range, in CIDR format, represented by this public delegated - // prefix. - optional string ip_cidr_range = 5 [json_name = "ipCidrRange"]; - - // If true, the prefix will be live migrated. - optional bool is_live_migration = 6 [json_name = "isLiveMigration"]; - - // [Output Only] Type of the resource. Always compute#publicDelegatedPrefix - // for public delegated prefixes. - optional string kind = 7 [json_name = "kind"]; - - // The public delegated prefix mode for IPv6 only. - // DELEGATION: The public delegated prefix is used for further sub-delegation - // only. Such prefixes cannot set allocatablePrefixLength. - // EXTERNAL_IPV6_FORWARDING_RULE_CREATION: The public delegated prefix is used - // for creating forwarding rules only. Such prefixes cannot set - // publicDelegatedSubPrefixes. - optional string mode = 16 [json_name = "mode"]; - - // 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. - optional string name = 8 [json_name = "name"]; - - // The URL of parent prefix. Either PublicAdvertisedPrefix or - // PublicDelegatedPrefix. - optional string parent_prefix = 9 [json_name = "parentPrefix"]; - - // The list of sub public delegated prefixes that exist for this public - // delegated prefix. - repeated PublicDelegatedPrefixPublicDelegatedSubPrefix - public_delegated_sub_prefixs = 10 - [json_name = "publicDelegatedSubPrefixs"]; - - // [Output Only] URL of the region where the public delegated prefix resides. - // This field applies only to the region resource. You must specify this field - // as part of the HTTP request URL. It is not settable as a field in the - // request body. - optional string region = 11 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 12 [json_name = "selfLink"]; - - // [Output Only] The status of the public delegated prefix, which can be one - // of following values: - `INITIALIZING` The public delegated prefix is being - // initialized and addresses cannot be created yet. - `READY_TO_ANNOUNCE` The - // public delegated prefix is a live migration prefix and is active. - - // `ANNOUNCED` The public delegated prefix is active. - `DELETING` The public - // delegated prefix is being deprovsioned. - // ANNOUNCED: The public delegated prefix is active. - // ANNOUNCED_TO_GOOGLE: The prefix is announced within Google network. - // ANNOUNCED_TO_INTERNET: The prefix is announced to Internet and within - // Google. - // DELETING: The public delegated prefix is being deprovsioned. - // INITIALIZING: The public delegated prefix is being initialized and - // addresses cannot be created yet. - // READY_TO_ANNOUNCE: The public delegated prefix is currently withdrawn but - // ready to be announced. - optional string status = 13 [json_name = "status"]; -} - -message PublicDelegatedPrefixList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of PublicDelegatedPrefix resources. - repeated PublicDelegatedPrefix items = 2 [json_name = "items"]; - - // [Output Only] Type of the resource. Always - // compute#publicDelegatedPrefixList for public delegated prefixes. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// Represents a sub PublicDelegatedPrefix. -message PublicDelegatedPrefixPublicDelegatedSubPrefix { - // The allocatable prefix length supported by this PublicDelegatedSubPrefix. - optional int32 allocatable_prefix_length = 8 - [json_name = "allocatablePrefixLength"]; - - // Name of the project scoping this PublicDelegatedSubPrefix. - optional string delegatee_project = 1 [json_name = "delegateeProject"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // The IP address range, in CIDR format, represented by this sub public - // delegated prefix. - optional string ip_cidr_range = 3 [json_name = "ipCidrRange"]; - - // Whether the sub prefix is delegated to create Address resources in the - // delegatee project. - optional bool is_address = 4 [json_name = "isAddress"]; - - // The PublicDelegatedSubPrefix mode for IPv6 only. - // DELEGATION: The public delegated prefix is used for further sub-delegation - // only. Such prefixes cannot set allocatablePrefixLength. - // EXTERNAL_IPV6_FORWARDING_RULE_CREATION: The public delegated prefix is used - // for creating forwarding rules only. Such prefixes cannot set - // publicDelegatedSubPrefixes. - optional string mode = 9 [json_name = "mode"]; - - // The name of the sub public delegated prefix. - optional string name = 5 [json_name = "name"]; - - // [Output Only] The region of the sub public delegated prefix if it is - // regional. If absent, the sub prefix is global. - optional string region = 6 [json_name = "region"]; - - // [Output Only] The status of the sub public delegated prefix. - // ACTIVE: - // INACTIVE: - optional string status = 7 [json_name = "status"]; +// A quotas entry. +message Quota { + // [Output Only] Quota limit for this metric. + optional double limit = 1 [json_name = "limit"]; + + // [Output Only] Name of the quota metric. + // A2_CPUS: + // AFFINITY_GROUPS: + // AUTOSCALERS: + // BACKEND_BUCKETS: + // BACKEND_SERVICES: + // C2D_CPUS: + // C2_CPUS: + // C3_CPUS: + // COMMITMENTS: + // COMMITTED_A2_CPUS: + // COMMITTED_C2D_CPUS: + // COMMITTED_C2_CPUS: + // COMMITTED_C3_CPUS: + // COMMITTED_CPUS: + // COMMITTED_E2_CPUS: + // COMMITTED_LICENSES: + // COMMITTED_LOCAL_SSD_TOTAL_GB: + // COMMITTED_M3_CPUS: + // COMMITTED_MEMORY_OPTIMIZED_CPUS: + // COMMITTED_N2A_CPUS: + // COMMITTED_N2D_CPUS: + // COMMITTED_N2_CPUS: + // COMMITTED_NVIDIA_A100_80GB_GPUS: + // COMMITTED_NVIDIA_A100_GPUS: + // COMMITTED_NVIDIA_H100_GPUS: + // COMMITTED_NVIDIA_K80_GPUS: + // COMMITTED_NVIDIA_L4_GPUS: + // COMMITTED_NVIDIA_P100_GPUS: + // COMMITTED_NVIDIA_P4_GPUS: + // COMMITTED_NVIDIA_T4_GPUS: + // COMMITTED_NVIDIA_V100_GPUS: + // COMMITTED_T2A_CPUS: + // COMMITTED_T2D_CPUS: + // COMMITTED_Z3_CPUS: + // CPUS: Guest CPUs + // CPUS_ALL_REGIONS: + // DISKS_TOTAL_GB: + // E2_CPUS: + // EXTERNAL_MANAGED_FORWARDING_RULES: + // EXTERNAL_NETWORK_LB_FORWARDING_RULES: + // EXTERNAL_PROTOCOL_FORWARDING_RULES: + // EXTERNAL_VPN_GATEWAYS: + // FIREWALLS: + // FORWARDING_RULES: + // GLOBAL_EXTERNAL_MANAGED_BACKEND_SERVICES: + // GLOBAL_EXTERNAL_MANAGED_FORWARDING_RULES: + // GLOBAL_EXTERNAL_PROXY_LB_BACKEND_SERVICES: + // GLOBAL_INTERNAL_ADDRESSES: + // GLOBAL_INTERNAL_MANAGED_BACKEND_SERVICES: + // GLOBAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES: + // GPUS_ALL_REGIONS: + // HDB_TOTAL_GB: + // HDB_TOTAL_IOPS: + // HDB_TOTAL_THROUGHPUT: + // HEALTH_CHECKS: + // IMAGES: + // INSTANCES: + // INSTANCE_GROUPS: + // INSTANCE_GROUP_MANAGERS: + // INSTANCE_TEMPLATES: + // INTERCONNECTS: + // INTERCONNECT_ATTACHMENTS_PER_REGION: + // INTERCONNECT_ATTACHMENTS_TOTAL_MBPS: + // INTERCONNECT_TOTAL_GBPS: + // INTERNAL_ADDRESSES: + // INTERNAL_TRAFFIC_DIRECTOR_FORWARDING_RULES: + // IN_PLACE_SNAPSHOTS: + // IN_USE_ADDRESSES: + // IN_USE_BACKUP_SCHEDULES: + // IN_USE_SNAPSHOT_SCHEDULES: + // LOCAL_SSD_TOTAL_GB: + // M1_CPUS: + // M2_CPUS: + // M3_CPUS: + // MACHINE_IMAGES: + // N2A_CPUS: + // N2D_CPUS: + // N2_CPUS: + // NETWORKS: + // NETWORK_ATTACHMENTS: + // NETWORK_ENDPOINT_GROUPS: + // NETWORK_FIREWALL_POLICIES: + // NET_LB_SECURITY_POLICIES_PER_REGION: + // NET_LB_SECURITY_POLICY_RULES_PER_REGION: + // NET_LB_SECURITY_POLICY_RULE_ATTRIBUTES_PER_REGION: + // NODE_GROUPS: + // NODE_TEMPLATES: + // NVIDIA_A100_80GB_GPUS: + // NVIDIA_A100_GPUS: + // NVIDIA_K80_GPUS: + // NVIDIA_L4_GPUS: + // NVIDIA_P100_GPUS: + // NVIDIA_P100_VWS_GPUS: + // NVIDIA_P4_GPUS: + // NVIDIA_P4_VWS_GPUS: + // NVIDIA_T4_GPUS: + // NVIDIA_T4_VWS_GPUS: + // NVIDIA_V100_GPUS: + // PACKET_MIRRORINGS: + // PD_EXTREME_TOTAL_PROVISIONED_IOPS: + // PREEMPTIBLE_CPUS: + // PREEMPTIBLE_LOCAL_SSD_GB: + // PREEMPTIBLE_NVIDIA_A100_80GB_GPUS: + // PREEMPTIBLE_NVIDIA_A100_GPUS: + // PREEMPTIBLE_NVIDIA_H100_GPUS: + // PREEMPTIBLE_NVIDIA_K80_GPUS: + // PREEMPTIBLE_NVIDIA_L4_GPUS: + // PREEMPTIBLE_NVIDIA_P100_GPUS: + // PREEMPTIBLE_NVIDIA_P100_VWS_GPUS: + // PREEMPTIBLE_NVIDIA_P4_GPUS: + // PREEMPTIBLE_NVIDIA_P4_VWS_GPUS: + // PREEMPTIBLE_NVIDIA_T4_GPUS: + // PREEMPTIBLE_NVIDIA_T4_VWS_GPUS: + // PREEMPTIBLE_NVIDIA_V100_GPUS: + // PREEMPTIBLE_TPU_LITE_DEVICE_V5: + // PREEMPTIBLE_TPU_LITE_PODSLICE_V5: + // PREEMPTIBLE_TPU_PODSLICE_V4: + // PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK: + // PSC_INTERNAL_LB_FORWARDING_RULES: + // PUBLIC_ADVERTISED_PREFIXES: + // PUBLIC_DELEGATED_PREFIXES: + // REGIONAL_AUTOSCALERS: + // REGIONAL_EXTERNAL_MANAGED_BACKEND_SERVICES: + // REGIONAL_EXTERNAL_NETWORK_LB_BACKEND_SERVICES: + // REGIONAL_INSTANCE_GROUP_MANAGERS: + // REGIONAL_INTERNAL_LB_BACKEND_SERVICES: + // REGIONAL_INTERNAL_MANAGED_BACKEND_SERVICES: + // REGIONAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES: + // RESERVATIONS: + // RESOURCE_POLICIES: + // ROUTERS: + // ROUTES: + // SECURITY_POLICIES: + // SECURITY_POLICIES_PER_REGION: + // SECURITY_POLICY_ADVANCED_RULES_PER_REGION: + // SECURITY_POLICY_CEVAL_RULES: + // SECURITY_POLICY_RULES: + // SECURITY_POLICY_RULES_PER_REGION: + // SERVICE_ATTACHMENTS: + // SNAPSHOTS: The total number of snapshots allowed for a single project. + // SSD_TOTAL_GB: + // SSL_CERTIFICATES: + // SSL_POLICIES: + // STATIC_ADDRESSES: + // STATIC_BYOIP_ADDRESSES: + // STATIC_EXTERNAL_IPV6_ADDRESS_RANGES: + // SUBNETWORKS: + // T2A_CPUS: + // T2D_CPUS: + // TARGET_HTTPS_PROXIES: + // TARGET_HTTP_PROXIES: + // TARGET_INSTANCES: + // TARGET_POOLS: + // TARGET_SSL_PROXIES: + // TARGET_TCP_PROXIES: + // TARGET_VPN_GATEWAYS: + // TPU_LITE_DEVICE_V5: + // TPU_LITE_PODSLICE_V5: + // TPU_PODSLICE_V4: + // URL_MAPS: + // VARIABLE_IPV6_PUBLIC_DELEGATED_PREFIXES: + // VPN_GATEWAYS: + // VPN_TUNNELS: + // XPN_SERVICE_PROJECTS: + optional string metric = 2 [json_name = "metric"]; + + // [Output Only] Owning resource. This is the resource on which this quota is + // applied. + optional string owner = 3 [json_name = "owner"]; + + // [Output Only] Current usage of this metric. + optional double usage = 4 [json_name = "usage"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_093.proto b/protos/google/cloud/compute/v1/internal/common_093.proto index 9ca031a90edd1..0fca4b96a70ec 100644 --- a/protos/google/cloud/compute/v1/internal/common_093.proto +++ b/protos/google/cloud/compute/v1/internal/common_093.proto @@ -15,41 +15,38 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; +import "google/cloud/compute/v1/internal/common_022.proto"; import "google/cloud/compute/v1/internal/common_092.proto"; -message PublicDelegatedPrefixAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; +// Represents a Region resource. A region is a geographical area where a +// resource is located. For more information, read Regions and Zones. +message Region { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // A list of PublicDelegatedPrefixesScopedList resources. - map items = 2 - [json_name = "items"]; + // [Output Only] The deprecation status associated with this region. + optional DeprecationStatus deprecated = 2 [json_name = "deprecated"]; - // [Output Only] Type of the resource. Always - // compute#publicDelegatedPrefixAggregatedList for aggregated lists of public - // delegated prefixes. - optional string kind = 3 [json_name = "kind"]; + // [Output Only] Textual description of the resource. + optional string description = 3 [json_name = "description"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // [Output Only] Type of the resource. Always compute#region for regions. + optional string kind = 5 [json_name = "kind"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; + // [Output Only] Name of the resource. + optional string name = 6 [json_name = "name"]; - message Warning { + message QuotaStatusWarning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by @@ -130,14 +127,51 @@ message PublicDelegatedPrefixAggregatedList { optional string message = 3 [json_name = "message"]; } - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + // [Output Only] Warning of fetching the `quotas` field for this region. This + // field is populated only if fetching of the `quotas` field fails. + optional QuotaStatusWarning quota_status_warning = 12 + [json_name = "quotaStatusWarning"]; + + // [Output Only] Quotas assigned to this region. + repeated Quota quotas = 7 [json_name = "quotas"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 8 [json_name = "selfLink"]; + + // [Output Only] Status of the region, either UP or DOWN. + // DOWN: + // UP: + optional string status = 9 [json_name = "status"]; + + // [Output Only] Reserved for future use. + optional bool supports_pzs = 10 [json_name = "supportsPzs"]; + + // [Output Only] A list of zones available in this region, in the form of + // resource URLs. + repeated string zones = 11 [json_name = "zones"]; } -message PublicDelegatedPrefixesScopedList { - // [Output Only] A list of PublicDelegatedPrefixes contained in this scope. - repeated PublicDelegatedPrefix public_delegated_prefixes = 1 - [json_name = "publicDelegatedPrefixes"]; +// Contains a list of region resources. +message RegionList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of Region resources. + repeated Region items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#regionList for lists of + // regions. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -220,7 +254,6 @@ message PublicDelegatedPrefixesScopedList { optional string message = 3 [json_name = "message"]; } - // [Output Only] Informational warning which replaces the list of public - // delegated prefixes when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_094.proto b/protos/google/cloud/compute/v1/internal/common_094.proto index d466267f151d1..3d53d89b8cf1b 100644 --- a/protos/google/cloud/compute/v1/internal/common_094.proto +++ b/protos/google/cloud/compute/v1/internal/common_094.proto @@ -15,188 +15,116 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// A quotas entry. -message Quota { - // [Output Only] Quota limit for this metric. - optional double limit = 1 [json_name = "limit"]; +import "google/cloud/compute/v1/internal/common_008.proto"; - // [Output Only] Name of the quota metric. - // A2_CPUS: - // AFFINITY_GROUPS: - // AUTOSCALERS: - // BACKEND_BUCKETS: - // BACKEND_SERVICES: - // C2D_CPUS: - // C2_CPUS: - // C3_CPUS: - // COMMITMENTS: - // COMMITTED_A2_CPUS: - // COMMITTED_C2D_CPUS: - // COMMITTED_C2_CPUS: - // COMMITTED_C3_CPUS: - // COMMITTED_CPUS: - // COMMITTED_E2_CPUS: - // COMMITTED_LICENSES: - // COMMITTED_LOCAL_SSD_TOTAL_GB: - // COMMITTED_M3_CPUS: - // COMMITTED_MEMORY_OPTIMIZED_CPUS: - // COMMITTED_N2A_CPUS: - // COMMITTED_N2D_CPUS: - // COMMITTED_N2_CPUS: - // COMMITTED_NVIDIA_A100_80GB_GPUS: - // COMMITTED_NVIDIA_A100_GPUS: - // COMMITTED_NVIDIA_H100_GPUS: - // COMMITTED_NVIDIA_K80_GPUS: - // COMMITTED_NVIDIA_L4_GPUS: - // COMMITTED_NVIDIA_P100_GPUS: - // COMMITTED_NVIDIA_P4_GPUS: - // COMMITTED_NVIDIA_T4_GPUS: - // COMMITTED_NVIDIA_V100_GPUS: - // COMMITTED_T2A_CPUS: - // COMMITTED_T2D_CPUS: - // COMMITTED_Z3_CPUS: - // CPUS: Guest CPUs - // CPUS_ALL_REGIONS: - // DISKS_TOTAL_GB: - // E2_CPUS: - // EXTERNAL_MANAGED_FORWARDING_RULES: - // EXTERNAL_NETWORK_LB_FORWARDING_RULES: - // EXTERNAL_PROTOCOL_FORWARDING_RULES: - // EXTERNAL_VPN_GATEWAYS: - // FIREWALLS: - // FORWARDING_RULES: - // GLOBAL_EXTERNAL_MANAGED_BACKEND_SERVICES: - // GLOBAL_EXTERNAL_MANAGED_FORWARDING_RULES: - // GLOBAL_EXTERNAL_PROXY_LB_BACKEND_SERVICES: - // GLOBAL_INTERNAL_ADDRESSES: - // GLOBAL_INTERNAL_MANAGED_BACKEND_SERVICES: - // GLOBAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES: - // GPUS_ALL_REGIONS: - // HDB_TOTAL_GB: - // HDB_TOTAL_IOPS: - // HDB_TOTAL_THROUGHPUT: - // HEALTH_CHECKS: - // IMAGES: - // INSTANCES: - // INSTANCE_GROUPS: - // INSTANCE_GROUP_MANAGERS: - // INSTANCE_TEMPLATES: - // INTERCONNECTS: - // INTERCONNECT_ATTACHMENTS_PER_REGION: - // INTERCONNECT_ATTACHMENTS_TOTAL_MBPS: - // INTERCONNECT_TOTAL_GBPS: - // INTERNAL_ADDRESSES: - // INTERNAL_TRAFFIC_DIRECTOR_FORWARDING_RULES: - // IN_PLACE_SNAPSHOTS: - // IN_USE_ADDRESSES: - // IN_USE_BACKUP_SCHEDULES: - // IN_USE_SNAPSHOT_SCHEDULES: - // LOCAL_SSD_TOTAL_GB: - // M1_CPUS: - // M2_CPUS: - // M3_CPUS: - // MACHINE_IMAGES: - // N2A_CPUS: - // N2D_CPUS: - // N2_CPUS: - // NETWORKS: - // NETWORK_ATTACHMENTS: - // NETWORK_ENDPOINT_GROUPS: - // NETWORK_FIREWALL_POLICIES: - // NET_LB_SECURITY_POLICIES_PER_REGION: - // NET_LB_SECURITY_POLICY_RULES_PER_REGION: - // NET_LB_SECURITY_POLICY_RULE_ATTRIBUTES_PER_REGION: - // NODE_GROUPS: - // NODE_TEMPLATES: - // NVIDIA_A100_80GB_GPUS: - // NVIDIA_A100_GPUS: - // NVIDIA_K80_GPUS: - // NVIDIA_L4_GPUS: - // NVIDIA_P100_GPUS: - // NVIDIA_P100_VWS_GPUS: - // NVIDIA_P4_GPUS: - // NVIDIA_P4_VWS_GPUS: - // NVIDIA_T4_GPUS: - // NVIDIA_T4_VWS_GPUS: - // NVIDIA_V100_GPUS: - // PACKET_MIRRORINGS: - // PD_EXTREME_TOTAL_PROVISIONED_IOPS: - // PREEMPTIBLE_CPUS: - // PREEMPTIBLE_LOCAL_SSD_GB: - // PREEMPTIBLE_NVIDIA_A100_80GB_GPUS: - // PREEMPTIBLE_NVIDIA_A100_GPUS: - // PREEMPTIBLE_NVIDIA_H100_GPUS: - // PREEMPTIBLE_NVIDIA_K80_GPUS: - // PREEMPTIBLE_NVIDIA_L4_GPUS: - // PREEMPTIBLE_NVIDIA_P100_GPUS: - // PREEMPTIBLE_NVIDIA_P100_VWS_GPUS: - // PREEMPTIBLE_NVIDIA_P4_GPUS: - // PREEMPTIBLE_NVIDIA_P4_VWS_GPUS: - // PREEMPTIBLE_NVIDIA_T4_GPUS: - // PREEMPTIBLE_NVIDIA_T4_VWS_GPUS: - // PREEMPTIBLE_NVIDIA_V100_GPUS: - // PREEMPTIBLE_TPU_LITE_DEVICE_V5: - // PREEMPTIBLE_TPU_LITE_PODSLICE_V5: - // PREEMPTIBLE_TPU_PODSLICE_V4: - // PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK: - // PSC_INTERNAL_LB_FORWARDING_RULES: - // PUBLIC_ADVERTISED_PREFIXES: - // PUBLIC_DELEGATED_PREFIXES: - // REGIONAL_AUTOSCALERS: - // REGIONAL_EXTERNAL_MANAGED_BACKEND_SERVICES: - // REGIONAL_EXTERNAL_NETWORK_LB_BACKEND_SERVICES: - // REGIONAL_INSTANCE_GROUP_MANAGERS: - // REGIONAL_INTERNAL_LB_BACKEND_SERVICES: - // REGIONAL_INTERNAL_MANAGED_BACKEND_SERVICES: - // REGIONAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES: - // RESERVATIONS: - // RESOURCE_POLICIES: - // ROUTERS: - // ROUTES: - // SECURITY_POLICIES: - // SECURITY_POLICIES_PER_REGION: - // SECURITY_POLICY_ADVANCED_RULES_PER_REGION: - // SECURITY_POLICY_CEVAL_RULES: - // SECURITY_POLICY_RULES: - // SECURITY_POLICY_RULES_PER_REGION: - // SERVICE_ATTACHMENTS: - // SNAPSHOTS: The total number of snapshots allowed for a single project. - // SSD_TOTAL_GB: - // SSL_CERTIFICATES: - // SSL_POLICIES: - // STATIC_ADDRESSES: - // STATIC_BYOIP_ADDRESSES: - // STATIC_EXTERNAL_IPV6_ADDRESS_RANGES: - // SUBNETWORKS: - // T2A_CPUS: - // T2D_CPUS: - // TARGET_HTTPS_PROXIES: - // TARGET_HTTP_PROXIES: - // TARGET_INSTANCES: - // TARGET_POOLS: - // TARGET_SSL_PROXIES: - // TARGET_TCP_PROXIES: - // TARGET_VPN_GATEWAYS: - // TPU_LITE_DEVICE_V5: - // TPU_LITE_PODSLICE_V5: - // TPU_PODSLICE_V4: - // URL_MAPS: - // VARIABLE_IPV6_PUBLIC_DELEGATED_PREFIXES: - // VPN_GATEWAYS: - // VPN_TUNNELS: - // XPN_SERVICE_PROJECTS: - optional string metric = 2 [json_name = "metric"]; +// Contains a list of autoscalers. +message RegionAutoscalerList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; - // [Output Only] Owning resource. This is the resource on which this quota is - // applied. - optional string owner = 3 [json_name = "owner"]; + // A list of Autoscaler resources. + repeated Autoscaler items = 2 [json_name = "items"]; - // [Output Only] Current usage of this metric. - optional double usage = 4 [json_name = "usage"]; + // Type of resource. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_095.proto b/protos/google/cloud/compute/v1/internal/common_095.proto index b4cb87930f671..e2f9c67114bb2 100644 --- a/protos/google/cloud/compute/v1/internal/common_095.proto +++ b/protos/google/cloud/compute/v1/internal/common_095.proto @@ -15,152 +15,23 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; -import "google/cloud/compute/v1/internal/common_094.proto"; +import "google/cloud/compute/v1/internal/common_026.proto"; -// Represents a Region resource. A region is a geographical area where a -// resource is located. For more information, read Regions and Zones. -message Region { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // [Output Only] The deprecation status associated with this region. - optional DeprecationStatus deprecated = 2 [json_name = "deprecated"]; - - // [Output Only] Textual description of the resource. - optional string description = 3 [json_name = "description"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 4 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#region for regions. - optional string kind = 5 [json_name = "kind"]; - - // [Output Only] Name of the resource. - optional string name = 6 [json_name = "name"]; - - message QuotaStatusWarning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Warning of fetching the `quotas` field for this region. This - // field is populated only if fetching of the `quotas` field fails. - optional QuotaStatusWarning quota_status_warning = 12 - [json_name = "quotaStatusWarning"]; - - // [Output Only] Quotas assigned to this region. - repeated Quota quotas = 7 [json_name = "quotas"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 8 [json_name = "selfLink"]; - - // [Output Only] Status of the region, either UP or DOWN. - // DOWN: - // UP: - optional string status = 9 [json_name = "status"]; - - // [Output Only] Reserved for future use. - optional bool supports_pzs = 10 [json_name = "supportsPzs"]; - - // [Output Only] A list of zones available in this region, in the form of - // resource URLs. - repeated string zones = 11 [json_name = "zones"]; -} - -// Contains a list of region resources. -message RegionList { +message RegionDiskTypeList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of Region resources. - repeated Region items = 2 [json_name = "items"]; + // A list of DiskType resources. + repeated DiskType items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#regionList for lists of - // regions. + // [Output Only] Type of resource. Always compute#regionDiskTypeList for + // region disk types. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for diff --git a/protos/google/cloud/compute/v1/internal/common_096.proto b/protos/google/cloud/compute/v1/internal/common_096.proto index 7d21f6c1e23cd..5ba43289d7314 100644 --- a/protos/google/cloud/compute/v1/internal/common_096.proto +++ b/protos/google/cloud/compute/v1/internal/common_096.proto @@ -15,116 +15,36 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_009.proto"; - -// Contains a list of autoscalers. -message RegionAutoscalerList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of Autoscaler resources. - repeated Autoscaler items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } +message RegionDisksAddResourcePoliciesRequest { + // Resource policies to be added to this disk. + repeated string resource_policies = 1 [json_name = "resourcePolicies"]; +} - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; +message RegionDisksRemoveResourcePoliciesRequest { + // Resource policies to be removed from this disk. + repeated string resource_policies = 1 [json_name = "resourcePolicies"]; +} - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } +message RegionDisksResizeRequest { + // The new size of the regional persistent disk, which is specified in GB. + optional string size_gb = 1 [json_name = "sizeGb"]; +} - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; +message RegionDisksStartAsyncReplicationRequest { + // The secondary disk to start asynchronous replication to. You can provide + // this as a partial or full URL to the resource. For example, the following + // are valid values: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /disks/disk - + // https://www.googleapis.com/compute/v1/projects/project/regions/region + // /disks/disk - projects/project/zones/zone/disks/disk - + // projects/project/regions/region/disks/disk - zones/zone/disks/disk - + // regions/region/disks/disk + optional string async_secondary_disk = 1 [json_name = "asyncSecondaryDisk"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_097.proto b/protos/google/cloud/compute/v1/internal/common_097.proto index 3f8b998ccc653..73e29e649810d 100644 --- a/protos/google/cloud/compute/v1/internal/common_097.proto +++ b/protos/google/cloud/compute/v1/internal/common_097.proto @@ -15,23 +15,24 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_027.proto"; +import "google/cloud/compute/v1/internal/common_057.proto"; +import "google/cloud/compute/v1/internal/common_078.proto"; -message RegionDiskTypeList { +// Contains a list of InstanceGroup resources. +message RegionInstanceGroupList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of DiskType resources. - repeated DiskType items = 2 [json_name = "items"]; + // A list of InstanceGroup resources. + repeated InstanceGroup items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#regionDiskTypeList for - // region disk types. + // The resource type. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -128,3 +129,134 @@ message RegionDiskTypeList { // [Output Only] Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } + +message RegionInstanceGroupsListInstances { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of InstanceWithNamedPorts resources. + repeated InstanceWithNamedPorts items = 2 [json_name = "items"]; + + // The resource type. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message RegionInstanceGroupsListInstancesRequest { + // Instances in which state should be returned. Valid options are: 'ALL', + // 'RUNNING'. By default, it lists all instances. + // ALL: Matches any status of the instances, running, non-running and others. + // RUNNING: Instance is in RUNNING state if it is running. + optional string instance_state = 1 [json_name = "instanceState"]; + + // Name of port user is interested in. It is optional. If it is set, only + // information about this ports will be returned. If it is not set, all the + // named ports will be returned. Always lists all instances. + optional string port_name = 2 [json_name = "portName"]; +} + +message RegionInstanceGroupsSetNamedPortsRequest { + // The fingerprint of the named ports information for this instance group. Use + // this optional property to prevent conflicts when multiple users change the + // named ports settings concurrently. Obtain the fingerprint with the + // instanceGroups.get method. Then, include the fingerprint in your request to + // ensure that you do not overwrite changes that were applied from another + // concurrent request. + optional string fingerprint = 1 [json_name = "fingerprint"]; + + // The list of named ports to set for this instance group. + repeated NamedPort named_ports = 2 [json_name = "namedPorts"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_098.proto b/protos/google/cloud/compute/v1/internal/common_098.proto index a99cbefb79af4..ee68e35870d8a 100644 --- a/protos/google/cloud/compute/v1/internal/common_098.proto +++ b/protos/google/cloud/compute/v1/internal/common_098.proto @@ -15,36 +15,356 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message RegionDisksAddResourcePoliciesRequest { - // Resource policies to be added to this disk. - repeated string resource_policies = 1 [json_name = "resourcePolicies"]; +import "google/cloud/compute/v1/internal/common_028.proto"; + +// RegionInstanceGroupManagers.deletePerInstanceConfigs +message RegionInstanceGroupManagerDeleteInstanceConfigReq { + // The list of instance names for which we want to delete per-instance configs + // on this managed instance group. + repeated string names = 1 [json_name = "names"]; } -message RegionDisksRemoveResourcePoliciesRequest { - // Resource policies to be removed from this disk. - repeated string resource_policies = 1 [json_name = "resourcePolicies"]; +// Contains a list of managed instance groups. +message RegionInstanceGroupManagerList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of InstanceGroupManager resources. + repeated InstanceGroupManager items = 2 [json_name = "items"]; + + // [Output Only] The resource type, which is always + // compute#instanceGroupManagerList for a list of managed instance groups that + // exist in th regional scope. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } -message RegionDisksResizeRequest { - // The new size of the regional persistent disk, which is specified in GB. - optional string size_gb = 1 [json_name = "sizeGb"]; +// RegionInstanceGroupManagers.patchPerInstanceConfigs +message RegionInstanceGroupManagerPatchInstanceConfigReq { + // The list of per-instance configurations to insert or patch on this managed + // instance group. + repeated PerInstanceConfig per_instance_configs = 1 + [json_name = "perInstanceConfigs"]; +} + +// RegionInstanceGroupManagers.updatePerInstanceConfigs +message RegionInstanceGroupManagerUpdateInstanceConfigReq { + // The list of per-instance configurations to insert or patch on this managed + // instance group. + repeated PerInstanceConfig per_instance_configs = 1 + [json_name = "perInstanceConfigs"]; +} + +message RegionInstanceGroupManagersAbandonInstancesRequest { + // The URLs of one or more instances to abandon. This can be a full URL or a + // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + repeated string instances = 1 [json_name = "instances"]; +} + +// RegionInstanceGroupManagers.applyUpdatesToInstances +message RegionInstanceGroupManagersApplyUpdatesRequest { + // Flag to update all instances instead of specified list of “instances”. + // If the flag is set to true then the instances may not be specified in the + // request. + optional bool all_instances = 1 [json_name = "allInstances"]; + + // The list of URLs of one or more instances for which you want to apply + // updates. Each URL can be a full URL or a partial URL, such as + // zones/[ZONE]/instances/[INSTANCE_NAME]. + repeated string instances = 2 [json_name = "instances"]; + + // The minimal action that you want to perform on each instance during the + // update: - REPLACE: At minimum, delete the instance and create it again. - + // RESTART: Stop the instance and start it again. - REFRESH: Do not stop the + // instance and limit disruption as much as possible. - NONE: Do not disrupt + // the instance at all. By default, the minimum action is NONE. If your update + // requires a more disruptive action than you set with this flag, the + // necessary action is performed to execute the update. + // NONE: Do not perform any action. + // REFRESH: Do not stop the instance. + // REPLACE: (Default.) Replace the instance according to the replacement + // method option. + // RESTART: Stop the instance and start it again. + optional string minimal_action = 3 [json_name = "minimalAction"]; + + // The most disruptive action that you want to perform on each instance during + // the update: - REPLACE: Delete the instance and create it again. - RESTART: + // Stop the instance and start it again. - REFRESH: Do not stop the instance + // and limit disruption as much as possible. - NONE: Do not disrupt the + // instance at all. By default, the most disruptive allowed action is REPLACE. + // If your update requires a more disruptive action than you set with this + // flag, the update request will fail. + // NONE: Do not perform any action. + // REFRESH: Do not stop the instance. + // REPLACE: (Default.) Replace the instance according to the replacement + // method option. + // RESTART: Stop the instance and start it again. + optional string most_disruptive_allowed_action = 4 + [json_name = "mostDisruptiveAllowedAction"]; +} + +// RegionInstanceGroupManagers.createInstances +message RegionInstanceGroupManagersCreateInstancesRequest { + // [Required] List of specifications of per-instance configs. + repeated PerInstanceConfig instances = 1 [json_name = "instances"]; +} + +message RegionInstanceGroupManagersDeleteInstancesRequest { + // The URLs of one or more instances to delete. This can be a full URL or a + // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + repeated string instances = 1 [json_name = "instances"]; + + // Specifies whether the request should proceed despite the inclusion of + // instances that are not members of the group or that are already in the + // process of being deleted or abandoned. If this field is set to `false` and + // such an instance is specified in the request, the operation fails. The + // operation always fails if the request contains a malformed instance URL or + // a reference to an instance that exists in a zone or region other than the + // group's zone or region. + optional bool skip_instances_on_validation_error = 2 + [json_name = "skipInstancesOnValidationError"]; +} + +message RegionInstanceGroupManagersListErrorsResponse { + // [Output Only] The list of errors of the managed instance group. + repeated InstanceManagedByIgmError items = 1 [json_name = "items"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 2 [json_name = "nextPageToken"]; +} + +message RegionInstanceGroupManagersListInstanceConfigsResp { + // [Output Only] The list of PerInstanceConfig. + repeated PerInstanceConfig items = 1 [json_name = "items"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 2 [json_name = "nextPageToken"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 3 [json_name = "warning"]; +} + +message RegionInstanceGroupManagersListInstancesResponse { + // A list of managed instances. + repeated ManagedInstance managed_instances = 1 + [json_name = "managedInstances"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 2 [json_name = "nextPageToken"]; +} + +message RegionInstanceGroupManagersRecreateRequest { + // The URLs of one or more instances to recreate. This can be a full URL or a + // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. + repeated string instances = 1 [json_name = "instances"]; +} + +message RegionInstanceGroupManagersSetTargetPoolsRequest { + // Fingerprint of the target pools information, which is a hash of the + // contents. This field is used for optimistic locking when you update the + // target pool entries. This field is optional. + optional string fingerprint = 1 [json_name = "fingerprint"]; + + // The URL of all TargetPool resources to which instances in the instanceGroup + // field are added. The target pools automatically apply to all of the + // instances in the managed instance group. + repeated string target_pools = 2 [json_name = "targetPools"]; } -message RegionDisksStartAsyncReplicationRequest { - // The secondary disk to start asynchronous replication to. You can provide - // this as a partial or full URL to the resource. For example, the following - // are valid values: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /disks/disk - - // https://www.googleapis.com/compute/v1/projects/project/regions/region - // /disks/disk - projects/project/zones/zone/disks/disk - - // projects/project/regions/region/disks/disk - zones/zone/disks/disk - - // regions/region/disks/disk - optional string async_secondary_disk = 1 [json_name = "asyncSecondaryDisk"]; +message RegionInstanceGroupManagersSetTemplateRequest { + // URL of the InstanceTemplate resource from which all new instances will be + // created. + optional string instance_template = 1 [json_name = "instanceTemplate"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_099.proto b/protos/google/cloud/compute/v1/internal/common_099.proto index 092741bdf14cc..29a97f96e0e4c 100644 --- a/protos/google/cloud/compute/v1/internal/common_099.proto +++ b/protos/google/cloud/compute/v1/internal/common_099.proto @@ -15,248 +15,22 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_059.proto"; -import "google/cloud/compute/v1/internal/common_080.proto"; +import "google/cloud/compute/v1/internal/common_012.proto"; -// Contains a list of InstanceGroup resources. -message RegionInstanceGroupList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of InstanceGroup resources. - repeated InstanceGroup items = 2 [json_name = "items"]; - - // The resource type. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -message RegionInstanceGroupsListInstances { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of InstanceWithNamedPorts resources. - repeated InstanceWithNamedPorts items = 2 [json_name = "items"]; - - // The resource type. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -message RegionInstanceGroupsListInstancesRequest { - // Instances in which state should be returned. Valid options are: 'ALL', - // 'RUNNING'. By default, it lists all instances. - // ALL: Matches any status of the instances, running, non-running and others. - // RUNNING: Instance is in RUNNING state if it is running. - optional string instance_state = 1 [json_name = "instanceState"]; - - // Name of port user is interested in. It is optional. If it is set, only - // information about this ports will be returned. If it is not set, all the - // named ports will be returned. Always lists all instances. - optional string port_name = 2 [json_name = "portName"]; +message RegionNetworkEndpointGroupsAttachEndpointsRequest { + // The list of network endpoints to be attached. + repeated NetworkEndpoint network_endpoints = 1 + [json_name = "networkEndpoints"]; } -message RegionInstanceGroupsSetNamedPortsRequest { - // The fingerprint of the named ports information for this instance group. Use - // this optional property to prevent conflicts when multiple users change the - // named ports settings concurrently. Obtain the fingerprint with the - // instanceGroups.get method. Then, include the fingerprint in your request to - // ensure that you do not overwrite changes that were applied from another - // concurrent request. - optional string fingerprint = 1 [json_name = "fingerprint"]; - - // The list of named ports to set for this instance group. - repeated NamedPort named_ports = 2 [json_name = "namedPorts"]; +message RegionNetworkEndpointGroupsDetachEndpointsRequest { + // The list of network endpoints to be detached. + repeated NetworkEndpoint network_endpoints = 1 + [json_name = "networkEndpoints"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_100.proto b/protos/google/cloud/compute/v1/internal/common_100.proto index f8e0b4d7779eb..1c9a66f912399 100644 --- a/protos/google/cloud/compute/v1/internal/common_100.proto +++ b/protos/google/cloud/compute/v1/internal/common_100.proto @@ -15,356 +15,44 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_029.proto"; +import "google/cloud/compute/v1/internal/common_034.proto"; +import "google/cloud/compute/v1/internal/common_038.proto"; -// RegionInstanceGroupManagers.deletePerInstanceConfigs -message RegionInstanceGroupManagerDeleteInstanceConfigReq { - // The list of instance names for which we want to delete per-instance configs - // on this managed instance group. - repeated string names = 1 [json_name = "names"]; -} - -// Contains a list of managed instance groups. -message RegionInstanceGroupManagerList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of InstanceGroupManager resources. - repeated InstanceGroupManager items = 2 [json_name = "items"]; - - // [Output Only] The resource type, which is always - // compute#instanceGroupManagerList for a list of managed instance groups that - // exist in th regional scope. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// RegionInstanceGroupManagers.patchPerInstanceConfigs -message RegionInstanceGroupManagerPatchInstanceConfigReq { - // The list of per-instance configurations to insert or patch on this managed - // instance group. - repeated PerInstanceConfig per_instance_configs = 1 - [json_name = "perInstanceConfigs"]; -} - -// RegionInstanceGroupManagers.updatePerInstanceConfigs -message RegionInstanceGroupManagerUpdateInstanceConfigReq { - // The list of per-instance configurations to insert or patch on this managed - // instance group. - repeated PerInstanceConfig per_instance_configs = 1 - [json_name = "perInstanceConfigs"]; -} - -message RegionInstanceGroupManagersAbandonInstancesRequest { - // The URLs of one or more instances to abandon. This can be a full URL or a - // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 1 [json_name = "instances"]; -} - -// RegionInstanceGroupManagers.applyUpdatesToInstances -message RegionInstanceGroupManagersApplyUpdatesRequest { - // Flag to update all instances instead of specified list of “instances”. - // If the flag is set to true then the instances may not be specified in the - // request. - optional bool all_instances = 1 [json_name = "allInstances"]; - - // The list of URLs of one or more instances for which you want to apply - // updates. Each URL can be a full URL or a partial URL, such as - // zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 2 [json_name = "instances"]; - - // The minimal action that you want to perform on each instance during the - // update: - REPLACE: At minimum, delete the instance and create it again. - - // RESTART: Stop the instance and start it again. - REFRESH: Do not stop the - // instance and limit disruption as much as possible. - NONE: Do not disrupt - // the instance at all. By default, the minimum action is NONE. If your update - // requires a more disruptive action than you set with this flag, the - // necessary action is performed to execute the update. - // NONE: Do not perform any action. - // REFRESH: Do not stop the instance. - // REPLACE: (Default.) Replace the instance according to the replacement - // method option. - // RESTART: Stop the instance and start it again. - optional string minimal_action = 3 [json_name = "minimalAction"]; +message RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse { + // [Output only] Effective firewalls from firewall policy. It applies to + // Regional Network Firewall Policies in the specified region, Global Network + // Firewall Policies and Hierachial Firewall Policies which are associated + // with the network. + repeated + RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy + firewall_policys = 1 [json_name = "firewallPolicys"]; - // The most disruptive action that you want to perform on each instance during - // the update: - REPLACE: Delete the instance and create it again. - RESTART: - // Stop the instance and start it again. - REFRESH: Do not stop the instance - // and limit disruption as much as possible. - NONE: Do not disrupt the - // instance at all. By default, the most disruptive allowed action is REPLACE. - // If your update requires a more disruptive action than you set with this - // flag, the update request will fail. - // NONE: Do not perform any action. - // REFRESH: Do not stop the instance. - // REPLACE: (Default.) Replace the instance according to the replacement - // method option. - // RESTART: Stop the instance and start it again. - optional string most_disruptive_allowed_action = 4 - [json_name = "mostDisruptiveAllowedAction"]; + // Effective firewalls on the network. + repeated Firewall firewalls = 2 [json_name = "firewalls"]; } -// RegionInstanceGroupManagers.createInstances -message RegionInstanceGroupManagersCreateInstancesRequest { - // [Required] List of specifications of per-instance configs. - repeated PerInstanceConfig instances = 1 [json_name = "instances"]; -} - -message RegionInstanceGroupManagersDeleteInstancesRequest { - // The URLs of one or more instances to delete. This can be a full URL or a - // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 1 [json_name = "instances"]; - - // Specifies whether the request should proceed despite the inclusion of - // instances that are not members of the group or that are already in the - // process of being deleted or abandoned. If this field is set to `false` and - // such an instance is specified in the request, the operation fails. The - // operation always fails if the request contains a malformed instance URL or - // a reference to an instance that exists in a zone or region other than the - // group's zone or region. - optional bool skip_instances_on_validation_error = 2 - [json_name = "skipInstancesOnValidationError"]; -} - -message RegionInstanceGroupManagersListErrorsResponse { - // [Output Only] The list of errors of the managed instance group. - repeated InstanceManagedByIgmError items = 1 [json_name = "items"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 2 [json_name = "nextPageToken"]; -} - -message RegionInstanceGroupManagersListInstanceConfigsResp { - // [Output Only] The list of PerInstanceConfig. - repeated PerInstanceConfig items = 1 [json_name = "items"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 2 [json_name = "nextPageToken"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; +message +RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy { + // [Output Only] The display name of the firewall policy. + optional string display_name = 1 [json_name = "displayName"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // [Output Only] The name of the firewall policy. + optional string name = 2 [json_name = "name"]; - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 3 [json_name = "warning"]; -} - -message RegionInstanceGroupManagersListInstancesResponse { - // A list of managed instances. - repeated ManagedInstance managed_instances = 1 - [json_name = "managedInstances"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 2 [json_name = "nextPageToken"]; -} - -message RegionInstanceGroupManagersRecreateRequest { - // The URLs of one or more instances to recreate. This can be a full URL or a - // partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME]. - repeated string instances = 1 [json_name = "instances"]; -} - -message RegionInstanceGroupManagersSetTargetPoolsRequest { - // Fingerprint of the target pools information, which is a hash of the - // contents. This field is used for optimistic locking when you update the - // target pool entries. This field is optional. - optional string fingerprint = 1 [json_name = "fingerprint"]; - - // The URL of all TargetPool resources to which instances in the instanceGroup - // field are added. The target pools automatically apply to all of the - // instances in the managed instance group. - repeated string target_pools = 2 [json_name = "targetPools"]; -} + // [Output only] The rules that apply to the network. + repeated FirewallPolicyRule rules = 3 [json_name = "rules"]; -message RegionInstanceGroupManagersSetTemplateRequest { - // URL of the InstanceTemplate resource from which all new instances will be - // created. - optional string instance_template = 1 [json_name = "instanceTemplate"]; + // [Output Only] The type of the firewall policy. Can be one of HIERARCHY, + // NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. + // HIERARCHY: + // NETWORK: + // NETWORK_REGIONAL: + // UNSPECIFIED: + optional string type = 4 [json_name = "type"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_101.proto b/protos/google/cloud/compute/v1/internal/common_101.proto index b48bbb8d030f1..efe00aba1f141 100644 --- a/protos/google/cloud/compute/v1/internal/common_101.proto +++ b/protos/google/cloud/compute/v1/internal/common_101.proto @@ -15,22 +15,20 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_013.proto"; +message RegionSetLabelsRequest { + // The fingerprint of the previous set of labels for this resource, used to + // detect conflicts. The fingerprint is initially generated by Compute Engine + // and changes after every request to modify or update labels. You must always + // provide an up-to-date fingerprint hash in order to update or change labels. + // Make a get() request to the resource to get the latest fingerprint. + optional string label_fingerprint = 1 [json_name = "labelFingerprint"]; -message RegionNetworkEndpointGroupsAttachEndpointsRequest { - // The list of network endpoints to be attached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; -} - -message RegionNetworkEndpointGroupsDetachEndpointsRequest { - // The list of network endpoints to be detached. - repeated NetworkEndpoint network_endpoints = 1 - [json_name = "networkEndpoints"]; + // The labels to set for this resource. + map labels = 2 [json_name = "labels"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_102.proto b/protos/google/cloud/compute/v1/internal/common_102.proto index 51b06d8ad02ad..7ed922cf1601b 100644 --- a/protos/google/cloud/compute/v1/internal/common_102.proto +++ b/protos/google/cloud/compute/v1/internal/common_102.proto @@ -15,41 +15,25 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_035.proto"; -import "google/cloud/compute/v1/internal/common_039.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; -message RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponse { - // Effective firewalls from firewall policy. - repeated - RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy - firewall_policys = 1 [json_name = "firewallPolicys"]; +message RegionSetPolicyRequest { + // Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use + // 'policy' to specify bindings. + repeated Binding bindings = 1 [json_name = "bindings"]; - // Effective firewalls on the network. - repeated Firewall firewalls = 2 [json_name = "firewalls"]; -} - -message -RegionNetworkFirewallPoliciesGetEffectiveFirewallsResponseEffectiveFirewallPolicy { - // [Output Only] The display name of the firewall policy. - optional string display_name = 1 [json_name = "displayName"]; - - // [Output Only] The name of the firewall policy. - optional string name = 2 [json_name = "name"]; - - // The rules that apply to the network. - repeated FirewallPolicyRule rules = 3 [json_name = "rules"]; + // Flatten Policy to create a backward compatible wire-format. Deprecated. Use + // 'policy' to specify the etag. + optional string etag = 2 [json_name = "etag"]; - // [Output Only] The type of the firewall policy. Can be one of HIERARCHY, - // NETWORK, NETWORK_REGIONAL, SYSTEM_GLOBAL, SYSTEM_REGIONAL. - // HIERARCHY: - // NETWORK: - // NETWORK_REGIONAL: - // UNSPECIFIED: - optional string type = 4 [json_name = "type"]; + // REQUIRED: The complete policy to be applied to the 'resource'. The size of + // the policy is limited to a few 10s of KB. An empty policy is in general a + // valid policy but certain services (like Projects) might reject them. + optional Policy policy = 3 [json_name = "policy"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_103.proto b/protos/google/cloud/compute/v1/internal/common_103.proto index 6b4c07ec967b7..8fb1731d119aa 100644 --- a/protos/google/cloud/compute/v1/internal/common_103.proto +++ b/protos/google/cloud/compute/v1/internal/common_103.proto @@ -15,20 +15,14 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message RegionSetLabelsRequest { - // The fingerprint of the previous set of labels for this resource, used to - // detect conflicts. The fingerprint is initially generated by Compute Engine - // and changes after every request to modify or update labels. You must always - // provide an up-to-date fingerprint hash in order to update or change labels. - // Make a get() request to the resource to get the latest fingerprint. - optional string label_fingerprint = 1 [json_name = "labelFingerprint"]; - - // The labels to set for this resource. - map labels = 2 [json_name = "labels"]; +message RegionTargetHttpsProxiesSetSslCertificatesRequest { + // New set of SslCertificate resources to associate with this TargetHttpsProxy + // resource. + repeated string ssl_certificates = 1 [json_name = "sslCertificates"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_104.proto b/protos/google/cloud/compute/v1/internal/common_104.proto index 0dc25f430bd4d..adf47a0742938 100644 --- a/protos/google/cloud/compute/v1/internal/common_104.proto +++ b/protos/google/cloud/compute/v1/internal/common_104.proto @@ -15,25 +15,15 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_008.proto"; +import "google/cloud/compute/v1/internal/common_019.proto"; -message RegionSetPolicyRequest { - // Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use - // 'policy' to specify bindings. - repeated Binding bindings = 1 [json_name = "bindings"]; - - // Flatten Policy to create a backward compatible wire-format. Deprecated. Use - // 'policy' to specify the etag. - optional string etag = 2 [json_name = "etag"]; - - // REQUIRED: The complete policy to be applied to the 'resource'. The size of - // the policy is limited to a few 10s of KB. An empty policy is in general a - // valid policy but certain services (like Projects) might reject them. - optional Policy policy = 3 [json_name = "policy"]; +message RegionUrlMapsValidateRequest { + // Content of the UrlMap to be validated. + optional UrlMap resource = 1 [json_name = "resource"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_105.proto b/protos/google/cloud/compute/v1/internal/common_105.proto index 5de139c5a4059..ba0211932f278 100644 --- a/protos/google/cloud/compute/v1/internal/common_105.proto +++ b/protos/google/cloud/compute/v1/internal/common_105.proto @@ -15,14 +15,322 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message RegionTargetHttpsProxiesSetSslCertificatesRequest { - // New set of SslCertificate resources to associate with this TargetHttpsProxy - // resource. - repeated string ssl_certificates = 1 [json_name = "sslCertificates"]; +import "google/cloud/compute/v1/internal/common_006.proto"; + +// Contains a list of reservations. +message ReservationAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of Allocation resources. + map items = 2 [json_name = "items"]; + + // Type of resource. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +message ReservationList { + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 1 [json_name = "id"]; + + // [Output Only] A list of Allocation resources. + repeated Reservation items = 2 [json_name = "items"]; + + // [Output Only] Type of resource.Always compute#reservationsList for listsof + // reservations + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message ReservationsResizeRequest { + // Number of allocated resources can be resized with minimum = 1 and maximum = + // 1000. + optional string specific_sku_count = 1 [json_name = "specificSkuCount"]; +} + +message ReservationsScopedList { + // A list of reservations contained in this scope. + repeated Reservation reservations = 1 [json_name = "reservations"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of reservations when the list + // is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_106.proto b/protos/google/cloud/compute/v1/internal/common_106.proto index 9cbc2e2c4fe58..8a0ebd05b68b0 100644 --- a/protos/google/cloud/compute/v1/internal/common_106.proto +++ b/protos/google/cloud/compute/v1/internal/common_106.proto @@ -15,15 +15,576 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_020.proto"; +message ResourcePoliciesScopedList { + // A list of resourcePolicies contained in this scope. + repeated ResourcePolicy resource_policies = 1 + [json_name = "resourcePolicies"]; -message RegionUrlMapsValidateRequest { - // Content of the UrlMap to be validated. - optional UrlMap resource = 1 [json_name = "resource"]; + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of resourcePolicies when the + // list is empty. + optional Warning warning = 2 [json_name = "warning"]; +} + +// Represents a Resource Policy resource. You can use resource policies to +// schedule actions for some Compute Engine resources. For example, you can use +// them to schedule persistent disk snapshots. +message ResourcePolicy { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + optional string description = 2 [json_name = "description"]; + + // Resource policy for disk consistency groups. + optional ResourcePolicyDiskConsistencyGroupPolicy + disk_consistency_group_policy = 13 + [json_name = "diskConsistencyGroupPolicy"]; + + // Resource policy for instances for placement configuration. + optional ResourcePolicyGroupPlacementPolicy group_placement_policy = 3 + [json_name = "groupPlacementPolicy"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // Resource policy for scheduling instance operations. + optional ResourcePolicyInstanceSchedulePolicy instance_schedule_policy = 5 + [json_name = "instanceSchedulePolicy"]; + + // [Output Only] Type of the resource. Always compute#resource_policies for + // resource policies. + optional string kind = 6 [json_name = "kind"]; + + // The name of the resource, provided by the client when initially creating + // the resource. The resource name must be 1-63 characters long, and comply + // with RFC1035. Specifically, the name must be 1-63 characters long and match + // the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first + // character must be a lowercase letter, and all following characters must be + // a dash, lowercase letter, or digit, except the last character, which cannot + // be a dash. + optional string name = 7 [json_name = "name"]; + + optional string region = 8 [json_name = "region"]; + + // [Output Only] The system status of the resource policy. + optional ResourcePolicyResourceStatus resource_status = 9 + [json_name = "resourceStatus"]; + + // [Output Only] Server-defined fully-qualified URL for this resource. + optional string self_link = 10 [json_name = "selfLink"]; + + // Resource policy for persistent disks for creating snapshots. + optional ResourcePolicySnapshotSchedulePolicy snapshot_schedule_policy = 11 + [json_name = "snapshotSchedulePolicy"]; + + // [Output Only] The status of resource policy creation. + // CREATING: Resource policy is being created. + // DELETING: Resource policy is being deleted. + // EXPIRED: Resource policy is expired and will not run again. + // INVALID: + // READY: Resource policy is ready to be used. + optional string status = 12 [json_name = "status"]; +} + +// Contains a list of resourcePolicies. +message ResourcePolicyAggregatedList { + optional string etag = 1 [json_name = "etag"]; + + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 2 [json_name = "id"]; + + // A list of ResourcePolicy resources. + map items = 3 [json_name = "items"]; + + // Type of resource. + optional string kind = 4 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 5 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 7 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 8 [json_name = "warning"]; +} + +// Time window specified for daily operations. +message ResourcePolicyDailyCycle { + // Defines a schedule with units measured in days. The value determines how + // many days pass between the start of each cycle. + optional int32 days_in_cycle = 1 [json_name = "daysInCycle"]; + + // [Output only] A predetermined duration for the window, automatically chosen + // to be the smallest possible in the given scenario. + optional string duration = 2 [json_name = "duration"]; + + // Start time of the window. This must be in UTC format that resolves to one + // of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 + // and 08:00 are valid. + optional string start_time = 3 [json_name = "startTime"]; +} + +// Resource policy for disk consistency groups. +message ResourcePolicyDiskConsistencyGroupPolicy {} + +// A GroupPlacementPolicy specifies resource placement configuration. It +// specifies the failure bucket separation +message ResourcePolicyGroupPlacementPolicy { + // The number of availability domains to spread instances across. If two + // instances are in different availability domain, they are not in the same + // low latency network. + optional int32 availability_domain_count = 1 + [json_name = "availabilityDomainCount"]; + + // Specifies network collocation + // COLLOCATED: + // UNSPECIFIED_COLLOCATION: + optional string collocation = 2 [json_name = "collocation"]; + + // Number of VMs in this placement group. Google does not recommend that you + // use this field unless you use a compact policy and you want your policy to + // work only if it contains this exact number of VMs. + optional int32 vm_count = 3 [json_name = "vmCount"]; +} + +// Time window specified for hourly operations. +message ResourcePolicyHourlyCycle { + // [Output only] Duration of the time window, automatically chosen to be + // smallest possible in the given scenario. + optional string duration = 1 [json_name = "duration"]; + + // Defines a schedule with units measured in hours. The value determines how + // many hours pass between the start of each cycle. + optional int32 hours_in_cycle = 2 [json_name = "hoursInCycle"]; + + // Time within the window to start the operations. It must be in format + // "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + optional string start_time = 3 [json_name = "startTime"]; +} + +// An InstanceSchedulePolicy specifies when and how frequent certain operations +// are performed on the instance. +message ResourcePolicyInstanceSchedulePolicy { + // The expiration time of the schedule. The timestamp is an RFC3339 string. + optional string expiration_time = 1 [json_name = "expirationTime"]; + + // The start time of the schedule. The timestamp is an RFC3339 string. + optional string start_time = 2 [json_name = "startTime"]; + + // Specifies the time zone to be used in interpreting Schedule.schedule. The + // value of this field must be a time zone name from the tz database: + // https://wikipedia.org/wiki/Tz_database. + optional string time_zone = 3 [json_name = "timeZone"]; + + // Specifies the schedule for starting instances. + optional ResourcePolicyInstanceSchedulePolicySchedule vm_start_schedule = 4 + [json_name = "vmStartSchedule"]; + + // Specifies the schedule for stopping instances. + optional ResourcePolicyInstanceSchedulePolicySchedule vm_stop_schedule = 5 + [json_name = "vmStopSchedule"]; +} + +// Schedule for an instance operation. +message ResourcePolicyInstanceSchedulePolicySchedule { + // Specifies the frequency for the operation, using the unix-cron format. + optional string schedule = 1 [json_name = "schedule"]; +} + +message ResourcePolicyList { + optional string etag = 1 [json_name = "etag"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 2 [json_name = "id"]; + + // [Output Only] A list of ResourcePolicy resources. + repeated ResourcePolicy items = 3 [json_name = "items"]; + + // [Output Only] Type of resource.Always compute#resourcePoliciesList for + // listsof resourcePolicies + optional string kind = 4 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 5 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +// Contains output only fields. Use this sub-message for all output fields set +// on ResourcePolicy. The internal structure of this "status" field should mimic +// the structure of ResourcePolicy proto specification. +message ResourcePolicyResourceStatus { + // [Output Only] Specifies a set of output values reffering to the + // instance_schedule_policy system status. This field should have the same + // name as corresponding policy field. + optional ResourcePolicyResourceStatusInstanceSchedulePolicyStatus + instance_schedule_policy = 1 [json_name = "instanceSchedulePolicy"]; +} + +message ResourcePolicyResourceStatusInstanceSchedulePolicyStatus { + // [Output Only] The last time the schedule successfully ran. The timestamp is + // an RFC3339 string. + optional string last_run_start_time = 1 [json_name = "lastRunStartTime"]; + + // [Output Only] The next time the schedule is planned to run. The actual time + // might be slightly different. The timestamp is an RFC3339 string. + optional string next_run_start_time = 2 [json_name = "nextRunStartTime"]; +} + +// A snapshot schedule policy specifies when and how frequently snapshots are to +// be created for the target disk. Also specifies how many and how long these +// scheduled snapshots should be retained. +message ResourcePolicySnapshotSchedulePolicy { + // Retention policy applied to snapshots created by this resource policy. + optional ResourcePolicySnapshotSchedulePolicyRetentionPolicy + retention_policy = 1 [json_name = "retentionPolicy"]; + + // A Vm Maintenance Policy specifies what kind of infrastructure maintenance + // we are allowed to perform on this VM and when. Schedule that is applied to + // disks covered by this policy. + optional ResourcePolicySnapshotSchedulePolicySchedule schedule = 2 + [json_name = "schedule"]; + + // Properties with which snapshots are created such as labels, encryption + // keys. + optional ResourcePolicySnapshotSchedulePolicySnapshotProperties + snapshot_properties = 3 [json_name = "snapshotProperties"]; +} + +// Policy for retention of scheduled snapshots. +message ResourcePolicySnapshotSchedulePolicyRetentionPolicy { + // Maximum age of the snapshot that is allowed to be kept. + optional int32 max_retention_days = 1 [json_name = "maxRetentionDays"]; + + // Specifies the behavior to apply to scheduled snapshots when the source disk + // is deleted. + // APPLY_RETENTION_POLICY: + // KEEP_AUTO_SNAPSHOTS: + // UNSPECIFIED_ON_SOURCE_DISK_DELETE: + optional string on_source_disk_delete = 2 [json_name = "onSourceDiskDelete"]; +} + +// A schedule for disks where the schedueled operations are performed. +message ResourcePolicySnapshotSchedulePolicySchedule { + optional ResourcePolicyDailyCycle daily_schedule = 1 + [json_name = "dailySchedule"]; + + optional ResourcePolicyHourlyCycle hourly_schedule = 2 + [json_name = "hourlySchedule"]; + + optional ResourcePolicyWeeklyCycle weekly_schedule = 3 + [json_name = "weeklySchedule"]; +} + +// Specified snapshot properties for scheduled snapshots created by this policy. +message ResourcePolicySnapshotSchedulePolicySnapshotProperties { + // Chain name that the snapshot is created in. + optional string chain_name = 1 [json_name = "chainName"]; + + // Indication to perform a 'guest aware' snapshot. + optional bool guest_flush = 2 [json_name = "guestFlush"]; + + // Labels to apply to scheduled snapshots. These can be later modified by the + // setLabels method. Label values may be empty. + map labels = 3 [json_name = "labels"]; + + // Cloud Storage bucket storage location of the auto snapshot (regional or + // multi-regional). + repeated string storage_locations = 4 [json_name = "storageLocations"]; +} + +// Time window specified for weekly operations. +message ResourcePolicyWeeklyCycle { + // Up to 7 intervals/windows, one for each day of the week. + repeated ResourcePolicyWeeklyCycleDayOfWeek day_of_weeks = 1 + [json_name = "dayOfWeeks"]; +} + +message ResourcePolicyWeeklyCycleDayOfWeek { + // Defines a schedule that runs on specific days of the week. Specify one or + // more days. The following options are available: MONDAY, TUESDAY, WEDNESDAY, + // THURSDAY, FRIDAY, SATURDAY, SUNDAY. + // FRIDAY: + // INVALID: + // MONDAY: + // SATURDAY: + // SUNDAY: + // THURSDAY: + // TUESDAY: + // WEDNESDAY: + optional string day = 1 [json_name = "day"]; + + // [Output only] Duration of the time window, automatically chosen to be + // smallest possible in the given scenario. + optional string duration = 2 [json_name = "duration"]; + + // Time within the window to start the operations. It must be in format + // "HH:MM", where HH : [00-23] and MM : [00-00] GMT. + optional string start_time = 3 [json_name = "startTime"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_107.proto b/protos/google/cloud/compute/v1/internal/common_107.proto index a30856a05abc1..c2e577edd536a 100644 --- a/protos/google/cloud/compute/v1/internal/common_107.proto +++ b/protos/google/cloud/compute/v1/internal/common_107.proto @@ -15,146 +15,132 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_006.proto"; +// Represents a Route resource. A route defines a path from VM instances in the +// VPC network to a specific destination. This destination can be inside or +// outside the VPC network. For more information, read the Routes overview. +message Route { + // [Output Only] AS path. + repeated RouteAsPath as_paths = 1 [json_name = "asPaths"]; -// Contains a list of reservations. -message ReservationAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - // A list of Allocation resources. - map items = 2 [json_name = "items"]; + // An optional description of this resource. Provide this field when you + // create the resource. + optional string description = 3 [json_name = "description"]; - // Type of resource. - optional string kind = 3 [json_name = "kind"]; + // The destination range of outgoing packets that this route applies to. Both + // IPv4 and IPv6 are supported. Must specify an IPv4 range (e.g. 192.0.2.0/24) + // or an IPv6 range in RFC 4291 format (e.g. 2001:db8::/32). IPv6 range will + // be displayed using RFC 5952 compressed format. + optional string dest_range = 4 [json_name = "destRange"]; - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -message ReservationList { // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 1 [json_name = "id"]; - - // [Output Only] A list of Allocation resources. - repeated Reservation items = 2 [json_name = "items"]; - - // [Output Only] Type of resource.Always compute#reservationsList for listsof - // reservations - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { + optional string id = 5 [json_name = "id"]; + + // [Output Only] Type of this resource. Always compute#routes for Route + // resources. + optional string kind = 6 [json_name = "kind"]; + + // 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])?`. The first character must be a + // lowercase letter, and all following characters (except for the last + // character) must be a dash, lowercase letter, or digit. The last character + // must be a lowercase letter or digit. + optional string name = 7 [json_name = "name"]; + + // Fully-qualified URL of the network that this route applies to. + optional string network = 8 [json_name = "network"]; + + // The URL to a gateway that should handle matching packets. You can only + // specify the internet gateway using a full or partial valid URL: projects/ + // project/global/gateways/default-internet-gateway + optional string next_hop_gateway = 9 [json_name = "nextHopGateway"]; + + // [Output Only] The full resource name of the Network Connectivity Center hub + // that will handle matching packets. + optional string next_hop_hub = 22 [json_name = "nextHopHub"]; + + // The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that + // should handle matching packets or the IP address of the forwarding Rule. + // For example, the following are all valid URLs: - + // https://www.googleapis.com/compute/v1/projects/project/regions/region + // /forwardingRules/forwardingRule - + // regions/region/forwardingRules/forwardingRule If an IP address is provided, + // must specify an IPv4 address in dot-decimal notation or an IPv6 address in + // RFC 4291 format. For example, the following are all valid IP addresses: - + // 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses + // will be displayed using RFC 5952 compressed format (e.g. + // 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. + optional string next_hop_ilb = 10 [json_name = "nextHopIlb"]; + + // The URL to an instance that should handle matching packets. You can specify + // this as a full or partial URL. For example: + // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ + optional string next_hop_instance = 11 [json_name = "nextHopInstance"]; + + // The network IP address of an instance that should handle matching packets. + // Both IPv6 address and IPv4 addresses are supported. Must specify an IPv4 + // address in dot-decimal notation (e.g. 192.0.2.99) or an IPv6 address in RFC + // 4291 format (e.g. 2001:db8::2d9:51:0:0 or 2001:db8:0:0:2d9:51:0:0). IPv6 + // addresses will be displayed using RFC 5952 compressed format (e.g. + // 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. + optional string next_hop_ip = 12 [json_name = "nextHopIp"]; + + // The URL of the local network if it should handle matching packets. + optional string next_hop_network = 13 [json_name = "nextHopNetwork"]; + + // [Output Only] The network peering name that should handle matching packets, + // which should conform to RFC1035. + optional string next_hop_peering = 14 [json_name = "nextHopPeering"]; + + // The URL to a VpnTunnel that should handle matching packets. + optional string next_hop_vpn_tunnel = 15 [json_name = "nextHopVpnTunnel"]; + + // The priority of this route. Priority is used to break ties in cases where + // there is more than one matching route of equal prefix length. In cases + // where multiple routes have equal prefix length, the one with the + // lowest-numbered priority value wins. The default value is `1000`. The + // priority value must be from `0` to `65535`, inclusive. + optional uint32 priority = 16 [json_name = "priority"]; + + // [Output only] The status of the route. + // ACTIVE: This route is processed and active. + // DROPPED: The route is dropped due to the VPC exceeding the dynamic route + // limit. For dynamic route limit, please refer to the Learned route example + // INACTIVE: This route is processed but inactive due to failure from the + // backend. The backend may have rejected the route + // PENDING: This route is being processed internally. The status will change + // once processed. + optional string route_status = 17 [json_name = "routeStatus"]; + + // [Output Only] The type of this route, which can be one of the following + // values: - 'TRANSIT' for a transit route that this router learned from + // another Cloud Router and will readvertise to one of its BGP peers - + // 'SUBNET' for a route from a subnet of the VPC - 'BGP' for a route learned + // from a BGP peer of this router - 'STATIC' for a static route + // BGP: + // STATIC: + // SUBNET: + // TRANSIT: + optional string route_type = 18 [json_name = "routeType"]; + + // [Output Only] Server-defined fully-qualified URL for this resource. + optional string self_link = 19 [json_name = "selfLink"]; + + // A list of instance tags to which this route applies. + repeated string tags = 20 [json_name = "tags"]; + + message WarningsItem { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by @@ -235,102 +221,25 @@ message ReservationList { optional string message = 3 [json_name = "message"]; } - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + // [Output Only] If potential misconfigurations are detected for this route, + // this field will be populated with warning messages. + repeated WarningsItem warnings = 21 [json_name = "warnings"]; } -message ReservationsResizeRequest { - // Number of allocated resources can be resized with minimum = 1 and maximum = - // 1000. - optional string specific_sku_count = 1 [json_name = "specificSkuCount"]; -} - -message ReservationsScopedList { - // A list of reservations contained in this scope. - repeated Reservation reservations = 1 [json_name = "reservations"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of reservations when the list - // is empty. - optional Warning warning = 2 [json_name = "warning"]; +message RouteAsPath { + // [Output Only] The AS numbers of the AS Path. + repeated uint32 as_lists = 1 [json_name = "asLists"]; + + // [Output Only] The type of the AS Path, which can be one of the following + // values: - 'AS_SET': unordered set of autonomous systems that the route in + // has traversed - 'AS_SEQUENCE': ordered set of autonomous systems that the + // route has traversed - 'AS_CONFED_SEQUENCE': ordered set of Member + // Autonomous Systems in the local confederation that the route has traversed + // - 'AS_CONFED_SET': unordered set of Member Autonomous Systems in the local + // confederation that the route has traversed + // AS_CONFED_SEQUENCE: + // AS_CONFED_SET: + // AS_SEQUENCE: + // AS_SET: + optional string path_segment_type = 2 [json_name = "pathSegmentType"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_108.proto b/protos/google/cloud/compute/v1/internal/common_108.proto index 49bd2a2c3b02f..fa8e673adb3e5 100644 --- a/protos/google/cloud/compute/v1/internal/common_108.proto +++ b/protos/google/cloud/compute/v1/internal/common_108.proto @@ -15,189 +15,34 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message ResourcePoliciesScopedList { - // A list of resourcePolicies contained in this scope. - repeated ResourcePolicy resource_policies = 1 - [json_name = "resourcePolicies"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of resourcePolicies when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} - -// Represents a Resource Policy resource. You can use resource policies to -// schedule actions for some Compute Engine resources. For example, you can use -// them to schedule persistent disk snapshots. -message ResourcePolicy { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - optional string description = 2 [json_name = "description"]; - - // Resource policy for disk consistency groups. - optional ResourcePolicyDiskConsistencyGroupPolicy - disk_consistency_group_policy = 13 - [json_name = "diskConsistencyGroupPolicy"]; - - // Resource policy for instances for placement configuration. - optional ResourcePolicyGroupPlacementPolicy group_placement_policy = 3 - [json_name = "groupPlacementPolicy"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 4 [json_name = "id"]; - - // Resource policy for scheduling instance operations. - optional ResourcePolicyInstanceSchedulePolicy instance_schedule_policy = 5 - [json_name = "instanceSchedulePolicy"]; - - // [Output Only] Type of the resource. Always compute#resource_policies for - // resource policies. - optional string kind = 6 [json_name = "kind"]; - - // The name of the resource, provided by the client when initially creating - // the resource. The resource name must be 1-63 characters long, and comply - // with RFC1035. Specifically, the name must be 1-63 characters long and match - // the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first - // character must be a lowercase letter, and all following characters must be - // a dash, lowercase letter, or digit, except the last character, which cannot - // be a dash. - optional string name = 7 [json_name = "name"]; - - optional string region = 8 [json_name = "region"]; - - // [Output Only] The system status of the resource policy. - optional ResourcePolicyResourceStatus resource_status = 9 - [json_name = "resourceStatus"]; - - // [Output Only] Server-defined fully-qualified URL for this resource. - optional string self_link = 10 [json_name = "selfLink"]; - - // Resource policy for persistent disks for creating snapshots. - optional ResourcePolicySnapshotSchedulePolicy snapshot_schedule_policy = 11 - [json_name = "snapshotSchedulePolicy"]; - - // [Output Only] The status of resource policy creation. - // CREATING: Resource policy is being created. - // DELETING: Resource policy is being deleted. - // EXPIRED: Resource policy is expired and will not run again. - // INVALID: - // READY: Resource policy is ready to be used. - optional string status = 12 [json_name = "status"]; -} - -// Contains a list of resourcePolicies. -message ResourcePolicyAggregatedList { - optional string etag = 1 [json_name = "etag"]; +import "google/cloud/compute/v1/internal/common_107.proto"; +// Contains a list of Route resources. +message RouteList { // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 2 [json_name = "id"]; + optional string id = 1 [json_name = "id"]; - // A list of ResourcePolicy resources. - map items = 3 [json_name = "items"]; + // A list of Route resources. + repeated Route items = 2 [json_name = "items"]; // Type of resource. - optional string kind = 4 [json_name = "kind"]; + optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for // list requests. If the number of results is larger than maxResults, use the // nextPageToken as a value for the query parameter pageToken in the next list // request. Subsequent list requests will have their own nextPageToken to // continue paging through the results. - optional string next_page_token = 5 [json_name = "nextPageToken"]; + optional string next_page_token = 4 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. - optional string self_link = 6 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 7 [json_name = "unreachables"]; + optional string self_link = 5 [json_name = "selfLink"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -281,310 +126,5 @@ message ResourcePolicyAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; -} - -// Time window specified for daily operations. -message ResourcePolicyDailyCycle { - // Defines a schedule with units measured in days. The value determines how - // many days pass between the start of each cycle. - optional int32 days_in_cycle = 1 [json_name = "daysInCycle"]; - - // [Output only] A predetermined duration for the window, automatically chosen - // to be the smallest possible in the given scenario. - optional string duration = 2 [json_name = "duration"]; - - // Start time of the window. This must be in UTC format that resolves to one - // of 00:00, 04:00, 08:00, 12:00, 16:00, or 20:00. For example, both 13:00-5 - // and 08:00 are valid. - optional string start_time = 3 [json_name = "startTime"]; -} - -// Resource policy for disk consistency groups. -message ResourcePolicyDiskConsistencyGroupPolicy {} - -// A GroupPlacementPolicy specifies resource placement configuration. It -// specifies the failure bucket separation -message ResourcePolicyGroupPlacementPolicy { - // The number of availability domains to spread instances across. If two - // instances are in different availability domain, they are not in the same - // low latency network. - optional int32 availability_domain_count = 1 - [json_name = "availabilityDomainCount"]; - - // Specifies network collocation - // COLLOCATED: - // UNSPECIFIED_COLLOCATION: - optional string collocation = 2 [json_name = "collocation"]; - - // Number of VMs in this placement group. Google does not recommend that you - // use this field unless you use a compact policy and you want your policy to - // work only if it contains this exact number of VMs. - optional int32 vm_count = 3 [json_name = "vmCount"]; -} - -// Time window specified for hourly operations. -message ResourcePolicyHourlyCycle { - // [Output only] Duration of the time window, automatically chosen to be - // smallest possible in the given scenario. - optional string duration = 1 [json_name = "duration"]; - - // Defines a schedule with units measured in hours. The value determines how - // many hours pass between the start of each cycle. - optional int32 hours_in_cycle = 2 [json_name = "hoursInCycle"]; - - // Time within the window to start the operations. It must be in format - // "HH:MM", where HH : [00-23] and MM : [00-00] GMT. - optional string start_time = 3 [json_name = "startTime"]; -} - -// An InstanceSchedulePolicy specifies when and how frequent certain operations -// are performed on the instance. -message ResourcePolicyInstanceSchedulePolicy { - // The expiration time of the schedule. The timestamp is an RFC3339 string. - optional string expiration_time = 1 [json_name = "expirationTime"]; - - // The start time of the schedule. The timestamp is an RFC3339 string. - optional string start_time = 2 [json_name = "startTime"]; - - // Specifies the time zone to be used in interpreting Schedule.schedule. The - // value of this field must be a time zone name from the tz database: - // https://wikipedia.org/wiki/Tz_database. - optional string time_zone = 3 [json_name = "timeZone"]; - - // Specifies the schedule for starting instances. - optional ResourcePolicyInstanceSchedulePolicySchedule vm_start_schedule = 4 - [json_name = "vmStartSchedule"]; - - // Specifies the schedule for stopping instances. - optional ResourcePolicyInstanceSchedulePolicySchedule vm_stop_schedule = 5 - [json_name = "vmStopSchedule"]; -} - -// Schedule for an instance operation. -message ResourcePolicyInstanceSchedulePolicySchedule { - // Specifies the frequency for the operation, using the unix-cron format. - optional string schedule = 1 [json_name = "schedule"]; -} - -message ResourcePolicyList { - optional string etag = 1 [json_name = "etag"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 2 [json_name = "id"]; - - // [Output Only] A list of ResourcePolicy resources. - repeated ResourcePolicy items = 3 [json_name = "items"]; - - // [Output Only] Type of resource.Always compute#resourcePoliciesList for - // listsof resourcePolicies - optional string kind = 4 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 5 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 6 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -// Contains output only fields. Use this sub-message for all output fields set -// on ResourcePolicy. The internal structure of this "status" field should mimic -// the structure of ResourcePolicy proto specification. -message ResourcePolicyResourceStatus { - // [Output Only] Specifies a set of output values reffering to the - // instance_schedule_policy system status. This field should have the same - // name as corresponding policy field. - optional ResourcePolicyResourceStatusInstanceSchedulePolicyStatus - instance_schedule_policy = 1 [json_name = "instanceSchedulePolicy"]; -} - -message ResourcePolicyResourceStatusInstanceSchedulePolicyStatus { - // [Output Only] The last time the schedule successfully ran. The timestamp is - // an RFC3339 string. - optional string last_run_start_time = 1 [json_name = "lastRunStartTime"]; - - // [Output Only] The next time the schedule is planned to run. The actual time - // might be slightly different. The timestamp is an RFC3339 string. - optional string next_run_start_time = 2 [json_name = "nextRunStartTime"]; -} - -// A snapshot schedule policy specifies when and how frequently snapshots are to -// be created for the target disk. Also specifies how many and how long these -// scheduled snapshots should be retained. -message ResourcePolicySnapshotSchedulePolicy { - // Retention policy applied to snapshots created by this resource policy. - optional ResourcePolicySnapshotSchedulePolicyRetentionPolicy - retention_policy = 1 [json_name = "retentionPolicy"]; - - // A Vm Maintenance Policy specifies what kind of infrastructure maintenance - // we are allowed to perform on this VM and when. Schedule that is applied to - // disks covered by this policy. - optional ResourcePolicySnapshotSchedulePolicySchedule schedule = 2 - [json_name = "schedule"]; - - // Properties with which snapshots are created such as labels, encryption - // keys. - optional ResourcePolicySnapshotSchedulePolicySnapshotProperties - snapshot_properties = 3 [json_name = "snapshotProperties"]; -} - -// Policy for retention of scheduled snapshots. -message ResourcePolicySnapshotSchedulePolicyRetentionPolicy { - // Maximum age of the snapshot that is allowed to be kept. - optional int32 max_retention_days = 1 [json_name = "maxRetentionDays"]; - - // Specifies the behavior to apply to scheduled snapshots when the source disk - // is deleted. - // APPLY_RETENTION_POLICY: - // KEEP_AUTO_SNAPSHOTS: - // UNSPECIFIED_ON_SOURCE_DISK_DELETE: - optional string on_source_disk_delete = 2 [json_name = "onSourceDiskDelete"]; -} - -// A schedule for disks where the schedueled operations are performed. -message ResourcePolicySnapshotSchedulePolicySchedule { - optional ResourcePolicyDailyCycle daily_schedule = 1 - [json_name = "dailySchedule"]; - - optional ResourcePolicyHourlyCycle hourly_schedule = 2 - [json_name = "hourlySchedule"]; - - optional ResourcePolicyWeeklyCycle weekly_schedule = 3 - [json_name = "weeklySchedule"]; -} - -// Specified snapshot properties for scheduled snapshots created by this policy. -message ResourcePolicySnapshotSchedulePolicySnapshotProperties { - // Chain name that the snapshot is created in. - optional string chain_name = 1 [json_name = "chainName"]; - - // Indication to perform a 'guest aware' snapshot. - optional bool guest_flush = 2 [json_name = "guestFlush"]; - - // Labels to apply to scheduled snapshots. These can be later modified by the - // setLabels method. Label values may be empty. - map labels = 3 [json_name = "labels"]; - - // Cloud Storage bucket storage location of the auto snapshot (regional or - // multi-regional). - repeated string storage_locations = 4 [json_name = "storageLocations"]; -} - -// Time window specified for weekly operations. -message ResourcePolicyWeeklyCycle { - // Up to 7 intervals/windows, one for each day of the week. - repeated ResourcePolicyWeeklyCycleDayOfWeek day_of_weeks = 1 - [json_name = "dayOfWeeks"]; -} - -message ResourcePolicyWeeklyCycleDayOfWeek { - // Defines a schedule that runs on specific days of the week. Specify one or - // more days. The following options are available: MONDAY, TUESDAY, WEDNESDAY, - // THURSDAY, FRIDAY, SATURDAY, SUNDAY. - // FRIDAY: - // INVALID: - // MONDAY: - // SATURDAY: - // SUNDAY: - // THURSDAY: - // TUESDAY: - // WEDNESDAY: - optional string day = 1 [json_name = "day"]; - - // [Output only] Duration of the time window, automatically chosen to be - // smallest possible in the given scenario. - optional string duration = 2 [json_name = "duration"]; - - // Time within the window to start the operations. It must be in format - // "HH:MM", where HH : [00-23] and MM : [00-00] GMT. - optional string start_time = 3 [json_name = "startTime"]; + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_109.proto b/protos/google/cloud/compute/v1/internal/common_109.proto index 26ba3a88ccf1f..e324a5ed5d3e6 100644 --- a/protos/google/cloud/compute/v1/internal/common_109.proto +++ b/protos/google/cloud/compute/v1/internal/common_109.proto @@ -15,132 +15,260 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Route resource. A route defines a path from VM instances in the -// VPC network to a specific destination. This destination can be inside or -// outside the VPC network. For more information, read the Routes overview. -message Route { - // [Output Only] AS path. - repeated RouteAsPath as_paths = 1 [json_name = "asPaths"]; +import "google/cloud/compute/v1/internal/common_031.proto"; + +// Represents a Google Cloud Armor security policy resource. Only external +// backend services that use load balancers can reference a security policy. For +// more information, see Google Cloud Armor security policy overview. +message SecurityPolicy { + optional SecurityPolicyAdaptiveProtectionConfig adaptive_protection_config = 1 + [json_name = "adaptiveProtectionConfig"]; + + optional SecurityPolicyAdvancedOptionsConfig advanced_options_config = 2 + [json_name = "advancedOptionsConfig"]; // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + + optional SecurityPolicyDdosProtectionConfig ddos_protection_config = 4 + [json_name = "ddosProtectionConfig"]; - // An optional description of this resource. Provide this field when you + // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 3 [json_name = "description"]; + optional string description = 5 [json_name = "description"]; - // The destination range of outgoing packets that this route applies to. Both - // IPv4 and IPv6 are supported. Must specify an IPv4 range (e.g. 192.0.2.0/24) - // or an IPv6 range in RFC 4291 format (e.g. 2001:db8::/32). IPv6 range will - // be displayed using RFC 5952 compressed format. - optional string dest_range = 4 [json_name = "destRange"]; + // Specifies a fingerprint for this resource, which is essentially a hash of + // the metadata's contents and used for optimistic locking. The fingerprint is + // initially generated by Compute Engine and changes after every request to + // modify or update metadata. You must always provide an up-to-date + // fingerprint hash in order to update or change metadata, otherwise the + // request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make get() request to the security policy. + optional string fingerprint = 6 [json_name = "fingerprint"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 5 [json_name = "id"]; + optional string id = 7 [json_name = "id"]; - // [Output Only] Type of this resource. Always compute#routes for Route - // resources. - optional string kind = 6 [json_name = "kind"]; + // [Output only] Type of the resource. Always compute#securityPolicyfor + // security policies + optional string kind = 8 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this security policy, which + // is essentially a hash of the labels set used for optimistic locking. The + // fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels. To see the + // latest fingerprint, make get() request to the security policy. + optional string label_fingerprint = 15 [json_name = "labelFingerprint"]; + + // Labels for this resource. These can only be added or modified by the + // setLabels method. Each label key/value pair must comply with RFC1035. Label + // values may be empty. + map labels = 16 [json_name = "labels"]; // 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])?`. The first character must be a - // lowercase letter, and all following characters (except for the last - // character) must be a dash, lowercase letter, or digit. The last character - // must be a lowercase letter or digit. - optional string name = 7 [json_name = "name"]; - - // Fully-qualified URL of the network that this route applies to. - optional string network = 8 [json_name = "network"]; - - // The URL to a gateway that should handle matching packets. You can only - // specify the internet gateway using a full or partial valid URL: projects/ - // project/global/gateways/default-internet-gateway - optional string next_hop_gateway = 9 [json_name = "nextHopGateway"]; - - // [Output Only] The full resource name of the Network Connectivity Center hub - // that will handle matching packets. - optional string next_hop_hub = 22 [json_name = "nextHopHub"]; - - // The URL to a forwarding rule of type loadBalancingScheme=INTERNAL that - // should handle matching packets or the IP address of the forwarding Rule. - // For example, the following are all valid URLs: - - // https://www.googleapis.com/compute/v1/projects/project/regions/region - // /forwardingRules/forwardingRule - - // regions/region/forwardingRules/forwardingRule If an IP address is provided, - // must specify an IPv4 address in dot-decimal notation or an IPv6 address in - // RFC 4291 format. For example, the following are all valid IP addresses: - - // 10.128.0.56 - 2001:db8::2d9:51:0:0 - 2001:db8:0:0:2d9:51:0:0 IPv6 addresses - // will be displayed using RFC 5952 compressed format (e.g. - // 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. - optional string next_hop_ilb = 10 [json_name = "nextHopIlb"]; - - // The URL to an instance that should handle matching packets. You can specify - // this as a full or partial URL. For example: - // https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/ - optional string next_hop_instance = 11 [json_name = "nextHopInstance"]; - - // The network IP address of an instance that should handle matching packets. - // Both IPv6 address and IPv4 addresses are supported. Must specify an IPv4 - // address in dot-decimal notation (e.g. 192.0.2.99) or an IPv6 address in RFC - // 4291 format (e.g. 2001:db8::2d9:51:0:0 or 2001:db8:0:0:2d9:51:0:0). IPv6 - // addresses will be displayed using RFC 5952 compressed format (e.g. - // 2001:db8::2d9:51:0:0). Should never be an IPv4-mapped IPv6 address. - optional string next_hop_ip = 12 [json_name = "nextHopIp"]; - - // The URL of the local network if it should handle matching packets. - optional string next_hop_network = 13 [json_name = "nextHopNetwork"]; - - // [Output Only] The network peering name that should handle matching packets, - // which should conform to RFC1035. - optional string next_hop_peering = 14 [json_name = "nextHopPeering"]; - - // The URL to a VpnTunnel that should handle matching packets. - optional string next_hop_vpn_tunnel = 15 [json_name = "nextHopVpnTunnel"]; - - // The priority of this route. Priority is used to break ties in cases where - // there is more than one matching route of equal prefix length. In cases - // where multiple routes have equal prefix length, the one with the - // lowest-numbered priority value wins. The default value is `1000`. The - // priority value must be from `0` to `65535`, inclusive. - optional uint32 priority = 16 [json_name = "priority"]; - - // [Output only] The status of the route. - // ACTIVE: This route is processed and active. - // DROPPED: The route is dropped due to the VPC exceeding the dynamic route - // limit. For dynamic route limit, please refer to the Learned route example - // INACTIVE: This route is processed but inactive due to failure from the - // backend. The backend may have rejected the route - // PENDING: This route is being processed internally. The status will change - // once processed. - optional string route_status = 17 [json_name = "routeStatus"]; - - // [Output Only] The type of this route, which can be one of the following - // values: - 'TRANSIT' for a transit route that this router learned from - // another Cloud Router and will readvertise to one of its BGP peers - - // 'SUBNET' for a route from a subnet of the VPC - 'BGP' for a route learned - // from a BGP peer of this router - 'STATIC' for a static route - // BGP: - // STATIC: - // SUBNET: - // TRANSIT: - optional string route_type = 18 [json_name = "routeType"]; - - // [Output Only] Server-defined fully-qualified URL for this resource. - optional string self_link = 19 [json_name = "selfLink"]; - - // A list of instance tags to which this route applies. - repeated string tags = 20 [json_name = "tags"]; - - message WarningsItem { + // 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. + optional string name = 9 [json_name = "name"]; + + optional SecurityPolicyRecaptchaOptionsConfig recaptcha_options_config = 10 + [json_name = "recaptchaOptionsConfig"]; + + // [Output Only] URL of the region where the regional security policy resides. + // This field is not applicable to global security policies. + optional string region = 11 [json_name = "region"]; + + // A list of rules that belong to this policy. There must always be a default + // rule which is a rule with priority 2147483647 and match all condition (for + // the match condition this means match "*" for srcIpRanges and for the + // networkMatch condition every field must be either match "*" or not set). If + // no rules are provided when creating a security policy, a default rule with + // action "allow" will be added. + repeated SecurityPolicyRule rules = 12 [json_name = "rules"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 13 [json_name = "selfLink"]; + + // The type indicates the intended use of the security policy. - CLOUD_ARMOR: + // Cloud Armor backend security policies can be configured to filter incoming + // HTTP requests targeting backend services. They filter requests before they + // hit the origin servers. - CLOUD_ARMOR_EDGE: Cloud Armor edge security + // policies can be configured to filter incoming HTTP requests targeting + // backend services (including Cloud CDN-enabled) as well as backend buckets + // (Cloud Storage). They filter requests before the request is served from + // Google's cache. - CLOUD_ARMOR_INTERNAL_SERVICE: Cloud Armor internal + // service policies can be configured to filter HTTP requests targeting + // services managed by Traffic Director in a service mesh. They filter + // requests before the request is served from the application. - + // CLOUD_ARMOR_NETWORK: Cloud Armor network policies can be configured to + // filter packets targeting network load balancing resources such as backend + // services, target pools, target instances, and instances with external IPs. + // They filter requests before the request is served from the application. + // This field can be set only at resource creation time. + // CLOUD_ARMOR: + // CLOUD_ARMOR_EDGE: + // CLOUD_ARMOR_NETWORK: + optional string type = 14 [json_name = "type"]; + + // Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A + // user-defined field consists of up to 4 bytes extracted from a fixed offset + // in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an + // optional mask to select certain bits. Rules may then specify matching + // values for these fields. Example: userDefinedFields: - name: + // "ipv4_fragment_offset" base: IPV4 offset: 6 size: 2 mask: "0x1fff" + repeated SecurityPolicyUserDefinedField user_defined_fields = 17 + [json_name = "userDefinedFields"]; +} + +// Configuration options for Cloud Armor Adaptive Protection (CAAP). +message SecurityPolicyAdaptiveProtectionConfig { + // If set to true, enables Cloud Armor Machine Learning. + optional SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig + layer7_ddos_defense_config = 1 [json_name = "layer7DdosDefenseConfig"]; +} + +// Configuration options for L7 DDoS detection. This field is only supported in +// Global Security Policies of type CLOUD_ARMOR. +message SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig { + // If set to true, enables CAAP for L7 DDoS detection. This field is only + // supported in Global Security Policies of type CLOUD_ARMOR. + optional bool enable = 1 [json_name = "enable"]; + + // Rule visibility can be one of the following: STANDARD - opaque rules. + // (default) PREMIUM - transparent rules. This field is only supported in + // Global Security Policies of type CLOUD_ARMOR. + // PREMIUM: + // STANDARD: + optional string rule_visibility = 2 [json_name = "ruleVisibility"]; + + // Configuration options for layer7 adaptive protection for various + // customizable thresholds. + repeated + SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig + threshold_configs = 3 [json_name = "thresholdConfigs"]; +} + +message +SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig { + optional float auto_deploy_confidence_threshold = 1 + [json_name = "autoDeployConfidenceThreshold"]; + + optional int32 auto_deploy_expiration_sec = 2 + [json_name = "autoDeployExpirationSec"]; + + optional float auto_deploy_impacted_baseline_threshold = 3 + [json_name = "autoDeployImpactedBaselineThreshold"]; + + optional float auto_deploy_load_threshold = 4 + [json_name = "autoDeployLoadThreshold"]; + + optional float detection_absolute_qps = 6 + [json_name = "detectionAbsoluteQps"]; + + optional float detection_load_threshold = 7 + [json_name = "detectionLoadThreshold"]; + + optional float detection_relative_to_baseline_qps = 8 + [json_name = "detectionRelativeToBaselineQps"]; + + // The name must be 1-63 characters long, and comply with RFC1035. The name + // must be unique within the security policy. + optional string name = 5 [json_name = "name"]; + + // Configuration options for enabling Adaptive Protection to operate on + // specified granular traffic units. + repeated + SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig + traffic_granularity_configs = 9 + [json_name = "trafficGranularityConfigs"]; +} + +// Configurations to specifc granular traffic units processed by Adaptive +// Protection. +message +SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig { + // If enabled, traffic matching each unique value for the specified type + // constitutes a separate traffic unit. It can only be set to true if `value` + // is empty. + optional bool enable_each_unique_value = 1 + [json_name = "enableEachUniqueValue"]; + + // Type of this configuration. + // HTTP_HEADER_HOST: + // HTTP_PATH: + // UNSPECIFIED_TYPE: + optional string type = 2 [json_name = "type"]; + + // Requests that match this value constitute a granular traffic unit. + optional string value = 3 [json_name = "value"]; +} + +message SecurityPolicyAdvancedOptionsConfig { + // Custom configuration to apply the JSON parsing. Only applicable when + // json_parsing is set to STANDARD. + optional SecurityPolicyAdvancedOptionsConfigJsonCustomConfig + json_custom_config = 1 [json_name = "jsonCustomConfig"]; + + // DISABLED: + // STANDARD: + // STANDARD_WITH_GRAPHQL: + optional string json_parsing = 2 [json_name = "jsonParsing"]; + + // NORMAL: + // VERBOSE: + optional string log_level = 3 [json_name = "logLevel"]; + + // An optional list of case-insensitive request header names to use for + // resolving the callers client IP address. + repeated string user_ip_request_headers = 4 + [json_name = "userIpRequestHeaders"]; +} + +message SecurityPolicyAdvancedOptionsConfigJsonCustomConfig { + // A list of custom Content-Type header values to apply the JSON parsing. As + // per RFC 1341, a Content-Type header value has the following format: + // Content-Type := type "/" subtype *[";" parameter] When configuring a custom + // Content-Type header value, only the type/subtype needs to be specified, and + // the parameters should be excluded. + repeated string content_types = 1 [json_name = "contentTypes"]; +} + +message SecurityPolicyDdosProtectionConfig { + // ADVANCED: + // STANDARD: + optional string ddos_protection = 1 [json_name = "ddosProtection"]; +} + +message SecurityPolicyList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of SecurityPolicy resources. + repeated SecurityPolicy items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#securityPolicyList for + // listsof securityPolicies + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by @@ -221,25 +349,458 @@ message Route { optional string message = 3 [json_name = "message"]; } - // [Output Only] If potential misconfigurations are detected for this route, - // this field will be populated with warning messages. - repeated WarningsItem warnings = 21 [json_name = "warnings"]; -} - -message RouteAsPath { - // [Output Only] The AS numbers of the AS Path. - repeated uint32 as_lists = 1 [json_name = "asLists"]; - - // [Output Only] The type of the AS Path, which can be one of the following - // values: - 'AS_SET': unordered set of autonomous systems that the route in - // has traversed - 'AS_SEQUENCE': ordered set of autonomous systems that the - // route has traversed - 'AS_CONFED_SEQUENCE': ordered set of Member - // Autonomous Systems in the local confederation that the route has traversed - // - 'AS_CONFED_SET': unordered set of Member Autonomous Systems in the local - // confederation that the route has traversed - // AS_CONFED_SEQUENCE: - // AS_CONFED_SET: - // AS_SEQUENCE: - // AS_SET: - optional string path_segment_type = 2 [json_name = "pathSegmentType"]; + // [Output Only] Informational warning message. + optional Warning warning = 5 [json_name = "warning"]; +} + +message SecurityPolicyRecaptchaOptionsConfig { + // An optional field to supply a reCAPTCHA site key to be used for all the + // rules using the redirect action with the type of GOOGLE_RECAPTCHA under the + // security policy. The specified site key needs to be created from the + // reCAPTCHA API. The user is responsible for the validity of the specified + // site key. If not specified, a Google-managed site key is used. This field + // is only supported in Global Security Policies of type CLOUD_ARMOR. + optional string redirect_site_key = 1 [json_name = "redirectSiteKey"]; +} + +// Represents a rule that describes one or more match conditions along with the +// action to be taken when traffic matches this condition (allow or deny). +message SecurityPolicyRule { + // The Action to perform when the rule is matched. The following are the valid + // actions: - allow: allow access to target. - deny(STATUS): deny access to + // target, returns the HTTP response code specified. Valid values for `STATUS` + // are 403, 404, and 502. - rate_based_ban: limit client traffic to the + // configured threshold and ban the client if the traffic exceeds the + // threshold. Configure parameters for this action in RateLimitOptions. + // Requires rate_limit_options to be set. - redirect: redirect to a different + // target. This can either be an internal reCAPTCHA redirect, or an external + // URL-based redirect via a 302 response. Parameters for this action can be + // configured via redirectOptions. This action is only supported in Global + // Security Policies of type CLOUD_ARMOR. - throttle: limit client traffic to + // the configured threshold. Configure parameters for this action in + // rateLimitOptions. Requires rate_limit_options to be set for this. + optional string action = 1 [json_name = "action"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; + + // Optional, additional actions that are performed on headers. This field is + // only supported in Global Security Policies of type CLOUD_ARMOR. + optional SecurityPolicyRuleHttpHeaderAction header_action = 3 + [json_name = "headerAction"]; + + // [Output only] Type of the resource. Always compute#securityPolicyRule for + // security policy rules + optional string kind = 4 [json_name = "kind"]; + + // A match condition that incoming traffic is evaluated against. If it + // evaluates to true, the corresponding 'action' is enforced. + optional SecurityPolicyRuleMatcher match = 5 [json_name = "match"]; + + // A match condition that incoming packets are evaluated against for + // CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding + // 'action' is enforced. The match criteria for a rule consists of built-in + // match fields (like 'srcIpRanges') and potentially multiple user-defined + // match fields ('userDefinedFields'). Field values may be extracted directly + // from the packet or derived from it (e.g. 'srcRegionCodes'). Some fields may + // not be present in every packet (e.g. 'srcPorts'). A user-defined field is + // only present if the base header is found in the packet and the entire field + // is in bounds. Each match field may specify which values can match it, + // listing one or more ranges, prefixes, or exact values that are considered a + // match for the field. A field value must be present in order to match a + // specified match field. If no match values are specified for a match field, + // then any field value is considered to match it, and it's not required to be + // present. For strings specifying '*' is also equivalent to match all. For a + // packet to match a rule, all specified match fields must match the + // corresponding field values derived from the packet. Example: networkMatch: + // srcIpRanges: - "192.0.2.0/24" - "198.51.100.0/24" userDefinedFields: - + // name: "ipv4_fragment_offset" values: - "1-0x1fff" The above match condition + // matches packets with a source IP in 192.0.2.0/24 or 198.51.100.0/24 and a + // user-defined field named "ipv4_fragment_offset" with a value between 1 and + // 0x1fff inclusive. + optional SecurityPolicyRuleNetworkMatcher network_match = 11 + [json_name = "networkMatch"]; + + // Preconfigured WAF configuration to be applied for the rule. If the rule + // does not evaluate preconfigured WAF rules, i.e., if + // evaluatePreconfiguredWaf() is not used, this field will have no effect. + optional SecurityPolicyRulePreconfiguredWafConfig preconfigured_waf_config = 6 + [json_name = "preconfiguredWafConfig"]; + + // If set to true, the specified action is not enforced. + optional bool preview = 7 [json_name = "preview"]; + + // An integer indicating the priority of a rule in the list. The priority must + // be a positive value between 0 and 2147483647. Rules are evaluated from + // highest to lowest priority where 0 is the highest priority and 2147483647 + // is the lowest priority. + optional int32 priority = 8 [json_name = "priority"]; + + // Must be specified if the action is "rate_based_ban" or "throttle". Cannot + // be specified for any other actions. + optional SecurityPolicyRuleRateLimitOptions rate_limit_options = 9 + [json_name = "rateLimitOptions"]; + + // Parameters defining the redirect action. Cannot be specified for any other + // actions. This field is only supported in Global Security Policies of type + // CLOUD_ARMOR. + optional SecurityPolicyRuleRedirectOptions redirect_options = 10 + [json_name = "redirectOptions"]; +} + +message SecurityPolicyRuleHttpHeaderAction { + // The list of request headers to add or overwrite if they're already present. + repeated SecurityPolicyRuleHttpHeaderActionHttpHeaderOption + request_headers_to_adds = 1 [json_name = "requestHeadersToAdds"]; +} + +message SecurityPolicyRuleHttpHeaderActionHttpHeaderOption { + // The name of the header to set. + optional string header_name = 1 [json_name = "headerName"]; + + // The value to set the named header to. + optional string header_value = 2 [json_name = "headerValue"]; +} + +// Represents a match condition that incoming traffic is evaluated against. +// Exactly one field must be specified. +message SecurityPolicyRuleMatcher { + // The configuration options available when specifying versioned_expr. This + // field must be specified if versioned_expr is specified and cannot be + // specified if versioned_expr is not specified. + optional SecurityPolicyRuleMatcherConfig config = 1 [json_name = "config"]; + + // User defined CEVAL expression. A CEVAL expression is used to specify match + // criteria such as origin.ip, source.region_code and contents in the request + // header. Expressions containing `evaluateThreatIntelligence` require Cloud + // Armor Managed Protection Plus tier and are not supported in Edge Policies + // nor in Regional Policies. Expressions containing + // `evaluatePreconfiguredExpr('sourceiplist-*')` require Cloud Armor Managed + // Protection Plus tier and are only supported in Global Security Policies. + optional Expr expr = 2 [json_name = "expr"]; + + // The configuration options available when specifying a user defined CEVAL + // expression (i.e., 'expr'). + optional SecurityPolicyRuleMatcherExprOptions expr_options = 4 + [json_name = "exprOptions"]; + + // Preconfigured versioned expression. If this field is specified, config must + // also be specified. Available preconfigured expressions along with their + // requirements are: SRC_IPS_V1 - must specify the corresponding src_ip_range + // field in config. + // SRC_IPS_V1: Matches the source IP address of a request to the IP ranges + // supplied in config. + optional string versioned_expr = 3 [json_name = "versionedExpr"]; +} + +message SecurityPolicyRuleMatcherConfig { + // CIDR IP address range. Maximum number of src_ip_ranges allowed is 10. + repeated string src_ip_ranges = 1 [json_name = "srcIpRanges"]; +} + +message SecurityPolicyRuleMatcherExprOptions { + // reCAPTCHA configuration options to be applied for the rule. If the rule + // does not evaluate reCAPTCHA tokens, this field has no effect. + optional SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions + recaptcha_options = 1 [json_name = "recaptchaOptions"]; +} + +message SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions { + // A list of site keys to be used during the validation of reCAPTCHA + // action-tokens. The provided site keys need to be created from reCAPTCHA API + // under the same project where the security policy is created. + repeated string action_token_site_keys = 1 + [json_name = "actionTokenSiteKeys"]; + + // A list of site keys to be used during the validation of reCAPTCHA + // session-tokens. The provided site keys need to be created from reCAPTCHA + // API under the same project where the security policy is created. + repeated string session_token_site_keys = 2 + [json_name = "sessionTokenSiteKeys"]; +} + +// Represents a match condition that incoming network traffic is evaluated +// against. +message SecurityPolicyRuleNetworkMatcher { + // Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text format. + repeated string dest_ip_ranges = 1 [json_name = "destIpRanges"]; + + // Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit + // unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). + repeated string dest_ports = 2 [json_name = "destPorts"]; + + // IPv4 protocol / IPv6 next header (after extension headers). Each element + // can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g. "253-254"), + // or one of the following protocol names: "tcp", "udp", "icmp", "esp", "ah", + // "ipip", or "sctp". + repeated string ip_protocols = 3 [json_name = "ipProtocols"]; + + // BGP Autonomous System Number associated with the source IP address. + repeated uint32 src_asns = 4 [json_name = "srcAsns"]; + + // Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format. + repeated string src_ip_ranges = 5 [json_name = "srcIpRanges"]; + + // Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned + // decimal number (e.g. "80") or range (e.g. "0-1023"). + repeated string src_ports = 6 [json_name = "srcPorts"]; + + // Two-letter ISO 3166-1 alpha-2 country code associated with the source IP + // address. + repeated string src_region_codes = 7 [json_name = "srcRegionCodes"]; + + // User-defined fields. Each element names a defined field and lists the + // matching values for that field. + repeated SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch + user_defined_fields = 8 [json_name = "userDefinedFields"]; +} + +message SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch { + // Name of the user-defined field, as given in the definition. + optional string name = 1 [json_name = "name"]; + + // Matching values of the field. Each element can be a 32-bit unsigned decimal + // or hexadecimal (starting with "0x") number (e.g. "64") or range (e.g. + // "0x400-0x7ff"). + repeated string values = 2 [json_name = "values"]; +} + +message SecurityPolicyRulePreconfiguredWafConfig { + // A list of exclusions to apply during preconfigured WAF evaluation. + repeated SecurityPolicyRulePreconfiguredWafConfigExclusion exclusions = 1 + [json_name = "exclusions"]; +} + +message SecurityPolicyRulePreconfiguredWafConfigExclusion { + // A list of request cookie names whose value will be excluded from inspection + // during preconfigured WAF evaluation. + repeated SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams + request_cookies_to_exclude = 1 [json_name = "requestCookiesToExclude"]; + + // A list of request header names whose value will be excluded from inspection + // during preconfigured WAF evaluation. + repeated SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams + request_headers_to_exclude = 2 [json_name = "requestHeadersToExclude"]; + + // A list of request query parameter names whose value will be excluded from + // inspection during preconfigured WAF evaluation. Note that the parameter can + // be in the query string or in the POST body. + repeated SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams + request_query_params_to_exclude = 3 + [json_name = "requestQueryParamsToExclude"]; + + // A list of request URIs from the request line to be excluded from inspection + // during preconfigured WAF evaluation. When specifying this field, the query + // or fragment part should be excluded. + repeated SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams + request_uris_to_exclude = 4 [json_name = "requestUrisToExclude"]; + + // A list of target rule IDs under the WAF rule set to apply the preconfigured + // WAF exclusion. If omitted, it refers to all the rule IDs under the WAF rule + // set. + repeated string target_rule_ids = 5 [json_name = "targetRuleIds"]; + + // Target WAF rule set to apply the preconfigured WAF exclusion. + optional string target_rule_set = 6 [json_name = "targetRuleSet"]; +} + +message SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams { + // The match operator for the field. + // CONTAINS: The operator matches if the field value contains the specified + // value. + // ENDS_WITH: The operator matches if the field value ends with the specified + // value. + // EQUALS: The operator matches if the field value equals the specified value. + // EQUALS_ANY: The operator matches if the field value is any value. + // STARTS_WITH: The operator matches if the field value starts with the + // specified value. + optional string op = 1 [json_name = "op"]; + + // The value of the field. + optional string val = 2 [json_name = "val"]; +} + +message SecurityPolicyRuleRateLimitOptions { + // Can only be specified if the action for the rule is "rate_based_ban". If + // specified, determines the time (in seconds) the traffic will continue to be + // banned by the rate limit after the rate falls below the threshold. + optional int32 ban_duration_sec = 1 [json_name = "banDurationSec"]; + + // Can only be specified if the action for the rule is "rate_based_ban". If + // specified, the key will be banned for the configured 'ban_duration_sec' + // when the number of requests that exceed the 'rate_limit_threshold' also + // exceed this 'ban_threshold'. + optional SecurityPolicyRuleRateLimitOptionsThreshold ban_threshold = 2 + [json_name = "banThreshold"]; + + // Action to take for requests that are under the configured rate limit + // threshold. Valid option is "allow" only. + optional string conform_action = 3 [json_name = "conformAction"]; + + // Determines the key to enforce the rate_limit_threshold on. Possible values + // are: - ALL: A single rate limit threshold is applied to all the requests + // matching this rule. This is the default value if "enforceOnKey" is not + // configured. - IP: The source IP address of the request is the key. Each IP + // has this limit enforced separately. - HTTP_HEADER: The value of the HTTP + // header whose name is configured under "enforceOnKeyName". The key value is + // truncated to the first 128 bytes of the header value. If no such header is + // present in the request, the key type defaults to ALL. - XFF_IP: The first + // IP address (i.e. the originating client IP address) specified in the list + // of IPs under X-Forwarded-For HTTP header. If no such header is present or + // the value is not a valid IP, the key defaults to the source IP address of + // the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie + // whose name is configured under "enforceOnKeyName". The key value is + // truncated to the first 128 bytes of the cookie value. If no such cookie is + // present in the request, the key type defaults to ALL. - HTTP_PATH: The URL + // path of the HTTP request. The key value is truncated to the first 128 + // bytes. - SNI: Server name indication in the TLS session of the HTTPS + // request. The key value is truncated to the first 128 bytes. The key type + // defaults to ALL on a HTTP session. - REGION_CODE: The country/region from + // which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL + // fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not + // available, the key type defaults to ALL. - USER_IP: The IP address of the + // originating client, which is resolved based on "userIpRequestHeaders" + // configured with the security policy. If there is no "userIpRequestHeaders" + // configuration or an IP address cannot be resolved from it, the key type + // defaults to IP. + // ALL: + // HTTP_COOKIE: + // HTTP_HEADER: + // HTTP_PATH: + // IP: + // REGION_CODE: + // SNI: + // TLS_JA3_FINGERPRINT: + // USER_IP: + // XFF_IP: + optional string enforce_on_key = 4 [json_name = "enforceOnKey"]; + + // If specified, any combination of values of + // enforce_on_key_type/enforce_on_key_name is treated as the key on which + // ratelimit threshold/action is enforced. You can specify up to 3 + // enforce_on_key_configs. If enforce_on_key_configs is specified, + // enforce_on_key must not be specified. + repeated SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig + enforce_on_key_configs = 9 [json_name = "enforceOnKeyConfigs"]; + + // Rate limit key name applicable only for the following key types: + // HTTP_HEADER -- Name of the HTTP header whose value is taken as the key + // value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the + // key value. + optional string enforce_on_key_name = 5 [json_name = "enforceOnKeyName"]; + + // Action to take for requests that are above the configured rate limit + // threshold, to either deny with a specified HTTP response code, or redirect + // to a different endpoint. Valid options are `deny(STATUS)`, where valid + // values for `STATUS` are 403, 404, 429, and 502, and `redirect`, where the + // redirect parameters come from `exceedRedirectOptions` below. The `redirect` + // action is only supported in Global Security Policies of type CLOUD_ARMOR. + optional string exceed_action = 6 [json_name = "exceedAction"]; + + // Parameters defining the redirect action that is used as the exceed action. + // Cannot be specified if the exceed action is not redirect. This field is + // only supported in Global Security Policies of type CLOUD_ARMOR. + optional SecurityPolicyRuleRedirectOptions exceed_redirect_options = 7 + [json_name = "exceedRedirectOptions"]; + + // Threshold at which to begin ratelimiting. + optional SecurityPolicyRuleRateLimitOptionsThreshold rate_limit_threshold = 8 + [json_name = "rateLimitThreshold"]; +} + +message SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig { + // Rate limit key name applicable only for the following key types: + // HTTP_HEADER -- Name of the HTTP header whose value is taken as the key + // value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the + // key value. + optional string enforce_on_key_name = 1 [json_name = "enforceOnKeyName"]; + + // Determines the key to enforce the rate_limit_threshold on. Possible values + // are: - ALL: A single rate limit threshold is applied to all the requests + // matching this rule. This is the default value if "enforceOnKeyConfigs" is + // not configured. - IP: The source IP address of the request is the key. Each + // IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP + // header whose name is configured under "enforceOnKeyName". The key value is + // truncated to the first 128 bytes of the header value. If no such header is + // present in the request, the key type defaults to ALL. - XFF_IP: The first + // IP address (i.e. the originating client IP address) specified in the list + // of IPs under X-Forwarded-For HTTP header. If no such header is present or + // the value is not a valid IP, the key defaults to the source IP address of + // the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie + // whose name is configured under "enforceOnKeyName". The key value is + // truncated to the first 128 bytes of the cookie value. If no such cookie is + // present in the request, the key type defaults to ALL. - HTTP_PATH: The URL + // path of the HTTP request. The key value is truncated to the first 128 + // bytes. - SNI: Server name indication in the TLS session of the HTTPS + // request. The key value is truncated to the first 128 bytes. The key type + // defaults to ALL on a HTTP session. - REGION_CODE: The country/region from + // which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL + // fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not + // available, the key type defaults to ALL. - USER_IP: The IP address of the + // originating client, which is resolved based on "userIpRequestHeaders" + // configured with the security policy. If there is no "userIpRequestHeaders" + // configuration or an IP address cannot be resolved from it, the key type + // defaults to IP. + // ALL: + // HTTP_COOKIE: + // HTTP_HEADER: + // HTTP_PATH: + // IP: + // REGION_CODE: + // SNI: + // TLS_JA3_FINGERPRINT: + // USER_IP: + // XFF_IP: + optional string enforce_on_key_type = 2 [json_name = "enforceOnKeyType"]; +} + +message SecurityPolicyRuleRateLimitOptionsThreshold { + // Number of HTTP(S) requests for calculating the threshold. + optional int32 count = 1 [json_name = "count"]; + + // Interval over which the threshold is computed. + optional int32 interval_sec = 2 [json_name = "intervalSec"]; +} + +message SecurityPolicyRuleRedirectOptions { + // Target for the redirect action. This is required if the type is + // EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA. + optional string target = 1 [json_name = "target"]; + + // Type of the redirect action. + // EXTERNAL_302: + // GOOGLE_RECAPTCHA: + optional string type = 2 [json_name = "type"]; +} + +message SecurityPolicyUserDefinedField { + // The base relative to which 'offset' is measured. Possible values are: - + // IPV4: Points to the beginning of the IPv4 header. - IPV6: Points to the + // beginning of the IPv6 header. - TCP: Points to the beginning of the TCP + // header, skipping over any IPv4 options or IPv6 extension headers. Not + // present for non-first fragments. - UDP: Points to the beginning of the UDP + // header, skipping over any IPv4 options or IPv6 extension headers. Not + // present for non-first fragments. required + // IPV4: + // IPV6: + // TCP: + // UDP: + optional string base = 1 [json_name = "base"]; + + // If specified, apply this mask (bitwise AND) to the field to ignore bits + // before matching. Encoded as a hexadecimal number (starting with "0x"). The + // last byte of the field (in network byte order) corresponds to the least + // significant byte of the mask. + optional string mask = 2 [json_name = "mask"]; + + // The name of this field. Must be unique within the policy. + optional string name = 3 [json_name = "name"]; + + // Offset of the first byte of the field (in network byte order) relative to + // 'base'. + optional int32 offset = 4 [json_name = "offset"]; + + // Size of the field in bytes. Valid values: 1-4. + optional int32 size = 5 [json_name = "size"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_110.proto b/protos/google/cloud/compute/v1/internal/common_110.proto index 1ba7683a3aa7b..97f38d74b1b77 100644 --- a/protos/google/cloud/compute/v1/internal/common_110.proto +++ b/protos/google/cloud/compute/v1/internal/common_110.proto @@ -15,116 +15,12 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_109.proto"; - -// Contains a list of Route resources. -message RouteList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of Route resources. - repeated Route items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; +message SecurityPolicyReference { + optional string security_policy = 1 [json_name = "securityPolicy"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_111.proto b/protos/google/cloud/compute/v1/internal/common_111.proto index 86dca74680e7a..5b2ee8ba6f246 100644 --- a/protos/google/cloud/compute/v1/internal/common_111.proto +++ b/protos/google/cloud/compute/v1/internal/common_111.proto @@ -15,63 +15,80 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_032.proto"; - -// Represents a Google Cloud Armor security policy resource. Only external -// backend services that use load balancers can reference a security policy. For -// more information, see Google Cloud Armor security policy overview. -message SecurityPolicy { - optional SecurityPolicyAdaptiveProtectionConfig adaptive_protection_config = 1 - [json_name = "adaptiveProtectionConfig"]; - - optional SecurityPolicyAdvancedOptionsConfig advanced_options_config = 2 - [json_name = "advancedOptionsConfig"]; +// Represents a ServiceAttachment resource. A service attachment represents a +// service that a producer has exposed. It encapsulates the load balancer which +// fronts the service runs and a list of NAT IP ranges that the producers uses +// to represent the consumers connecting to the service. +message ServiceAttachment { + // [Output Only] An array of connections for all the consumers connected to + // this service attachment. + repeated ServiceAttachmentConnectedEndpoint connected_endpoints = 1 + [json_name = "connectedEndpoints"]; + + // The connection preference of service attachment. The value can be set to + // ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always + // accepts the connection from consumer forwarding rules. + // ACCEPT_AUTOMATIC: + // ACCEPT_MANUAL: + // CONNECTION_PREFERENCE_UNSPECIFIED: + optional string connection_preference = 2 + [json_name = "connectionPreference"]; + + // Specifies which consumer projects or networks are allowed to connect to the + // service attachment. Each project or network has a connection limit. A given + // service attachment can manage connections at either the project or network + // level. Therefore, both the accept and reject lists for a given service + // attachment must contain either only projects or only networks. + repeated ServiceAttachmentConsumerProjectLimit consumer_accept_lists = 3 + [json_name = "consumerAcceptLists"]; + + // Specifies a list of projects or networks that are not allowed to connect to + // this service attachment. The project can be specified using its project ID + // or project number and the network can be specified using its URL. A given + // service attachment can manage connections at either the project or network + // level. Therefore, both the reject and accept lists for a given service + // attachment must contain either only projects or only networks. + repeated string consumer_reject_lists = 4 [json_name = "consumerRejectLists"]; // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; - - optional SecurityPolicyDdosProtectionConfig ddos_protection_config = 4 - [json_name = "ddosProtectionConfig"]; + optional string creation_timestamp = 5 [json_name = "creationTimestamp"]; // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 5 [json_name = "description"]; - - // Specifies a fingerprint for this resource, which is essentially a hash of - // the metadata's contents and used for optimistic locking. The fingerprint is - // initially generated by Compute Engine and changes after every request to - // modify or update metadata. You must always provide an up-to-date - // fingerprint hash in order to update or change metadata, otherwise the - // request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make get() request to the security policy. - optional string fingerprint = 6 [json_name = "fingerprint"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 7 [json_name = "id"]; - - // [Output only] Type of the resource. Always compute#securityPolicyfor - // security policies - optional string kind = 8 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this security policy, which - // is essentially a hash of the labels set used for optimistic locking. The - // fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels. To see the - // latest fingerprint, make get() request to the security policy. - optional string label_fingerprint = 15 [json_name = "labelFingerprint"]; - - // Labels for this resource. These can only be added or modified by the - // setLabels method. Each label key/value pair must comply with RFC1035. Label - // values may be empty. - map labels = 16 [json_name = "labels"]; + optional string description = 6 [json_name = "description"]; + + // If specified, the domain name will be used during the integration between + // the PSC connected endpoints and the Cloud DNS. For example, this is a valid + // domain name: "p.mycompany.com.". Current max number of domain names + // supported is 1. + repeated string domain_names = 7 [json_name = "domainNames"]; + + // If true, enable the proxy protocol which is for supplying client TCP/IP + // address data in TCP connections that traverse proxies on their way to + // destination servers. + optional bool enable_proxy_protocol = 8 [json_name = "enableProxyProtocol"]; + + // 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 ServiceAttachment. An up-to-date fingerprint must be provided + // in order to patch/update the ServiceAttachment; otherwise, the request will + // fail with error 412 conditionNotMet. To see the latest fingerprint, make a + // get() request to retrieve the ServiceAttachment. + optional string fingerprint = 9 [json_name = "fingerprint"]; + + // [Output Only] The unique identifier for the resource type. The server + // generates this identifier. + optional string id = 10 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#serviceAttachment for + // service attachments. + optional string kind = 11 [json_name = "kind"]; // 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. @@ -80,185 +97,68 @@ message SecurityPolicy { // 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. - optional string name = 9 [json_name = "name"]; - - optional SecurityPolicyRecaptchaOptionsConfig recaptcha_options_config = 10 - [json_name = "recaptchaOptionsConfig"]; - - // [Output Only] URL of the region where the regional security policy resides. - // This field is not applicable to global security policies. - optional string region = 11 [json_name = "region"]; - - // A list of rules that belong to this policy. There must always be a default - // rule which is a rule with priority 2147483647 and match all condition (for - // the match condition this means match "*" for srcIpRanges and for the - // networkMatch condition every field must be either match "*" or not set). If - // no rules are provided when creating a security policy, a default rule with - // action "allow" will be added. - repeated SecurityPolicyRule rules = 12 [json_name = "rules"]; + optional string name = 12 [json_name = "name"]; + + // An array of URLs where each entry is the URL of a subnet provided by the + // service producer to use for NAT in this service attachment. + repeated string nat_subnets = 13 [json_name = "natSubnets"]; + + // The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is + // serving the endpoint identified by this service attachment. + optional string producer_forwarding_rule = 14 + [json_name = "producerForwardingRule"]; + + // The number of consumer spokes that connected Private Service Connect + // endpoints can be propagated to through Network Connectivity Center. This + // limit lets the service producer limit how many propagated Private Service + // Connect connections can be established to this service attachment from a + // single consumer. If the connection preference of the service attachment is + // ACCEPT_MANUAL, the limit applies to each project or network that is listed + // in the consumer accept list. If the connection preference of the service + // attachment is ACCEPT_AUTOMATIC, the limit applies to each project that + // contains a connected endpoint. If unspecified, the default propagated + // connection limit is 250. + optional uint32 propagated_connection_limit = 20 + [json_name = "propagatedConnectionLimit"]; + + // [Output Only] An 128-bit global unique ID of the PSC service attachment. + optional Uint128 psc_service_attachment_id = 15 + [json_name = "pscServiceAttachmentId"]; + + // This flag determines whether a consumer accept/reject list change can + // reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. - If + // false, connection policy update will only affect existing PENDING PSC + // endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched + // regardless how the connection policy is modified . - If true, update will + // affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an + // ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to + // the reject list. For newly created service attachment, this boolean + // defaults to false. + optional bool reconcile_connections = 19 [json_name = "reconcileConnections"]; + + // [Output Only] URL of the region where the service attachment resides. This + // field applies only to the region resource. You must specify this field as + // part of the HTTP request URL. It is not settable as a field in the request + // body. + optional string region = 16 [json_name = "region"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 13 [json_name = "selfLink"]; - - // The type indicates the intended use of the security policy. - CLOUD_ARMOR: - // Cloud Armor backend security policies can be configured to filter incoming - // HTTP requests targeting backend services. They filter requests before they - // hit the origin servers. - CLOUD_ARMOR_EDGE: Cloud Armor edge security - // policies can be configured to filter incoming HTTP requests targeting - // backend services (including Cloud CDN-enabled) as well as backend buckets - // (Cloud Storage). They filter requests before the request is served from - // Google's cache. - CLOUD_ARMOR_INTERNAL_SERVICE: Cloud Armor internal - // service policies can be configured to filter HTTP requests targeting - // services managed by Traffic Director in a service mesh. They filter - // requests before the request is served from the application. - - // CLOUD_ARMOR_NETWORK: Cloud Armor network policies can be configured to - // filter packets targeting network load balancing resources such as backend - // services, target pools, target instances, and instances with external IPs. - // They filter requests before the request is served from the application. - // This field can be set only at resource creation time. - // CLOUD_ARMOR: - // CLOUD_ARMOR_EDGE: - // CLOUD_ARMOR_NETWORK: - optional string type = 14 [json_name = "type"]; - - // Definitions of user-defined fields for CLOUD_ARMOR_NETWORK policies. A - // user-defined field consists of up to 4 bytes extracted from a fixed offset - // in the packet, relative to the IPv4, IPv6, TCP, or UDP header, with an - // optional mask to select certain bits. Rules may then specify matching - // values for these fields. Example: userDefinedFields: - name: - // "ipv4_fragment_offset" base: IPV4 offset: 6 size: 2 mask: "0x1fff" - repeated SecurityPolicyUserDefinedField user_defined_fields = 17 - [json_name = "userDefinedFields"]; -} - -// Configuration options for Cloud Armor Adaptive Protection (CAAP). -message SecurityPolicyAdaptiveProtectionConfig { - // If set to true, enables Cloud Armor Machine Learning. - optional SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig - layer7_ddos_defense_config = 1 [json_name = "layer7DdosDefenseConfig"]; -} - -// Configuration options for L7 DDoS detection. This field is only supported in -// Global Security Policies of type CLOUD_ARMOR. -message SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfig { - // If set to true, enables CAAP for L7 DDoS detection. This field is only - // supported in Global Security Policies of type CLOUD_ARMOR. - optional bool enable = 1 [json_name = "enable"]; - - // Rule visibility can be one of the following: STANDARD - opaque rules. - // (default) PREMIUM - transparent rules. This field is only supported in - // Global Security Policies of type CLOUD_ARMOR. - // PREMIUM: - // STANDARD: - optional string rule_visibility = 2 [json_name = "ruleVisibility"]; - - // Configuration options for layer7 adaptive protection for various - // customizable thresholds. - repeated - SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig - threshold_configs = 3 [json_name = "thresholdConfigs"]; -} - -message -SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfig { - optional float auto_deploy_confidence_threshold = 1 - [json_name = "autoDeployConfidenceThreshold"]; - - optional int32 auto_deploy_expiration_sec = 2 - [json_name = "autoDeployExpirationSec"]; - - optional float auto_deploy_impacted_baseline_threshold = 3 - [json_name = "autoDeployImpactedBaselineThreshold"]; - - optional float auto_deploy_load_threshold = 4 - [json_name = "autoDeployLoadThreshold"]; - - optional float detection_absolute_qps = 6 - [json_name = "detectionAbsoluteQps"]; - - optional float detection_load_threshold = 7 - [json_name = "detectionLoadThreshold"]; - - optional float detection_relative_to_baseline_qps = 8 - [json_name = "detectionRelativeToBaselineQps"]; - - // The name must be 1-63 characters long, and comply with RFC1035. The name - // must be unique within the security policy. - optional string name = 5 [json_name = "name"]; - - // Configuration options for enabling Adaptive Protection to operate on - // specified granular traffic units. - repeated - SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig - traffic_granularity_configs = 9 - [json_name = "trafficGranularityConfigs"]; -} - -// Configurations to specifc granular traffic units processed by Adaptive -// Protection. -message -SecurityPolicyAdaptiveProtectionConfigLayer7DdosDefenseConfigThresholdConfigTrafficGranularityConfig { - // If enabled, traffic matching each unique value for the specified type - // constitutes a separate traffic unit. It can only be set to true if `value` - // is empty. - optional bool enable_each_unique_value = 1 - [json_name = "enableEachUniqueValue"]; - - // Type of this configuration. - // HTTP_HEADER_HOST: - // HTTP_PATH: - // UNSPECIFIED_TYPE: - optional string type = 2 [json_name = "type"]; - - // Requests that match this value constitute a granular traffic unit. - optional string value = 3 [json_name = "value"]; -} - -message SecurityPolicyAdvancedOptionsConfig { - // Custom configuration to apply the JSON parsing. Only applicable when - // json_parsing is set to STANDARD. - optional SecurityPolicyAdvancedOptionsConfigJsonCustomConfig - json_custom_config = 1 [json_name = "jsonCustomConfig"]; - - // DISABLED: - // STANDARD: - // STANDARD_WITH_GRAPHQL: - optional string json_parsing = 2 [json_name = "jsonParsing"]; - - // NORMAL: - // VERBOSE: - optional string log_level = 3 [json_name = "logLevel"]; - - // An optional list of case-insensitive request header names to use for - // resolving the callers client IP address. - repeated string user_ip_request_headers = 4 - [json_name = "userIpRequestHeaders"]; -} - -message SecurityPolicyAdvancedOptionsConfigJsonCustomConfig { - // A list of custom Content-Type header values to apply the JSON parsing. As - // per RFC 1341, a Content-Type header value has the following format: - // Content-Type := type "/" subtype *[";" parameter] When configuring a custom - // Content-Type header value, only the type/subtype needs to be specified, and - // the parameters should be excluded. - repeated string content_types = 1 [json_name = "contentTypes"]; -} + optional string self_link = 17 [json_name = "selfLink"]; -message SecurityPolicyDdosProtectionConfig { - // ADVANCED: - // STANDARD: - optional string ddos_protection = 1 [json_name = "ddosProtection"]; + // The URL of a service serving the endpoint identified by this service + // attachment. + optional string target_service = 18 [json_name = "targetService"]; } -message SecurityPolicyList { +// Contains a list of ServiceAttachmentsScopedList. +message ServiceAttachmentAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of SecurityPolicy resources. - repeated SecurityPolicy items = 2 [json_name = "items"]; + // A list of ServiceAttachmentsScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#securityPolicyList for - // listsof securityPolicies + // Type of resource. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -268,6 +168,12 @@ message SecurityPolicyList { // continue paging through the results. optional string next_page_token = 4 [json_name = "nextPageToken"]; + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -350,457 +256,247 @@ message SecurityPolicyList { } // [Output Only] Informational warning message. - optional Warning warning = 5 [json_name = "warning"]; -} - -message SecurityPolicyRecaptchaOptionsConfig { - // An optional field to supply a reCAPTCHA site key to be used for all the - // rules using the redirect action with the type of GOOGLE_RECAPTCHA under the - // security policy. The specified site key needs to be created from the - // reCAPTCHA API. The user is responsible for the validity of the specified - // site key. If not specified, a Google-managed site key is used. This field - // is only supported in Global Security Policies of type CLOUD_ARMOR. - optional string redirect_site_key = 1 [json_name = "redirectSiteKey"]; + optional Warning warning = 7 [json_name = "warning"]; } -// Represents a rule that describes one or more match conditions along with the -// action to be taken when traffic matches this condition (allow or deny). -message SecurityPolicyRule { - // The Action to perform when the rule is matched. The following are the valid - // actions: - allow: allow access to target. - deny(STATUS): deny access to - // target, returns the HTTP response code specified. Valid values for `STATUS` - // are 403, 404, and 502. - rate_based_ban: limit client traffic to the - // configured threshold and ban the client if the traffic exceeds the - // threshold. Configure parameters for this action in RateLimitOptions. - // Requires rate_limit_options to be set. - redirect: redirect to a different - // target. This can either be an internal reCAPTCHA redirect, or an external - // URL-based redirect via a 302 response. Parameters for this action can be - // configured via redirectOptions. This action is only supported in Global - // Security Policies of type CLOUD_ARMOR. - throttle: limit client traffic to - // the configured threshold. Configure parameters for this action in - // rateLimitOptions. Requires rate_limit_options to be set for this. - optional string action = 1 [json_name = "action"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // Optional, additional actions that are performed on headers. This field is - // only supported in Global Security Policies of type CLOUD_ARMOR. - optional SecurityPolicyRuleHttpHeaderAction header_action = 3 - [json_name = "headerAction"]; - - // [Output only] Type of the resource. Always compute#securityPolicyRule for - // security policy rules - optional string kind = 4 [json_name = "kind"]; - - // A match condition that incoming traffic is evaluated against. If it - // evaluates to true, the corresponding 'action' is enforced. - optional SecurityPolicyRuleMatcher match = 5 [json_name = "match"]; - - // A match condition that incoming packets are evaluated against for - // CLOUD_ARMOR_NETWORK security policies. If it matches, the corresponding - // 'action' is enforced. The match criteria for a rule consists of built-in - // match fields (like 'srcIpRanges') and potentially multiple user-defined - // match fields ('userDefinedFields'). Field values may be extracted directly - // from the packet or derived from it (e.g. 'srcRegionCodes'). Some fields may - // not be present in every packet (e.g. 'srcPorts'). A user-defined field is - // only present if the base header is found in the packet and the entire field - // is in bounds. Each match field may specify which values can match it, - // listing one or more ranges, prefixes, or exact values that are considered a - // match for the field. A field value must be present in order to match a - // specified match field. If no match values are specified for a match field, - // then any field value is considered to match it, and it's not required to be - // present. For strings specifying '*' is also equivalent to match all. For a - // packet to match a rule, all specified match fields must match the - // corresponding field values derived from the packet. Example: networkMatch: - // srcIpRanges: - "192.0.2.0/24" - "198.51.100.0/24" userDefinedFields: - - // name: "ipv4_fragment_offset" values: - "1-0x1fff" The above match condition - // matches packets with a source IP in 192.0.2.0/24 or 198.51.100.0/24 and a - // user-defined field named "ipv4_fragment_offset" with a value between 1 and - // 0x1fff inclusive. - optional SecurityPolicyRuleNetworkMatcher network_match = 11 - [json_name = "networkMatch"]; - - // Preconfigured WAF configuration to be applied for the rule. If the rule - // does not evaluate preconfigured WAF rules, i.e., if - // evaluatePreconfiguredWaf() is not used, this field will have no effect. - optional SecurityPolicyRulePreconfiguredWafConfig preconfigured_waf_config = 6 - [json_name = "preconfiguredWafConfig"]; - - // If set to true, the specified action is not enforced. - optional bool preview = 7 [json_name = "preview"]; - - // An integer indicating the priority of a rule in the list. The priority must - // be a positive value between 0 and 2147483647. Rules are evaluated from - // highest to lowest priority where 0 is the highest priority and 2147483647 - // is the lowest priority. - optional int32 priority = 8 [json_name = "priority"]; - - // Must be specified if the action is "rate_based_ban" or "throttle". Cannot - // be specified for any other actions. - optional SecurityPolicyRuleRateLimitOptions rate_limit_options = 9 - [json_name = "rateLimitOptions"]; - - // Parameters defining the redirect action. Cannot be specified for any other - // actions. This field is only supported in Global Security Policies of type - // CLOUD_ARMOR. - optional SecurityPolicyRuleRedirectOptions redirect_options = 10 - [json_name = "redirectOptions"]; +// [Output Only] A connection connected to this service attachment. +message ServiceAttachmentConnectedEndpoint { + // The url of the consumer network. + optional string consumer_network = 4 [json_name = "consumerNetwork"]; + + // The url of a connected endpoint. + optional string endpoint = 1 [json_name = "endpoint"]; + + // The number of consumer Network Connectivity Center spokes that the + // connected Private Service Connect endpoint has propagated to. + optional uint32 propagated_connection_count = 5 + [json_name = "propagatedConnectionCount"]; + + // The PSC connection id of the connected endpoint. + optional string psc_connection_id = 2 [json_name = "pscConnectionId"]; + + // The status of a connected endpoint to this service attachment. + // ACCEPTED: The connection has been accepted by the producer. + // CLOSED: The connection has been closed by the producer. + // NEEDS_ATTENTION: The connection has been accepted by the producer, but the + // producer needs to take further action before the forwarding rule can serve + // traffic. + // PENDING: The connection is pending acceptance by the producer. + // REJECTED: The consumer is still connected but not using the connection. + // STATUS_UNSPECIFIED: + optional string status = 3 [json_name = "status"]; } -message SecurityPolicyRuleHttpHeaderAction { - // The list of request headers to add or overwrite if they're already present. - repeated SecurityPolicyRuleHttpHeaderActionHttpHeaderOption - request_headers_to_adds = 1 [json_name = "requestHeadersToAdds"]; -} - -message SecurityPolicyRuleHttpHeaderActionHttpHeaderOption { - // The name of the header to set. - optional string header_name = 1 [json_name = "headerName"]; - - // The value to set the named header to. - optional string header_value = 2 [json_name = "headerValue"]; -} - -// Represents a match condition that incoming traffic is evaluated against. -// Exactly one field must be specified. -message SecurityPolicyRuleMatcher { - // The configuration options available when specifying versioned_expr. This - // field must be specified if versioned_expr is specified and cannot be - // specified if versioned_expr is not specified. - optional SecurityPolicyRuleMatcherConfig config = 1 [json_name = "config"]; - - // User defined CEVAL expression. A CEVAL expression is used to specify match - // criteria such as origin.ip, source.region_code and contents in the request - // header. Expressions containing `evaluateThreatIntelligence` require Cloud - // Armor Managed Protection Plus tier and are not supported in Edge Policies - // nor in Regional Policies. Expressions containing - // `evaluatePreconfiguredExpr('sourceiplist-*')` require Cloud Armor Managed - // Protection Plus tier and are only supported in Global Security Policies. - optional Expr expr = 2 [json_name = "expr"]; - - // The configuration options available when specifying a user defined CEVAL - // expression (i.e., 'expr'). - optional SecurityPolicyRuleMatcherExprOptions expr_options = 4 - [json_name = "exprOptions"]; - - // Preconfigured versioned expression. If this field is specified, config must - // also be specified. Available preconfigured expressions along with their - // requirements are: SRC_IPS_V1 - must specify the corresponding src_ip_range - // field in config. - // SRC_IPS_V1: Matches the source IP address of a request to the IP ranges - // supplied in config. - optional string versioned_expr = 3 [json_name = "versionedExpr"]; -} +message ServiceAttachmentConsumerProjectLimit { + // The value of the limit to set. + optional uint32 connection_limit = 1 [json_name = "connectionLimit"]; -message SecurityPolicyRuleMatcherConfig { - // CIDR IP address range. Maximum number of src_ip_ranges allowed is 10. - repeated string src_ip_ranges = 1 [json_name = "srcIpRanges"]; -} + // The network URL for the network to set the limit for. + optional string network_url = 2 [json_name = "networkUrl"]; -message SecurityPolicyRuleMatcherExprOptions { - // reCAPTCHA configuration options to be applied for the rule. If the rule - // does not evaluate reCAPTCHA tokens, this field has no effect. - optional SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions - recaptcha_options = 1 [json_name = "recaptchaOptions"]; + // The project id or number for the project to set the limit for. + optional string project_id_or_num = 3 [json_name = "projectIdOrNum"]; } -message SecurityPolicyRuleMatcherExprOptionsRecaptchaOptions { - // A list of site keys to be used during the validation of reCAPTCHA - // action-tokens. The provided site keys need to be created from reCAPTCHA API - // under the same project where the security policy is created. - repeated string action_token_site_keys = 1 - [json_name = "actionTokenSiteKeys"]; - - // A list of site keys to be used during the validation of reCAPTCHA - // session-tokens. The provided site keys need to be created from reCAPTCHA - // API under the same project where the security policy is created. - repeated string session_token_site_keys = 2 - [json_name = "sessionTokenSiteKeys"]; -} +message ServiceAttachmentList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; -// Represents a match condition that incoming network traffic is evaluated -// against. -message SecurityPolicyRuleNetworkMatcher { - // Destination IPv4/IPv6 addresses or CIDR prefixes, in standard text format. - repeated string dest_ip_ranges = 1 [json_name = "destIpRanges"]; + // A list of ServiceAttachment resources. + repeated ServiceAttachment items = 2 [json_name = "items"]; - // Destination port numbers for TCP/UDP/SCTP. Each element can be a 16-bit - // unsigned decimal number (e.g. "80") or range (e.g. "0-1023"). - repeated string dest_ports = 2 [json_name = "destPorts"]; + // [Output Only] Type of the resource. Always compute#serviceAttachment for + // service attachments. + optional string kind = 3 [json_name = "kind"]; - // IPv4 protocol / IPv6 next header (after extension headers). Each element - // can be an 8-bit unsigned decimal number (e.g. "6"), range (e.g. "253-254"), - // or one of the following protocol names: "tcp", "udp", "icmp", "esp", "ah", - // "ipip", or "sctp". - repeated string ip_protocols = 3 [json_name = "ipProtocols"]; + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; - // BGP Autonomous System Number associated with the source IP address. - repeated uint32 src_asns = 4 [json_name = "srcAsns"]; + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; - // Source IPv4/IPv6 addresses or CIDR prefixes, in standard text format. - repeated string src_ip_ranges = 5 [json_name = "srcIpRanges"]; + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; - // Source port numbers for TCP/UDP/SCTP. Each element can be a 16-bit unsigned - // decimal number (e.g. "80") or range (e.g. "0-1023"). - repeated string src_ports = 6 [json_name = "srcPorts"]; + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; - // Two-letter ISO 3166-1 alpha-2 country code associated with the source IP - // address. - repeated string src_region_codes = 7 [json_name = "srcRegionCodes"]; + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } - // User-defined fields. Each element names a defined field and lists the - // matching values for that field. - repeated SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch - user_defined_fields = 8 [json_name = "userDefinedFields"]; -} + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; -message SecurityPolicyRuleNetworkMatcherUserDefinedFieldMatch { - // Name of the user-defined field, as given in the definition. - optional string name = 1 [json_name = "name"]; + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // Matching values of the field. Each element can be a 32-bit unsigned decimal - // or hexadecimal (starting with "0x") number (e.g. "64") or range (e.g. - // "0x400-0x7ff"). - repeated string values = 2 [json_name = "values"]; + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } -message SecurityPolicyRulePreconfiguredWafConfig { - // A list of exclusions to apply during preconfigured WAF evaluation. - repeated SecurityPolicyRulePreconfiguredWafConfigExclusion exclusions = 1 - [json_name = "exclusions"]; -} +message ServiceAttachmentsScopedList { + // A list of ServiceAttachments contained in this scope. + repeated ServiceAttachment service_attachments = 1 + [json_name = "serviceAttachments"]; -message SecurityPolicyRulePreconfiguredWafConfigExclusion { - // A list of request cookie names whose value will be excluded from inspection - // during preconfigured WAF evaluation. - repeated SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams - request_cookies_to_exclude = 1 [json_name = "requestCookiesToExclude"]; - - // A list of request header names whose value will be excluded from inspection - // during preconfigured WAF evaluation. - repeated SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams - request_headers_to_exclude = 2 [json_name = "requestHeadersToExclude"]; - - // A list of request query parameter names whose value will be excluded from - // inspection during preconfigured WAF evaluation. Note that the parameter can - // be in the query string or in the POST body. - repeated SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams - request_query_params_to_exclude = 3 - [json_name = "requestQueryParamsToExclude"]; - - // A list of request URIs from the request line to be excluded from inspection - // during preconfigured WAF evaluation. When specifying this field, the query - // or fragment part should be excluded. - repeated SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams - request_uris_to_exclude = 4 [json_name = "requestUrisToExclude"]; - - // A list of target rule IDs under the WAF rule set to apply the preconfigured - // WAF exclusion. If omitted, it refers to all the rule IDs under the WAF rule - // set. - repeated string target_rule_ids = 5 [json_name = "targetRuleIds"]; - - // Target WAF rule set to apply the preconfigured WAF exclusion. - optional string target_rule_set = 6 [json_name = "targetRuleSet"]; -} + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; -message SecurityPolicyRulePreconfiguredWafConfigExclusionFieldParams { - // The match operator for the field. - // CONTAINS: The operator matches if the field value contains the specified - // value. - // ENDS_WITH: The operator matches if the field value ends with the specified - // value. - // EQUALS: The operator matches if the field value equals the specified value. - // EQUALS_ANY: The operator matches if the field value is any value. - // STARTS_WITH: The operator matches if the field value starts with the - // specified value. - optional string op = 1 [json_name = "op"]; - - // The value of the field. - optional string val = 2 [json_name = "val"]; -} + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; -message SecurityPolicyRuleRateLimitOptions { - // Can only be specified if the action for the rule is "rate_based_ban". If - // specified, determines the time (in seconds) the traffic will continue to be - // banned by the rate limit after the rate falls below the threshold. - optional int32 ban_duration_sec = 1 [json_name = "banDurationSec"]; - - // Can only be specified if the action for the rule is "rate_based_ban". If - // specified, the key will be banned for the configured 'ban_duration_sec' - // when the number of requests that exceed the 'rate_limit_threshold' also - // exceed this 'ban_threshold'. - optional SecurityPolicyRuleRateLimitOptionsThreshold ban_threshold = 2 - [json_name = "banThreshold"]; - - // Action to take for requests that are under the configured rate limit - // threshold. Valid option is "allow" only. - optional string conform_action = 3 [json_name = "conformAction"]; - - // Determines the key to enforce the rate_limit_threshold on. Possible values - // are: - ALL: A single rate limit threshold is applied to all the requests - // matching this rule. This is the default value if "enforceOnKey" is not - // configured. - IP: The source IP address of the request is the key. Each IP - // has this limit enforced separately. - HTTP_HEADER: The value of the HTTP - // header whose name is configured under "enforceOnKeyName". The key value is - // truncated to the first 128 bytes of the header value. If no such header is - // present in the request, the key type defaults to ALL. - XFF_IP: The first - // IP address (i.e. the originating client IP address) specified in the list - // of IPs under X-Forwarded-For HTTP header. If no such header is present or - // the value is not a valid IP, the key defaults to the source IP address of - // the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie - // whose name is configured under "enforceOnKeyName". The key value is - // truncated to the first 128 bytes of the cookie value. If no such cookie is - // present in the request, the key type defaults to ALL. - HTTP_PATH: The URL - // path of the HTTP request. The key value is truncated to the first 128 - // bytes. - SNI: Server name indication in the TLS session of the HTTPS - // request. The key value is truncated to the first 128 bytes. The key type - // defaults to ALL on a HTTP session. - REGION_CODE: The country/region from - // which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL - // fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not - // available, the key type defaults to ALL. - USER_IP: The IP address of the - // originating client, which is resolved based on "userIpRequestHeaders" - // configured with the security policy. If there is no "userIpRequestHeaders" - // configuration or an IP address cannot be resolved from it, the key type - // defaults to IP. - // ALL: - // HTTP_COOKIE: - // HTTP_HEADER: - // HTTP_PATH: - // IP: - // REGION_CODE: - // SNI: - // TLS_JA3_FINGERPRINT: - // USER_IP: - // XFF_IP: - optional string enforce_on_key = 4 [json_name = "enforceOnKey"]; - - // If specified, any combination of values of - // enforce_on_key_type/enforce_on_key_name is treated as the key on which - // ratelimit threshold/action is enforced. You can specify up to 3 - // enforce_on_key_configs. If enforce_on_key_configs is specified, - // enforce_on_key must not be specified. - repeated SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig - enforce_on_key_configs = 9 [json_name = "enforceOnKeyConfigs"]; - - // Rate limit key name applicable only for the following key types: - // HTTP_HEADER -- Name of the HTTP header whose value is taken as the key - // value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the - // key value. - optional string enforce_on_key_name = 5 [json_name = "enforceOnKeyName"]; - - // Action to take for requests that are above the configured rate limit - // threshold, to either deny with a specified HTTP response code, or redirect - // to a different endpoint. Valid options are `deny(STATUS)`, where valid - // values for `STATUS` are 403, 404, 429, and 502, and `redirect`, where the - // redirect parameters come from `exceedRedirectOptions` below. The `redirect` - // action is only supported in Global Security Policies of type CLOUD_ARMOR. - optional string exceed_action = 6 [json_name = "exceedAction"]; - - // Parameters defining the redirect action that is used as the exceed action. - // Cannot be specified if the exceed action is not redirect. This field is - // only supported in Global Security Policies of type CLOUD_ARMOR. - optional SecurityPolicyRuleRedirectOptions exceed_redirect_options = 7 - [json_name = "exceedRedirectOptions"]; - - // Threshold at which to begin ratelimiting. - optional SecurityPolicyRuleRateLimitOptionsThreshold rate_limit_threshold = 8 - [json_name = "rateLimitThreshold"]; -} + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } -message SecurityPolicyRuleRateLimitOptionsEnforceOnKeyConfig { - // Rate limit key name applicable only for the following key types: - // HTTP_HEADER -- Name of the HTTP header whose value is taken as the key - // value. HTTP_COOKIE -- Name of the HTTP cookie whose value is taken as the - // key value. - optional string enforce_on_key_name = 1 [json_name = "enforceOnKeyName"]; - - // Determines the key to enforce the rate_limit_threshold on. Possible values - // are: - ALL: A single rate limit threshold is applied to all the requests - // matching this rule. This is the default value if "enforceOnKeyConfigs" is - // not configured. - IP: The source IP address of the request is the key. Each - // IP has this limit enforced separately. - HTTP_HEADER: The value of the HTTP - // header whose name is configured under "enforceOnKeyName". The key value is - // truncated to the first 128 bytes of the header value. If no such header is - // present in the request, the key type defaults to ALL. - XFF_IP: The first - // IP address (i.e. the originating client IP address) specified in the list - // of IPs under X-Forwarded-For HTTP header. If no such header is present or - // the value is not a valid IP, the key defaults to the source IP address of - // the request i.e. key type IP. - HTTP_COOKIE: The value of the HTTP cookie - // whose name is configured under "enforceOnKeyName". The key value is - // truncated to the first 128 bytes of the cookie value. If no such cookie is - // present in the request, the key type defaults to ALL. - HTTP_PATH: The URL - // path of the HTTP request. The key value is truncated to the first 128 - // bytes. - SNI: Server name indication in the TLS session of the HTTPS - // request. The key value is truncated to the first 128 bytes. The key type - // defaults to ALL on a HTTP session. - REGION_CODE: The country/region from - // which the request originates. - TLS_JA3_FINGERPRINT: JA3 TLS/SSL - // fingerprint if the client connects using HTTPS, HTTP/2 or HTTP/3. If not - // available, the key type defaults to ALL. - USER_IP: The IP address of the - // originating client, which is resolved based on "userIpRequestHeaders" - // configured with the security policy. If there is no "userIpRequestHeaders" - // configuration or an IP address cannot be resolved from it, the key type - // defaults to IP. - // ALL: - // HTTP_COOKIE: - // HTTP_HEADER: - // HTTP_PATH: - // IP: - // REGION_CODE: - // SNI: - // TLS_JA3_FINGERPRINT: - // USER_IP: - // XFF_IP: - optional string enforce_on_key_type = 2 [json_name = "enforceOnKeyType"]; -} + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; -message SecurityPolicyRuleRateLimitOptionsThreshold { - // Number of HTTP(S) requests for calculating the threshold. - optional int32 count = 1 [json_name = "count"]; + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // Interval over which the threshold is computed. - optional int32 interval_sec = 2 [json_name = "intervalSec"]; + // Informational warning which replaces the list of service attachments when + // the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } -message SecurityPolicyRuleRedirectOptions { - // Target for the redirect action. This is required if the type is - // EXTERNAL_302 and cannot be specified for GOOGLE_RECAPTCHA. - optional string target = 1 [json_name = "target"]; - - // Type of the redirect action. - // EXTERNAL_302: - // GOOGLE_RECAPTCHA: - optional string type = 2 [json_name = "type"]; -} +message Uint128 { + optional string high = 1 [json_name = "high"]; -message SecurityPolicyUserDefinedField { - // The base relative to which 'offset' is measured. Possible values are: - - // IPV4: Points to the beginning of the IPv4 header. - IPV6: Points to the - // beginning of the IPv6 header. - TCP: Points to the beginning of the TCP - // header, skipping over any IPv4 options or IPv6 extension headers. Not - // present for non-first fragments. - UDP: Points to the beginning of the UDP - // header, skipping over any IPv4 options or IPv6 extension headers. Not - // present for non-first fragments. required - // IPV4: - // IPV6: - // TCP: - // UDP: - optional string base = 1 [json_name = "base"]; - - // If specified, apply this mask (bitwise AND) to the field to ignore bits - // before matching. Encoded as a hexadecimal number (starting with "0x"). The - // last byte of the field (in network byte order) corresponds to the least - // significant byte of the mask. - optional string mask = 2 [json_name = "mask"]; - - // The name of this field. Must be unique within the policy. - optional string name = 3 [json_name = "name"]; - - // Offset of the first byte of the field (in network byte order) relative to - // 'base'. - optional int32 offset = 4 [json_name = "offset"]; - - // Size of the field in bytes. Valid values: 1-4. - optional int32 size = 5 [json_name = "size"]; + optional string low = 2 [json_name = "low"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_112.proto b/protos/google/cloud/compute/v1/internal/common_112.proto index 0339fc074c073..645f27745d014 100644 --- a/protos/google/cloud/compute/v1/internal/common_112.proto +++ b/protos/google/cloud/compute/v1/internal/common_112.proto @@ -15,12 +15,30 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message SecurityPolicyReference { - optional string security_policy = 1 [json_name = "securityPolicy"]; +// The share setting for reservations and sole tenancy node groups. +message ShareSettings { + // A map of project id and project config. This is only valid when + // share_type's value is SPECIFIC_PROJECTS. + map project_map = 1 + [json_name = "projectMap"]; + + // Type of sharing for this shared-reservation + // LOCAL: Default value. + // ORGANIZATION: Shared-reservation is open to entire Organization + // SHARE_TYPE_UNSPECIFIED: Default value. This value is unused. + // SPECIFIC_PROJECTS: Shared-reservation is open to specific projects + optional string share_type = 2 [json_name = "shareType"]; +} + +// Config for each project in the share settings. +message ShareSettingsProjectConfig { + // The project ID, should be same as the key of this project config in the + // parent map. + optional string project_id = 1 [json_name = "projectId"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_113.proto b/protos/google/cloud/compute/v1/internal/common_113.proto index 5ee90d42a0ac9..66e872a06b244 100644 --- a/protos/google/cloud/compute/v1/internal/common_113.proto +++ b/protos/google/cloud/compute/v1/internal/common_113.proto @@ -15,470 +15,23 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a ServiceAttachment resource. A service attachment represents a -// service that a producer has exposed. It encapsulates the load balancer which -// fronts the service runs and a list of NAT IP ranges that the producers uses -// to represent the consumers connecting to the service. -message ServiceAttachment { - // [Output Only] An array of connections for all the consumers connected to - // this service attachment. - repeated ServiceAttachmentConnectedEndpoint connected_endpoints = 1 - [json_name = "connectedEndpoints"]; - - // The connection preference of service attachment. The value can be set to - // ACCEPT_AUTOMATIC. An ACCEPT_AUTOMATIC service attachment is one that always - // accepts the connection from consumer forwarding rules. - // ACCEPT_AUTOMATIC: - // ACCEPT_MANUAL: - // CONNECTION_PREFERENCE_UNSPECIFIED: - optional string connection_preference = 2 - [json_name = "connectionPreference"]; - - // Specifies which consumer projects or networks are allowed to connect to the - // service attachment. Each project or network has a connection limit. A given - // service attachment can manage connections at either the project or network - // level. Therefore, both the accept and reject lists for a given service - // attachment must contain either only projects or only networks. - repeated ServiceAttachmentConsumerProjectLimit consumer_accept_lists = 3 - [json_name = "consumerAcceptLists"]; - - // Specifies a list of projects or networks that are not allowed to connect to - // this service attachment. The project can be specified using its project ID - // or project number and the network can be specified using its URL. A given - // service attachment can manage connections at either the project or network - // level. Therefore, both the reject and accept lists for a given service - // attachment must contain either only projects or only networks. - repeated string consumer_reject_lists = 4 [json_name = "consumerRejectLists"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 5 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 6 [json_name = "description"]; - - // If specified, the domain name will be used during the integration between - // the PSC connected endpoints and the Cloud DNS. For example, this is a valid - // domain name: "p.mycompany.com.". Current max number of domain names - // supported is 1. - repeated string domain_names = 7 [json_name = "domainNames"]; - - // If true, enable the proxy protocol which is for supplying client TCP/IP - // address data in TCP connections that traverse proxies on their way to - // destination servers. - optional bool enable_proxy_protocol = 8 [json_name = "enableProxyProtocol"]; - - // 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 ServiceAttachment. An up-to-date fingerprint must be provided - // in order to patch/update the ServiceAttachment; otherwise, the request will - // fail with error 412 conditionNotMet. To see the latest fingerprint, make a - // get() request to retrieve the ServiceAttachment. - optional string fingerprint = 9 [json_name = "fingerprint"]; - - // [Output Only] The unique identifier for the resource type. The server - // generates this identifier. - optional string id = 10 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#serviceAttachment for - // service attachments. - optional string kind = 11 [json_name = "kind"]; - - // 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. - optional string name = 12 [json_name = "name"]; - - // An array of URLs where each entry is the URL of a subnet provided by the - // service producer to use for NAT in this service attachment. - repeated string nat_subnets = 13 [json_name = "natSubnets"]; - - // The URL of a forwarding rule with loadBalancingScheme INTERNAL* that is - // serving the endpoint identified by this service attachment. - optional string producer_forwarding_rule = 14 - [json_name = "producerForwardingRule"]; - - // [Output Only] An 128-bit global unique ID of the PSC service attachment. - optional Uint128 psc_service_attachment_id = 15 - [json_name = "pscServiceAttachmentId"]; - - // This flag determines whether a consumer accept/reject list change can - // reconcile the statuses of existing ACCEPTED or REJECTED PSC endpoints. - If - // false, connection policy update will only affect existing PENDING PSC - // endpoints. Existing ACCEPTED/REJECTED endpoints will remain untouched - // regardless how the connection policy is modified . - If true, update will - // affect both PENDING and ACCEPTED/REJECTED PSC endpoints. For example, an - // ACCEPTED PSC endpoint will be moved to REJECTED if its project is added to - // the reject list. For newly created service attachment, this boolean - // defaults to false. - optional bool reconcile_connections = 19 [json_name = "reconcileConnections"]; - - // [Output Only] URL of the region where the service attachment resides. This - // field applies only to the region resource. You must specify this field as - // part of the HTTP request URL. It is not settable as a field in the request - // body. - optional string region = 16 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 17 [json_name = "selfLink"]; - - // The URL of a service serving the endpoint identified by this service - // attachment. - optional string target_service = 18 [json_name = "targetService"]; -} - -// Contains a list of ServiceAttachmentsScopedList. -message ServiceAttachmentAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of ServiceAttachmentsScopedList resources. - map items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -// [Output Only] A connection connected to this service attachment. -message ServiceAttachmentConnectedEndpoint { - // The url of the consumer network. - optional string consumer_network = 4 [json_name = "consumerNetwork"]; - - // The url of a connected endpoint. - optional string endpoint = 1 [json_name = "endpoint"]; - - // The PSC connection id of the connected endpoint. - optional string psc_connection_id = 2 [json_name = "pscConnectionId"]; - - // The status of a connected endpoint to this service attachment. - // ACCEPTED: The connection has been accepted by the producer. - // CLOSED: The connection has been closed by the producer. - // NEEDS_ATTENTION: The connection has been accepted by the producer, but the - // producer needs to take further action before the forwarding rule can serve - // traffic. - // PENDING: The connection is pending acceptance by the producer. - // REJECTED: The consumer is still connected but not using the connection. - // STATUS_UNSPECIFIED: - optional string status = 3 [json_name = "status"]; -} - -message ServiceAttachmentConsumerProjectLimit { - // The value of the limit to set. - optional uint32 connection_limit = 1 [json_name = "connectionLimit"]; - - // The network URL for the network to set the limit for. - optional string network_url = 2 [json_name = "networkUrl"]; - - // The project id or number for the project to set the limit for. - optional string project_id_or_num = 3 [json_name = "projectIdOrNum"]; -} - -message ServiceAttachmentList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of ServiceAttachment resources. - repeated ServiceAttachment items = 2 [json_name = "items"]; - - // [Output Only] Type of the resource. Always compute#serviceAttachment for - // service attachments. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -message ServiceAttachmentsScopedList { - // A list of ServiceAttachments contained in this scope. - repeated ServiceAttachment service_attachments = 1 - [json_name = "serviceAttachments"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of service attachments when - // the list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} - -message Uint128 { - optional string high = 1 [json_name = "high"]; - - optional string low = 2 [json_name = "low"]; +// Represents a customer-supplied Signing Key used by Cloud CDN Signed URLs +message SignedUrlKey { + // Name of the key. 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. + optional string key_name = 1 [json_name = "keyName"]; + + // 128-bit key value used for signing the URL. The key value must be a valid + // RFC 4648 Section 5 base64url encoded string. + optional string key_value = 2 [json_name = "keyValue"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_114.proto b/protos/google/cloud/compute/v1/internal/common_114.proto index a1956a1ffb46a..0d351d5af6b4c 100644 --- a/protos/google/cloud/compute/v1/internal/common_114.proto +++ b/protos/google/cloud/compute/v1/internal/common_114.proto @@ -15,30 +15,208 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// The share setting for reservations and sole tenancy node groups. -message ShareSettings { - // A map of project id and project config. This is only valid when - // share_type's value is SPECIFIC_PROJECTS. - map project_map = 1 - [json_name = "projectMap"]; - - // Type of sharing for this shared-reservation - // LOCAL: Default value. - // ORGANIZATION: Shared-reservation is open to entire Organization - // SHARE_TYPE_UNSPECIFIED: Default value. This value is unused. - // SPECIFIC_PROJECTS: Shared-reservation is open to specific projects - optional string share_type = 2 [json_name = "shareType"]; -} +import "google/cloud/compute/v1/internal/common_020.proto"; + +// Represents a Persistent Disk Snapshot resource. You can use snapshots to back +// up data on a regular interval. For more information, read Creating persistent +// disk snapshots. +message Snapshot { + // [Output Only] The architecture of the snapshot. Valid values are ARM64 or + // X86_64. + // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. + // ARM64: Machines with architecture ARM64 + // X86_64: Machines with architecture X86_64 + optional string architecture = 1 [json_name = "architecture"]; + + // [Output Only] Set to true if snapshots are automatically created by + // applying resource policy on the target disk. + optional bool auto_created = 2 [json_name = "autoCreated"]; + + // Creates the new snapshot in the snapshot chain labeled with the specified + // name. The chain name must be 1-63 characters long and comply with RFC1035. + // This is an uncommon option only for advanced service owners who needs to + // create separate snapshot chains, for example, for chargeback tracking. When + // you describe your snapshot resource, this field is visible only if it has a + // non-empty value. + optional string chain_name = 3 [json_name = "chainName"]; + + // [Output Only] Size in bytes of the snapshot at creation time. + optional string creation_size_bytes = 4 [json_name = "creationSizeBytes"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 5 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 6 [json_name = "description"]; + + // [Output Only] Size of the source disk, specified in GB. + optional string disk_size_gb = 7 [json_name = "diskSizeGb"]; + + // [Output Only] Number of bytes downloaded to restore a snapshot to a disk. + optional string download_bytes = 8 [json_name = "downloadBytes"]; + + // Whether this snapshot is created from a confidential compute mode disk. + // [Output Only]: This field is not set by user, but from source disk. + optional bool enable_confidential_compute = 32 + [json_name = "enableConfidentialCompute"]; + + // [Output Only] A list of features to enable on the guest operating system. + // Applicable only for bootable images. Read Enabling guest operating system + // features to see a list of available options. + repeated GuestOsFeature guest_os_features = 31 + [json_name = "guestOsFeatures"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 9 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#snapshot for Snapshot + // resources. + optional string kind = 10 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this snapshot, which is + // essentially a hash of the labels set used for optimistic locking. The + // fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels, otherwise + // the request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve a snapshot. + optional string label_fingerprint = 11 [json_name = "labelFingerprint"]; + + // Labels to apply to this snapshot. These can be later modified by the + // setLabels method. Label values may be empty. + map labels = 12 [json_name = "labels"]; + + // [Output Only] Integer license codes indicating which licenses are attached + // to this snapshot. + repeated string license_codes = 13 [json_name = "licenseCodes"]; + + // [Output Only] A list of public visible licenses that apply to this + // snapshot. This can be because the original image had licenses attached + // (such as a Windows image). + repeated string licenses = 14 [json_name = "licenses"]; + + // An opaque location hint used to place the snapshot close to other + // resources. This field is for use by internal tools that use the public API. + optional string location_hint = 15 [json_name = "locationHint"]; + + // 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. + optional string name = 16 [json_name = "name"]; + + // Output only. Reserved for future use. + optional bool satisfies_pzi = 33 [json_name = "satisfiesPzi"]; + + // [Output Only] Reserved for future use. + optional bool satisfies_pzs = 17 [json_name = "satisfiesPzs"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 18 [json_name = "selfLink"]; + + // Encrypts the snapshot using a customer-supplied encryption key. After you + // encrypt a snapshot using a customer-supplied key, you must provide the same + // key if you use the snapshot later. For example, you must provide the + // encryption key when you create a disk from the encrypted snapshot in a + // future request. Customer-supplied encryption keys do not protect access to + // metadata of the snapshot. If you do not provide an encryption key when + // creating the snapshot, then the snapshot will be encrypted using an + // automatically generated key and you do not need to provide a key to use the + // snapshot later. + optional CustomerEncryptionKey snapshot_encryption_key = 19 + [json_name = "snapshotEncryptionKey"]; + + // Indicates the type of the snapshot. + // ARCHIVE: + // STANDARD: + optional string snapshot_type = 20 [json_name = "snapshotType"]; + + // The source disk used to create this snapshot. + optional string source_disk = 21 [json_name = "sourceDisk"]; + + // The customer-supplied encryption key of the source disk. Required if the + // source disk is protected by a customer-supplied encryption key. + optional CustomerEncryptionKey source_disk_encryption_key = 22 + [json_name = "sourceDiskEncryptionKey"]; + + // The source disk whose recovery checkpoint will be used to create this + // snapshot. + optional string source_disk_for_recovery_checkpoint = 30 + [json_name = "sourceDiskForRecoveryCheckpoint"]; + + // [Output Only] The ID value of the disk used to create this snapshot. This + // value may be used to determine whether the snapshot was taken from the + // current or a previous instance of a given disk name. + optional string source_disk_id = 23 [json_name = "sourceDiskId"]; + + // The source instant snapshot used to create this snapshot. You can provide + // this as a partial or full URL to the resource. For example, the following + // are valid values: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /instantSnapshots/instantSnapshot - + // projects/project/zones/zone/instantSnapshots/instantSnapshot - + // zones/zone/instantSnapshots/instantSnapshot + optional string source_instant_snapshot = 34 + [json_name = "sourceInstantSnapshot"]; + + // Customer provided encryption key when creating Snapshot from Instant + // Snapshot. + optional CustomerEncryptionKey source_instant_snapshot_encryption_key = 35 + [json_name = "sourceInstantSnapshotEncryptionKey"]; + + // [Output Only] The unique ID of the instant snapshot used to create this + // snapshot. This value identifies the exact instant snapshot that was used to + // create this persistent disk. For example, if you created the persistent + // disk from an instant snapshot that was later deleted and recreated under + // the same name, the source instant snapshot ID would identify the exact + // instant snapshot that was used. + optional string source_instant_snapshot_id = 36 + [json_name = "sourceInstantSnapshotId"]; + + // [Output Only] URL of the resource policy which created this scheduled + // snapshot. + optional string source_snapshot_schedule_policy = 24 + [json_name = "sourceSnapshotSchedulePolicy"]; + + // [Output Only] ID of the resource policy which created this scheduled + // snapshot. + optional string source_snapshot_schedule_policy_id = 25 + [json_name = "sourceSnapshotSchedulePolicyId"]; + + // [Output Only] The status of the snapshot. This can be CREATING, DELETING, + // FAILED, READY, or UPLOADING. + // CREATING: Snapshot creation is in progress. + // DELETING: Snapshot is currently being deleted. + // FAILED: Snapshot creation failed. + // READY: Snapshot has been created successfully. + // UPLOADING: Snapshot is being uploaded. + optional string status = 26 [json_name = "status"]; + + // [Output Only] A size of the storage used by the snapshot. As snapshots + // share storage, this number is expected to change with snapshot + // creation/deletion. + optional string storage_bytes = 27 [json_name = "storageBytes"]; + + // [Output Only] An indicator whether storageBytes is in a stable state or it + // is being adjusted as a result of shared storage reallocation. This status + // can either be UPDATING, meaning the size of the snapshot is being updated, + // or UP_TO_DATE, meaning the size of the snapshot is up-to-date. + // UPDATING: + // UP_TO_DATE: + optional string storage_bytes_status = 28 [json_name = "storageBytesStatus"]; -// Config for each project in the share settings. -message ShareSettingsProjectConfig { - // The project ID, should be same as the key of this project config in the - // parent map. - optional string project_id = 1 [json_name = "projectId"]; + // Cloud Storage bucket storage location of the snapshot (regional or + // multi-regional). + repeated string storage_locations = 29 [json_name = "storageLocations"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_115.proto b/protos/google/cloud/compute/v1/internal/common_115.proto index 0dfaa110b21f9..9d910458eb4bb 100644 --- a/protos/google/cloud/compute/v1/internal/common_115.proto +++ b/protos/google/cloud/compute/v1/internal/common_115.proto @@ -15,23 +15,116 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a customer-supplied Signing Key used by Cloud CDN Signed URLs -message SignedUrlKey { - // Name of the key. 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. - optional string key_name = 1 [json_name = "keyName"]; - - // 128-bit key value used for signing the URL. The key value must be a valid - // RFC 4648 Section 5 base64url encoded string. - optional string key_value = 2 [json_name = "keyValue"]; +import "google/cloud/compute/v1/internal/common_114.proto"; + +// Contains a list of Snapshot resources. +message SnapshotList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of Snapshot resources. + repeated Snapshot items = 2 [json_name = "items"]; + + // Type of resource. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_116.proto b/protos/google/cloud/compute/v1/internal/common_116.proto index eb8cbf9d4c676..5ce9e068b454a 100644 --- a/protos/google/cloud/compute/v1/internal/common_116.proto +++ b/protos/google/cloud/compute/v1/internal/common_116.proto @@ -15,208 +15,42 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_021.proto"; - -// Represents a Persistent Disk Snapshot resource. You can use snapshots to back -// up data on a regular interval. For more information, read Creating persistent -// disk snapshots. -message Snapshot { - // [Output Only] The architecture of the snapshot. Valid values are ARM64 or - // X86_64. - // ARCHITECTURE_UNSPECIFIED: Default value indicating Architecture is not set. - // ARM64: Machines with architecture ARM64 - // X86_64: Machines with architecture X86_64 - optional string architecture = 1 [json_name = "architecture"]; - - // [Output Only] Set to true if snapshots are automatically created by - // applying resource policy on the target disk. - optional bool auto_created = 2 [json_name = "autoCreated"]; - - // Creates the new snapshot in the snapshot chain labeled with the specified - // name. The chain name must be 1-63 characters long and comply with RFC1035. - // This is an uncommon option only for advanced service owners who needs to - // create separate snapshot chains, for example, for chargeback tracking. When - // you describe your snapshot resource, this field is visible only if it has a - // non-empty value. - optional string chain_name = 3 [json_name = "chainName"]; - - // [Output Only] Size in bytes of the snapshot at creation time. - optional string creation_size_bytes = 4 [json_name = "creationSizeBytes"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 5 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 6 [json_name = "description"]; - - // [Output Only] Size of the source disk, specified in GB. - optional string disk_size_gb = 7 [json_name = "diskSizeGb"]; - - // [Output Only] Number of bytes downloaded to restore a snapshot to a disk. - optional string download_bytes = 8 [json_name = "downloadBytes"]; - - // Whether this snapshot is created from a confidential compute mode disk. - // [Output Only]: This field is not set by user, but from source disk. - optional bool enable_confidential_compute = 32 - [json_name = "enableConfidentialCompute"]; - - // [Output Only] A list of features to enable on the guest operating system. - // Applicable only for bootable images. Read Enabling guest operating system - // features to see a list of available options. - repeated GuestOsFeature guest_os_features = 31 - [json_name = "guestOsFeatures"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 9 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#snapshot for Snapshot - // resources. - optional string kind = 10 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this snapshot, which is - // essentially a hash of the labels set used for optimistic locking. The - // fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels, otherwise - // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve a snapshot. - optional string label_fingerprint = 11 [json_name = "labelFingerprint"]; - - // Labels to apply to this snapshot. These can be later modified by the - // setLabels method. Label values may be empty. - map labels = 12 [json_name = "labels"]; - - // [Output Only] Integer license codes indicating which licenses are attached - // to this snapshot. - repeated string license_codes = 13 [json_name = "licenseCodes"]; - - // [Output Only] A list of public visible licenses that apply to this - // snapshot. This can be because the original image had licenses attached - // (such as a Windows image). - repeated string licenses = 14 [json_name = "licenses"]; - - // An opaque location hint used to place the snapshot close to other - // resources. This field is for use by internal tools that use the public API. - optional string location_hint = 15 [json_name = "locationHint"]; - - // 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. - optional string name = 16 [json_name = "name"]; - - // Output only. Reserved for future use. - optional bool satisfies_pzi = 33 [json_name = "satisfiesPzi"]; - - // [Output Only] Reserved for future use. - optional bool satisfies_pzs = 17 [json_name = "satisfiesPzs"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 18 [json_name = "selfLink"]; - - // Encrypts the snapshot using a customer-supplied encryption key. After you - // encrypt a snapshot using a customer-supplied key, you must provide the same - // key if you use the snapshot later. For example, you must provide the - // encryption key when you create a disk from the encrypted snapshot in a - // future request. Customer-supplied encryption keys do not protect access to - // metadata of the snapshot. If you do not provide an encryption key when - // creating the snapshot, then the snapshot will be encrypted using an - // automatically generated key and you do not need to provide a key to use the - // snapshot later. - optional CustomerEncryptionKey snapshot_encryption_key = 19 - [json_name = "snapshotEncryptionKey"]; - - // Indicates the type of the snapshot. - // ARCHIVE: - // STANDARD: - optional string snapshot_type = 20 [json_name = "snapshotType"]; - - // The source disk used to create this snapshot. - optional string source_disk = 21 [json_name = "sourceDisk"]; - - // The customer-supplied encryption key of the source disk. Required if the - // source disk is protected by a customer-supplied encryption key. - optional CustomerEncryptionKey source_disk_encryption_key = 22 - [json_name = "sourceDiskEncryptionKey"]; - - // The source disk whose recovery checkpoint will be used to create this - // snapshot. - optional string source_disk_for_recovery_checkpoint = 30 - [json_name = "sourceDiskForRecoveryCheckpoint"]; - - // [Output Only] The ID value of the disk used to create this snapshot. This - // value may be used to determine whether the snapshot was taken from the - // current or a previous instance of a given disk name. - optional string source_disk_id = 23 [json_name = "sourceDiskId"]; - - // The source instant snapshot used to create this snapshot. You can provide - // this as a partial or full URL to the resource. For example, the following - // are valid values: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /instantSnapshots/instantSnapshot - - // projects/project/zones/zone/instantSnapshots/instantSnapshot - - // zones/zone/instantSnapshots/instantSnapshot - optional string source_instant_snapshot = 34 - [json_name = "sourceInstantSnapshot"]; - - // Customer provided encryption key when creating Snapshot from Instant - // Snapshot. - optional CustomerEncryptionKey source_instant_snapshot_encryption_key = 35 - [json_name = "sourceInstantSnapshotEncryptionKey"]; - - // [Output Only] The unique ID of the instant snapshot used to create this - // snapshot. This value identifies the exact instant snapshot that was used to - // create this persistent disk. For example, if you created the persistent - // disk from an instant snapshot that was later deleted and recreated under - // the same name, the source instant snapshot ID would identify the exact - // instant snapshot that was used. - optional string source_instant_snapshot_id = 36 - [json_name = "sourceInstantSnapshotId"]; - - // [Output Only] URL of the resource policy which created this scheduled - // snapshot. - optional string source_snapshot_schedule_policy = 24 - [json_name = "sourceSnapshotSchedulePolicy"]; - - // [Output Only] ID of the resource policy which created this scheduled - // snapshot. - optional string source_snapshot_schedule_policy_id = 25 - [json_name = "sourceSnapshotSchedulePolicyId"]; - - // [Output Only] The status of the snapshot. This can be CREATING, DELETING, - // FAILED, READY, or UPLOADING. - // CREATING: Snapshot creation is in progress. - // DELETING: Snapshot is currently being deleted. - // FAILED: Snapshot creation failed. - // READY: Snapshot has been created successfully. - // UPLOADING: Snapshot is being uploaded. - optional string status = 26 [json_name = "status"]; - - // [Output Only] A size of the storage used by the snapshot. As snapshots - // share storage, this number is expected to change with snapshot - // creation/deletion. - optional string storage_bytes = 27 [json_name = "storageBytes"]; +message SnapshotSettings { + // Policy of which storage location is going to be resolved, and additional + // data that particularizes how the policy is going to be carried out. + optional SnapshotSettingsStorageLocationSettings storage_location = 1 + [json_name = "storageLocation"]; +} - // [Output Only] An indicator whether storageBytes is in a stable state or it - // is being adjusted as a result of shared storage reallocation. This status - // can either be UPDATING, meaning the size of the snapshot is being updated, - // or UP_TO_DATE, meaning the size of the snapshot is up-to-date. - // UPDATING: - // UP_TO_DATE: - optional string storage_bytes_status = 28 [json_name = "storageBytesStatus"]; +message SnapshotSettingsStorageLocationSettings { + // When the policy is SPECIFIC_LOCATIONS, snapshots will be stored in the + // locations listed in this field. Keys are Cloud Storage bucket locations. + // Only one location can be specified. + map + locations = 1 [json_name = "locations"]; + + // The chosen location policy. + // LOCAL_REGION: Store snapshot in the same region as with the originating + // disk. No additional parameters are needed. + // NEAREST_MULTI_REGION: Store snapshot in the nearest multi region Cloud + // Storage bucket, relative to the originating disk. No additional parameters + // are needed. + // SPECIFIC_LOCATIONS: Store snapshot in the specific locations, as specified + // by the user. The list of regions to store must be defined under the + // `locations` field. + // STORAGE_LOCATION_POLICY_UNSPECIFIED: + optional string policy = 2 [json_name = "policy"]; +} - // Cloud Storage bucket storage location of the snapshot (regional or - // multi-regional). - repeated string storage_locations = 29 [json_name = "storageLocations"]; +// A structure for specifying storage locations. +message SnapshotSettingsStorageLocationSettingsStorageLocationPreference { + // Name of the location. It should be one of the Cloud Storage buckets. Only + // one location can be specified. + optional string name = 1 [json_name = "name"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_117.proto b/protos/google/cloud/compute/v1/internal/common_117.proto index 686fcf1ddfec1..8a9d96b764547 100644 --- a/protos/google/cloud/compute/v1/internal/common_117.proto +++ b/protos/google/cloud/compute/v1/internal/common_117.proto @@ -15,21 +15,101 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_116.proto"; +// Represents an SSL certificate resource. Google Compute Engine has two SSL +// certificate resources: * +// [Global](/compute/docs/reference/rest/v1/sslCertificates) * +// [Regional](/compute/docs/reference/rest/v1/regionSslCertificates) The global +// SSL certificates (sslCertificates) are used by: - Global external Application +// Load Balancers - Classic Application Load Balancers - Proxy Network Load +// Balancers (with target SSL proxies) The regional SSL certificates +// (regionSslCertificates) are used by: - Regional external Application Load +// Balancers - Regional internal Application Load Balancers Optionally, +// certificate file contents that you upload can contain a set of up to five +// PEM-encoded certificates. The API call creates an object (sslCertificate) +// that holds this data. You can use SSL keys and certificates to secure +// connections to a load balancer. For more information, read Creating and using +// SSL certificates, SSL certificates quotas and limits, and Troubleshooting SSL +// certificates. +message SslCertificate { + // A value read into memory from a certificate file. The certificate file must + // be in PEM format. The certificate chain must be no greater than 5 certs + // long. The chain must include at least one intermediate cert. + optional string certificate = 1 [json_name = "certificate"]; -// Contains a list of Snapshot resources. -message SnapshotList { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + // [Output Only] Expire time of the certificate. RFC3339 + optional string expire_time = 4 [json_name = "expireTime"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 5 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#sslCertificate for SSL + // certificates. + optional string kind = 6 [json_name = "kind"]; + + // Configuration and status of a managed SSL certificate. + optional SslCertificateManagedSslCertificate managed = 7 + [json_name = "managed"]; + + // 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. + optional string name = 8 [json_name = "name"]; + + // A value read into memory from a write-only private key file. The private + // key file must be in PEM format. For security, only insert requests include + // this field. + optional string private_key = 9 [json_name = "privateKey"]; + + // [Output Only] URL of the region where the regional SSL Certificate resides. + // This field is not applicable to global SSL Certificate. + optional string region = 10 [json_name = "region"]; + + // [Output only] Server-defined URL for the resource. + optional string self_link = 11 [json_name = "selfLink"]; + + // Configuration and status of a self-managed SSL certificate. + optional SslCertificateSelfManagedSslCertificate self_managed = 12 + [json_name = "selfManaged"]; + + // [Output Only] Domains associated with the certificate via Subject + // Alternative Name. + repeated string subject_alternative_names = 13 + [json_name = "subjectAlternativeNames"]; + + // (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or + // "MANAGED". If not specified, the certificate is self-managed and the fields + // certificate and private_key are used. + // MANAGED: Google-managed SSLCertificate. + // SELF_MANAGED: Certificate uploaded by user. + // TYPE_UNSPECIFIED: + optional string type = 14 [json_name = "type"]; +} + +// Contains a list of SslCertificate resources. +message SslCertificateList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of Snapshot resources. - repeated Snapshot items = 2 [json_name = "items"]; + // A list of SslCertificate resources. + repeated SslCertificate items = 2 [json_name = "items"]; // Type of resource. optional string kind = 3 [json_name = "kind"]; @@ -128,3 +208,48 @@ message SnapshotList { // [Output Only] Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } + +// Configuration and status of a managed SSL certificate. +message SslCertificateManagedSslCertificate { + // [Output only] Detailed statuses of the domains specified for managed + // certificate resource. + map domain_status = 1 [json_name = "domainStatus"]; + + // The domains for which a managed SSL certificate will be generated. Each + // Google-managed SSL certificate supports up to the [maximum number of + // domains per Google-managed SSL + // certificate](/load-balancing/docs/quotas#ssl_certificates). + repeated string domains = 2 [json_name = "domains"]; + + // [Output only] Status of the managed certificate resource. + // ACTIVE: The certificate management is working, and a certificate has been + // provisioned. + // MANAGED_CERTIFICATE_STATUS_UNSPECIFIED: + // PROVISIONING: The certificate management is working. GCP will attempt to + // provision the first certificate. + // PROVISIONING_FAILED: Certificate provisioning failed due to an issue with + // the DNS or load balancing configuration. For details of which domain + // failed, consult domain_status field. + // PROVISIONING_FAILED_PERMANENTLY: Certificate provisioning failed due to an + // issue with the DNS or load balancing configuration. It won't be retried. To + // try again delete and create a new managed SslCertificate resource. For + // details of which domain failed, consult domain_status field. + // RENEWAL_FAILED: Renewal of the certificate has failed due to an issue with + // the DNS or load balancing configuration. The existing cert is still + // serving; however, it will expire shortly. To provision a renewed + // certificate, delete and create a new managed SslCertificate resource. For + // details on which domain failed, consult domain_status field. + optional string status = 3 [json_name = "status"]; +} + +// Configuration and status of a self-managed SSL certificate. +message SslCertificateSelfManagedSslCertificate { + // A local certificate file. The certificate must be in PEM format. The + // certificate chain must be no greater than 5 certs long. The chain must + // include at least one intermediate cert. + optional string certificate = 1 [json_name = "certificate"]; + + // A write-only private key in PEM format. Only insert requests will include + // this field. + optional string private_key = 2 [json_name = "privateKey"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_118.proto b/protos/google/cloud/compute/v1/internal/common_118.proto index 2fce3ea3cc02e..2a4245b8866af 100644 --- a/protos/google/cloud/compute/v1/internal/common_118.proto +++ b/protos/google/cloud/compute/v1/internal/common_118.proto @@ -15,42 +15,209 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message SnapshotSettings { - // Policy of which storage location is going to be resolved, and additional - // data that particularizes how the policy is going to be carried out. - optional SnapshotSettingsStorageLocationSettings storage_location = 1 - [json_name = "storageLocation"]; -} +import "google/cloud/compute/v1/internal/common_117.proto"; + +message SslCertificateAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of SslCertificatesScopedList resources. + map items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#sslCertificateAggregatedList + // for lists of SSL Certificates. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; -message SnapshotSettingsStorageLocationSettings { - // When the policy is SPECIFIC_LOCATIONS, snapshots will be stored in the - // locations listed in this field. Keys are Cloud Storage bucket locations. - // Only one location can be specified. - map - locations = 1 [json_name = "locations"]; - - // The chosen location policy. - // LOCAL_REGION: Store snapshot in the same region as with the originating - // disk. No additional parameters are needed. - // NEAREST_MULTI_REGION: Store snapshot in the nearest multi region Cloud - // Storage bucket, relative to the originating disk. No additional parameters - // are needed. - // SPECIFIC_LOCATIONS: Store snapshot in the specific locations, as specified - // by the user. The list of regions to store must be defined under the - // `locations` field. - // STORAGE_LOCATION_POLICY_UNSPECIFIED: - optional string policy = 2 [json_name = "policy"]; + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; } -// A structure for specifying storage locations. -message SnapshotSettingsStorageLocationSettingsStorageLocationPreference { - // Name of the location. It should be one of the Cloud Storage buckets. Only - // one location can be specified. - optional string name = 1 [json_name = "name"]; +message SslCertificatesScopedList { + // List of SslCertificates contained in this scope. + repeated SslCertificate ssl_certificates = 1 [json_name = "sslCertificates"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of backend services when the + // list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_119.proto b/protos/google/cloud/compute/v1/internal/common_119.proto index 8b1cce021ed22..f729404d29531 100644 --- a/protos/google/cloud/compute/v1/internal/common_119.proto +++ b/protos/google/cloud/compute/v1/internal/common_119.proto @@ -15,114 +15,39 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents an SSL certificate resource. Google Compute Engine has two SSL -// certificate resources: * -// [Global](/compute/docs/reference/rest/v1/sslCertificates) * -// [Regional](/compute/docs/reference/rest/v1/regionSslCertificates) The global -// SSL certificates (sslCertificates) are used by: - Global external Application -// Load Balancers - Classic Application Load Balancers - Proxy Network Load -// Balancers (with target SSL proxies) The regional SSL certificates -// (regionSslCertificates) are used by: - Regional external Application Load -// Balancers - Regional internal Application Load Balancers Optionally, -// certificate file contents that you upload can contain a set of up to five -// PEM-encoded certificates. The API call creates an object (sslCertificate) -// that holds this data. You can use SSL keys and certificates to secure -// connections to a load balancer. For more information, read Creating and using -// SSL certificates, SSL certificates quotas and limits, and Troubleshooting SSL -// certificates. -message SslCertificate { - // A value read into memory from a certificate file. The certificate file must - // be in PEM format. The certificate chain must be no greater than 5 certs - // long. The chain must include at least one intermediate cert. - optional string certificate = 1 [json_name = "certificate"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; - - // [Output Only] Expire time of the certificate. RFC3339 - optional string expire_time = 4 [json_name = "expireTime"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 5 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#sslCertificate for SSL - // certificates. - optional string kind = 6 [json_name = "kind"]; - - // Configuration and status of a managed SSL certificate. - optional SslCertificateManagedSslCertificate managed = 7 - [json_name = "managed"]; - - // 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. - optional string name = 8 [json_name = "name"]; - - // A value read into memory from a write-only private key file. The private - // key file must be in PEM format. For security, only insert requests include - // this field. - optional string private_key = 9 [json_name = "privateKey"]; - - // [Output Only] URL of the region where the regional SSL Certificate resides. - // This field is not applicable to global SSL Certificate. - optional string region = 10 [json_name = "region"]; - - // [Output only] Server-defined URL for the resource. - optional string self_link = 11 [json_name = "selfLink"]; - - // Configuration and status of a self-managed SSL certificate. - optional SslCertificateSelfManagedSslCertificate self_managed = 12 - [json_name = "selfManaged"]; - - // [Output Only] Domains associated with the certificate via Subject - // Alternative Name. - repeated string subject_alternative_names = 13 - [json_name = "subjectAlternativeNames"]; - - // (Optional) Specifies the type of SSL certificate, either "SELF_MANAGED" or - // "MANAGED". If not specified, the certificate is self-managed and the fields - // certificate and private_key are used. - // MANAGED: Google-managed SSLCertificate. - // SELF_MANAGED: Certificate uploaded by user. - // TYPE_UNSPECIFIED: - optional string type = 14 [json_name = "type"]; -} +import "google/cloud/compute/v1/internal/common_120.proto"; + +message SslPoliciesAggregatedList { + optional string etag = 1 [json_name = "etag"]; -// Contains a list of SslCertificate resources. -message SslCertificateList { // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; + optional string id = 2 [json_name = "id"]; - // A list of SslCertificate resources. - repeated SslCertificate items = 2 [json_name = "items"]; + // A list of SslPoliciesScopedList resources. + map items = 3 [json_name = "items"]; - // Type of resource. - optional string kind = 3 [json_name = "kind"]; + // [Output Only] Type of resource. Always compute#sslPolicyAggregatedList for + // lists of SSL Policies. + optional string kind = 4 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for // list requests. If the number of results is larger than maxResults, use the // nextPageToken as a value for the query parameter pageToken in the next list // request. Subsequent list requests will have their own nextPageToken to // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; + optional string next_page_token = 5 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + optional string self_link = 6 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 7 [json_name = "unreachables"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -206,50 +131,95 @@ message SslCertificateList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 8 [json_name = "warning"]; } -// Configuration and status of a managed SSL certificate. -message SslCertificateManagedSslCertificate { - // [Output only] Detailed statuses of the domains specified for managed - // certificate resource. - map domain_status = 1 [json_name = "domainStatus"]; - - // The domains for which a managed SSL certificate will be generated. Each - // Google-managed SSL certificate supports up to the [maximum number of - // domains per Google-managed SSL - // certificate](/load-balancing/docs/quotas#ssl_certificates). - repeated string domains = 2 [json_name = "domains"]; - - // [Output only] Status of the managed certificate resource. - // ACTIVE: The certificate management is working, and a certificate has been - // provisioned. - // MANAGED_CERTIFICATE_STATUS_UNSPECIFIED: - // PROVISIONING: The certificate management is working. GCP will attempt to - // provision the first certificate. - // PROVISIONING_FAILED: Certificate provisioning failed due to an issue with - // the DNS or load balancing configuration. For details of which domain - // failed, consult domain_status field. - // PROVISIONING_FAILED_PERMANENTLY: Certificate provisioning failed due to an - // issue with the DNS or load balancing configuration. It won't be retried. To - // try again delete and create a new managed SslCertificate resource. For - // details of which domain failed, consult domain_status field. - // RENEWAL_FAILED: Renewal of the certificate has failed due to an issue with - // the DNS or load balancing configuration. The existing cert is still - // serving; however, it will expire shortly. To provision a renewed - // certificate, delete and create a new managed SslCertificate resource. For - // details on which domain failed, consult domain_status field. - optional string status = 3 [json_name = "status"]; -} +message SslPoliciesScopedList { + // A list of SslPolicies contained in this scope. + repeated SslPolicy ssl_policies = 1 [json_name = "sslPolicies"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; -// Configuration and status of a self-managed SSL certificate. -message SslCertificateSelfManagedSslCertificate { - // A local certificate file. The certificate must be in PEM format. The - // certificate chain must be no greater than 5 certs long. The chain must - // include at least one intermediate cert. - optional string certificate = 1 [json_name = "certificate"]; + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } - // A write-only private key in PEM format. Only insert requests will include - // this field. - optional string private_key = 2 [json_name = "privateKey"]; + // Informational warning which replaces the list of SSL policies when the list + // is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_120.proto b/protos/google/cloud/compute/v1/internal/common_120.proto index 6787fece59696..63fdeb141b80c 100644 --- a/protos/google/cloud/compute/v1/internal/common_120.proto +++ b/protos/google/cloud/compute/v1/internal/common_120.proto @@ -15,23 +15,21 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_119.proto"; - -message SslCertificateAggregatedList { +message SslPoliciesList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of SslCertificatesScopedList resources. - map items = 2 [json_name = "items"]; + // A list of SslPolicy resources. + repeated SslPolicy items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#sslCertificateAggregatedList - // for lists of SSL Certificates. + // [Output Only] Type of the resource. Always compute#sslPoliciesList for + // lists of sslPolicies. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -44,9 +42,6 @@ message SslCertificateAggregatedList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -129,14 +124,88 @@ message SslCertificateAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + optional Warning warning = 6 [json_name = "warning"]; } -message SslCertificatesScopedList { - // List of SslCertificates contained in this scope. - repeated SslCertificate ssl_certificates = 1 [json_name = "sslCertificates"]; +message SslPoliciesListAvailableFeaturesResponse { + repeated string features = 1 [json_name = "features"]; +} - message Warning { +// Represents an SSL Policy resource. Use SSL policies to control SSL features, +// such as versions and cipher suites, that are offered by Application Load +// Balancers and proxy Network Load Balancers. For more information, read SSL +// policies overview. +message SslPolicy { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // A list of features enabled when the selected profile is CUSTOM. The method + // returns the set of features that can be specified in this list. This field + // must be empty if the profile is not CUSTOM. + repeated string custom_features = 2 [json_name = "customFeatures"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + // [Output Only] The list of features enabled in the SSL policy. + repeated string enabled_features = 4 [json_name = "enabledFeatures"]; + + // 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 SslPolicy. An up-to-date fingerprint must be provided in order + // to update the SslPolicy, otherwise the request will fail with error 412 + // conditionNotMet. To see the latest fingerprint, make a get() request to + // retrieve an SslPolicy. + optional string fingerprint = 5 [json_name = "fingerprint"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 6 [json_name = "id"]; + + // [Output only] Type of the resource. Always compute#sslPolicyfor SSL + // policies. + optional string kind = 7 [json_name = "kind"]; + + // The minimum version of SSL protocol that can be used by the clients to + // establish a connection with the load balancer. This can be one of TLS_1_0, + // TLS_1_1, TLS_1_2. + // TLS_1_0: TLS 1.0 + // TLS_1_1: TLS 1.1 + // TLS_1_2: TLS 1.2 + optional string min_tls_version = 8 [json_name = "minTlsVersion"]; + + // Name of the resource. 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. + optional string name = 9 [json_name = "name"]; + + // Profile specifies the set of SSL features that can be used by the load + // balancer when negotiating SSL with clients. This can be one of COMPATIBLE, + // MODERN, RESTRICTED, or CUSTOM. If using CUSTOM, the set of SSL features to + // enable must be specified in the customFeatures field. + // COMPATIBLE: Compatible profile. Allows the broadset set of clients, even + // those which support only out-of-date SSL features to negotiate with the + // load balancer. + // CUSTOM: Custom profile. Allow only the set of allowed SSL features + // specified in the customFeatures field. + // MODERN: Modern profile. Supports a wide set of SSL features, allowing + // modern clients to negotiate SSL with the load balancer. + // RESTRICTED: Restricted profile. Supports a reduced set of SSL features, + // intended to meet stricter compliance requirements. + optional string profile = 10 [json_name = "profile"]; + + // [Output Only] URL of the region where the regional SSL policy resides. This + // field is not applicable to global SSL policies. + optional string region = 11 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 12 [json_name = "selfLink"]; + + message WarningsItem { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by @@ -217,7 +286,7 @@ message SslCertificatesScopedList { optional string message = 3 [json_name = "message"]; } - // Informational warning which replaces the list of backend services when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // [Output Only] If potential misconfigurations are detected for this SSL + // policy, this field will be populated with warning messages. + repeated WarningsItem warnings = 13 [json_name = "warnings"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_121.proto b/protos/google/cloud/compute/v1/internal/common_121.proto index 3a9f7e07aac68..1c72c765a3601 100644 --- a/protos/google/cloud/compute/v1/internal/common_121.proto +++ b/protos/google/cloud/compute/v1/internal/common_121.proto @@ -15,211 +15,14 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_122.proto"; - -message SslPoliciesAggregatedList { - optional string etag = 1 [json_name = "etag"]; - - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 2 [json_name = "id"]; - - // A list of SslPoliciesScopedList resources. - map items = 3 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#sslPolicyAggregatedList for - // lists of SSL Policies. - optional string kind = 4 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 5 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 6 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 7 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; -} - -message SslPoliciesScopedList { - // A list of SslPolicies contained in this scope. - repeated SslPolicy ssl_policies = 1 [json_name = "sslPolicies"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of SSL policies when the list - // is empty. - optional Warning warning = 2 [json_name = "warning"]; +message SslPolicyReference { + // URL of the SSL policy resource. Set this to empty string to clear any + // existing SSL policy associated with the target proxy resource. + optional string ssl_policy = 1 [json_name = "sslPolicy"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_122.proto b/protos/google/cloud/compute/v1/internal/common_122.proto index 40675ab73dab8..df760cb03c8bc 100644 --- a/protos/google/cloud/compute/v1/internal/common_122.proto +++ b/protos/google/cloud/compute/v1/internal/common_122.proto @@ -15,32 +15,139 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message SslPoliciesList { +// Represents a zonal storage pool resource. +message StoragePool { + // Provisioning type of the byte capacity of the pool. + // ADVANCED: Advanced provisioning "thinly" allocates the related resource. + // STANDARD: Standard provisioning allocates the related resource for the pool + // disks' exclusive use. + // UNSPECIFIED: + optional string capacity_provisioning_type = 1 + [json_name = "capacityProvisioningType"]; + + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 3 [json_name = "description"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#storagePool for storage + // pools. + optional string kind = 5 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this storage pool, which is + // essentially a hash of the labels set used for optimistic locking. The + // fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels, otherwise + // the request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve a storage pool. + optional string label_fingerprint = 6 [json_name = "labelFingerprint"]; + + // Labels to apply to this storage pool. These can be later modified by the + // setLabels method. + map labels = 7 [json_name = "labels"]; + + // 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. + optional string name = 8 [json_name = "name"]; + + // Provisioning type of the performance-related parameters of the pool, such + // as throughput and IOPS. + // ADVANCED: Advanced provisioning "thinly" allocates the related resource. + // STANDARD: Standard provisioning allocates the related resource for the pool + // disks' exclusive use. + // UNSPECIFIED: + optional string performance_provisioning_type = 9 + [json_name = "performanceProvisioningType"]; + + // Size, in GiB, of the storage pool. For more information about the size + // limits, see https://cloud.google.com/compute/docs/disks/storage-pools. + optional string pool_provisioned_capacity_gb = 10 + [json_name = "poolProvisionedCapacityGb"]; + + // Provisioned IOPS of the storage pool. Only relevant if the storage pool + // type is hyperdisk-balanced. + optional string pool_provisioned_iops = 11 + [json_name = "poolProvisionedIops"]; + + // Provisioned throughput of the storage pool. Only relevant if the storage + // pool type is hyperdisk-balanced or hyperdisk-throughput. + optional string pool_provisioned_throughput = 12 + [json_name = "poolProvisionedThroughput"]; + + // [Output Only] Status information for the storage pool resource. + optional StoragePoolResourceStatus resource_status = 13 + [json_name = "resourceStatus"]; + + // [Output Only] Server-defined fully-qualified URL for this resource. + optional string self_link = 14 [json_name = "selfLink"]; + + // [Output Only] Server-defined URL for this resource's resource id. + optional string self_link_with_id = 15 [json_name = "selfLinkWithId"]; + + // [Output Only] The status of storage pool creation. - CREATING: Storage pool + // is provisioning. storagePool. - FAILED: Storage pool creation failed. - + // READY: Storage pool is ready for use. - DELETING: Storage pool is deleting. + // CREATING: StoragePool is provisioning + // DELETING: StoragePool is deleting. + // FAILED: StoragePool creation failed. + // READY: StoragePool is ready for use. + optional string state = 16 [json_name = "state"]; + + // [Output Only] Status information for the storage pool resource. + optional StoragePoolResourceStatus status = 17 [json_name = "status"]; + + // Type of the storage pool. + optional string storage_pool_type = 18 [json_name = "storagePoolType"]; + + // [Output Only] URL of the zone where the storage pool resides. You must + // specify this field as part of the HTTP request URL. It is not settable as a + // field in the request body. + optional string zone = 19 [json_name = "zone"]; +} + +message StoragePoolAggregatedList { + optional string etag = 1 [json_name = "etag"]; + // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; + optional string id = 2 [json_name = "id"]; - // A list of SslPolicy resources. - repeated SslPolicy items = 2 [json_name = "items"]; + // A list of StoragePoolsScopedList resources. + map items = 3 [json_name = "items"]; - // [Output Only] Type of the resource. Always compute#sslPoliciesList for - // lists of sslPolicies. - optional string kind = 3 [json_name = "kind"]; + // [Output Only] Type of resource. Always compute#storagePoolAggregatedList + // for aggregated lists of storage pools. + optional string kind = 4 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for // list requests. If the number of results is larger than maxResults, use the // nextPageToken as a value for the query parameter pageToken in the next list // request. Subsequent list requests will have their own nextPageToken to // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; + optional string next_page_token = 5 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + optional string self_link = 6 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 7 [json_name = "unreachables"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -124,88 +231,331 @@ message SslPoliciesList { } // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional Warning warning = 8 [json_name = "warning"]; } -message SslPoliciesListAvailableFeaturesResponse { - repeated string features = 1 [json_name = "features"]; -} +message StoragePoolDisk { + // [Output Only] Instances this disk is attached to. + repeated string attached_instances = 1 [json_name = "attachedInstances"]; -// Represents an SSL Policy resource. Use SSL policies to control SSL features, -// such as versions and cipher suites, that are offered by Application Load -// Balancers and proxy Network Load Balancers. For more information, read SSL -// policies overview. -message SslPolicy { // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - // A list of features enabled when the selected profile is CUSTOM. The method - // returns the set of features that can be specified in this list. This field - // must be empty if the profile is not CUSTOM. - repeated string custom_features = 2 [json_name = "customFeatures"]; + // [Output Only] The URL of the disk. + optional string disk = 3 [json_name = "disk"]; - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; + // [Output Only] The name of the disk. + optional string name = 4 [json_name = "name"]; - // [Output Only] The list of features enabled in the SSL policy. - repeated string enabled_features = 4 [json_name = "enabledFeatures"]; + // [Output Only] The number of IOPS provisioned for the disk. + optional string provisioned_iops = 5 [json_name = "provisionedIops"]; - // 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 SslPolicy. An up-to-date fingerprint must be provided in order - // to update the SslPolicy, otherwise the request will fail with error 412 - // conditionNotMet. To see the latest fingerprint, make a get() request to - // retrieve an SslPolicy. - optional string fingerprint = 5 [json_name = "fingerprint"]; + // [Output Only] The throughput provisioned for the disk. + optional string provisioned_throughput = 6 + [json_name = "provisionedThroughput"]; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 6 [json_name = "id"]; - - // [Output only] Type of the resource. Always compute#sslPolicyfor SSL - // policies. - optional string kind = 7 [json_name = "kind"]; - - // The minimum version of SSL protocol that can be used by the clients to - // establish a connection with the load balancer. This can be one of TLS_1_0, - // TLS_1_1, TLS_1_2. - // TLS_1_0: TLS 1.0 - // TLS_1_1: TLS 1.1 - // TLS_1_2: TLS 1.2 - optional string min_tls_version = 8 [json_name = "minTlsVersion"]; - - // Name of the resource. 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. - optional string name = 9 [json_name = "name"]; - - // Profile specifies the set of SSL features that can be used by the load - // balancer when negotiating SSL with clients. This can be one of COMPATIBLE, - // MODERN, RESTRICTED, or CUSTOM. If using CUSTOM, the set of SSL features to - // enable must be specified in the customFeatures field. - // COMPATIBLE: Compatible profile. Allows the broadset set of clients, even - // those which support only out-of-date SSL features to negotiate with the - // load balancer. - // CUSTOM: Custom profile. Allow only the set of allowed SSL features - // specified in the customFeatures field. - // MODERN: Modern profile. Supports a wide set of SSL features, allowing - // modern clients to negotiate SSL with the load balancer. - // RESTRICTED: Restricted profile. Supports a reduced set of SSL features, - // intended to meet stricter compliance requirements. - optional string profile = 10 [json_name = "profile"]; - - // [Output Only] URL of the region where the regional SSL policy resides. This - // field is not applicable to global SSL policies. - optional string region = 11 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 12 [json_name = "selfLink"]; - - message WarningsItem { + // [Output Only] Resource policies applied to disk for automatic snapshot + // creations. + repeated string resource_policies = 7 [json_name = "resourcePolicies"]; + + // [Output Only] The disk size, in GB. + optional string size_gb = 8 [json_name = "sizeGb"]; + + // [Output Only] The disk status. + // CREATING: Disk is provisioning + // DELETING: Disk is deleting. + // FAILED: Disk creation failed. + // READY: Disk is ready for use. + // RESTORING: Source data is being copied into the disk. + // UNAVAILABLE: Disk is currently unavailable and cannot be accessed, attached + // or detached. + optional string status = 9 [json_name = "status"]; + + // [Output Only] The disk type. + optional string type = 10 [json_name = "type"]; + + // [Output Only] Amount of disk space used. + optional string used_bytes = 11 [json_name = "usedBytes"]; +} + +// A list of StoragePool resources. +message StoragePoolList { + optional string etag = 1 [json_name = "etag"]; + + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 2 [json_name = "id"]; + + // A list of StoragePool resources. + repeated StoragePool items = 3 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#storagePoolList for lists of + // storagePools. + optional string kind = 4 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 5 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. end_interface: + // MixerListResponseWithEtagBuilder + repeated string unreachables = 7 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 8 [json_name = "warning"]; +} + +message StoragePoolListDisks { + optional string etag = 1 [json_name = "etag"]; + + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 2 [json_name = "id"]; + + // A list of StoragePoolDisk resources. + repeated StoragePoolDisk items = 3 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#storagePoolListDisks for + // lists of disks in a storagePool. + optional string kind = 4 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 5 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 6 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. end_interface: + // MixerListResponseWithEtagBuilder + repeated string unreachables = 7 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 8 [json_name = "warning"]; +} + +// [Output Only] Contains output only fields. +message StoragePoolResourceStatus { + // [Output Only] Number of disks used. + optional string disk_count = 1 [json_name = "diskCount"]; + + // [Output Only] Timestamp of the last successful resize in RFC3339 text + // format. + optional string last_resize_timestamp = 2 [json_name = "lastResizeTimestamp"]; + + // [Output Only] Maximum allowed aggregate disk size in gigabytes. + optional string max_total_provisioned_disk_capacity_gb = 3 + [json_name = "maxTotalProvisionedDiskCapacityGb"]; + + // [Output Only] Space used by data stored in disks within the storage pool + // (in bytes). This will reflect the total number of bytes written to the + // disks in the pool, in contrast to the capacity of those disks. + optional string pool_used_capacity_bytes = 4 + [json_name = "poolUsedCapacityBytes"]; + + // [Output Only] Sum of all the disks' provisioned IOPS, minus some amount + // that is allowed per disk that is not counted towards pool's IOPS capacity. + // For more information, see + // https://cloud.google.com/compute/docs/disks/storage-pools. + optional string pool_used_iops = 5 [json_name = "poolUsedIops"]; + + // [Output Only] Sum of all the disks' provisioned throughput in MB/s. + optional string pool_used_throughput = 6 [json_name = "poolUsedThroughput"]; + + // [Output Only] Amount of data written into the pool, before it is compacted. + optional string pool_user_written_bytes = 7 + [json_name = "poolUserWrittenBytes"]; + + // [Output Only] Sum of all the capacity provisioned in disks in this storage + // pool. A disk's provisioned capacity is the same as its total capacity. + optional string total_provisioned_disk_capacity_gb = 8 + [json_name = "totalProvisionedDiskCapacityGb"]; + + // [Output Only] Sum of all the disks' provisioned IOPS. + optional string total_provisioned_disk_iops = 9 + [json_name = "totalProvisionedDiskIops"]; + + // [Output Only] Sum of all the disks' provisioned throughput in MB/s, minus + // some amount that is allowed per disk that is not counted towards pool's + // throughput capacity. + optional string total_provisioned_disk_throughput = 10 + [json_name = "totalProvisionedDiskThroughput"]; +} + +message StoragePoolsScopedList { + // [Output Only] A list of storage pool contained in this scope. + repeated StoragePool storage_pools = 1 [json_name = "storagePools"]; + + message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by @@ -286,7 +636,7 @@ message SslPolicy { optional string message = 3 [json_name = "message"]; } - // [Output Only] If potential misconfigurations are detected for this SSL - // policy, this field will be populated with warning messages. - repeated WarningsItem warnings = 13 [json_name = "warnings"]; + // [Output Only] Informational warning which replaces the list of storage pool + // when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_123.proto b/protos/google/cloud/compute/v1/internal/common_123.proto index c342e7c956c63..d3bd464796177 100644 --- a/protos/google/cloud/compute/v1/internal/common_123.proto +++ b/protos/google/cloud/compute/v1/internal/common_123.proto @@ -15,14 +15,379 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message SslPolicyReference { - // URL of the SSL policy resource. Set this to empty string to clear any - // existing SSL policy associated with the target proxy resource. - optional string ssl_policy = 1 [json_name = "sslPolicy"]; +import "google/cloud/compute/v1/internal/common_022.proto"; + +message StoragePoolType { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // [Output Only] The deprecation status associated with this storage pool + // type. + optional DeprecationStatus deprecated = 2 [json_name = "deprecated"]; + + // [Output Only] An optional description of this resource. + optional string description = 3 [json_name = "description"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // [Output Only] Type of the resource. Always compute#storagePoolType for + // storage pool types. + optional string kind = 5 [json_name = "kind"]; + + // [Output Only] Maximum storage pool size in GB. + optional string max_pool_provisioned_capacity_gb = 6 + [json_name = "maxPoolProvisionedCapacityGb"]; + + // [Output Only] Maximum provisioned IOPS. + optional string max_pool_provisioned_iops = 7 + [json_name = "maxPoolProvisionedIops"]; + + // [Output Only] Maximum provisioned throughput. + optional string max_pool_provisioned_throughput = 8 + [json_name = "maxPoolProvisionedThroughput"]; + + // [Output Only] Minimum storage pool size in GB. + optional string min_pool_provisioned_capacity_gb = 9 + [json_name = "minPoolProvisionedCapacityGb"]; + + // [Output Only] Minimum provisioned IOPS. + optional string min_pool_provisioned_iops = 10 + [json_name = "minPoolProvisionedIops"]; + + // [Output Only] Minimum provisioned throughput. + optional string min_pool_provisioned_throughput = 11 + [json_name = "minPoolProvisionedThroughput"]; + + // [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb + // instead. + optional string min_size_gb = 12 [json_name = "minSizeGb"]; + + // [Output Only] Name of the resource. + optional string name = 13 [json_name = "name"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 14 [json_name = "selfLink"]; + + // [Output Only] Server-defined URL for this resource with the resource id. + optional string self_link_with_id = 15 [json_name = "selfLinkWithId"]; + + // [Output Only] The list of disk types supported in this storage pool type. + repeated string supported_disk_types = 16 [json_name = "supportedDiskTypes"]; + + // [Output Only] URL of the zone where the storage pool type resides. You must + // specify this field as part of the HTTP request URL. It is not settable as a + // field in the request body. + optional string zone = 17 [json_name = "zone"]; +} + +message StoragePoolTypeAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of StoragePoolTypesScopedList resources. + map items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always + // compute#storagePoolTypeAggregatedList . + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +// Contains a list of storage pool types. +message StoragePoolTypeList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of StoragePoolType resources. + repeated StoragePoolType items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#storagePoolTypeList for + // storage pool types. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message StoragePoolTypesScopedList { + // [Output Only] A list of storage pool types contained in this scope. + repeated StoragePoolType storage_pool_types = 1 + [json_name = "storagePoolTypes"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning which replaces the list of storage pool + // types when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_124.proto b/protos/google/cloud/compute/v1/internal/common_124.proto index dc5752cf8c597..f7203c25dbc50 100644 --- a/protos/google/cloud/compute/v1/internal/common_124.proto +++ b/protos/google/cloud/compute/v1/internal/common_124.proto @@ -15,139 +15,208 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a zonal storage pool resource. -message StoragePool { - // Provisioning type of the byte capacity of the pool. - // ADVANCED: Advanced provisioning "thinly" allocates the related resource. - // STANDARD: Standard provisioning allocates the related resource for the pool - // disks' exclusive use. - // UNSPECIFIED: - optional string capacity_provisioning_type = 1 - [json_name = "capacityProvisioningType"]; - +// Represents a Subnetwork resource. A subnetwork (also known as a subnet) is a +// logical partition of a Virtual Private Cloud network with one primary IP +// range and zero or more secondary IP ranges. For more information, read +// Virtual Private Cloud (VPC) Network. +message Subnetwork { // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 3 [json_name = "description"]; + // create the resource. This field can be set only at resource creation time. + optional string description = 2 [json_name = "description"]; + + // Whether to enable flow logging for this subnetwork. If this field is not + // explicitly set, it will not appear in get listings. If not set the default + // behavior is determined by the org policy, if there is no org policy + // specified, then it will default to disabled. This field isn't supported if + // the subnet purpose field is set to REGIONAL_MANAGED_PROXY. + optional bool enable_flow_logs = 3 [json_name = "enableFlowLogs"]; + + // The external IPv6 address range that is owned by this subnetwork. + optional string external_ipv6_prefix = 4 [json_name = "externalIpv6Prefix"]; + + // 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. To see the latest fingerprint, make a get() request to + // retrieve a Subnetwork. + optional string fingerprint = 5 [json_name = "fingerprint"]; + + // [Output Only] The gateway address for default routes to reach destination + // addresses outside this subnetwork. + optional string gateway_address = 6 [json_name = "gatewayAddress"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 4 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#storagePool for storage - // pools. - optional string kind = 5 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this storage pool, which is - // essentially a hash of the labels set used for optimistic locking. The - // fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels, otherwise - // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve a storage pool. - optional string label_fingerprint = 6 [json_name = "labelFingerprint"]; - - // Labels to apply to this storage pool. These can be later modified by the - // setLabels method. - map labels = 7 [json_name = "labels"]; - - // 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. - optional string name = 8 [json_name = "name"]; - - // Provisioning type of the performance-related parameters of the pool, such - // as throughput and IOPS. - // ADVANCED: Advanced provisioning "thinly" allocates the related resource. - // STANDARD: Standard provisioning allocates the related resource for the pool - // disks' exclusive use. - // UNSPECIFIED: - optional string performance_provisioning_type = 9 - [json_name = "performanceProvisioningType"]; - - // Size, in GiB, of the storage pool. For more information about the size - // limits, see https://cloud.google.com/compute/docs/disks/storage-pools. - optional string pool_provisioned_capacity_gb = 10 - [json_name = "poolProvisionedCapacityGb"]; - - // Provisioned IOPS of the storage pool. Only relevant if the storage pool - // type is hyperdisk-balanced. - optional string pool_provisioned_iops = 11 - [json_name = "poolProvisionedIops"]; - - // Provisioned throughput of the storage pool. Only relevant if the storage - // pool type is hyperdisk-balanced or hyperdisk-throughput. - optional string pool_provisioned_throughput = 12 - [json_name = "poolProvisionedThroughput"]; - - // [Output Only] Status information for the storage pool resource. - optional StoragePoolResourceStatus resource_status = 13 - [json_name = "resourceStatus"]; - - // [Output Only] Server-defined fully-qualified URL for this resource. - optional string self_link = 14 [json_name = "selfLink"]; - - // [Output Only] Server-defined URL for this resource's resource id. - optional string self_link_with_id = 15 [json_name = "selfLinkWithId"]; - - // [Output Only] The status of storage pool creation. - CREATING: Storage pool - // is provisioning. storagePool. - FAILED: Storage pool creation failed. - - // READY: Storage pool is ready for use. - DELETING: Storage pool is deleting. - // CREATING: StoragePool is provisioning - // DELETING: StoragePool is deleting. - // FAILED: StoragePool creation failed. - // READY: StoragePool is ready for use. - optional string state = 16 [json_name = "state"]; - - // [Output Only] Status information for the storage pool resource. - optional StoragePoolResourceStatus status = 17 [json_name = "status"]; - - // Type of the storage pool. - optional string storage_pool_type = 18 [json_name = "storagePoolType"]; - - // [Output Only] URL of the zone where the storage pool resides. You must - // specify this field as part of the HTTP request URL. It is not settable as a - // field in the request body. - optional string zone = 19 [json_name = "zone"]; + optional string id = 7 [json_name = "id"]; + + // The internal IPv6 address range that is owned by this subnetwork. + optional string internal_ipv6_prefix = 8 [json_name = "internalIpv6Prefix"]; + + // 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. The + // range can be any range listed in the Valid ranges list. The range can be + // expanded after creation using expandIpCidrRange. + optional string ip_cidr_range = 9 [json_name = "ipCidrRange"]; + + // 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. + // EXTERNAL: VMs on this subnet will be assigned IPv6 addresses that are + // accessible via the Internet, as well as the VPC network. + // INTERNAL: VMs on this subnet will be assigned IPv6 addresses that are only + // accessible over the VPC network. + optional string ipv6_access_type = 10 [json_name = "ipv6AccessType"]; + + // [Output Only] This field is for internal use. + optional string ipv6_cidr_range = 11 [json_name = "ipv6CidrRange"]; + + // [Output Only] Type of the resource. Always compute#subnetwork for + // Subnetwork resources. + optional string kind = 12 [json_name = "kind"]; + + // This field denotes the VPC flow logging options for this subnetwork. If + // logging is enabled, logs are exported to Cloud Logging. + optional SubnetworkLogConfig log_config = 13 [json_name = "logConfig"]; + + // The name of the resource, provided by the client when initially creating + // the resource. 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. + optional string name = 14 [json_name = "name"]; + + // The URL of the network to which this subnetwork belongs, provided by the + // client when initially creating the subnetwork. This field can be set only + // at resource creation time. + optional string network = 15 [json_name = "network"]; + + // Whether the VMs in this subnet can access Google services without assigned + // external IP addresses. This field can be both set at resource creation time + // and updated using setPrivateIpGoogleAccess. + optional bool private_ip_google_access = 16 + [json_name = "privateIpGoogleAccess"]; + + // This field is for internal use. This field can be both set at resource + // creation time and updated using patch. + // DISABLE_GOOGLE_ACCESS: Disable private IPv6 access to/from Google services. + // ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE: Bidirectional private IPv6 access + // to/from Google services. + // ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE: Outbound private IPv6 access from VMs + // in this subnet to Google services. + optional string private_ipv6_google_access = 17 + [json_name = "privateIpv6GoogleAccess"]; + + // The purpose of the resource. This field can be either PRIVATE, + // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or + // PRIVATE is the default purpose for user-created subnets or subnets that are + // automatically created in auto mode networks. Subnets with purpose set to + // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks + // that are reserved for Envoy-based load balancers. A subnet with purpose set + // to PRIVATE_SERVICE_CONNECT is used to publish services using Private + // Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. + // The enableFlowLogs field isn't supported if the subnet purpose field is set + // to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. + // GLOBAL_MANAGED_PROXY: Subnet reserved for Global Envoy-based Load + // Balancing. + // INTERNAL_HTTPS_LOAD_BALANCER: Subnet reserved for Internal HTTP(S) Load + // Balancing. This is a legacy purpose, please use REGIONAL_MANAGED_PROXY + // instead. + // PRIVATE: Regular user created or automatically created subnet. + // PRIVATE_NAT: Subnetwork used as source range for Private NAT Gateways. + // PRIVATE_RFC_1918: Regular user created or automatically created subnet. + // PRIVATE_SERVICE_CONNECT: Subnetworks created for Private Service Connect in + // the producer network. + // REGIONAL_MANAGED_PROXY: Subnetwork used for Regional Envoy-based Load + // Balancing. + optional string purpose = 18 [json_name = "purpose"]; + + // URL of the region where the Subnetwork resides. This field can be set only + // at resource creation time. + optional string region = 19 [json_name = "region"]; + + // The URL of the reserved internal range. + optional string reserved_internal_range = 25 + [json_name = "reservedInternalRange"]; + + // The role of subnetwork. Currently, this field is only used when purpose is + // set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set + // to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being + // used for Envoy-based load balancers in a region. A BACKUP subnetwork is one + // that is ready to be promoted to ACTIVE or is currently draining. This field + // can be updated with a patch request. + // ACTIVE: The ACTIVE subnet that is currently used. + // BACKUP: The BACKUP subnet that could be promoted to ACTIVE. + optional string role = 20 [json_name = "role"]; + + // An array of configurations for secondary IP ranges for VM instances + // contained in this subnetwork. The primary IP of such VM must belong to the + // primary ipCidrRange of the subnetwork. The alias IPs may belong to either + // primary or secondary ranges. This field can be updated with a patch + // request. + repeated SubnetworkSecondaryRange secondary_ip_ranges = 21 + [json_name = "secondaryIpRanges"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 22 [json_name = "selfLink"]; + + // The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet + // are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the + // subnet can be assigned both IPv4 and IPv6 addresses. If not specified, + // IPV4_ONLY is used. This field can be both set at resource creation time and + // updated using patch. + // IPV4_IPV6: New VMs in this subnet can have both IPv4 and IPv6 addresses. + // IPV4_ONLY: New VMs in this subnet will only be assigned IPv4 addresses. + // IPV6_ONLY: New VMs in this subnet will only be assigned IPv6 addresses. + optional string stack_type = 23 [json_name = "stackType"]; + + // [Output Only] The state of the subnetwork, which can be one of the + // following values: READY: Subnetwork is created and ready to use DRAINING: + // 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 + // DRAINING: Subnetwork is being drained. + // READY: Subnetwork is ready for use. + optional string state = 24 [json_name = "state"]; } -message StoragePoolAggregatedList { - optional string etag = 1 [json_name = "etag"]; - +message SubnetworkAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 2 [json_name = "id"]; + optional string id = 1 [json_name = "id"]; - // A list of StoragePoolsScopedList resources. - map items = 3 [json_name = "items"]; + // A list of SubnetworksScopedList resources. + map items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#storagePoolAggregatedList - // for aggregated lists of storage pools. - optional string kind = 4 [json_name = "kind"]; + // [Output Only] Type of resource. Always compute#subnetworkAggregatedList for + // aggregated lists of subnetworks. + optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for // list requests. If the number of results is larger than maxResults, use the // nextPageToken as a value for the query parameter pageToken in the next list // request. Subsequent list requests will have their own nextPageToken to // continue paging through the results. - optional string next_page_token = 5 [json_name = "nextPageToken"]; + optional string next_page_token = 4 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. - optional string self_link = 6 [json_name = "selfLink"]; + optional string self_link = 5 [json_name = "selfLink"]; // [Output Only] Unreachable resources. - repeated string unreachables = 7 [json_name = "unreachables"]; + repeated string unreachables = 6 [json_name = "unreachables"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -231,80 +300,30 @@ message StoragePoolAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; + optional Warning warning = 7 [json_name = "warning"]; } -message StoragePoolDisk { - // [Output Only] Instances this disk is attached to. - repeated string attached_instances = 1 [json_name = "attachedInstances"]; - - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - - // [Output Only] The URL of the disk. - optional string disk = 3 [json_name = "disk"]; - - // [Output Only] The name of the disk. - optional string name = 4 [json_name = "name"]; - - // [Output Only] The number of IOPS provisioned for the disk. - optional string provisioned_iops = 5 [json_name = "provisionedIops"]; - - // [Output Only] The throughput provisioned for the disk. - optional string provisioned_throughput = 6 - [json_name = "provisionedThroughput"]; - - // [Output Only] Resource policies applied to disk for automatic snapshot - // creations. - repeated string resource_policies = 7 [json_name = "resourcePolicies"]; - - // [Output Only] The disk size, in GB. - optional string size_gb = 8 [json_name = "sizeGb"]; - - // [Output Only] The disk status. - // CREATING: Disk is provisioning - // DELETING: Disk is deleting. - // FAILED: Disk creation failed. - // READY: Disk is ready for use. - // RESTORING: Source data is being copied into the disk. - // UNAVAILABLE: Disk is currently unavailable and cannot be accessed, attached - // or detached. - optional string status = 9 [json_name = "status"]; - - // [Output Only] The disk type. - optional string type = 10 [json_name = "type"]; - - // [Output Only] Amount of disk space used. - optional string used_bytes = 11 [json_name = "usedBytes"]; -} - -// A list of StoragePool resources. -message StoragePoolList { - optional string etag = 1 [json_name = "etag"]; - +// Contains a list of Subnetwork resources. +message SubnetworkList { // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 2 [json_name = "id"]; + optional string id = 1 [json_name = "id"]; - // A list of StoragePool resources. - repeated StoragePool items = 3 [json_name = "items"]; + // A list of Subnetwork resources. + repeated Subnetwork items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#storagePoolList for lists of - // storagePools. - optional string kind = 4 [json_name = "kind"]; + // [Output Only] Type of resource. Always compute#subnetworkList for lists of + // subnetworks. + optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for // list requests. If the number of results is larger than maxResults, use the // nextPageToken as a value for the query parameter pageToken in the next list // request. Subsequent list requests will have their own nextPageToken to // continue paging through the results. - optional string next_page_token = 5 [json_name = "nextPageToken"]; + optional string next_page_token = 4 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. - optional string self_link = 6 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. end_interface: - // MixerListResponseWithEtagBuilder - repeated string unreachables = 7 [json_name = "unreachables"]; + optional string self_link = 5 [json_name = "selfLink"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -388,35 +407,86 @@ message StoragePoolList { } // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; + optional Warning warning = 6 [json_name = "warning"]; } -message StoragePoolListDisks { - optional string etag = 1 [json_name = "etag"]; - - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 2 [json_name = "id"]; - - // A list of StoragePoolDisk resources. - repeated StoragePoolDisk items = 3 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#storagePoolListDisks for - // lists of disks in a storagePool. - optional string kind = 4 [json_name = "kind"]; +// The available logging options for this subnetwork. +message SubnetworkLogConfig { + // Can only be specified if VPC flow logging for this subnetwork is enabled. + // Toggles the aggregation interval for collecting flow logs. Increasing the + // interval time will reduce the amount of generated flow logs for long + // lasting connections. Default is an interval of 5 seconds per connection. + // INTERVAL_10_MIN: + // INTERVAL_15_MIN: + // INTERVAL_1_MIN: + // INTERVAL_30_SEC: + // INTERVAL_5_MIN: + // INTERVAL_5_SEC: + optional string aggregation_interval = 1 [json_name = "aggregationInterval"]; + + // Whether to enable flow logging for this subnetwork. If this field is not + // explicitly set, it will not appear in get listings. If not set the default + // behavior is determined by the org policy, if there is no org policy + // specified, then it will default to disabled. Flow logging isn't supported + // if the subnet purpose field is set to REGIONAL_MANAGED_PROXY. + optional bool enable = 2 [json_name = "enable"]; + + // Can only be specified if VPC flow logs for this subnetwork is enabled. The + // filter expression is used to define which VPC flow logs should be exported + // to Cloud Logging. + optional string filter_expr = 3 [json_name = "filterExpr"]; + + // Can only be specified if VPC flow logging for this subnetwork is enabled. + // The value of the field must be in [0, 1]. Set the sampling rate of VPC flow + // logs within the subnetwork where 1.0 means all collected logs are reported + // and 0.0 means no logs are reported. Default is 0.5 unless otherwise + // specified by the org policy, which means half of all collected logs are + // reported. + optional float flow_sampling = 4 [json_name = "flowSampling"]; + + // Can only be specified if VPC flow logs for this subnetwork is enabled. + // Configures whether all, none or a subset of metadata fields should be added + // to the reported VPC flow logs. Default is EXCLUDE_ALL_METADATA. + // CUSTOM_METADATA: + // EXCLUDE_ALL_METADATA: + // INCLUDE_ALL_METADATA: + optional string metadata = 5 [json_name = "metadata"]; + + // Can only be specified if VPC flow logs for this subnetwork is enabled and + // "metadata" was set to CUSTOM_METADATA. + repeated string metadata_fields = 6 [json_name = "metadataFields"]; +} - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 5 [json_name = "nextPageToken"]; +// Represents a secondary IP range of a subnetwork. +message SubnetworkSecondaryRange { + // The range of IP addresses belonging to this subnetwork secondary range. + // Provide this property when you create the subnetwork. Ranges must be unique + // and non-overlapping with all primary and secondary IP ranges within a + // network. Only IPv4 is supported. The range can be any range listed in the + // Valid ranges list. + optional string ip_cidr_range = 1 [json_name = "ipCidrRange"]; + + // The name associated with this subnetwork secondary range, used when adding + // an alias IP range to a VM instance. The name must be 1-63 characters long, + // and comply with RFC1035. The name must be unique within the subnetwork. + optional string range_name = 2 [json_name = "rangeName"]; + + // The URL of the reserved internal range. + optional string reserved_internal_range = 3 + [json_name = "reservedInternalRange"]; +} - // [Output Only] Server-defined URL for this resource. - optional string self_link = 6 [json_name = "selfLink"]; +message SubnetworksExpandIpCidrRangeRequest { + // The IP (in CIDR format or netmask) of internal addresses that are legal on + // this Subnetwork. This range should be disjoint from other subnetworks + // within this network. This range can only be larger than (i.e. a superset + // of) the range previously defined before the update. + optional string ip_cidr_range = 1 [json_name = "ipCidrRange"]; +} - // [Output Only] Unreachable resources. end_interface: - // MixerListResponseWithEtagBuilder - repeated string unreachables = 7 [json_name = "unreachables"]; +message SubnetworksScopedList { + // A list of subnetworks contained in this scope. + repeated Subnetwork subnetworks = 1 [json_name = "subnetworks"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -499,61 +569,127 @@ message StoragePoolListDisks { optional string message = 3 [json_name = "message"]; } - // [Output Only] Informational warning message. - optional Warning warning = 8 [json_name = "warning"]; + // An informational warning that appears when the list of addresses is empty. + optional Warning warning = 2 [json_name = "warning"]; } -// [Output Only] Contains output only fields. -message StoragePoolResourceStatus { - // [Output Only] Number of disks used. - optional string disk_count = 1 [json_name = "diskCount"]; - - // [Output Only] Timestamp of the last successful resize in RFC3339 text - // format. - optional string last_resize_timestamp = 2 [json_name = "lastResizeTimestamp"]; - - // [Output Only] Maximum allowed aggregate disk size in gigabytes. - optional string max_total_provisioned_disk_capacity_gb = 3 - [json_name = "maxTotalProvisionedDiskCapacityGb"]; - - // [Output Only] Space used by data stored in disks within the storage pool - // (in bytes). This will reflect the total number of bytes written to the - // disks in the pool, in contrast to the capacity of those disks. - optional string pool_used_capacity_bytes = 4 - [json_name = "poolUsedCapacityBytes"]; - - // [Output Only] Sum of all the disks' provisioned IOPS, minus some amount - // that is allowed per disk that is not counted towards pool's IOPS capacity. - // For more information, see - // https://cloud.google.com/compute/docs/disks/storage-pools. - optional string pool_used_iops = 5 [json_name = "poolUsedIops"]; - - // [Output Only] Sum of all the disks' provisioned throughput in MB/s. - optional string pool_used_throughput = 6 [json_name = "poolUsedThroughput"]; - - // [Output Only] Amount of data written into the pool, before it is compacted. - optional string pool_user_written_bytes = 7 - [json_name = "poolUserWrittenBytes"]; - - // [Output Only] Sum of all the capacity provisioned in disks in this storage - // pool. A disk's provisioned capacity is the same as its total capacity. - optional string total_provisioned_disk_capacity_gb = 8 - [json_name = "totalProvisionedDiskCapacityGb"]; - - // [Output Only] Sum of all the disks' provisioned IOPS. - optional string total_provisioned_disk_iops = 9 - [json_name = "totalProvisionedDiskIops"]; - - // [Output Only] Sum of all the disks' provisioned throughput in MB/s, minus - // some amount that is allowed per disk that is not counted towards pool's - // throughput capacity. - optional string total_provisioned_disk_throughput = 10 - [json_name = "totalProvisionedDiskThroughput"]; +message SubnetworksSetPrivateIpGoogleAccessRequest { + optional bool private_ip_google_access = 1 + [json_name = "privateIpGoogleAccess"]; } -message StoragePoolsScopedList { - // [Output Only] A list of storage pool contained in this scope. - repeated StoragePool storage_pools = 1 [json_name = "storagePools"]; +// Subnetwork which the current user has compute.subnetworks.use permission on. +message UsableSubnetwork { + // [Output Only] The external IPv6 address range that is assigned to this + // subnetwork. + optional string external_ipv6_prefix = 1 [json_name = "externalIpv6Prefix"]; + + // [Output Only] The internal IPv6 address range that is assigned to this + // subnetwork. + optional string internal_ipv6_prefix = 2 [json_name = "internalIpv6Prefix"]; + + // The range of internal addresses that are owned by this subnetwork. + optional string ip_cidr_range = 3 [json_name = "ipCidrRange"]; + + // 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. + // EXTERNAL: VMs on this subnet will be assigned IPv6 addresses that are + // accessible via the Internet, as well as the VPC network. + // INTERNAL: VMs on this subnet will be assigned IPv6 addresses that are only + // accessible over the VPC network. + optional string ipv6_access_type = 4 [json_name = "ipv6AccessType"]; + + // Network URL. + optional string network = 5 [json_name = "network"]; + + // The purpose of the resource. This field can be either PRIVATE, + // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or + // PRIVATE is the default purpose for user-created subnets or subnets that are + // automatically created in auto mode networks. Subnets with purpose set to + // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks + // that are reserved for Envoy-based load balancers. A subnet with purpose set + // to PRIVATE_SERVICE_CONNECT is used to publish services using Private + // Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. + // The enableFlowLogs field isn't supported if the subnet purpose field is set + // to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. + // GLOBAL_MANAGED_PROXY: Subnet reserved for Global Envoy-based Load + // Balancing. + // INTERNAL_HTTPS_LOAD_BALANCER: Subnet reserved for Internal HTTP(S) Load + // Balancing. This is a legacy purpose, please use REGIONAL_MANAGED_PROXY + // instead. + // PRIVATE: Regular user created or automatically created subnet. + // PRIVATE_NAT: Subnetwork used as source range for Private NAT Gateways. + // PRIVATE_RFC_1918: Regular user created or automatically created subnet. + // PRIVATE_SERVICE_CONNECT: Subnetworks created for Private Service Connect in + // the producer network. + // REGIONAL_MANAGED_PROXY: Subnetwork used for Regional Envoy-based Load + // Balancing. + optional string purpose = 6 [json_name = "purpose"]; + + // The role of subnetwork. Currently, this field is only used when purpose is + // set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set + // to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being + // used for Envoy-based load balancers in a region. A BACKUP subnetwork is one + // that is ready to be promoted to ACTIVE or is currently draining. This field + // can be updated with a patch request. + // ACTIVE: The ACTIVE subnet that is currently used. + // BACKUP: The BACKUP subnet that could be promoted to ACTIVE. + optional string role = 7 [json_name = "role"]; + + // Secondary IP ranges. + repeated UsableSubnetworkSecondaryRange secondary_ip_ranges = 8 + [json_name = "secondaryIpRanges"]; + + // The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet + // are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the + // subnet can be assigned both IPv4 and IPv6 addresses. If not specified, + // IPV4_ONLY is used. This field can be both set at resource creation time and + // updated using patch. + // IPV4_IPV6: New VMs in this subnet can have both IPv4 and IPv6 addresses. + // IPV4_ONLY: New VMs in this subnet will only be assigned IPv4 addresses. + // IPV6_ONLY: New VMs in this subnet will only be assigned IPv6 addresses. + optional string stack_type = 9 [json_name = "stackType"]; + + // Subnetwork URL. + optional string subnetwork = 10 [json_name = "subnetwork"]; +} + +// Secondary IP range of a usable subnetwork. +message UsableSubnetworkSecondaryRange { + // The range of IP addresses belonging to this subnetwork secondary range. + optional string ip_cidr_range = 1 [json_name = "ipCidrRange"]; + + // The name associated with this subnetwork secondary range, used when adding + // an alias IP range to a VM instance. The name must be 1-63 characters long, + // and comply with RFC1035. The name must be unique within the subnetwork. + optional string range_name = 2 [json_name = "rangeName"]; +} + +message UsableSubnetworksAggregatedList { + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 1 [json_name = "id"]; + + // [Output] A list of usable subnetwork URLs. + repeated UsableSubnetwork items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always + // compute#usableSubnetworksAggregatedList for aggregated lists of usable + // subnetworks. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. In special cases listUsable may return + // 0 subnetworks and nextPageToken which still should be used to get the next + // page of results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -636,7 +772,6 @@ message StoragePoolsScopedList { optional string message = 3 [json_name = "message"]; } - // [Output Only] Informational warning which replaces the list of storage pool - // when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_125.proto b/protos/google/cloud/compute/v1/internal/common_125.proto index e9ec86e2e9b37..23f7e43c63df8 100644 --- a/protos/google/cloud/compute/v1/internal/common_125.proto +++ b/protos/google/cloud/compute/v1/internal/common_125.proto @@ -15,195 +15,83 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; - -message StoragePoolType { +// Represents a Target gRPC Proxy resource. A target gRPC proxy is a component +// of load balancers intended for load balancing gRPC traffic. Only global +// forwarding rules with load balancing scheme INTERNAL_SELF_MANAGED can +// reference a target gRPC proxy. The target gRPC Proxy references a URL map +// that specifies how traffic is routed to gRPC backend services. +message TargetGrpcProxy { // [Output Only] Creation timestamp in RFC3339 text format. optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - // [Output Only] The deprecation status associated with this storage pool - // type. - optional DeprecationStatus deprecated = 2 [json_name = "deprecated"]; + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; - // [Output Only] An optional description of this resource. - optional string description = 3 [json_name = "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 TargetGrpcProxy. An up-to-date fingerprint must be provided in + // order to patch/update the TargetGrpcProxy; otherwise, the request will fail + // with error 412 conditionNotMet. To see the latest fingerprint, make a get() + // request to retrieve the TargetGrpcProxy. + optional string fingerprint = 3 [json_name = "fingerprint"]; - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. + // [Output Only] The unique identifier for the resource type. The server + // generates this identifier. optional string id = 4 [json_name = "id"]; - // [Output Only] Type of the resource. Always compute#storagePoolType for - // storage pool types. + // [Output Only] Type of the resource. Always compute#targetGrpcProxy for + // target grpc proxies. optional string kind = 5 [json_name = "kind"]; - // [Output Only] Maximum storage pool size in GB. - optional string max_pool_provisioned_capacity_gb = 6 - [json_name = "maxPoolProvisionedCapacityGb"]; - - // [Output Only] Maximum provisioned IOPS. - optional string max_pool_provisioned_iops = 7 - [json_name = "maxPoolProvisionedIops"]; - - // [Output Only] Maximum provisioned throughput. - optional string max_pool_provisioned_throughput = 8 - [json_name = "maxPoolProvisionedThroughput"]; - - // [Output Only] Minimum storage pool size in GB. - optional string min_pool_provisioned_capacity_gb = 9 - [json_name = "minPoolProvisionedCapacityGb"]; - - // [Output Only] Minimum provisioned IOPS. - optional string min_pool_provisioned_iops = 10 - [json_name = "minPoolProvisionedIops"]; - - // [Output Only] Minimum provisioned throughput. - optional string min_pool_provisioned_throughput = 11 - [json_name = "minPoolProvisionedThroughput"]; - - // [Deprecated] This field is deprecated. Use minPoolProvisionedCapacityGb - // instead. - optional string min_size_gb = 12 [json_name = "minSizeGb"]; - - // [Output Only] Name of the resource. - optional string name = 13 [json_name = "name"]; + // 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. + optional string name = 6 [json_name = "name"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 14 [json_name = "selfLink"]; - - // [Output Only] Server-defined URL for this resource with the resource id. - optional string self_link_with_id = 15 [json_name = "selfLinkWithId"]; - - // [Output Only] The list of disk types supported in this storage pool type. - repeated string supported_disk_types = 16 [json_name = "supportedDiskTypes"]; - - // [Output Only] URL of the zone where the storage pool type resides. You must - // specify this field as part of the HTTP request URL. It is not settable as a - // field in the request body. - optional string zone = 17 [json_name = "zone"]; -} - -message StoragePoolTypeAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of StoragePoolTypesScopedList resources. - map items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always - // compute#storagePoolTypeAggregatedList . - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + optional string self_link = 7 [json_name = "selfLink"]; + + // [Output Only] Server-defined URL with id for the resource. + optional string self_link_with_id = 8 [json_name = "selfLinkWithId"]; + + // URL to the UrlMap resource that defines the mapping from URL to the + // BackendService. The protocol field in the BackendService must be set to + // GRPC. + optional string url_map = 9 [json_name = "urlMap"]; + + // If true, indicates that the BackendServices referenced by the urlMap may be + // accessed by gRPC applications without using a sidecar proxy. This will + // enable configuration checks on urlMap and its referenced BackendServices to + // not allow unsupported features. A gRPC application must use "xds:///" + // scheme in the target URI of the service it is connecting to. If false, + // indicates that the BackendServices referenced by the urlMap will be + // accessed by gRPC applications via a sidecar proxy. In this case, a gRPC + // application must not use "xds:///" scheme in the target URI of the service + // it is connecting to + optional bool validate_for_proxyless = 10 + [json_name = "validateForProxyless"]; } -// Contains a list of storage pool types. -message StoragePoolTypeList { +message TargetGrpcProxyList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of StoragePoolType resources. - repeated StoragePoolType items = 2 [json_name = "items"]; + // A list of TargetGrpcProxy resources. + repeated TargetGrpcProxy items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#storagePoolTypeList for - // storage pool types. + // [Output Only] Type of the resource. Always compute#targetGrpcProxy for + // target grpc proxies. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -300,94 +188,3 @@ message StoragePoolTypeList { // [Output Only] Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } - -message StoragePoolTypesScopedList { - // [Output Only] A list of storage pool types contained in this scope. - repeated StoragePoolType storage_pool_types = 1 - [json_name = "storagePoolTypes"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning which replaces the list of storage pool - // types when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} diff --git a/protos/google/cloud/compute/v1/internal/common_126.proto b/protos/google/cloud/compute/v1/internal/common_126.proto index a397778100e04..e4aa3f8fdac1e 100644 --- a/protos/google/cloud/compute/v1/internal/common_126.proto +++ b/protos/google/cloud/compute/v1/internal/common_126.proto @@ -15,477 +15,18 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Subnetwork resource. A subnetwork (also known as a subnet) is a -// logical partition of a Virtual Private Cloud network with one primary IP -// range and zero or more secondary IP ranges. For more information, read -// Virtual Private Cloud (VPC) Network. -message Subnetwork { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; +import "google/cloud/compute/v1/internal/common_127.proto"; - // An optional description of this resource. Provide this property when you - // create the resource. This field can be set only at resource creation time. - optional string description = 2 [json_name = "description"]; - - // Whether to enable flow logging for this subnetwork. If this field is not - // explicitly set, it will not appear in get listings. If not set the default - // behavior is determined by the org policy, if there is no org policy - // specified, then it will default to disabled. This field isn't supported if - // the subnet purpose field is set to REGIONAL_MANAGED_PROXY. - optional bool enable_flow_logs = 3 [json_name = "enableFlowLogs"]; - - // The external IPv6 address range that is owned by this subnetwork. - optional string external_ipv6_prefix = 4 [json_name = "externalIpv6Prefix"]; - - // 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. To see the latest fingerprint, make a get() request to - // retrieve a Subnetwork. - optional string fingerprint = 5 [json_name = "fingerprint"]; - - // [Output Only] The gateway address for default routes to reach destination - // addresses outside this subnetwork. - optional string gateway_address = 6 [json_name = "gatewayAddress"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 7 [json_name = "id"]; - - // The internal IPv6 address range that is owned by this subnetwork. - optional string internal_ipv6_prefix = 8 [json_name = "internalIpv6Prefix"]; - - // 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. The - // range can be any range listed in the Valid ranges list. The range can be - // expanded after creation using expandIpCidrRange. - optional string ip_cidr_range = 9 [json_name = "ipCidrRange"]; - - // 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. - // EXTERNAL: VMs on this subnet will be assigned IPv6 addresses that are - // accessible via the Internet, as well as the VPC network. - // INTERNAL: VMs on this subnet will be assigned IPv6 addresses that are only - // accessible over the VPC network. - optional string ipv6_access_type = 10 [json_name = "ipv6AccessType"]; - - // [Output Only] This field is for internal use. - optional string ipv6_cidr_range = 11 [json_name = "ipv6CidrRange"]; - - // [Output Only] Type of the resource. Always compute#subnetwork for - // Subnetwork resources. - optional string kind = 12 [json_name = "kind"]; - - // This field denotes the VPC flow logging options for this subnetwork. If - // logging is enabled, logs are exported to Cloud Logging. - optional SubnetworkLogConfig log_config = 13 [json_name = "logConfig"]; - - // The name of the resource, provided by the client when initially creating - // the resource. 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. - optional string name = 14 [json_name = "name"]; - - // The URL of the network to which this subnetwork belongs, provided by the - // client when initially creating the subnetwork. This field can be set only - // at resource creation time. - optional string network = 15 [json_name = "network"]; - - // Whether the VMs in this subnet can access Google services without assigned - // external IP addresses. This field can be both set at resource creation time - // and updated using setPrivateIpGoogleAccess. - optional bool private_ip_google_access = 16 - [json_name = "privateIpGoogleAccess"]; - - // This field is for internal use. This field can be both set at resource - // creation time and updated using patch. - // DISABLE_GOOGLE_ACCESS: Disable private IPv6 access to/from Google services. - // ENABLE_BIDIRECTIONAL_ACCESS_TO_GOOGLE: Bidirectional private IPv6 access - // to/from Google services. - // ENABLE_OUTBOUND_VM_ACCESS_TO_GOOGLE: Outbound private IPv6 access from VMs - // in this subnet to Google services. - optional string private_ipv6_google_access = 17 - [json_name = "privateIpv6GoogleAccess"]; - - // The purpose of the resource. This field can be either PRIVATE, - // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or - // PRIVATE is the default purpose for user-created subnets or subnets that are - // automatically created in auto mode networks. Subnets with purpose set to - // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks - // that are reserved for Envoy-based load balancers. A subnet with purpose set - // to PRIVATE_SERVICE_CONNECT is used to publish services using Private - // Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. - // The enableFlowLogs field isn't supported if the subnet purpose field is set - // to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. - // GLOBAL_MANAGED_PROXY: Subnet reserved for Global Envoy-based Load - // Balancing. - // INTERNAL_HTTPS_LOAD_BALANCER: Subnet reserved for Internal HTTP(S) Load - // Balancing. This is a legacy purpose, please use REGIONAL_MANAGED_PROXY - // instead. - // PRIVATE: Regular user created or automatically created subnet. - // PRIVATE_NAT: Subnetwork used as source range for Private NAT Gateways. - // PRIVATE_RFC_1918: Regular user created or automatically created subnet. - // PRIVATE_SERVICE_CONNECT: Subnetworks created for Private Service Connect in - // the producer network. - // REGIONAL_MANAGED_PROXY: Subnetwork used for Regional Envoy-based Load - // Balancing. - optional string purpose = 18 [json_name = "purpose"]; - - // URL of the region where the Subnetwork resides. This field can be set only - // at resource creation time. - optional string region = 19 [json_name = "region"]; - - // The URL of the reserved internal range. - optional string reserved_internal_range = 25 - [json_name = "reservedInternalRange"]; - - // The role of subnetwork. Currently, this field is only used when purpose is - // set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set - // to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being - // used for Envoy-based load balancers in a region. A BACKUP subnetwork is one - // that is ready to be promoted to ACTIVE or is currently draining. This field - // can be updated with a patch request. - // ACTIVE: The ACTIVE subnet that is currently used. - // BACKUP: The BACKUP subnet that could be promoted to ACTIVE. - optional string role = 20 [json_name = "role"]; - - // An array of configurations for secondary IP ranges for VM instances - // contained in this subnetwork. The primary IP of such VM must belong to the - // primary ipCidrRange of the subnetwork. The alias IPs may belong to either - // primary or secondary ranges. This field can be updated with a patch - // request. - repeated SubnetworkSecondaryRange secondary_ip_ranges = 21 - [json_name = "secondaryIpRanges"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 22 [json_name = "selfLink"]; - - // The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet - // are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the - // subnet can be assigned both IPv4 and IPv6 addresses. If not specified, - // IPV4_ONLY is used. This field can be both set at resource creation time and - // updated using patch. - // IPV4_IPV6: New VMs in this subnet can have both IPv4 and IPv6 addresses. - // IPV4_ONLY: New VMs in this subnet will only be assigned IPv4 addresses. - optional string stack_type = 23 [json_name = "stackType"]; - - // [Output Only] The state of the subnetwork, which can be one of the - // following values: READY: Subnetwork is created and ready to use DRAINING: - // 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 - // DRAINING: Subnetwork is being drained. - // READY: Subnetwork is ready for use. - optional string state = 24 [json_name = "state"]; -} - -message SubnetworkAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of SubnetworksScopedList resources. - map items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#subnetworkAggregatedList for - // aggregated lists of subnetworks. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -// Contains a list of Subnetwork resources. -message SubnetworkList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of Subnetwork resources. - repeated Subnetwork items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#subnetworkList for lists of - // subnetworks. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -// The available logging options for this subnetwork. -message SubnetworkLogConfig { - // Can only be specified if VPC flow logging for this subnetwork is enabled. - // Toggles the aggregation interval for collecting flow logs. Increasing the - // interval time will reduce the amount of generated flow logs for long - // lasting connections. Default is an interval of 5 seconds per connection. - // INTERVAL_10_MIN: - // INTERVAL_15_MIN: - // INTERVAL_1_MIN: - // INTERVAL_30_SEC: - // INTERVAL_5_MIN: - // INTERVAL_5_SEC: - optional string aggregation_interval = 1 [json_name = "aggregationInterval"]; - - // Whether to enable flow logging for this subnetwork. If this field is not - // explicitly set, it will not appear in get listings. If not set the default - // behavior is determined by the org policy, if there is no org policy - // specified, then it will default to disabled. Flow logging isn't supported - // if the subnet purpose field is set to REGIONAL_MANAGED_PROXY. - optional bool enable = 2 [json_name = "enable"]; - - // Can only be specified if VPC flow logs for this subnetwork is enabled. The - // filter expression is used to define which VPC flow logs should be exported - // to Cloud Logging. - optional string filter_expr = 3 [json_name = "filterExpr"]; - - // Can only be specified if VPC flow logging for this subnetwork is enabled. - // The value of the field must be in [0, 1]. Set the sampling rate of VPC flow - // logs within the subnetwork where 1.0 means all collected logs are reported - // and 0.0 means no logs are reported. Default is 0.5 unless otherwise - // specified by the org policy, which means half of all collected logs are - // reported. - optional float flow_sampling = 4 [json_name = "flowSampling"]; - - // Can only be specified if VPC flow logs for this subnetwork is enabled. - // Configures whether all, none or a subset of metadata fields should be added - // to the reported VPC flow logs. Default is EXCLUDE_ALL_METADATA. - // CUSTOM_METADATA: - // EXCLUDE_ALL_METADATA: - // INCLUDE_ALL_METADATA: - optional string metadata = 5 [json_name = "metadata"]; - - // Can only be specified if VPC flow logs for this subnetwork is enabled and - // "metadata" was set to CUSTOM_METADATA. - repeated string metadata_fields = 6 [json_name = "metadataFields"]; -} - -// Represents a secondary IP range of a subnetwork. -message SubnetworkSecondaryRange { - // The range of IP addresses belonging to this subnetwork secondary range. - // Provide this property when you create the subnetwork. Ranges must be unique - // and non-overlapping with all primary and secondary IP ranges within a - // network. Only IPv4 is supported. The range can be any range listed in the - // Valid ranges list. - optional string ip_cidr_range = 1 [json_name = "ipCidrRange"]; - - // The name associated with this subnetwork secondary range, used when adding - // an alias IP range to a VM instance. The name must be 1-63 characters long, - // and comply with RFC1035. The name must be unique within the subnetwork. - optional string range_name = 2 [json_name = "rangeName"]; - - // The URL of the reserved internal range. - optional string reserved_internal_range = 3 - [json_name = "reservedInternalRange"]; -} - -message SubnetworksExpandIpCidrRangeRequest { - // The IP (in CIDR format or netmask) of internal addresses that are legal on - // this Subnetwork. This range should be disjoint from other subnetworks - // within this network. This range can only be larger than (i.e. a superset - // of) the range previously defined before the update. - optional string ip_cidr_range = 1 [json_name = "ipCidrRange"]; -} - -message SubnetworksScopedList { - // A list of subnetworks contained in this scope. - repeated Subnetwork subnetworks = 1 [json_name = "subnetworks"]; +message TargetHttpProxiesScopedList { + // A list of TargetHttpProxies contained in this scope. + repeated TargetHttpProxy target_http_proxies = 1 + [json_name = "targetHttpProxies"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -568,208 +109,32 @@ message SubnetworksScopedList { optional string message = 3 [json_name = "message"]; } - // An informational warning that appears when the list of addresses is empty. + // Informational warning which replaces the list of backend services when the + // list is empty. optional Warning warning = 2 [json_name = "warning"]; } -message SubnetworksSetPrivateIpGoogleAccessRequest { - optional bool private_ip_google_access = 1 - [json_name = "privateIpGoogleAccess"]; -} - -// Subnetwork which the current user has compute.subnetworks.use permission on. -message UsableSubnetwork { - // [Output Only] The external IPv6 address range that is assigned to this - // subnetwork. - optional string external_ipv6_prefix = 1 [json_name = "externalIpv6Prefix"]; - - // [Output Only] The internal IPv6 address range that is assigned to this - // subnetwork. - optional string internal_ipv6_prefix = 2 [json_name = "internalIpv6Prefix"]; - - // The range of internal addresses that are owned by this subnetwork. - optional string ip_cidr_range = 3 [json_name = "ipCidrRange"]; - - // 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. - // EXTERNAL: VMs on this subnet will be assigned IPv6 addresses that are - // accessible via the Internet, as well as the VPC network. - // INTERNAL: VMs on this subnet will be assigned IPv6 addresses that are only - // accessible over the VPC network. - optional string ipv6_access_type = 4 [json_name = "ipv6AccessType"]; - - // Network URL. - optional string network = 5 [json_name = "network"]; - - // The purpose of the resource. This field can be either PRIVATE, - // GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY, PRIVATE_SERVICE_CONNECT, or - // PRIVATE is the default purpose for user-created subnets or subnets that are - // automatically created in auto mode networks. Subnets with purpose set to - // GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY are user-created subnetworks - // that are reserved for Envoy-based load balancers. A subnet with purpose set - // to PRIVATE_SERVICE_CONNECT is used to publish services using Private - // Service Connect. If unspecified, the subnet purpose defaults to PRIVATE. - // The enableFlowLogs field isn't supported if the subnet purpose field is set - // to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. - // GLOBAL_MANAGED_PROXY: Subnet reserved for Global Envoy-based Load - // Balancing. - // INTERNAL_HTTPS_LOAD_BALANCER: Subnet reserved for Internal HTTP(S) Load - // Balancing. This is a legacy purpose, please use REGIONAL_MANAGED_PROXY - // instead. - // PRIVATE: Regular user created or automatically created subnet. - // PRIVATE_NAT: Subnetwork used as source range for Private NAT Gateways. - // PRIVATE_RFC_1918: Regular user created or automatically created subnet. - // PRIVATE_SERVICE_CONNECT: Subnetworks created for Private Service Connect in - // the producer network. - // REGIONAL_MANAGED_PROXY: Subnetwork used for Regional Envoy-based Load - // Balancing. - optional string purpose = 6 [json_name = "purpose"]; - - // The role of subnetwork. Currently, this field is only used when purpose is - // set to GLOBAL_MANAGED_PROXY or REGIONAL_MANAGED_PROXY. The value can be set - // to ACTIVE or BACKUP. An ACTIVE subnetwork is one that is currently being - // used for Envoy-based load balancers in a region. A BACKUP subnetwork is one - // that is ready to be promoted to ACTIVE or is currently draining. This field - // can be updated with a patch request. - // ACTIVE: The ACTIVE subnet that is currently used. - // BACKUP: The BACKUP subnet that could be promoted to ACTIVE. - optional string role = 7 [json_name = "role"]; - - // Secondary IP ranges. - repeated UsableSubnetworkSecondaryRange secondary_ip_ranges = 8 - [json_name = "secondaryIpRanges"]; - - // The stack type for the subnet. If set to IPV4_ONLY, new VMs in the subnet - // are assigned IPv4 addresses only. If set to IPV4_IPV6, new VMs in the - // subnet can be assigned both IPv4 and IPv6 addresses. If not specified, - // IPV4_ONLY is used. This field can be both set at resource creation time and - // updated using patch. - // IPV4_IPV6: New VMs in this subnet can have both IPv4 and IPv6 addresses. - // IPV4_ONLY: New VMs in this subnet will only be assigned IPv4 addresses. - optional string stack_type = 9 [json_name = "stackType"]; - - // Subnetwork URL. - optional string subnetwork = 10 [json_name = "subnetwork"]; -} - -// Secondary IP range of a usable subnetwork. -message UsableSubnetworkSecondaryRange { - // The range of IP addresses belonging to this subnetwork secondary range. - optional string ip_cidr_range = 1 [json_name = "ipCidrRange"]; - - // The name associated with this subnetwork secondary range, used when adding - // an alias IP range to a VM instance. The name must be 1-63 characters long, - // and comply with RFC1035. The name must be unique within the subnetwork. - optional string range_name = 2 [json_name = "rangeName"]; -} - -message UsableSubnetworksAggregatedList { - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. +message TargetHttpProxyAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // [Output] A list of usable subnetwork URLs. - repeated UsableSubnetwork items = 2 [json_name = "items"]; + // A list of TargetHttpProxiesScopedList resources. + map items = 2 [json_name = "items"]; // [Output Only] Type of resource. Always - // compute#usableSubnetworksAggregatedList for aggregated lists of usable - // subnetworks. + // compute#targetHttpProxyAggregatedList for lists of Target HTTP Proxies. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for // list requests. If the number of results is larger than maxResults, use the // nextPageToken as a value for the query parameter pageToken in the next list // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. In special cases listUsable may return - // 0 subnetworks and nextPageToken which still should be used to get the next - // page of results. + // continue paging through the results. optional string next_page_token = 4 [json_name = "nextPageToken"]; // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_127.proto b/protos/google/cloud/compute/v1/internal/common_127.proto index c6806b823a426..ff20642532a79 100644 --- a/protos/google/cloud/compute/v1/internal/common_127.proto +++ b/protos/google/cloud/compute/v1/internal/common_127.proto @@ -15,18 +15,25 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Target gRPC Proxy resource. A target gRPC proxy is a component -// of load balancers intended for load balancing gRPC traffic. Only global -// forwarding rules with load balancing scheme INTERNAL_SELF_MANAGED can -// reference a target gRPC proxy. The target gRPC Proxy references a URL map -// that specifies how traffic is routed to gRPC backend services. -message TargetGrpcProxy { +// Represents a Target HTTP Proxy resource. Google Compute Engine has two Target +// HTTP Proxy resources: * +// [Global](/compute/docs/reference/rest/v1/targetHttpProxies) * +// [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies) A target +// HTTP proxy is a component of Google Cloud HTTP load balancers. * +// targetHttpProxies are used by global external Application Load Balancers, +// classic Application Load Balancers, cross-region internal Application Load +// Balancers, and Traffic Director. * regionTargetHttpProxies are used by +// regional internal Application Load Balancers and regional external +// Application Load Balancers. Forwarding rules reference a target HTTP proxy, +// and the target proxy then references a URL map. For more information, read +// Using Target Proxies and Forwarding rule concepts. +message TargetHttpProxy { // [Output Only] Creation timestamp in RFC3339 text format. optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; @@ -36,18 +43,27 @@ message TargetGrpcProxy { // 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 TargetGrpcProxy. An up-to-date fingerprint must be provided in - // order to patch/update the TargetGrpcProxy; otherwise, the request will fail + // inserting a TargetHttpProxy. An up-to-date fingerprint must be provided in + // order to patch/update the TargetHttpProxy; otherwise, the request will fail // with error 412 conditionNotMet. To see the latest fingerprint, make a get() - // request to retrieve the TargetGrpcProxy. + // request to retrieve the TargetHttpProxy. optional string fingerprint = 3 [json_name = "fingerprint"]; - // [Output Only] The unique identifier for the resource type. The server - // generates this identifier. + // Specifies how long to keep a connection open, after completing a response, + // while there is no matching traffic (in seconds). If an HTTP keep-alive is + // not specified, a default value (610 seconds) will be used. For global + // external Application Load Balancers, the minimum allowed value is 5 seconds + // and the maximum allowed value is 1200 seconds. For classic Application Load + // Balancers, this option is not supported. + optional int32 http_keep_alive_timeout_sec = 11 + [json_name = "httpKeepAliveTimeoutSec"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. optional string id = 4 [json_name = "id"]; - // [Output Only] Type of the resource. Always compute#targetGrpcProxy for - // target grpc proxies. + // [Output Only] Type of resource. Always compute#targetHttpProxy for target + // HTTP proxies. optional string kind = 5 [json_name = "kind"]; // Name of the resource. Provided by the client when the resource is created. @@ -59,39 +75,38 @@ message TargetGrpcProxy { // dash. optional string name = 6 [json_name = "name"]; - // [Output Only] Server-defined URL for the resource. - optional string self_link = 7 [json_name = "selfLink"]; + // This field only applies when the forwarding rule that references this + // target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When + // this field is set to true, Envoy proxies set up inbound traffic + // interception and bind to the IP address and port specified in the + // forwarding rule. This is generally useful when using Traffic Director to + // configure Envoy as a gateway or middle proxy (in other words, not a sidecar + // proxy). The Envoy proxy listens for inbound requests and handles requests + // when it receives them. The default is false. + optional bool proxy_bind = 7 [json_name = "proxyBind"]; + + // [Output Only] URL of the region where the regional Target HTTP Proxy + // resides. This field is not applicable to global Target HTTP Proxies. + optional string region = 8 [json_name = "region"]; - // [Output Only] Server-defined URL with id for the resource. - optional string self_link_with_id = 8 [json_name = "selfLinkWithId"]; + // [Output Only] Server-defined URL for the resource. + optional string self_link = 9 [json_name = "selfLink"]; // URL to the UrlMap resource that defines the mapping from URL to the - // BackendService. The protocol field in the BackendService must be set to - // GRPC. - optional string url_map = 9 [json_name = "urlMap"]; - - // If true, indicates that the BackendServices referenced by the urlMap may be - // accessed by gRPC applications without using a sidecar proxy. This will - // enable configuration checks on urlMap and its referenced BackendServices to - // not allow unsupported features. A gRPC application must use "xds:///" - // scheme in the target URI of the service it is connecting to. If false, - // indicates that the BackendServices referenced by the urlMap will be - // accessed by gRPC applications via a sidecar proxy. In this case, a gRPC - // application must not use "xds:///" scheme in the target URI of the service - // it is connecting to - optional bool validate_for_proxyless = 10 - [json_name = "validateForProxyless"]; + // BackendService. + optional string url_map = 10 [json_name = "urlMap"]; } -message TargetGrpcProxyList { +// A list of TargetHttpProxy resources. +message TargetHttpProxyList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of TargetGrpcProxy resources. - repeated TargetGrpcProxy items = 2 [json_name = "items"]; + // A list of TargetHttpProxy resources. + repeated TargetHttpProxy items = 2 [json_name = "items"]; - // [Output Only] Type of the resource. Always compute#targetGrpcProxy for - // target grpc proxies. + // Type of resource. Always compute#targetHttpProxyList for lists of target + // HTTP proxies. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for diff --git a/protos/google/cloud/compute/v1/internal/common_128.proto b/protos/google/cloud/compute/v1/internal/common_128.proto index a5c3730bb394a..68a09f905f732 100644 --- a/protos/google/cloud/compute/v1/internal/common_128.proto +++ b/protos/google/cloud/compute/v1/internal/common_128.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -23,10 +23,10 @@ package google.cloud.cpp.compute.v1; import "google/cloud/compute/v1/internal/common_129.proto"; -message TargetHttpProxiesScopedList { - // A list of TargetHttpProxies contained in this scope. - repeated TargetHttpProxy target_http_proxies = 1 - [json_name = "targetHttpProxies"]; +message TargetHttpsProxiesScopedList { + // A list of TargetHttpsProxies contained in this scope. + repeated TargetHttpsProxy target_https_proxies = 1 + [json_name = "targetHttpsProxies"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -114,15 +114,38 @@ message TargetHttpProxiesScopedList { optional Warning warning = 2 [json_name = "warning"]; } -message TargetHttpProxyAggregatedList { +message TargetHttpsProxiesSetCertificateMapRequest { + // URL of the Certificate Map to associate with this TargetHttpsProxy. + // Accepted format is //certificatemanager.googleapis.com/projects/{project + // }/locations/{location}/certificateMaps/{resourceName}. + optional string certificate_map = 1 [json_name = "certificateMap"]; +} + +message TargetHttpsProxiesSetQuicOverrideRequest { + // QUIC policy for the TargetHttpsProxy resource. + // DISABLE: The load balancer will not attempt to negotiate QUIC with clients. + // ENABLE: The load balancer will attempt to negotiate QUIC with clients. + // NONE: No overrides to the default QUIC policy. This option is implicit if + // no QUIC override has been specified in the request. + optional string quic_override = 1 [json_name = "quicOverride"]; +} + +message TargetHttpsProxiesSetSslCertificatesRequest { + // New set of SslCertificate resources to associate with this TargetHttpsProxy + // resource. At least one SSL certificate must be specified. Currently, you + // may specify up to 15 SSL certificates. + repeated string ssl_certificates = 1 [json_name = "sslCertificates"]; +} + +message TargetHttpsProxyAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of TargetHttpProxiesScopedList resources. - map items = 2 [json_name = "items"]; + // A list of TargetHttpsProxiesScopedList resources. + map items = 2 [json_name = "items"]; // [Output Only] Type of resource. Always - // compute#targetHttpProxyAggregatedList for lists of Target HTTP Proxies. + // compute#targetHttpsProxyAggregatedList for lists of Target HTTP Proxies. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -137,4 +160,88 @@ message TargetHttpProxyAggregatedList { // [Output Only] Unreachable resources. repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_129.proto b/protos/google/cloud/compute/v1/internal/common_129.proto index c0e821501b20e..dc78cb64dd179 100644 --- a/protos/google/cloud/compute/v1/internal/common_129.proto +++ b/protos/google/cloud/compute/v1/internal/common_129.proto @@ -15,39 +15,57 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Target HTTP Proxy resource. Google Compute Engine has two Target -// HTTP Proxy resources: * -// [Global](/compute/docs/reference/rest/v1/targetHttpProxies) * -// [Regional](/compute/docs/reference/rest/v1/regionTargetHttpProxies) A target -// HTTP proxy is a component of Google Cloud HTTP load balancers. * -// targetHttpProxies are used by global external Application Load Balancers, -// classic Application Load Balancers, cross-region internal Application Load -// Balancers, and Traffic Director. * regionTargetHttpProxies are used by -// regional internal Application Load Balancers and regional external -// Application Load Balancers. Forwarding rules reference a target HTTP proxy, -// and the target proxy then references a URL map. For more information, read -// Using Target Proxies and Forwarding rule concepts. -message TargetHttpProxy { +// Represents a Target HTTPS Proxy resource. Google Compute Engine has two +// Target HTTPS Proxy resources: * +// [Global](/compute/docs/reference/rest/v1/targetHttpsProxies) * +// [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies) A target +// HTTPS proxy is a component of GCP HTTPS load balancers. * targetHttpProxies +// are used by global external Application Load Balancers, classic Application +// Load Balancers, cross-region internal Application Load Balancers, and Traffic +// Director. * regionTargetHttpProxies are used by regional internal Application +// Load Balancers and regional external Application Load Balancers. Forwarding +// rules reference a target HTTPS proxy, and the target proxy then references a +// URL map. For more information, read Using Target Proxies and Forwarding rule +// concepts. +message TargetHttpsProxy { + // Optional. A URL referring to a networksecurity.AuthorizationPolicy resource + // that describes how the proxy should authorize inbound traffic. If left + // blank, access will not be restricted by an authorization policy. Refer to + // the AuthorizationPolicy resource for additional details. + // authorizationPolicy only applies to a global TargetHttpsProxy attached to + // globalForwardingRules with the loadBalancingScheme set to + // INTERNAL_SELF_MANAGED. Note: This field currently has no impact. + optional string authorization_policy = 1 [json_name = "authorizationPolicy"]; + + // URL of a certificate map that identifies a certificate map associated with + // the given target proxy. This field can only be set for Global external + // Application Load Balancer or Classic Application Load Balancer. For other + // products use Certificate Manager Certificates instead. If set, + // sslCertificates will be ignored. Accepted format is + // //certificatemanager.googleapis.com/projects/{project + // }/locations/{location}/certificateMaps/{resourceName}. + optional string certificate_map = 2 [json_name = "certificateMap"]; + // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 2 [json_name = "description"]; + optional string description = 4 [json_name = "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 TargetHttpProxy. An up-to-date fingerprint must be provided in - // order to patch/update the TargetHttpProxy; otherwise, the request will fail - // with error 412 conditionNotMet. To see the latest fingerprint, make a get() - // request to retrieve the TargetHttpProxy. - optional string fingerprint = 3 [json_name = "fingerprint"]; + // inserting a TargetHttpsProxy. An up-to-date fingerprint must be provided in + // order to patch the TargetHttpsProxy; otherwise, the request will fail with + // error 412 conditionNotMet. To see the latest fingerprint, make a get() + // request to retrieve the TargetHttpsProxy. + optional string fingerprint = 5 [json_name = "fingerprint"]; // Specifies how long to keep a connection open, after completing a response, // while there is no matching traffic (in seconds). If an HTTP keep-alive is @@ -55,16 +73,16 @@ message TargetHttpProxy { // external Application Load Balancers, the minimum allowed value is 5 seconds // and the maximum allowed value is 1200 seconds. For classic Application Load // Balancers, this option is not supported. - optional int32 http_keep_alive_timeout_sec = 11 + optional int32 http_keep_alive_timeout_sec = 17 [json_name = "httpKeepAliveTimeoutSec"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 4 [json_name = "id"]; + optional string id = 6 [json_name = "id"]; - // [Output Only] Type of resource. Always compute#targetHttpProxy for target - // HTTP proxies. - optional string kind = 5 [json_name = "kind"]; + // [Output Only] Type of resource. Always compute#targetHttpsProxy for target + // HTTPS proxies. + optional string kind = 7 [json_name = "kind"]; // 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. @@ -73,7 +91,7 @@ message TargetHttpProxy { // 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. - optional string name = 6 [json_name = "name"]; + optional string name = 8 [json_name = "name"]; // This field only applies when the forwarding rule that references this // target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When @@ -83,30 +101,107 @@ message TargetHttpProxy { // configure Envoy as a gateway or middle proxy (in other words, not a sidecar // proxy). The Envoy proxy listens for inbound requests and handles requests // when it receives them. The default is false. - optional bool proxy_bind = 7 [json_name = "proxyBind"]; + optional bool proxy_bind = 9 [json_name = "proxyBind"]; - // [Output Only] URL of the region where the regional Target HTTP Proxy - // resides. This field is not applicable to global Target HTTP Proxies. - optional string region = 8 [json_name = "region"]; + // Specifies the QUIC override policy for this TargetHttpsProxy resource. This + // setting determines whether the load balancer attempts to negotiate QUIC + // with clients. You can specify NONE, ENABLE, or DISABLE. - When + // quic-override is set to NONE, Google manages whether QUIC is used. - When + // quic-override is set to ENABLE, the load balancer uses QUIC when possible. + // - When quic-override is set to DISABLE, the load balancer doesn't use QUIC. + // - If the quic-override flag is not specified, NONE is implied. + // DISABLE: The load balancer will not attempt to negotiate QUIC with clients. + // ENABLE: The load balancer will attempt to negotiate QUIC with clients. + // NONE: No overrides to the default QUIC policy. This option is implicit if + // no QUIC override has been specified in the request. + optional string quic_override = 10 [json_name = "quicOverride"]; + + // [Output Only] URL of the region where the regional TargetHttpsProxy + // resides. This field is not applicable to global TargetHttpsProxies. + optional string region = 11 [json_name = "region"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 9 [json_name = "selfLink"]; + optional string self_link = 12 [json_name = "selfLink"]; + + // Optional. A URL referring to a networksecurity.ServerTlsPolicy resource + // that describes how the proxy should authenticate inbound traffic. + // serverTlsPolicy only applies to a global TargetHttpsProxy attached to + // globalForwardingRules with the loadBalancingScheme set to + // INTERNAL_SELF_MANAGED or EXTERNAL or EXTERNAL_MANAGED. For details which + // ServerTlsPolicy resources are accepted with INTERNAL_SELF_MANAGED and which + // with EXTERNAL, EXTERNAL_MANAGED loadBalancingScheme consult ServerTlsPolicy + // documentation. If left blank, communications are not encrypted. + optional string server_tls_policy = 13 [json_name = "serverTlsPolicy"]; + + // URLs to SslCertificate resources that are used to authenticate connections + // between users and the load balancer. At least one SSL certificate must be + // specified. SslCertificates do not apply when the load balancing scheme is + // set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate + // resource or Certificate Manager Certificate resource. Mixing Classic + // Certificates and Certificate Manager Certificates is not allowed. + // Certificate Manager Certificates must include the certificatemanager API. + // Certificate Manager Certificates are not supported by Global external + // Application Load Balancer or Classic Application Load Balancer, use + // certificate_map instead. Currently, you may specify up to 15 Classic SSL + // Certificates. Certificate Manager Certificates accepted formats are: - + // //certificatemanager.googleapis.com/projects/{project}/locations/{ + // location}/certificates/{resourceName}. - + // https://certificatemanager.googleapis.com/v1alpha1/projects/{project + // }/locations/{location}/certificates/{resourceName}. + repeated string ssl_certificates = 14 [json_name = "sslCertificates"]; + + // URL of SslPolicy resource that will be associated with the TargetHttpsProxy + // resource. If not set, the TargetHttpsProxy resource has no SSL policy + // configured. + optional string ssl_policy = 15 [json_name = "sslPolicy"]; + + // Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted for + // this service. Early Data allows a TLS resumption handshake to include the + // initial application payload (a HTTP request) alongside the handshake, + // reducing the effective round trips to "zero". This applies to TLS 1.3 + // connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). This can + // improve application performance, especially on networks where interruptions + // may be common, such as on mobile. Requests with Early Data will have the + // "Early-Data" HTTP header set on the request, with a value of "1", to allow + // the backend to determine whether Early Data was included. Note: TLS Early + // Data may allow requests to be replayed, as the data is sent to the backend + // before the handshake has fully completed. Applications that allow + // idempotent HTTP methods to make non-idempotent changes, such as a GET + // request updating a database, should not accept Early Data on those + // requests, and reject requests with the "Early-Data: 1" HTTP header by + // returning a HTTP 425 (Too Early) status code, in order to remain RFC + // compliant. The default value is DISABLED. + // DISABLED: TLS 1.3 Early Data is not advertised, and any (invalid) attempts + // to send Early Data will be rejected by closing the connection. + // PERMISSIVE: This enables TLS 1.3 0-RTT, and only allows Early Data to be + // included on requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE). + // This mode does not enforce any other limitations for requests with Early + // Data. The application owner should validate that Early Data is acceptable + // for a given request path. + // STRICT: This enables TLS 1.3 0-RTT, and only allows Early Data to be + // included on requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE) + // without query parameters. Requests that send Early Data with non-idempotent + // HTTP methods or with query parameters will be rejected with a HTTP 425. + optional string tls_early_data = 18 [json_name = "tlsEarlyData"]; - // URL to the UrlMap resource that defines the mapping from URL to the - // BackendService. - optional string url_map = 10 [json_name = "urlMap"]; + // A fully-qualified or valid partial URL to the UrlMap resource that defines + // the mapping from URL to the BackendService. For example, the following are + // all valid URLs for specifying a URL map: - + // https://www.googleapis.compute/v1/projects/project/global/urlMaps/ url-map + // - projects/project/global/urlMaps/url-map - global/urlMaps/url-map + optional string url_map = 16 [json_name = "urlMap"]; } -// A list of TargetHttpProxy resources. -message TargetHttpProxyList { +// Contains a list of TargetHttpsProxy resources. +message TargetHttpsProxyList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of TargetHttpProxy resources. - repeated TargetHttpProxy items = 2 [json_name = "items"]; + // A list of TargetHttpsProxy resources. + repeated TargetHttpsProxy items = 2 [json_name = "items"]; - // Type of resource. Always compute#targetHttpProxyList for lists of target - // HTTP proxies. + // Type of resource. Always compute#targetHttpsProxyList for lists of target + // HTTPS proxies. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for diff --git a/protos/google/cloud/compute/v1/internal/common_130.proto b/protos/google/cloud/compute/v1/internal/common_130.proto index 1fa1436e547d7..1fe3364f90221 100644 --- a/protos/google/cloud/compute/v1/internal/common_130.proto +++ b/protos/google/cloud/compute/v1/internal/common_130.proto @@ -15,18 +15,96 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_131.proto"; +// Represents a Target Instance resource. You can use a target instance to +// handle traffic for one or more forwarding rules, which is ideal for +// forwarding protocol traffic that is managed by a single source. For example, +// ESP, AH, TCP, or UDP. For more information, read Target instances. +message TargetInstance { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; -message TargetHttpsProxiesScopedList { - // A list of TargetHttpsProxies contained in this scope. - repeated TargetHttpsProxy target_https_proxies = 1 - [json_name = "targetHttpsProxies"]; + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 3 [json_name = "id"]; + + // A URL to the virtual machine instance that handles traffic for this target + // instance. When creating a target instance, you can provide the + // fully-qualified URL or a valid partial URL to the desired virtual machine. + // For example, the following are all valid URLs: - + // https://www.googleapis.com/compute/v1/projects/project/zones/zone + // /instances/instance - projects/project/zones/zone/instances/instance - + // zones/zone/instances/instance + optional string instance = 4 [json_name = "instance"]; + + // [Output Only] The type of the resource. Always compute#targetInstance for + // target instances. + optional string kind = 5 [json_name = "kind"]; + + // 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. + optional string name = 6 [json_name = "name"]; + + // Must have a value of NO_NAT. Protocol forwarding delivers packets while + // preserving the destination IP address of the forwarding rule referencing + // the target instance. + // NO_NAT: No NAT performed. + optional string nat_policy = 7 [json_name = "natPolicy"]; + + // The URL of the network this target instance uses to forward traffic. If not + // specified, the traffic will be forwarded to the network that the default + // network interface belongs to. + optional string network = 8 [json_name = "network"]; + + // [Output Only] The resource URL for the security policy associated with this + // target instance. + optional string security_policy = 11 [json_name = "securityPolicy"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 9 [json_name = "selfLink"]; + + // [Output Only] URL of the zone where the target instance resides. You must + // specify this field as part of the HTTP request URL. It is not settable as a + // field in the request body. + optional string zone = 10 [json_name = "zone"]; +} + +message TargetInstanceAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of TargetInstance resources. + map items = 2 [json_name = "items"]; + + // Type of resource. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -109,43 +187,19 @@ message TargetHttpsProxiesScopedList { optional string message = 3 [json_name = "message"]; } - // Informational warning which replaces the list of backend services when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} - -message TargetHttpsProxiesSetCertificateMapRequest { - // URL of the Certificate Map to associate with this TargetHttpsProxy. - // Accepted format is //certificatemanager.googleapis.com/projects/{project - // }/locations/{location}/certificateMaps/{resourceName}. - optional string certificate_map = 1 [json_name = "certificateMap"]; -} - -message TargetHttpsProxiesSetQuicOverrideRequest { - // QUIC policy for the TargetHttpsProxy resource. - // DISABLE: The load balancer will not attempt to negotiate QUIC with clients. - // ENABLE: The load balancer will attempt to negotiate QUIC with clients. - // NONE: No overrides to the default QUIC policy. This option is implicit if - // no QUIC override has been specified in the request. - optional string quic_override = 1 [json_name = "quicOverride"]; -} - -message TargetHttpsProxiesSetSslCertificatesRequest { - // New set of SslCertificate resources to associate with this TargetHttpsProxy - // resource. At least one SSL certificate must be specified. Currently, you - // may specify up to 15 SSL certificates. - repeated string ssl_certificates = 1 [json_name = "sslCertificates"]; + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; } -message TargetHttpsProxyAggregatedList { +// Contains a list of TargetInstance resources. +message TargetInstanceList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of TargetHttpsProxiesScopedList resources. - map items = 2 [json_name = "items"]; + // A list of TargetInstance resources. + repeated TargetInstance items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always - // compute#targetHttpsProxyAggregatedList for lists of Target HTTP Proxies. + // Type of resource. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -158,9 +212,6 @@ message TargetHttpsProxyAggregatedList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -243,5 +294,95 @@ message TargetHttpsProxyAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + optional Warning warning = 6 [json_name = "warning"]; +} + +message TargetInstancesScopedList { + // A list of target instances contained in this scope. + repeated TargetInstance target_instances = 1 [json_name = "targetInstances"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of addresses when the list is + // empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_131.proto b/protos/google/cloud/compute/v1/internal/common_131.proto index d2501bd401b58..eba3bd2e917df 100644 --- a/protos/google/cloud/compute/v1/internal/common_131.proto +++ b/protos/google/cloud/compute/v1/internal/common_131.proto @@ -15,74 +15,71 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Target HTTPS Proxy resource. Google Compute Engine has two -// Target HTTPS Proxy resources: * -// [Global](/compute/docs/reference/rest/v1/targetHttpsProxies) * -// [Regional](/compute/docs/reference/rest/v1/regionTargetHttpsProxies) A target -// HTTPS proxy is a component of GCP HTTPS load balancers. * targetHttpProxies -// are used by global external Application Load Balancers, classic Application -// Load Balancers, cross-region internal Application Load Balancers, and Traffic -// Director. * regionTargetHttpProxies are used by regional internal Application -// Load Balancers and regional external Application Load Balancers. Forwarding -// rules reference a target HTTPS proxy, and the target proxy then references a -// URL map. For more information, read Using Target Proxies and Forwarding rule -// concepts. -message TargetHttpsProxy { - // Optional. A URL referring to a networksecurity.AuthorizationPolicy resource - // that describes how the proxy should authorize inbound traffic. If left - // blank, access will not be restricted by an authorization policy. Refer to - // the AuthorizationPolicy resource for additional details. - // authorizationPolicy only applies to a global TargetHttpsProxy attached to - // globalForwardingRules with the loadBalancingScheme set to - // INTERNAL_SELF_MANAGED. Note: This field currently has no impact. - optional string authorization_policy = 1 [json_name = "authorizationPolicy"]; - - // URL of a certificate map that identifies a certificate map associated with - // the given target proxy. This field can only be set for Global external - // Application Load Balancer or Classic Application Load Balancer. For other - // products use Certificate Manager Certificates instead. If set, - // sslCertificates will be ignored. Accepted format is - // //certificatemanager.googleapis.com/projects/{project - // }/locations/{location}/certificateMaps/{resourceName}. - optional string certificate_map = 2 [json_name = "certificateMap"]; +import "google/cloud/compute/v1/internal/common_047.proto"; +import "google/cloud/compute/v1/internal/common_050.proto"; +import "google/cloud/compute/v1/internal/common_061.proto"; + +// Represents a Target Pool resource. Target pools are used with external +// passthrough Network Load Balancers. A target pool references member +// instances, an associated legacy HttpHealthCheck resource, and, optionally, a +// backup target pool. For more information, read Using target pools. +message TargetPool { + // The server-defined URL for the resource. 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]. backupPool 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. In 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. + optional string backup_pool = 1 [json_name = "backupPool"]; // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 3 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 4 [json_name = "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 TargetHttpsProxy. An up-to-date fingerprint must be provided in - // order to patch the TargetHttpsProxy; otherwise, the request will fail with - // error 412 conditionNotMet. To see the latest fingerprint, make a get() - // request to retrieve the TargetHttpsProxy. - optional string fingerprint = 5 [json_name = "fingerprint"]; - - // Specifies how long to keep a connection open, after completing a response, - // while there is no matching traffic (in seconds). If an HTTP keep-alive is - // not specified, a default value (610 seconds) will be used. For global - // external Application Load Balancers, the minimum allowed value is 5 seconds - // and the maximum allowed value is 1200 seconds. For classic Application Load - // Balancers, this option is not supported. - optional int32 http_keep_alive_timeout_sec = 17 - [json_name = "httpKeepAliveTimeoutSec"]; + optional string description = 3 [json_name = "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]. If 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. In 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. + optional float failover_ratio = 4 [json_name = "failoverRatio"]; + + // The URL of the HttpHealthCheck resource. A member instance in this pool is + // considered healthy if and only if the health checks pass. Only legacy + // HttpHealthChecks are supported. Only one health check may be specified. + repeated string health_checks = 5 [json_name = "healthChecks"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. optional string id = 6 [json_name = "id"]; - // [Output Only] Type of resource. Always compute#targetHttpsProxy for target - // HTTPS proxies. - optional string kind = 7 [json_name = "kind"]; + // A list of resource URLs to the virtual machine instances serving this pool. + // They must live in zones contained in the same region as this pool. + repeated string instances = 7 [json_name = "instances"]; + + // [Output Only] Type of the resource. Always compute#targetPool for target + // pools. + optional string kind = 8 [json_name = "kind"]; // 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. @@ -91,117 +88,182 @@ message TargetHttpsProxy { // 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. - optional string name = 8 [json_name = "name"]; - - // This field only applies when the forwarding rule that references this - // target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When - // this field is set to true, Envoy proxies set up inbound traffic - // interception and bind to the IP address and port specified in the - // forwarding rule. This is generally useful when using Traffic Director to - // configure Envoy as a gateway or middle proxy (in other words, not a sidecar - // proxy). The Envoy proxy listens for inbound requests and handles requests - // when it receives them. The default is false. - optional bool proxy_bind = 9 [json_name = "proxyBind"]; - - // Specifies the QUIC override policy for this TargetHttpsProxy resource. This - // setting determines whether the load balancer attempts to negotiate QUIC - // with clients. You can specify NONE, ENABLE, or DISABLE. - When - // quic-override is set to NONE, Google manages whether QUIC is used. - When - // quic-override is set to ENABLE, the load balancer uses QUIC when possible. - // - When quic-override is set to DISABLE, the load balancer doesn't use QUIC. - // - If the quic-override flag is not specified, NONE is implied. - // DISABLE: The load balancer will not attempt to negotiate QUIC with clients. - // ENABLE: The load balancer will attempt to negotiate QUIC with clients. - // NONE: No overrides to the default QUIC policy. This option is implicit if - // no QUIC override has been specified in the request. - optional string quic_override = 10 [json_name = "quicOverride"]; - - // [Output Only] URL of the region where the regional TargetHttpsProxy - // resides. This field is not applicable to global TargetHttpsProxies. - optional string region = 11 [json_name = "region"]; + optional string name = 9 [json_name = "name"]; + + // [Output Only] URL of the region where the target pool resides. + optional string region = 10 [json_name = "region"]; + + // [Output Only] The resource URL for the security policy associated with this + // target pool. + optional string security_policy = 13 [json_name = "securityPolicy"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 12 [json_name = "selfLink"]; - - // Optional. A URL referring to a networksecurity.ServerTlsPolicy resource - // that describes how the proxy should authenticate inbound traffic. - // serverTlsPolicy only applies to a global TargetHttpsProxy attached to - // globalForwardingRules with the loadBalancingScheme set to - // INTERNAL_SELF_MANAGED or EXTERNAL or EXTERNAL_MANAGED. For details which - // ServerTlsPolicy resources are accepted with INTERNAL_SELF_MANAGED and which - // with EXTERNAL, EXTERNAL_MANAGED loadBalancingScheme consult ServerTlsPolicy - // documentation. If left blank, communications are not encrypted. - optional string server_tls_policy = 13 [json_name = "serverTlsPolicy"]; - - // URLs to SslCertificate resources that are used to authenticate connections - // between users and the load balancer. At least one SSL certificate must be - // specified. SslCertificates do not apply when the load balancing scheme is - // set to INTERNAL_SELF_MANAGED. The URLs should refer to a SSL Certificate - // resource or Certificate Manager Certificate resource. Mixing Classic - // Certificates and Certificate Manager Certificates is not allowed. - // Certificate Manager Certificates must include the certificatemanager API. - // Certificate Manager Certificates are not supported by Global external - // Application Load Balancer or Classic Application Load Balancer, use - // certificate_map instead. Currently, you may specify up to 15 Classic SSL - // Certificates. Certificate Manager Certificates accepted formats are: - - // //certificatemanager.googleapis.com/projects/{project}/locations/{ - // location}/certificates/{resourceName}. - - // https://certificatemanager.googleapis.com/v1alpha1/projects/{project - // }/locations/{location}/certificates/{resourceName}. - repeated string ssl_certificates = 14 [json_name = "sslCertificates"]; - - // URL of SslPolicy resource that will be associated with the TargetHttpsProxy - // resource. If not set, the TargetHttpsProxy resource has no SSL policy - // configured. - optional string ssl_policy = 15 [json_name = "sslPolicy"]; - - // Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted for - // this service. Early Data allows a TLS resumption handshake to include the - // initial application payload (a HTTP request) alongside the handshake, - // reducing the effective round trips to "zero". This applies to TLS 1.3 - // connections over TCP (HTTP/2) as well as over UDP (QUIC/h3). This can - // improve application performance, especially on networks where interruptions - // may be common, such as on mobile. Requests with Early Data will have the - // "Early-Data" HTTP header set on the request, with a value of "1", to allow - // the backend to determine whether Early Data was included. Note: TLS Early - // Data may allow requests to be replayed, as the data is sent to the backend - // before the handshake has fully completed. Applications that allow - // idempotent HTTP methods to make non-idempotent changes, such as a GET - // request updating a database, should not accept Early Data on those - // requests, and reject requests with the "Early-Data: 1" HTTP header by - // returning a HTTP 425 (Too Early) status code, in order to remain RFC - // compliant. The default value is DISABLED. - // DISABLED: TLS 1.3 Early Data is not advertised, and any (invalid) attempts - // to send Early Data will be rejected by closing the connection. - // PERMISSIVE: This enables TLS 1.3 0-RTT, and only allows Early Data to be - // included on requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE). - // This mode does not enforce any other limitations for requests with Early - // Data. The application owner should validate that Early Data is acceptable - // for a given request path. - // STRICT: This enables TLS 1.3 0-RTT, and only allows Early Data to be - // included on requests with safe HTTP methods (GET, HEAD, OPTIONS, TRACE) - // without query parameters. Requests that send Early Data with non-idempotent - // HTTP methods or with query parameters will be rejected with a HTTP 425. - optional string tls_early_data = 18 [json_name = "tlsEarlyData"]; - - // A fully-qualified or valid partial URL to the UrlMap resource that defines - // the mapping from URL to the BackendService. For example, the following are - // all valid URLs for specifying a URL map: - - // https://www.googleapis.compute/v1/projects/project/global/urlMaps/ url-map - // - projects/project/global/urlMaps/url-map - global/urlMaps/url-map - optional string url_map = 16 [json_name = "urlMap"]; + optional string self_link = 11 [json_name = "selfLink"]; + + // Session 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. + // CLIENT_IP: 2-tuple hash on packet's source and destination IP addresses. + // Connections from the same source IP address to the same destination IP + // address will be served by the same backend VM while that VM remains + // healthy. + // CLIENT_IP_NO_DESTINATION: 1-tuple hash only on packet's source IP address. + // Connections from the same source IP address will be served by the same + // backend VM while that VM remains healthy. This option can only be used for + // Internal TCP/UDP Load Balancing. + // CLIENT_IP_PORT_PROTO: 5-tuple hash on packet's source and destination IP + // addresses, IP protocol, and source and destination ports. Connections for + // the same IP protocol from the same source IP address and port to the same + // destination IP address and port will be served by the same backend VM while + // that VM remains healthy. This option cannot be used for HTTP(S) load + // balancing. + // CLIENT_IP_PROTO: 3-tuple hash on packet's source and destination IP + // addresses, and IP protocol. Connections for the same IP protocol from the + // same source IP address to the same destination IP address will be served by + // the same backend VM while that VM remains healthy. This option cannot be + // used for HTTP(S) load balancing. + // GENERATED_COOKIE: Hash based on a cookie generated by the L7 loadbalancer. + // Only valid for HTTP(S) load balancing. + // HEADER_FIELD: The hash is based on a user specified header field. + // HTTP_COOKIE: The hash is based on a user provided cookie. + // NONE: No session affinity. Connections from the same client IP may go to + // any instance in the pool. + // STRONG_COOKIE_AFFINITY: Strong cookie-based affinity. Connections bearing + // the same cookie will be served by the same backend VM while that VM remains + // healthy, as long as the cookie has not expired. + optional string session_affinity = 12 [json_name = "sessionAffinity"]; } -// Contains a list of TargetHttpsProxy resources. -message TargetHttpsProxyList { +message TargetPoolAggregatedList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of TargetHttpsProxy resources. - repeated TargetHttpsProxy items = 2 [json_name = "items"]; + // A list of TargetPool resources. + map items = 2 [json_name = "items"]; - // Type of resource. Always compute#targetHttpsProxyList for lists of target - // HTTPS proxies. + // [Output Only] Type of resource. Always compute#targetPoolAggregatedList for + // aggregated lists of target pools. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +message TargetPoolInstanceHealth { + repeated HealthStatus health_status = 1 [json_name = "healthStatus"]; + + // [Output Only] Type of resource. Always compute#targetPoolInstanceHealth + // when checking the health of an instance. + optional string kind = 2 [json_name = "kind"]; +} + +// Contains a list of TargetPool resources. +message TargetPoolList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of TargetPool resources. + repeated TargetPool items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#targetPoolList for lists of + // target pools. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -298,3 +360,123 @@ message TargetHttpsProxyList { // [Output Only] Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } + +message TargetPoolsAddHealthCheckRequest { + // The HttpHealthCheck to add to the target pool. + repeated HealthCheckReference health_checks = 1 [json_name = "healthChecks"]; +} + +message TargetPoolsAddInstanceRequest { + // A full or partial URL to an instance to add to this target pool. This can + // be a full or partial URL. For example, the following are valid URLs: - + // https://www.googleapis.com/compute/v1/projects/project-id/zones/zone + // /instances/instance-name - + // projects/project-id/zones/zone/instances/instance-name - + // zones/zone/instances/instance-name + repeated InstanceReference instances = 1 [json_name = "instances"]; +} + +message TargetPoolsRemoveHealthCheckRequest { + // Health check URL to be removed. This can be a full or valid partial URL. + // For example, the following are valid URLs: - + // https://www.googleapis.com/compute/beta/projects/project + // /global/httpHealthChecks/health-check - + // projects/project/global/httpHealthChecks/health-check - + // global/httpHealthChecks/health-check + repeated HealthCheckReference health_checks = 1 [json_name = "healthChecks"]; +} + +message TargetPoolsRemoveInstanceRequest { + // URLs of the instances to be removed from target pool. + repeated InstanceReference instances = 1 [json_name = "instances"]; +} + +message TargetPoolsScopedList { + // A list of target pools contained in this scope. + repeated TargetPool target_pools = 1 [json_name = "targetPools"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of addresses when the list is + // empty. + optional Warning warning = 2 [json_name = "warning"]; +} diff --git a/protos/google/cloud/compute/v1/internal/common_132.proto b/protos/google/cloud/compute/v1/internal/common_132.proto index a246eb8217616..7a85834349d8f 100644 --- a/protos/google/cloud/compute/v1/internal/common_132.proto +++ b/protos/google/cloud/compute/v1/internal/common_132.proto @@ -15,374 +15,12 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Target Instance resource. You can use a target instance to -// handle traffic for one or more forwarding rules, which is ideal for -// forwarding protocol traffic that is managed by a single source. For example, -// ESP, AH, TCP, or UDP. For more information, read Target instances. -message TargetInstance { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 3 [json_name = "id"]; - - // A URL to the virtual machine instance that handles traffic for this target - // instance. When creating a target instance, you can provide the - // fully-qualified URL or a valid partial URL to the desired virtual machine. - // For example, the following are all valid URLs: - - // https://www.googleapis.com/compute/v1/projects/project/zones/zone - // /instances/instance - projects/project/zones/zone/instances/instance - - // zones/zone/instances/instance - optional string instance = 4 [json_name = "instance"]; - - // [Output Only] The type of the resource. Always compute#targetInstance for - // target instances. - optional string kind = 5 [json_name = "kind"]; - - // 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. - optional string name = 6 [json_name = "name"]; - - // Must have a value of NO_NAT. Protocol forwarding delivers packets while - // preserving the destination IP address of the forwarding rule referencing - // the target instance. - // NO_NAT: No NAT performed. - optional string nat_policy = 7 [json_name = "natPolicy"]; - - // The URL of the network this target instance uses to forward traffic. If not - // specified, the traffic will be forwarded to the network that the default - // network interface belongs to. - optional string network = 8 [json_name = "network"]; - - // [Output Only] The resource URL for the security policy associated with this - // target instance. - optional string security_policy = 11 [json_name = "securityPolicy"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 9 [json_name = "selfLink"]; - - // [Output Only] URL of the zone where the target instance resides. You must - // specify this field as part of the HTTP request URL. It is not settable as a - // field in the request body. - optional string zone = 10 [json_name = "zone"]; -} - -message TargetInstanceAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of TargetInstance resources. - map items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -// Contains a list of TargetInstance resources. -message TargetInstanceList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of TargetInstance resources. - repeated TargetInstance items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -message TargetInstancesScopedList { - // A list of target instances contained in this scope. - repeated TargetInstance target_instances = 1 [json_name = "targetInstances"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of addresses when the list is - // empty. - optional Warning warning = 2 [json_name = "warning"]; +message TargetReference { + optional string target = 1 [json_name = "target"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_133.proto b/protos/google/cloud/compute/v1/internal/common_133.proto index cffbc61bb8cd6..14cc238682252 100644 --- a/protos/google/cloud/compute/v1/internal/common_133.proto +++ b/protos/google/cloud/compute/v1/internal/common_133.proto @@ -15,34 +15,50 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_049.proto"; -import "google/cloud/compute/v1/internal/common_052.proto"; -import "google/cloud/compute/v1/internal/common_063.proto"; +message TargetSslProxiesSetBackendServiceRequest { + // The URL of the new BackendService resource for the targetSslProxy. + optional string service = 1 [json_name = "service"]; +} + +message TargetSslProxiesSetCertificateMapRequest { + // URL of the Certificate Map to associate with this TargetSslProxy. Accepted + // format is //certificatemanager.googleapis.com/projects/{project + // }/locations/{location}/certificateMaps/{resourceName}. + optional string certificate_map = 1 [json_name = "certificateMap"]; +} + +message TargetSslProxiesSetProxyHeaderRequest { + // The new type of proxy header to append before sending data to the backend. + // NONE or PROXY_V1 are allowed. + // NONE: + // PROXY_V1: + optional string proxy_header = 1 [json_name = "proxyHeader"]; +} + +message TargetSslProxiesSetSslCertificatesRequest { + // New set of URLs to SslCertificate resources to associate with this + // TargetSslProxy. At least one SSL certificate must be specified. Currently, + // you may specify up to 15 SSL certificates. + repeated string ssl_certificates = 1 [json_name = "sslCertificates"]; +} -// Represents a Target Pool resource. Target pools are used with external -// passthrough Network Load Balancers. A target pool references member -// instances, an associated legacy HttpHealthCheck resource, and, optionally, a -// backup target pool. For more information, read Using target pools. -message TargetPool { - // The server-defined URL for the resource. 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]. backupPool 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. In 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. - optional string backup_pool = 1 [json_name = "backupPool"]; +// Represents a Target SSL Proxy resource. A target SSL proxy is a component of +// a Proxy Network Load Balancer. The forwarding rule references the target SSL +// proxy, and the target proxy then references a backend service. For more +// information, read Proxy Network Load Balancer overview. +message TargetSslProxy { + // URL of a certificate map that identifies a certificate map associated with + // the given target proxy. This field can only be set for global target + // proxies. If set, sslCertificates will be ignored. Accepted format is + // //certificatemanager.googleapis.com/projects/{project + // }/locations/{location}/certificateMaps/{resourceName}. + optional string certificate_map = 1 [json_name = "certificateMap"]; // [Output Only] Creation timestamp in RFC3339 text format. optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; @@ -51,35 +67,13 @@ message TargetPool { // create the resource. optional string description = 3 [json_name = "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]. If 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. In 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. - optional float failover_ratio = 4 [json_name = "failoverRatio"]; - - // The URL of the HttpHealthCheck resource. A member instance in this pool is - // considered healthy if and only if the health checks pass. Only legacy - // HttpHealthChecks are supported. Only one health check may be specified. - repeated string health_checks = 5 [json_name = "healthChecks"]; - // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 6 [json_name = "id"]; - - // A list of resource URLs to the virtual machine instances serving this pool. - // They must live in zones contained in the same region as this pool. - repeated string instances = 7 [json_name = "instances"]; + optional string id = 4 [json_name = "id"]; - // [Output Only] Type of the resource. Always compute#targetPool for target - // pools. - optional string kind = 8 [json_name = "kind"]; + // [Output Only] Type of the resource. Always compute#targetSslProxy for + // target SSL proxies. + optional string kind = 5 [json_name = "kind"]; // 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. @@ -88,179 +82,41 @@ message TargetPool { // 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. - optional string name = 9 [json_name = "name"]; + optional string name = 6 [json_name = "name"]; - // [Output Only] URL of the region where the target pool resides. - optional string region = 10 [json_name = "region"]; - - // [Output Only] The resource URL for the security policy associated with this - // target pool. - optional string security_policy = 13 [json_name = "securityPolicy"]; + // Specifies the type of proxy header to append before sending data to the + // backend, either NONE or PROXY_V1. The default is NONE. + // NONE: + // PROXY_V1: + optional string proxy_header = 7 [json_name = "proxyHeader"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 11 [json_name = "selfLink"]; - - // Session 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. - // CLIENT_IP: 2-tuple hash on packet's source and destination IP addresses. - // Connections from the same source IP address to the same destination IP - // address will be served by the same backend VM while that VM remains - // healthy. - // CLIENT_IP_NO_DESTINATION: 1-tuple hash only on packet's source IP address. - // Connections from the same source IP address will be served by the same - // backend VM while that VM remains healthy. This option can only be used for - // Internal TCP/UDP Load Balancing. - // CLIENT_IP_PORT_PROTO: 5-tuple hash on packet's source and destination IP - // addresses, IP protocol, and source and destination ports. Connections for - // the same IP protocol from the same source IP address and port to the same - // destination IP address and port will be served by the same backend VM while - // that VM remains healthy. This option cannot be used for HTTP(S) load - // balancing. - // CLIENT_IP_PROTO: 3-tuple hash on packet's source and destination IP - // addresses, and IP protocol. Connections for the same IP protocol from the - // same source IP address to the same destination IP address will be served by - // the same backend VM while that VM remains healthy. This option cannot be - // used for HTTP(S) load balancing. - // GENERATED_COOKIE: Hash based on a cookie generated by the L7 loadbalancer. - // Only valid for HTTP(S) load balancing. - // HEADER_FIELD: The hash is based on a user specified header field. - // HTTP_COOKIE: The hash is based on a user provided cookie. - // NONE: No session affinity. Connections from the same client IP may go to - // any instance in the pool. - optional string session_affinity = 12 [json_name = "sessionAffinity"]; -} - -message TargetPoolAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of TargetPool resources. - map items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#targetPoolAggregatedList for - // aggregated lists of target pools. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; + optional string self_link = 8 [json_name = "selfLink"]; - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; + // URL to the BackendService resource. + optional string service = 9 [json_name = "service"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; + // URLs to SslCertificate resources that are used to authenticate connections + // to Backends. At least one SSL certificate must be specified. Currently, you + // may specify up to 15 SSL certificates. sslCertificates do not apply when + // the load balancing scheme is set to INTERNAL_SELF_MANAGED. + repeated string ssl_certificates = 10 [json_name = "sslCertificates"]; - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + // URL of SslPolicy resource that will be associated with the TargetSslProxy + // resource. If not set, the TargetSslProxy resource will not have any SSL + // policy configured. + optional string ssl_policy = 11 [json_name = "sslPolicy"]; } -message TargetPoolInstanceHealth { - repeated HealthStatus health_status = 1 [json_name = "healthStatus"]; - - // [Output Only] Type of resource. Always compute#targetPoolInstanceHealth - // when checking the health of an instance. - optional string kind = 2 [json_name = "kind"]; -} - -// Contains a list of TargetPool resources. -message TargetPoolList { +// Contains a list of TargetSslProxy resources. +message TargetSslProxyList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of TargetPool resources. - repeated TargetPool items = 2 [json_name = "items"]; + // A list of TargetSslProxy resources. + repeated TargetSslProxy items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#targetPoolList for lists of - // target pools. + // Type of resource. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -357,123 +213,3 @@ message TargetPoolList { // [Output Only] Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } - -message TargetPoolsAddHealthCheckRequest { - // The HttpHealthCheck to add to the target pool. - repeated HealthCheckReference health_checks = 1 [json_name = "healthChecks"]; -} - -message TargetPoolsAddInstanceRequest { - // A full or partial URL to an instance to add to this target pool. This can - // be a full or partial URL. For example, the following are valid URLs: - - // https://www.googleapis.com/compute/v1/projects/project-id/zones/zone - // /instances/instance-name - - // projects/project-id/zones/zone/instances/instance-name - - // zones/zone/instances/instance-name - repeated InstanceReference instances = 1 [json_name = "instances"]; -} - -message TargetPoolsRemoveHealthCheckRequest { - // Health check URL to be removed. This can be a full or valid partial URL. - // For example, the following are valid URLs: - - // https://www.googleapis.com/compute/beta/projects/project - // /global/httpHealthChecks/health-check - - // projects/project/global/httpHealthChecks/health-check - - // global/httpHealthChecks/health-check - repeated HealthCheckReference health_checks = 1 [json_name = "healthChecks"]; -} - -message TargetPoolsRemoveInstanceRequest { - // URLs of the instances to be removed from target pool. - repeated InstanceReference instances = 1 [json_name = "instances"]; -} - -message TargetPoolsScopedList { - // A list of target pools contained in this scope. - repeated TargetPool target_pools = 1 [json_name = "targetPools"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of addresses when the list is - // empty. - optional Warning warning = 2 [json_name = "warning"]; -} diff --git a/protos/google/cloud/compute/v1/internal/common_134.proto b/protos/google/cloud/compute/v1/internal/common_134.proto index 0c8d9ff872f6c..1e5057995a8d8 100644 --- a/protos/google/cloud/compute/v1/internal/common_134.proto +++ b/protos/google/cloud/compute/v1/internal/common_134.proto @@ -15,12 +15,223 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message TargetReference { - optional string target = 1 [json_name = "target"]; +import "google/cloud/compute/v1/internal/common_135.proto"; + +message TargetTcpProxiesScopedList { + // A list of TargetTcpProxies contained in this scope. + repeated TargetTcpProxy target_tcp_proxies = 1 + [json_name = "targetTcpProxies"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of backend services when the + // list is empty. + optional Warning warning = 2 [json_name = "warning"]; +} + +message TargetTcpProxiesSetBackendServiceRequest { + // The URL of the new BackendService resource for the targetTcpProxy. + optional string service = 1 [json_name = "service"]; +} + +message TargetTcpProxiesSetProxyHeaderRequest { + // The new type of proxy header to append before sending data to the backend. + // NONE or PROXY_V1 are allowed. + // NONE: + // PROXY_V1: + optional string proxy_header = 1 [json_name = "proxyHeader"]; +} + +message TargetTcpProxyAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of TargetTcpProxiesScopedList resources. + map items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#targetTcpProxyAggregatedList + // for lists of Target TCP Proxies. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_135.proto b/protos/google/cloud/compute/v1/internal/common_135.proto index 657d785d1b929..aa4d3684a4fb9 100644 --- a/protos/google/cloud/compute/v1/internal/common_135.proto +++ b/protos/google/cloud/compute/v1/internal/common_135.proto @@ -15,65 +15,31 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message TargetSslProxiesSetBackendServiceRequest { - // The URL of the new BackendService resource for the targetSslProxy. - optional string service = 1 [json_name = "service"]; -} - -message TargetSslProxiesSetCertificateMapRequest { - // URL of the Certificate Map to associate with this TargetSslProxy. Accepted - // format is //certificatemanager.googleapis.com/projects/{project - // }/locations/{location}/certificateMaps/{resourceName}. - optional string certificate_map = 1 [json_name = "certificateMap"]; -} - -message TargetSslProxiesSetProxyHeaderRequest { - // The new type of proxy header to append before sending data to the backend. - // NONE or PROXY_V1 are allowed. - // NONE: - // PROXY_V1: - optional string proxy_header = 1 [json_name = "proxyHeader"]; -} - -message TargetSslProxiesSetSslCertificatesRequest { - // New set of URLs to SslCertificate resources to associate with this - // TargetSslProxy. At least one SSL certificate must be specified. Currently, - // you may specify up to 15 SSL certificates. - repeated string ssl_certificates = 1 [json_name = "sslCertificates"]; -} - -// Represents a Target SSL Proxy resource. A target SSL proxy is a component of -// a Proxy Network Load Balancer. The forwarding rule references the target SSL +// Represents a Target TCP Proxy resource. A target TCP proxy is a component of +// a Proxy Network Load Balancer. The forwarding rule references the target TCP // proxy, and the target proxy then references a backend service. For more // information, read Proxy Network Load Balancer overview. -message TargetSslProxy { - // URL of a certificate map that identifies a certificate map associated with - // the given target proxy. This field can only be set for global target - // proxies. If set, sslCertificates will be ignored. Accepted format is - // //certificatemanager.googleapis.com/projects/{project - // }/locations/{location}/certificateMaps/{resourceName}. - optional string certificate_map = 1 [json_name = "certificateMap"]; - +message TargetTcpProxy { // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; // An optional description of this resource. Provide this property when you // create the resource. - optional string description = 3 [json_name = "description"]; + optional string description = 2 [json_name = "description"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 4 [json_name = "id"]; + optional string id = 3 [json_name = "id"]; - // [Output Only] Type of the resource. Always compute#targetSslProxy for - // target SSL proxies. - optional string kind = 5 [json_name = "kind"]; + // [Output Only] Type of the resource. Always compute#targetTcpProxy for + // target TCP proxies. + optional string kind = 4 [json_name = "kind"]; // 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. @@ -82,7 +48,17 @@ message TargetSslProxy { // 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. - optional string name = 6 [json_name = "name"]; + optional string name = 5 [json_name = "name"]; + + // This field only applies when the forwarding rule that references this + // target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When + // this field is set to true, Envoy proxies set up inbound traffic + // interception and bind to the IP address and port specified in the + // forwarding rule. This is generally useful when using Traffic Director to + // configure Envoy as a gateway or middle proxy (in other words, not a sidecar + // proxy). The Envoy proxy listens for inbound requests and handles requests + // when it receives them. The default is false. + optional bool proxy_bind = 6 [json_name = "proxyBind"]; // Specifies the type of proxy header to append before sending data to the // backend, either NONE or PROXY_V1. The default is NONE. @@ -90,31 +66,24 @@ message TargetSslProxy { // PROXY_V1: optional string proxy_header = 7 [json_name = "proxyHeader"]; + // [Output Only] URL of the region where the regional TCP proxy resides. This + // field is not applicable to global TCP proxy. + optional string region = 8 [json_name = "region"]; + // [Output Only] Server-defined URL for the resource. - optional string self_link = 8 [json_name = "selfLink"]; + optional string self_link = 9 [json_name = "selfLink"]; // URL to the BackendService resource. - optional string service = 9 [json_name = "service"]; - - // URLs to SslCertificate resources that are used to authenticate connections - // to Backends. At least one SSL certificate must be specified. Currently, you - // may specify up to 15 SSL certificates. sslCertificates do not apply when - // the load balancing scheme is set to INTERNAL_SELF_MANAGED. - repeated string ssl_certificates = 10 [json_name = "sslCertificates"]; - - // URL of SslPolicy resource that will be associated with the TargetSslProxy - // resource. If not set, the TargetSslProxy resource will not have any SSL - // policy configured. - optional string ssl_policy = 11 [json_name = "sslPolicy"]; + optional string service = 10 [json_name = "service"]; } -// Contains a list of TargetSslProxy resources. -message TargetSslProxyList { +// Contains a list of TargetTcpProxy resources. +message TargetTcpProxyList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of TargetSslProxy resources. - repeated TargetSslProxy items = 2 [json_name = "items"]; + // A list of TargetTcpProxy resources. + repeated TargetTcpProxy items = 2 [json_name = "items"]; // Type of resource. optional string kind = 3 [json_name = "kind"]; diff --git a/protos/google/cloud/compute/v1/internal/common_136.proto b/protos/google/cloud/compute/v1/internal/common_136.proto index df6e1e874de07..45f71b12043b1 100644 --- a/protos/google/cloud/compute/v1/internal/common_136.proto +++ b/protos/google/cloud/compute/v1/internal/common_136.proto @@ -15,18 +15,108 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_137.proto"; +// Represents a Target VPN Gateway resource. The target VPN gateway resource +// represents a Classic Cloud VPN gateway. For more information, read the the +// Cloud VPN Overview. +message TargetVpnGateway { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; -message TargetTcpProxiesScopedList { - // A list of TargetTcpProxies contained in this scope. - repeated TargetTcpProxy target_tcp_proxies = 1 - [json_name = "targetTcpProxies"]; + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; + + // [Output Only] A list of URLs to the ForwardingRule resources. + // ForwardingRules are created using compute.forwardingRules.insert and + // associated with a VPN gateway. + repeated string forwarding_rules = 3 [json_name = "forwardingRules"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // [Output Only] Type of resource. Always compute#targetVpnGateway for target + // VPN gateways. + optional string kind = 5 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this TargetVpnGateway, which + // is essentially a hash of the labels set used for optimistic locking. The + // fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels, otherwise + // the request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve a TargetVpnGateway. + optional string label_fingerprint = 12 [json_name = "labelFingerprint"]; + + // Labels for this resource. These can only be added or modified by the + // setLabels method. Each label key/value pair must comply with RFC1035. Label + // values may be empty. + map labels = 13 [json_name = "labels"]; + + // 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. + optional string name = 6 [json_name = "name"]; + + // URL of the network to which this VPN gateway is attached. Provided by the + // client when the VPN gateway is created. + optional string network = 7 [json_name = "network"]; + + // [Output Only] URL of the region where the target VPN gateway resides. You + // must specify this field as part of the HTTP request URL. It is not settable + // as a field in the request body. + optional string region = 8 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 9 [json_name = "selfLink"]; + + // [Output Only] The status of the VPN gateway, which can be one of the + // following: CREATING, READY, FAILED, or DELETING. + // CREATING: + // DELETING: + // FAILED: + // READY: + optional string status = 10 [json_name = "status"]; + + // [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are created + // using the compute.vpntunnels.insert method and associated with a VPN + // gateway. + repeated string tunnels = 11 [json_name = "tunnels"]; +} + +message TargetVpnGatewayAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of TargetVpnGateway resources. + map items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#targetVpnGateway for target + // VPN gateways. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine @@ -109,33 +199,20 @@ message TargetTcpProxiesScopedList { optional string message = 3 [json_name = "message"]; } - // Informational warning which replaces the list of backend services when the - // list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} - -message TargetTcpProxiesSetBackendServiceRequest { - // The URL of the new BackendService resource for the targetTcpProxy. - optional string service = 1 [json_name = "service"]; -} - -message TargetTcpProxiesSetProxyHeaderRequest { - // The new type of proxy header to append before sending data to the backend. - // NONE or PROXY_V1 are allowed. - // NONE: - // PROXY_V1: - optional string proxy_header = 1 [json_name = "proxyHeader"]; + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; } -message TargetTcpProxyAggregatedList { +// Contains a list of TargetVpnGateway resources. +message TargetVpnGatewayList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of TargetTcpProxiesScopedList resources. - map items = 2 [json_name = "items"]; + // A list of TargetVpnGateway resources. + repeated TargetVpnGateway items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#targetTcpProxyAggregatedList - // for lists of Target TCP Proxies. + // [Output Only] Type of resource. Always compute#targetVpnGateway for target + // VPN gateways. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -148,9 +225,6 @@ message TargetTcpProxyAggregatedList { // [Output Only] Server-defined URL for this resource. optional string self_link = 5 [json_name = "selfLink"]; - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - message Warning { // [Output Only] A warning code, if applicable. For example, Compute Engine // returns NO_RESULTS_ON_PAGE if there are no results in the response. @@ -233,5 +307,96 @@ message TargetTcpProxyAggregatedList { } // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + optional Warning warning = 6 [json_name = "warning"]; +} + +message TargetVpnGatewaysScopedList { + // [Output Only] A list of target VPN gateways contained in this scope. + repeated TargetVpnGateway target_vpn_gateways = 1 + [json_name = "targetVpnGateways"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning which replaces the list of addresses + // when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_137.proto b/protos/google/cloud/compute/v1/internal/common_137.proto index 03236a2d51cc5..e756b9bf9f15b 100644 --- a/protos/google/cloud/compute/v1/internal/common_137.proto +++ b/protos/google/cloud/compute/v1/internal/common_137.proto @@ -15,170 +15,20 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Target TCP Proxy resource. A target TCP proxy is a component of -// a Proxy Network Load Balancer. The forwarding rule references the target TCP -// proxy, and the target proxy then references a backend service. For more -// information, read Proxy Network Load Balancer overview. -message TargetTcpProxy { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 3 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#targetTcpProxy for - // target TCP proxies. - optional string kind = 4 [json_name = "kind"]; - - // 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. - optional string name = 5 [json_name = "name"]; - - // This field only applies when the forwarding rule that references this - // target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When - // this field is set to true, Envoy proxies set up inbound traffic - // interception and bind to the IP address and port specified in the - // forwarding rule. This is generally useful when using Traffic Director to - // configure Envoy as a gateway or middle proxy (in other words, not a sidecar - // proxy). The Envoy proxy listens for inbound requests and handles requests - // when it receives them. The default is false. - optional bool proxy_bind = 6 [json_name = "proxyBind"]; - - // Specifies the type of proxy header to append before sending data to the - // backend, either NONE or PROXY_V1. The default is NONE. - // NONE: - // PROXY_V1: - optional string proxy_header = 7 [json_name = "proxyHeader"]; - - // [Output Only] URL of the region where the regional TCP proxy resides. This - // field is not applicable to global TCP proxy. - optional string region = 8 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 9 [json_name = "selfLink"]; - - // URL to the BackendService resource. - optional string service = 10 [json_name = "service"]; +message TestPermissionsRequest { + // The set of permissions to check for the 'resource'. Permissions with + // wildcards (such as '*' or 'storage.*') are not allowed. + repeated string permissions = 1 [json_name = "permissions"]; } -// Contains a list of TargetTcpProxy resources. -message TargetTcpProxyList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of TargetTcpProxy resources. - repeated TargetTcpProxy items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; +message TestPermissionsResponse { + // A subset of `TestPermissionsRequest.permissions` that the caller is + // allowed. + repeated string permissions = 1 [json_name = "permissions"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_138.proto b/protos/google/cloud/compute/v1/internal/common_138.proto index ef928c86d86bd..f517e56bead89 100644 --- a/protos/google/cloud/compute/v1/internal/common_138.proto +++ b/protos/google/cloud/compute/v1/internal/common_138.proto @@ -15,388 +15,40 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Target VPN Gateway resource. The target VPN gateway resource -// represents a Classic Cloud VPN gateway. For more information, read the the -// Cloud VPN Overview. -message TargetVpnGateway { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; - - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // [Output Only] A list of URLs to the ForwardingRule resources. - // ForwardingRules are created using compute.forwardingRules.insert and - // associated with a VPN gateway. - repeated string forwarding_rules = 3 [json_name = "forwardingRules"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 4 [json_name = "id"]; - - // [Output Only] Type of resource. Always compute#targetVpnGateway for target - // VPN gateways. - optional string kind = 5 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this TargetVpnGateway, which - // is essentially a hash of the labels set used for optimistic locking. The - // fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels, otherwise - // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve a TargetVpnGateway. - optional string label_fingerprint = 12 [json_name = "labelFingerprint"]; - - // Labels for this resource. These can only be added or modified by the - // setLabels method. Each label key/value pair must comply with RFC1035. Label - // values may be empty. - map labels = 13 [json_name = "labels"]; - - // 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. - optional string name = 6 [json_name = "name"]; - - // URL of the network to which this VPN gateway is attached. Provided by the - // client when the VPN gateway is created. - optional string network = 7 [json_name = "network"]; - - // [Output Only] URL of the region where the target VPN gateway resides. You - // must specify this field as part of the HTTP request URL. It is not settable - // as a field in the request body. - optional string region = 8 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 9 [json_name = "selfLink"]; - - // [Output Only] The status of the VPN gateway, which can be one of the - // following: CREATING, READY, FAILED, or DELETING. - // CREATING: - // DELETING: - // FAILED: - // READY: - optional string status = 10 [json_name = "status"]; - - // [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are created - // using the compute.vpntunnels.insert method and associated with a VPN - // gateway. - repeated string tunnels = 11 [json_name = "tunnels"]; -} - -message TargetVpnGatewayAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of TargetVpnGateway resources. - map items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#targetVpnGateway for target - // VPN gateways. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -// Contains a list of TargetVpnGateway resources. -message TargetVpnGatewayList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of TargetVpnGateway resources. - repeated TargetVpnGateway items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#targetVpnGateway for target - // VPN gateways. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -message TargetVpnGatewaysScopedList { - // [Output Only] A list of target VPN gateways contained in this scope. - repeated TargetVpnGateway target_vpn_gateways = 1 - [json_name = "targetVpnGateways"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning which replaces the list of addresses - // when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; +// Upcoming Maintenance notification information. +message UpcomingMaintenance { + // Indicates if the maintenance can be customer triggered. + optional bool can_reschedule = 1 [json_name = "canReschedule"]; + + // The latest time for the planned maintenance window to start. This timestamp + // value is in RFC3339 text format. + optional string latest_window_start_time = 2 + [json_name = "latestWindowStartTime"]; + + // ONGOING: There is ongoing maintenance on this VM. + // PENDING: There is pending maintenance. + // UNKNOWN: Unknown maintenance status. Do not use this value. + optional string maintenance_status = 3 [json_name = "maintenanceStatus"]; + + // Defines the type of maintenance. + // SCHEDULED: Scheduled maintenance (e.g. maintenance after uptime guarantee + // is complete). + // UNKNOWN_TYPE: No type specified. Do not use this value. + // UNSCHEDULED: Unscheduled maintenance (e.g. emergency maintenance during + // uptime guarantee). + optional string type = 4 [json_name = "type"]; + + // The time by which the maintenance disruption will be completed. This + // timestamp value is in RFC3339 text format. + optional string window_end_time = 5 [json_name = "windowEndTime"]; + + // The current start time of the maintenance window. This timestamp value is + // in RFC3339 text format. + optional string window_start_time = 6 [json_name = "windowStartTime"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_139.proto b/protos/google/cloud/compute/v1/internal/common_139.proto index cd055be681de1..a13a3731bf97b 100644 --- a/protos/google/cloud/compute/v1/internal/common_139.proto +++ b/protos/google/cloud/compute/v1/internal/common_139.proto @@ -15,20 +15,12 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message TestPermissionsRequest { - // The set of permissions to check for the 'resource'. Permissions with - // wildcards (such as '*' or 'storage.*') are not allowed. - repeated string permissions = 1 [json_name = "permissions"]; -} - -message TestPermissionsResponse { - // A subset of `TestPermissionsRequest.permissions` that the caller is - // allowed. - repeated string permissions = 1 [json_name = "permissions"]; +message UrlMapReference { + optional string url_map = 1 [json_name = "urlMap"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_140.proto b/protos/google/cloud/compute/v1/internal/common_140.proto index ca0b327651b4e..d09eafc12733a 100644 --- a/protos/google/cloud/compute/v1/internal/common_140.proto +++ b/protos/google/cloud/compute/v1/internal/common_140.proto @@ -15,40 +15,486 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Upcoming Maintenance notification information. -message UpcomingMaintenance { - // Indicates if the maintenance can be customer triggered. - optional bool can_reschedule = 1 [json_name = "canReschedule"]; - - // The latest time for the planned maintenance window to start. This timestamp - // value is in RFC3339 text format. - optional string latest_window_start_time = 2 - [json_name = "latestWindowStartTime"]; - - // ONGOING: There is ongoing maintenance on this VM. - // PENDING: There is pending maintenance. - // UNKNOWN: Unknown maintenance status. Do not use this value. - optional string maintenance_status = 3 [json_name = "maintenanceStatus"]; - - // Defines the type of maintenance. - // SCHEDULED: Scheduled maintenance (e.g. maintenance after uptime guarantee - // is complete). - // UNKNOWN_TYPE: No type specified. Do not use this value. - // UNSCHEDULED: Unscheduled maintenance (e.g. emergency maintenance during - // uptime guarantee). - optional string type = 4 [json_name = "type"]; - - // The time by which the maintenance disruption will be completed. This - // timestamp value is in RFC3339 text format. - optional string window_end_time = 5 [json_name = "windowEndTime"]; - - // The current start time of the maintenance window. This timestamp value is - // in RFC3339 text format. - optional string window_start_time = 6 [json_name = "windowStartTime"]; +// Represents a HA VPN gateway. HA VPN is a high-availability (HA) Cloud VPN +// solution that lets you securely connect your on-premises network to your +// Google Cloud Virtual Private Cloud network through an IPsec VPN connection in +// a single region. For more information about Cloud HA VPN solutions, see Cloud +// VPN topologies . +message VpnGateway { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; + + // The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not + // specified, IPV4 will be used. + // IPV4: Every HA-VPN gateway interface is configured with an IPv4 address. + // IPV6: Every HA-VPN gateway interface is configured with an IPv6 address. + optional string gateway_ip_version = 13 [json_name = "gatewayIpVersion"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 3 [json_name = "id"]; + + // [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + optional string kind = 4 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this VpnGateway, which is + // essentially a hash of the labels set used for optimistic locking. The + // fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels, otherwise + // the request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve a VpnGateway. + optional string label_fingerprint = 5 [json_name = "labelFingerprint"]; + + // Labels for this resource. These can only be added or modified by the + // setLabels method. Each label key/value pair must comply with RFC1035. Label + // values may be empty. + map labels = 6 [json_name = "labels"]; + + // 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. + optional string name = 7 [json_name = "name"]; + + // URL of the network to which this VPN gateway is attached. Provided by the + // client when the VPN gateway is created. + optional string network = 8 [json_name = "network"]; + + // [Output Only] URL of the region where the VPN gateway resides. + optional string region = 9 [json_name = "region"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 10 [json_name = "selfLink"]; + + // The stack type for this VPN gateway to identify the IP protocols that are + // enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not + // specified, IPV4_ONLY is used if the gateway IP version is IPV4, or + // IPV4_IPV6 if the gateway IP version is IPV6. + // IPV4_IPV6: Enable VPN gateway with both IPv4 and IPv6 protocols. + // IPV4_ONLY: Enable VPN gateway with only IPv4 protocol. + // IPV6_ONLY: Enable VPN gateway with only IPv6 protocol. + optional string stack_type = 11 [json_name = "stackType"]; + + // The list of VPN interfaces associated with this VPN gateway. + repeated VpnGatewayVpnGatewayInterface vpn_interfaces = 12 + [json_name = "vpnInterfaces"]; +} + +message VpnGatewayAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of VpnGateway resources. + map items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +// Contains a list of VpnGateway resources. +message VpnGatewayList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of VpnGateway resources. + repeated VpnGateway items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message VpnGatewayStatus { + // List of VPN connection for this VpnGateway. + repeated VpnGatewayStatusVpnConnection vpn_connections = 1 + [json_name = "vpnConnections"]; +} + +// Describes the high availability requirement state for the VPN connection +// between this Cloud VPN gateway and a peer gateway. +message VpnGatewayStatusHighAvailabilityRequirementState { + // Indicates the high availability requirement state for the VPN connection. + // Valid values are CONNECTION_REDUNDANCY_MET, CONNECTION_REDUNDANCY_NOT_MET. + // CONNECTION_REDUNDANCY_MET: VPN tunnels are configured with adequate + // redundancy from Cloud VPN gateway to the peer VPN gateway. For both + // GCP-to-non-GCP and GCP-to-GCP connections, the adequate redundancy is a + // pre-requirement for users to get 99.99% availability on GCP side; please + // note that for any connection, end-to-end 99.99% availability is subject to + // proper configuration on the peer VPN gateway. + // CONNECTION_REDUNDANCY_NOT_MET: VPN tunnels are not configured with adequate + // redundancy from the Cloud VPN gateway to the peer gateway + optional string state = 1 [json_name = "state"]; + + // Indicates the reason why the VPN connection does not meet the high + // availability redundancy criteria/requirement. Valid values is + // INCOMPLETE_TUNNELS_COVERAGE. + // INCOMPLETE_TUNNELS_COVERAGE: + optional string unsatisfied_reason = 2 [json_name = "unsatisfiedReason"]; +} + +// Contains some information about a VPN tunnel. +message VpnGatewayStatusTunnel { + // The VPN gateway interface this VPN tunnel is associated with. + optional uint32 local_gateway_interface = 1 + [json_name = "localGatewayInterface"]; + + // The peer gateway interface this VPN tunnel is connected to, the peer + // gateway could either be an external VPN gateway or a Google Cloud VPN + // gateway. + optional uint32 peer_gateway_interface = 2 + [json_name = "peerGatewayInterface"]; + + // URL reference to the VPN tunnel. + optional string tunnel_url = 3 [json_name = "tunnelUrl"]; +} + +// A VPN connection contains all VPN tunnels connected from this VpnGateway to +// the same peer gateway. The peer gateway could either be an external VPN +// gateway or a Google Cloud VPN gateway. +message VpnGatewayStatusVpnConnection { + // URL reference to the peer external VPN gateways to which the VPN tunnels in + // this VPN connection are connected. This field is mutually exclusive with + // peer_gcp_gateway. + optional string peer_external_gateway = 1 [json_name = "peerExternalGateway"]; + + // URL reference to the peer side VPN gateways to which the VPN tunnels in + // this VPN connection are connected. This field is mutually exclusive with + // peer_gcp_gateway. + optional string peer_gcp_gateway = 2 [json_name = "peerGcpGateway"]; + + // HighAvailabilityRequirementState for the VPN connection. + optional VpnGatewayStatusHighAvailabilityRequirementState state = 3 + [json_name = "state"]; + + // List of VPN tunnels that are in this VPN connection. + repeated VpnGatewayStatusTunnel tunnels = 4 [json_name = "tunnels"]; +} + +// A VPN gateway interface. +message VpnGatewayVpnGatewayInterface { + // [Output Only] Numeric identifier for this VPN interface associated with the + // VPN gateway. + optional uint32 id = 1 [json_name = "id"]; + + // URL of the VLAN attachment (interconnectAttachment) resource for this VPN + // gateway interface. When the value of this field is present, the VPN gateway + // is used for HA VPN over Cloud Interconnect; all egress or ingress traffic + // for this VPN gateway interface goes through the specified VLAN attachment + // resource. + optional string interconnect_attachment = 2 + [json_name = "interconnectAttachment"]; + + // [Output Only] IP address for this VPN interface associated with the VPN + // gateway. The IP address could be either a regional external IP address or a + // regional internal IP address. The two IP addresses for a VPN gateway must + // be all regional external or regional internal IP addresses. There cannot be + // a mix of regional external IP addresses and regional internal IP addresses. + // For HA VPN over Cloud Interconnect, the IP addresses for both interfaces + // could either be regional internal IP addresses or regional external IP + // addresses. For regular (non HA VPN over Cloud Interconnect) HA VPN tunnels, + // the IP address must be a regional external IP address. + optional string ip_address = 3 [json_name = "ipAddress"]; + + // [Output Only] IPv6 address for this VPN interface associated with the VPN + // gateway. The IPv6 address must be a regional external IPv6 address. The + // format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). + optional string ipv6_address = 4 [json_name = "ipv6Address"]; +} + +message VpnGatewaysGetStatusResponse { + optional VpnGatewayStatus result = 1 [json_name = "result"]; +} + +message VpnGatewaysScopedList { + // [Output Only] A list of VPN gateways contained in this scope. + repeated VpnGateway vpn_gateways = 1 [json_name = "vpnGateways"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning which replaces the list of addresses + // when the list is empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_141.proto b/protos/google/cloud/compute/v1/internal/common_141.proto index b83db34ec7498..abdda0798fac9 100644 --- a/protos/google/cloud/compute/v1/internal/common_141.proto +++ b/protos/google/cloud/compute/v1/internal/common_141.proto @@ -15,12 +15,468 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -message UrlMapReference { - optional string url_map = 1 [json_name = "urlMap"]; +// Represents a Cloud VPN Tunnel resource. For more information about VPN, read +// the the Cloud VPN Overview. +message VpnTunnel { + // [Output Only] Creation timestamp in RFC3339 text format. + optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + + // An optional description of this resource. Provide this property when you + // create the resource. + optional string description = 2 [json_name = "description"]; + + // [Output Only] Detailed status message for the VPN tunnel. + optional string detailed_status = 3 [json_name = "detailedStatus"]; + + // [Output Only] The unique identifier for the resource. This identifier is + // defined by the server. + optional string id = 4 [json_name = "id"]; + + // IKE protocol version to use when establishing the VPN tunnel with the peer + // VPN gateway. Acceptable IKE versions are 1 or 2. The default version is 2. + optional int32 ike_version = 5 [json_name = "ikeVersion"]; + + // [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + optional string kind = 6 [json_name = "kind"]; + + // A fingerprint for the labels being applied to this VpnTunnel, which is + // essentially a hash of the labels set used for optimistic locking. The + // fingerprint is initially generated by Compute Engine and changes after + // every request to modify or update labels. You must always provide an + // up-to-date fingerprint hash in order to update or change labels, otherwise + // the request will fail with error 412 conditionNotMet. To see the latest + // fingerprint, make a get() request to retrieve a VpnTunnel. + optional string label_fingerprint = 23 [json_name = "labelFingerprint"]; + + // Labels for this resource. These can only be added or modified by the + // setLabels method. Each label key/value pair must comply with RFC1035. Label + // values may be empty. + map labels = 24 [json_name = "labels"]; + + // Local traffic selector to use when establishing the VPN tunnel with the + // peer VPN gateway. The value should be a CIDR formatted string, for example: + // 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported for + // Classic VPN tunnels. This field is output only for HA VPN tunnels. + repeated string local_traffic_selector = 7 + [json_name = "localTrafficSelector"]; + + // 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. + optional string name = 8 [json_name = "name"]; + + // URL of the peer side external VPN gateway to which this VPN tunnel is + // connected. Provided by the client when the VPN tunnel is created. This + // field is exclusive with the field peerGcpGateway. + optional string peer_external_gateway = 9 [json_name = "peerExternalGateway"]; + + // The interface ID of the external VPN gateway to which this VPN tunnel is + // connected. Provided by the client when the VPN tunnel is created. Possible + // values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the + // external VPN gateway redundancy type. + optional int32 peer_external_gateway_interface = 10 + [json_name = "peerExternalGatewayInterface"]; + + // URL of the peer side HA VPN gateway to which this VPN tunnel is connected. + // Provided by the client when the VPN tunnel is created. This field can be + // used when creating highly available VPN from VPC network to VPC network, + // the field is exclusive with the field peerExternalGateway. If provided, the + // VPN tunnel will automatically use the same vpnGatewayInterface ID in the + // peer Google Cloud VPN gateway. + optional string peer_gcp_gateway = 11 [json_name = "peerGcpGateway"]; + + // IP address of the peer VPN gateway. Only IPv4 is supported. This field can + // be set only for Classic VPN tunnels. + optional string peer_ip = 12 [json_name = "peerIp"]; + + // [Output Only] URL of the region where the VPN tunnel resides. You must + // specify this field as part of the HTTP request URL. It is not settable as a + // field in the request body. + optional string region = 13 [json_name = "region"]; + + // Remote traffic selectors to use when establishing the VPN tunnel with the + // peer VPN gateway. The value should be a CIDR formatted string, for example: + // 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported for + // Classic VPN tunnels. This field is output only for HA VPN tunnels. + repeated string remote_traffic_selector = 14 + [json_name = "remoteTrafficSelector"]; + + // URL of the router resource to be used for dynamic routing. + optional string router = 15 [json_name = "router"]; + + // [Output Only] Server-defined URL for the resource. + optional string self_link = 16 [json_name = "selfLink"]; + + // Shared secret used to set the secure session between the Cloud VPN gateway + // and the peer VPN gateway. + optional string shared_secret = 17 [json_name = "sharedSecret"]; + + // Hash of the shared secret. + optional string shared_secret_hash = 18 [json_name = "sharedSecretHash"]; + + // [Output Only] The status of the VPN tunnel, which can be one of the + // following: - PROVISIONING: Resource is being allocated for the VPN tunnel. + // - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs from + // the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route + // resources are needed to setup the VPN tunnel. - FIRST_HANDSHAKE: Successful + // first handshake with the peer VPN. - ESTABLISHED: Secure session is + // successfully established with the peer VPN. - NETWORK_ERROR: Deprecated, + // replaced by NO_INCOMING_PACKETS - AUTHORIZATION_ERROR: Auth error (for + // example, bad shared secret). - NEGOTIATION_FAILURE: Handshake failed. - + // DEPROVISIONING: Resources are being deallocated for the VPN tunnel. - + // FAILED: Tunnel creation has failed and the tunnel is not ready to be used. + // - NO_INCOMING_PACKETS: No incoming packets from peer. - REJECTED: Tunnel + // configuration was rejected, can be result of being denied access. - + // ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all + // required resources. - STOPPED: Tunnel is stopped due to its Forwarding + // Rules being deleted for Classic VPN tunnels or the project is in frozen + // state. - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, + // probably behind NAT. - TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing + // not allowed for an HA-VPN tunnel. + // ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all + // required resources (specifically, a borg task). + // AUTHORIZATION_ERROR: Auth error (e.g. bad shared secret). + // DEPROVISIONING: Resources is being deallocated for the VPN tunnel. + // ESTABLISHED: Secure session is successfully established with peer VPN. + // FAILED: Tunnel creation has failed and the tunnel is not ready to be used. + // FIRST_HANDSHAKE: Successful first handshake with peer VPN. + // NEGOTIATION_FAILURE: Handshake failed. + // NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS + // NO_INCOMING_PACKETS: No incoming packets from peer + // PROVISIONING: Resource is being allocated for the VPN tunnel. + // REJECTED: Tunnel configuration was rejected, can be result of being + // denylisted. + // STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted. + // WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs from + // user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule and Route + // resources are needed to setup VPN tunnel. + optional string status = 19 [json_name = "status"]; + + // URL of the Target VPN gateway with which this VPN tunnel is associated. + // Provided by the client when the VPN tunnel is created. This field can be + // set only for Classic VPN tunnels. + optional string target_vpn_gateway = 20 [json_name = "targetVpnGateway"]; + + // URL of the VPN gateway with which this VPN tunnel is associated. Provided + // by the client when the VPN tunnel is created. This must be used (instead of + // target_vpn_gateway) if a High Availability VPN gateway resource is created. + optional string vpn_gateway = 21 [json_name = "vpnGateway"]; + + // The interface ID of the VPN gateway with which this VPN tunnel is + // associated. Possible values are: `0`, `1`. + optional int32 vpn_gateway_interface = 22 [json_name = "vpnGatewayInterface"]; +} + +message VpnTunnelAggregatedList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of VpnTunnelsScopedList resources. + map items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + // [Output Only] Unreachable resources. + repeated string unreachables = 6 [json_name = "unreachables"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 7 [json_name = "warning"]; +} + +// Contains a list of VpnTunnel resources. +message VpnTunnelList { + // [Output Only] Unique identifier for the resource; defined by the server. + optional string id = 1 [json_name = "id"]; + + // A list of VpnTunnel resources. + repeated VpnTunnel items = 2 [json_name = "items"]; + + // [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. + optional string kind = 3 [json_name = "kind"]; + + // [Output Only] This token allows you to get the next page of results for + // list requests. If the number of results is larger than maxResults, use the + // nextPageToken as a value for the query parameter pageToken in the next list + // request. Subsequent list requests will have their own nextPageToken to + // continue paging through the results. + optional string next_page_token = 4 [json_name = "nextPageToken"]; + + // [Output Only] Server-defined URL for this resource. + optional string self_link = 5 [json_name = "selfLink"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // [Output Only] Informational warning message. + optional Warning warning = 6 [json_name = "warning"]; +} + +message VpnTunnelsScopedList { + // A list of VPN tunnels contained in this scope. + repeated VpnTunnel vpn_tunnels = 1 [json_name = "vpnTunnels"]; + + message Warning { + // [Output Only] A warning code, if applicable. For example, Compute Engine + // returns NO_RESULTS_ON_PAGE if there are no results in the response. + // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by + // a failed operation. + // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. + // DEPRECATED_TYPE_USED: When deploying and at least one of the resources + // has a type marked as deprecated + // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is + // larger than image size. + // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources + // has a type marked as experimental + // EXTERNAL_API_WARNING: Warning that is present in an external api call + // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. + // Deprecated unused field. + // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected + // kernel, which is deprecated. + // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend + // service is associated with a health check that is not of type + // HTTP/HTTPS/HTTP2. + // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly + // large number of resources + // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list + // overhead quota exceed which captures the amount of resources filtered out + // by user-defined list filter. + // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type + // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not + // assigned to an instance on the network. + // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip + // forward. + // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL + // refers to an instance that does not have an ipv6 interface on the same + // network as the route. + // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an + // instance that does not exist. + // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers + // to an instance that is not on the same network as the route. + // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a + // status of RUNNING. + // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue + // the process despite the mentioned error. + // NO_RESULTS_ON_PAGE: No results are present on a particular list page. + // PARTIAL_SUCCESS: Success is reported, but some results may be missing due + // to errors + // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that + // requires a TOS they have not accepted. + // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in + // use. + // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete + // could not be deleted because they were in use. + // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. + // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance + // group manager is valid as such, but its application does not make a lot + // of sense, because it allows only single instance in instance group. + // UNDECLARED_PROPERTIES: When undeclared properties in the schema are + // present + // UNREACHABLE: A given scope cannot be reached. + optional string code = 1 [json_name = "code"]; + + message DataItem { + // [Output Only] A key that provides more detail on the warning being + // returned. For example, for warnings where there are no results in a + // list request for a particular zone, this key might be scope and the key + // value might be the zone name. Other examples might be a key indicating + // a deprecated resource and a suggested replacement, or a warning about + // invalid network settings (for example, if an instance attempts to + // perform IP forwarding but is not enabled for IP forwarding). + optional string key = 1 [json_name = "key"]; + + // [Output Only] A warning data value corresponding to the key. + optional string value = 2 [json_name = "value"]; + } + + // [Output Only] Metadata about this warning in key: value format. For + // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } + repeated DataItem data = 2 [json_name = "data"]; + + // [Output Only] A human-readable description of the warning code. + optional string message = 3 [json_name = "message"]; + } + + // Informational warning which replaces the list of addresses when the list is + // empty. + optional Warning warning = 2 [json_name = "warning"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_142.proto b/protos/google/cloud/compute/v1/internal/common_142.proto index fc6449fcf1cdb..bf80ec8eeeb39 100644 --- a/protos/google/cloud/compute/v1/internal/common_142.proto +++ b/protos/google/cloud/compute/v1/internal/common_142.proto @@ -15,202 +15,65 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a HA VPN gateway. HA VPN is a high-availability (HA) Cloud VPN -// solution that lets you securely connect your on-premises network to your -// Google Cloud Virtual Private Cloud network through an IPsec VPN connection in -// a single region. For more information about Cloud HA VPN solutions, see Cloud -// VPN topologies . -message VpnGateway { +import "google/cloud/compute/v1/internal/common_022.proto"; + +// Represents a Zone resource. A zone is a deployment area. These deployment +// areas are subsets of a region. For example the zone us-east1-b is located in +// the us-east1 region. For more information, read Regions and Zones. +message Zone { + // [Output Only] Available cpu/platform selections for the zone. + repeated string available_cpu_platforms = 1 + [json_name = "availableCpuPlatforms"]; + // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; + optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; + // [Output Only] The deprecation status associated with this zone. + optional DeprecationStatus deprecated = 3 [json_name = "deprecated"]; - // The IP family of the gateway IPs for the HA-VPN gateway interfaces. If not - // specified, IPV4 will be used. - // IPV4: Every HA-VPN gateway interface is configured with an IPv4 address. - // IPV6: Every HA-VPN gateway interface is configured with an IPv6 address. - optional string gateway_ip_version = 13 [json_name = "gatewayIpVersion"]; + // [Output Only] Textual description of the resource. + optional string description = 4 [json_name = "description"]; // [Output Only] The unique identifier for the resource. This identifier is // defined by the server. - optional string id = 3 [json_name = "id"]; - - // [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. - optional string kind = 4 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this VpnGateway, which is - // essentially a hash of the labels set used for optimistic locking. The - // fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels, otherwise - // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve a VpnGateway. - optional string label_fingerprint = 5 [json_name = "labelFingerprint"]; + optional string id = 5 [json_name = "id"]; - // Labels for this resource. These can only be added or modified by the - // setLabels method. Each label key/value pair must comply with RFC1035. Label - // values may be empty. - map labels = 6 [json_name = "labels"]; + // [Output Only] Type of the resource. Always compute#zone for zones. + optional string kind = 6 [json_name = "kind"]; - // 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. + // [Output Only] Name of the resource. optional string name = 7 [json_name = "name"]; - // URL of the network to which this VPN gateway is attached. Provided by the - // client when the VPN gateway is created. - optional string network = 8 [json_name = "network"]; - - // [Output Only] URL of the region where the VPN gateway resides. - optional string region = 9 [json_name = "region"]; + // [Output Only] Full URL reference to the region which hosts the zone. + optional string region = 8 [json_name = "region"]; // [Output Only] Server-defined URL for the resource. - optional string self_link = 10 [json_name = "selfLink"]; - - // The stack type for this VPN gateway to identify the IP protocols that are - // enabled. Possible values are: IPV4_ONLY, IPV4_IPV6, IPV6_ONLY. If not - // specified, IPV4_ONLY is used if the gateway IP version is IPV4, or - // IPV4_IPV6 if the gateway IP version is IPV6. - // IPV4_IPV6: Enable VPN gateway with both IPv4 and IPv6 protocols. - // IPV4_ONLY: Enable VPN gateway with only IPv4 protocol. - // IPV6_ONLY: Enable VPN gateway with only IPv6 protocol. - optional string stack_type = 11 [json_name = "stackType"]; - - // The list of VPN interfaces associated with this VPN gateway. - repeated VpnGatewayVpnGatewayInterface vpn_interfaces = 12 - [json_name = "vpnInterfaces"]; -} - -message VpnGatewayAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of VpnGateway resources. - map items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; + optional string self_link = 9 [json_name = "selfLink"]; - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } + // [Output Only] Status of the zone, either UP or DOWN. + // DOWN: + // UP: + optional string status = 10 [json_name = "status"]; - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; + // [Output Only] Reserved for future use. + optional bool supports_pzs = 11 [json_name = "supportsPzs"]; } -// Contains a list of VpnGateway resources. -message VpnGatewayList { +// Contains a list of zone resources. +message ZoneList { // [Output Only] Unique identifier for the resource; defined by the server. optional string id = 1 [json_name = "id"]; - // A list of VpnGateway resources. - repeated VpnGateway items = 2 [json_name = "items"]; + // A list of Zone resources. + repeated Zone items = 2 [json_name = "items"]; - // [Output Only] Type of resource. Always compute#vpnGateway for VPN gateways. + // Type of resource. optional string kind = 3 [json_name = "kind"]; // [Output Only] This token allows you to get the next page of results for @@ -307,194 +170,3 @@ message VpnGatewayList { // [Output Only] Informational warning message. optional Warning warning = 6 [json_name = "warning"]; } - -message VpnGatewayStatus { - // List of VPN connection for this VpnGateway. - repeated VpnGatewayStatusVpnConnection vpn_connections = 1 - [json_name = "vpnConnections"]; -} - -// Describes the high availability requirement state for the VPN connection -// between this Cloud VPN gateway and a peer gateway. -message VpnGatewayStatusHighAvailabilityRequirementState { - // Indicates the high availability requirement state for the VPN connection. - // Valid values are CONNECTION_REDUNDANCY_MET, CONNECTION_REDUNDANCY_NOT_MET. - // CONNECTION_REDUNDANCY_MET: VPN tunnels are configured with adequate - // redundancy from Cloud VPN gateway to the peer VPN gateway. For both - // GCP-to-non-GCP and GCP-to-GCP connections, the adequate redundancy is a - // pre-requirement for users to get 99.99% availability on GCP side; please - // note that for any connection, end-to-end 99.99% availability is subject to - // proper configuration on the peer VPN gateway. - // CONNECTION_REDUNDANCY_NOT_MET: VPN tunnels are not configured with adequate - // redundancy from the Cloud VPN gateway to the peer gateway - optional string state = 1 [json_name = "state"]; - - // Indicates the reason why the VPN connection does not meet the high - // availability redundancy criteria/requirement. Valid values is - // INCOMPLETE_TUNNELS_COVERAGE. - // INCOMPLETE_TUNNELS_COVERAGE: - optional string unsatisfied_reason = 2 [json_name = "unsatisfiedReason"]; -} - -// Contains some information about a VPN tunnel. -message VpnGatewayStatusTunnel { - // The VPN gateway interface this VPN tunnel is associated with. - optional uint32 local_gateway_interface = 1 - [json_name = "localGatewayInterface"]; - - // The peer gateway interface this VPN tunnel is connected to, the peer - // gateway could either be an external VPN gateway or a Google Cloud VPN - // gateway. - optional uint32 peer_gateway_interface = 2 - [json_name = "peerGatewayInterface"]; - - // URL reference to the VPN tunnel. - optional string tunnel_url = 3 [json_name = "tunnelUrl"]; -} - -// A VPN connection contains all VPN tunnels connected from this VpnGateway to -// the same peer gateway. The peer gateway could either be an external VPN -// gateway or a Google Cloud VPN gateway. -message VpnGatewayStatusVpnConnection { - // URL reference to the peer external VPN gateways to which the VPN tunnels in - // this VPN connection are connected. This field is mutually exclusive with - // peer_gcp_gateway. - optional string peer_external_gateway = 1 [json_name = "peerExternalGateway"]; - - // URL reference to the peer side VPN gateways to which the VPN tunnels in - // this VPN connection are connected. This field is mutually exclusive with - // peer_gcp_gateway. - optional string peer_gcp_gateway = 2 [json_name = "peerGcpGateway"]; - - // HighAvailabilityRequirementState for the VPN connection. - optional VpnGatewayStatusHighAvailabilityRequirementState state = 3 - [json_name = "state"]; - - // List of VPN tunnels that are in this VPN connection. - repeated VpnGatewayStatusTunnel tunnels = 4 [json_name = "tunnels"]; -} - -// A VPN gateway interface. -message VpnGatewayVpnGatewayInterface { - // [Output Only] Numeric identifier for this VPN interface associated with the - // VPN gateway. - optional uint32 id = 1 [json_name = "id"]; - - // URL of the VLAN attachment (interconnectAttachment) resource for this VPN - // gateway interface. When the value of this field is present, the VPN gateway - // is used for HA VPN over Cloud Interconnect; all egress or ingress traffic - // for this VPN gateway interface goes through the specified VLAN attachment - // resource. - optional string interconnect_attachment = 2 - [json_name = "interconnectAttachment"]; - - // [Output Only] IP address for this VPN interface associated with the VPN - // gateway. The IP address could be either a regional external IP address or a - // regional internal IP address. The two IP addresses for a VPN gateway must - // be all regional external or regional internal IP addresses. There cannot be - // a mix of regional external IP addresses and regional internal IP addresses. - // For HA VPN over Cloud Interconnect, the IP addresses for both interfaces - // could either be regional internal IP addresses or regional external IP - // addresses. For regular (non HA VPN over Cloud Interconnect) HA VPN tunnels, - // the IP address must be a regional external IP address. - optional string ip_address = 3 [json_name = "ipAddress"]; - - // [Output Only] IPv6 address for this VPN interface associated with the VPN - // gateway. The IPv6 address must be a regional external IPv6 address. The - // format is RFC 5952 format (e.g. 2001:db8::2d9:51:0:0). - optional string ipv6_address = 4 [json_name = "ipv6Address"]; -} - -message VpnGatewaysGetStatusResponse { - optional VpnGatewayStatus result = 1 [json_name = "result"]; -} - -message VpnGatewaysScopedList { - // [Output Only] A list of VPN gateways contained in this scope. - repeated VpnGateway vpn_gateways = 1 [json_name = "vpnGateways"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning which replaces the list of addresses - // when the list is empty. - optional Warning warning = 2 [json_name = "warning"]; -} diff --git a/protos/google/cloud/compute/v1/internal/common_143.proto b/protos/google/cloud/compute/v1/internal/common_143.proto index aca4ebbb4d92a..69312bcddaf97 100644 --- a/protos/google/cloud/compute/v1/internal/common_143.proto +++ b/protos/google/cloud/compute/v1/internal/common_143.proto @@ -15,468 +15,20 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -// Represents a Cloud VPN Tunnel resource. For more information about VPN, read -// the the Cloud VPN Overview. -message VpnTunnel { - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 1 [json_name = "creationTimestamp"]; +message ZoneSetLabelsRequest { + // The fingerprint of the previous set of labels for this resource, used to + // detect conflicts. The fingerprint is initially generated by Compute Engine + // and changes after every request to modify or update labels. You must always + // provide an up-to-date fingerprint hash in order to update or change labels. + // Make a get() request to the resource to get the latest fingerprint. + optional string label_fingerprint = 1 [json_name = "labelFingerprint"]; - // An optional description of this resource. Provide this property when you - // create the resource. - optional string description = 2 [json_name = "description"]; - - // [Output Only] Detailed status message for the VPN tunnel. - optional string detailed_status = 3 [json_name = "detailedStatus"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 4 [json_name = "id"]; - - // IKE protocol version to use when establishing the VPN tunnel with the peer - // VPN gateway. Acceptable IKE versions are 1 or 2. The default version is 2. - optional int32 ike_version = 5 [json_name = "ikeVersion"]; - - // [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. - optional string kind = 6 [json_name = "kind"]; - - // A fingerprint for the labels being applied to this VpnTunnel, which is - // essentially a hash of the labels set used for optimistic locking. The - // fingerprint is initially generated by Compute Engine and changes after - // every request to modify or update labels. You must always provide an - // up-to-date fingerprint hash in order to update or change labels, otherwise - // the request will fail with error 412 conditionNotMet. To see the latest - // fingerprint, make a get() request to retrieve a VpnTunnel. - optional string label_fingerprint = 23 [json_name = "labelFingerprint"]; - - // Labels for this resource. These can only be added or modified by the - // setLabels method. Each label key/value pair must comply with RFC1035. Label - // values may be empty. - map labels = 24 [json_name = "labels"]; - - // Local traffic selector to use when establishing the VPN tunnel with the - // peer VPN gateway. The value should be a CIDR formatted string, for example: - // 192.168.0.0/16. The ranges must be disjoint. Only IPv4 is supported for - // Classic VPN tunnels. This field is output only for HA VPN tunnels. - repeated string local_traffic_selector = 7 - [json_name = "localTrafficSelector"]; - - // 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. - optional string name = 8 [json_name = "name"]; - - // URL of the peer side external VPN gateway to which this VPN tunnel is - // connected. Provided by the client when the VPN tunnel is created. This - // field is exclusive with the field peerGcpGateway. - optional string peer_external_gateway = 9 [json_name = "peerExternalGateway"]; - - // The interface ID of the external VPN gateway to which this VPN tunnel is - // connected. Provided by the client when the VPN tunnel is created. Possible - // values are: `0`, `1`, `2`, `3`. The number of IDs in use depends on the - // external VPN gateway redundancy type. - optional int32 peer_external_gateway_interface = 10 - [json_name = "peerExternalGatewayInterface"]; - - // URL of the peer side HA VPN gateway to which this VPN tunnel is connected. - // Provided by the client when the VPN tunnel is created. This field can be - // used when creating highly available VPN from VPC network to VPC network, - // the field is exclusive with the field peerExternalGateway. If provided, the - // VPN tunnel will automatically use the same vpnGatewayInterface ID in the - // peer Google Cloud VPN gateway. - optional string peer_gcp_gateway = 11 [json_name = "peerGcpGateway"]; - - // IP address of the peer VPN gateway. Only IPv4 is supported. This field can - // be set only for Classic VPN tunnels. - optional string peer_ip = 12 [json_name = "peerIp"]; - - // [Output Only] URL of the region where the VPN tunnel resides. You must - // specify this field as part of the HTTP request URL. It is not settable as a - // field in the request body. - optional string region = 13 [json_name = "region"]; - - // Remote traffic selectors to use when establishing the VPN tunnel with the - // peer VPN gateway. The value should be a CIDR formatted string, for example: - // 192.168.0.0/16. The ranges should be disjoint. Only IPv4 is supported for - // Classic VPN tunnels. This field is output only for HA VPN tunnels. - repeated string remote_traffic_selector = 14 - [json_name = "remoteTrafficSelector"]; - - // URL of the router resource to be used for dynamic routing. - optional string router = 15 [json_name = "router"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 16 [json_name = "selfLink"]; - - // Shared secret used to set the secure session between the Cloud VPN gateway - // and the peer VPN gateway. - optional string shared_secret = 17 [json_name = "sharedSecret"]; - - // Hash of the shared secret. - optional string shared_secret_hash = 18 [json_name = "sharedSecretHash"]; - - // [Output Only] The status of the VPN tunnel, which can be one of the - // following: - PROVISIONING: Resource is being allocated for the VPN tunnel. - // - WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs from - // the user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule, and Route - // resources are needed to setup the VPN tunnel. - FIRST_HANDSHAKE: Successful - // first handshake with the peer VPN. - ESTABLISHED: Secure session is - // successfully established with the peer VPN. - NETWORK_ERROR: Deprecated, - // replaced by NO_INCOMING_PACKETS - AUTHORIZATION_ERROR: Auth error (for - // example, bad shared secret). - NEGOTIATION_FAILURE: Handshake failed. - - // DEPROVISIONING: Resources are being deallocated for the VPN tunnel. - - // FAILED: Tunnel creation has failed and the tunnel is not ready to be used. - // - NO_INCOMING_PACKETS: No incoming packets from peer. - REJECTED: Tunnel - // configuration was rejected, can be result of being denied access. - - // ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all - // required resources. - STOPPED: Tunnel is stopped due to its Forwarding - // Rules being deleted for Classic VPN tunnels or the project is in frozen - // state. - PEER_IDENTITY_MISMATCH: Peer identity does not match peer IP, - // probably behind NAT. - TS_NARROWING_NOT_ALLOWED: Traffic selector narrowing - // not allowed for an HA-VPN tunnel. - // ALLOCATING_RESOURCES: Cloud VPN is in the process of allocating all - // required resources (specifically, a borg task). - // AUTHORIZATION_ERROR: Auth error (e.g. bad shared secret). - // DEPROVISIONING: Resources is being deallocated for the VPN tunnel. - // ESTABLISHED: Secure session is successfully established with peer VPN. - // FAILED: Tunnel creation has failed and the tunnel is not ready to be used. - // FIRST_HANDSHAKE: Successful first handshake with peer VPN. - // NEGOTIATION_FAILURE: Handshake failed. - // NETWORK_ERROR: Deprecated, replaced by NO_INCOMING_PACKETS - // NO_INCOMING_PACKETS: No incoming packets from peer - // PROVISIONING: Resource is being allocated for the VPN tunnel. - // REJECTED: Tunnel configuration was rejected, can be result of being - // denylisted. - // STOPPED: Tunnel is stopped due to its Forwarding Rules being deleted. - // WAITING_FOR_FULL_CONFIG: Waiting to receive all VPN-related configs from - // user. Network, TargetVpnGateway, VpnTunnel, ForwardingRule and Route - // resources are needed to setup VPN tunnel. - optional string status = 19 [json_name = "status"]; - - // URL of the Target VPN gateway with which this VPN tunnel is associated. - // Provided by the client when the VPN tunnel is created. This field can be - // set only for Classic VPN tunnels. - optional string target_vpn_gateway = 20 [json_name = "targetVpnGateway"]; - - // URL of the VPN gateway with which this VPN tunnel is associated. Provided - // by the client when the VPN tunnel is created. This must be used (instead of - // target_vpn_gateway) if a High Availability VPN gateway resource is created. - optional string vpn_gateway = 21 [json_name = "vpnGateway"]; - - // The interface ID of the VPN gateway with which this VPN tunnel is - // associated. Possible values are: `0`, `1`. - optional int32 vpn_gateway_interface = 22 [json_name = "vpnGatewayInterface"]; -} - -message VpnTunnelAggregatedList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of VpnTunnelsScopedList resources. - map items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - // [Output Only] Unreachable resources. - repeated string unreachables = 6 [json_name = "unreachables"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 7 [json_name = "warning"]; -} - -// Contains a list of VpnTunnel resources. -message VpnTunnelList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of VpnTunnel resources. - repeated VpnTunnel items = 2 [json_name = "items"]; - - // [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; -} - -message VpnTunnelsScopedList { - // A list of VPN tunnels contained in this scope. - repeated VpnTunnel vpn_tunnels = 1 [json_name = "vpnTunnels"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // Informational warning which replaces the list of addresses when the list is - // empty. - optional Warning warning = 2 [json_name = "warning"]; + // The labels to set for this resource. + map labels = 2 [json_name = "labels"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_144.proto b/protos/google/cloud/compute/v1/internal/common_144.proto index 6eb8e7e8b048e..8b29f464ba1c7 100644 --- a/protos/google/cloud/compute/v1/internal/common_144.proto +++ b/protos/google/cloud/compute/v1/internal/common_144.proto @@ -15,158 +15,25 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; package google.cloud.cpp.compute.v1; -import "google/cloud/compute/v1/internal/common_023.proto"; +import "google/cloud/compute/v1/internal/common_007.proto"; -// Represents a Zone resource. A zone is a deployment area. These deployment -// areas are subsets of a region. For example the zone us-east1-b is located in -// the us-east1 region. For more information, read Regions and Zones. -message Zone { - // [Output Only] Available cpu/platform selections for the zone. - repeated string available_cpu_platforms = 1 - [json_name = "availableCpuPlatforms"]; +message ZoneSetPolicyRequest { + // Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use + // 'policy' to specify bindings. + repeated Binding bindings = 1 [json_name = "bindings"]; - // [Output Only] Creation timestamp in RFC3339 text format. - optional string creation_timestamp = 2 [json_name = "creationTimestamp"]; + // Flatten Policy to create a backward compatible wire-format. Deprecated. Use + // 'policy' to specify the etag. + optional string etag = 2 [json_name = "etag"]; - // [Output Only] The deprecation status associated with this zone. - optional DeprecationStatus deprecated = 3 [json_name = "deprecated"]; - - // [Output Only] Textual description of the resource. - optional string description = 4 [json_name = "description"]; - - // [Output Only] The unique identifier for the resource. This identifier is - // defined by the server. - optional string id = 5 [json_name = "id"]; - - // [Output Only] Type of the resource. Always compute#zone for zones. - optional string kind = 6 [json_name = "kind"]; - - // [Output Only] Name of the resource. - optional string name = 7 [json_name = "name"]; - - // [Output Only] Full URL reference to the region which hosts the zone. - optional string region = 8 [json_name = "region"]; - - // [Output Only] Server-defined URL for the resource. - optional string self_link = 9 [json_name = "selfLink"]; - - // [Output Only] Status of the zone, either UP or DOWN. - // DOWN: - // UP: - optional string status = 10 [json_name = "status"]; - - // [Output Only] Reserved for future use. - optional bool supports_pzs = 11 [json_name = "supportsPzs"]; -} - -// Contains a list of zone resources. -message ZoneList { - // [Output Only] Unique identifier for the resource; defined by the server. - optional string id = 1 [json_name = "id"]; - - // A list of Zone resources. - repeated Zone items = 2 [json_name = "items"]; - - // Type of resource. - optional string kind = 3 [json_name = "kind"]; - - // [Output Only] This token allows you to get the next page of results for - // list requests. If the number of results is larger than maxResults, use the - // nextPageToken as a value for the query parameter pageToken in the next list - // request. Subsequent list requests will have their own nextPageToken to - // continue paging through the results. - optional string next_page_token = 4 [json_name = "nextPageToken"]; - - // [Output Only] Server-defined URL for this resource. - optional string self_link = 5 [json_name = "selfLink"]; - - message Warning { - // [Output Only] A warning code, if applicable. For example, Compute Engine - // returns NO_RESULTS_ON_PAGE if there are no results in the response. - // CLEANUP_FAILED: Warning about failed cleanup of transient changes made by - // a failed operation. - // DEPRECATED_RESOURCE_USED: A link to a deprecated resource was created. - // DEPRECATED_TYPE_USED: When deploying and at least one of the resources - // has a type marked as deprecated - // DISK_SIZE_LARGER_THAN_IMAGE_SIZE: The user created a boot disk that is - // larger than image size. - // EXPERIMENTAL_TYPE_USED: When deploying and at least one of the resources - // has a type marked as experimental - // EXTERNAL_API_WARNING: Warning that is present in an external api call - // FIELD_VALUE_OVERRIDEN: Warning that value of a field has been overridden. - // Deprecated unused field. - // INJECTED_KERNELS_DEPRECATED: The operation involved use of an injected - // kernel, which is deprecated. - // INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB: A WEIGHTED_MAGLEV backend - // service is associated with a health check that is not of type - // HTTP/HTTPS/HTTP2. - // LARGE_DEPLOYMENT_WARNING: When deploying a deployment with a exceedingly - // large number of resources - // LIST_OVERHEAD_QUOTA_EXCEED: Resource can't be retrieved due to list - // overhead quota exceed which captures the amount of resources filtered out - // by user-defined list filter. - // MISSING_TYPE_DEPENDENCY: A resource depends on a missing type - // NEXT_HOP_ADDRESS_NOT_ASSIGNED: The route's nextHopIp address is not - // assigned to an instance on the network. - // NEXT_HOP_CANNOT_IP_FORWARD: The route's next hop instance cannot ip - // forward. - // NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE: The route's nextHopInstance URL - // refers to an instance that does not have an ipv6 interface on the same - // network as the route. - // NEXT_HOP_INSTANCE_NOT_FOUND: The route's nextHopInstance URL refers to an - // instance that does not exist. - // NEXT_HOP_INSTANCE_NOT_ON_NETWORK: The route's nextHopInstance URL refers - // to an instance that is not on the same network as the route. - // NEXT_HOP_NOT_RUNNING: The route's next hop instance does not have a - // status of RUNNING. - // NOT_CRITICAL_ERROR: Error which is not critical. We decided to continue - // the process despite the mentioned error. - // NO_RESULTS_ON_PAGE: No results are present on a particular list page. - // PARTIAL_SUCCESS: Success is reported, but some results may be missing due - // to errors - // REQUIRED_TOS_AGREEMENT: The user attempted to use a resource that - // requires a TOS they have not accepted. - // RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING: Warning that a resource is in - // use. - // RESOURCE_NOT_DELETED: One or more of the resources set to auto-delete - // could not be deleted because they were in use. - // SCHEMA_VALIDATION_IGNORED: When a resource schema validation is ignored. - // SINGLE_INSTANCE_PROPERTY_TEMPLATE: Instance template used in instance - // group manager is valid as such, but its application does not make a lot - // of sense, because it allows only single instance in instance group. - // UNDECLARED_PROPERTIES: When undeclared properties in the schema are - // present - // UNREACHABLE: A given scope cannot be reached. - optional string code = 1 [json_name = "code"]; - - message DataItem { - // [Output Only] A key that provides more detail on the warning being - // returned. For example, for warnings where there are no results in a - // list request for a particular zone, this key might be scope and the key - // value might be the zone name. Other examples might be a key indicating - // a deprecated resource and a suggested replacement, or a warning about - // invalid network settings (for example, if an instance attempts to - // perform IP forwarding but is not enabled for IP forwarding). - optional string key = 1 [json_name = "key"]; - - // [Output Only] A warning data value corresponding to the key. - optional string value = 2 [json_name = "value"]; - } - - // [Output Only] Metadata about this warning in key: value format. For - // example: "data": [ { "key": "scope", "value": "zones/us-east1-d" } - repeated DataItem data = 2 [json_name = "data"]; - - // [Output Only] A human-readable description of the warning code. - optional string message = 3 [json_name = "message"]; - } - - // [Output Only] Informational warning message. - optional Warning warning = 6 [json_name = "warning"]; + // REQUIRED: The complete policy to be applied to the 'resource'. The size of + // the policy is limited to a few 10s of KB. An empty policy is in general a + // valid policy but certain services (like Projects) might reject them. + optional Policy policy = 3 [json_name = "policy"]; } diff --git a/protos/google/cloud/compute/v1/internal/common_145.proto b/protos/google/cloud/compute/v1/internal/common_145.proto deleted file mode 100644 index 74112bc77d703..0000000000000 --- a/protos/google/cloud/compute/v1/internal/common_145.proto +++ /dev/null @@ -1,34 +0,0 @@ -// Copyright 2024 Google LLC -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// https://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. - -// Generated by the C++ microgenerator. -// If you make any local changes, they will be lost. -// file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 - -syntax = "proto3"; - -package google.cloud.cpp.compute.v1; - -message ZoneSetLabelsRequest { - // The fingerprint of the previous set of labels for this resource, used to - // detect conflicts. The fingerprint is initially generated by Compute Engine - // and changes after every request to modify or update labels. You must always - // provide an up-to-date fingerprint hash in order to update or change labels. - // Make a get() request to the resource to get the latest fingerprint. - optional string label_fingerprint = 1 [json_name = "labelFingerprint"]; - - // The labels to set for this resource. - map labels = 2 [json_name = "labels"]; -} diff --git a/protos/google/cloud/compute/v1/internal/common_146.proto b/protos/google/cloud/compute/v1/internal/common_146.proto deleted file mode 100644 index c5abe802d3426..0000000000000 --- a/protos/google/cloud/compute/v1/internal/common_146.proto +++ /dev/null @@ -1,39 +0,0 @@ -// Copyright 2024 Google LLC -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// https://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. - -// Generated by the C++ microgenerator. -// If you make any local changes, they will be lost. -// file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 - -syntax = "proto3"; - -package google.cloud.cpp.compute.v1; - -import "google/cloud/compute/v1/internal/common_008.proto"; - -message ZoneSetPolicyRequest { - // Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use - // 'policy' to specify bindings. - repeated Binding bindings = 1 [json_name = "bindings"]; - - // Flatten Policy to create a backward compatible wire-format. Deprecated. Use - // 'policy' to specify the etag. - optional string etag = 2 [json_name = "etag"]; - - // REQUIRED: The complete policy to be applied to the 'resource'. The size of - // the policy is limited to a few 10s of KB. An empty policy is in general a - // valid policy but certain services (like Projects) might reject them. - optional Policy policy = 3 [json_name = "policy"]; -} diff --git a/protos/google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto b/protos/google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto index 7b1076a9975dc..17aee7427b479 100644 --- a/protos/google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto +++ b/protos/google/cloud/compute/vpn_gateways/v1/vpn_gateways.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,10 +24,10 @@ package google.cloud.cpp.compute.vpn_gateways.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_103.proto"; -import "google/cloud/compute/v1/internal/common_139.proto"; -import "google/cloud/compute/v1/internal/common_142.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_101.proto"; +import "google/cloud/compute/v1/internal/common_137.proto"; +import "google/cloud/compute/v1/internal/common_140.proto"; import "google/cloud/extended_operations.proto"; // Service for the vpnGateways resource. diff --git a/protos/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto b/protos/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto index 27f249d42e1f0..3133ee5859101 100644 --- a/protos/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto +++ b/protos/google/cloud/compute/vpn_tunnels/v1/vpn_tunnels.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,9 +24,9 @@ package google.cloud.cpp.compute.vpn_tunnels.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_103.proto"; -import "google/cloud/compute/v1/internal/common_143.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_101.proto"; +import "google/cloud/compute/v1/internal/common_141.proto"; import "google/cloud/extended_operations.proto"; // Service for the vpnTunnels resource. diff --git a/protos/google/cloud/compute/zone_operations/v1/zone_operations.proto b/protos/google/cloud/compute/zone_operations/v1/zone_operations.proto index 20c2ca155712d..97c2fc8240207 100644 --- a/protos/google/cloud/compute/zone_operations/v1/zone_operations.proto +++ b/protos/google/cloud/compute/zone_operations/v1/zone_operations.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,8 +24,8 @@ package google.cloud.cpp.compute.zone_operations.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_017.proto"; -import "google/cloud/compute/v1/internal/common_088.proto"; +import "google/cloud/compute/v1/internal/common_016.proto"; +import "google/cloud/compute/v1/internal/common_086.proto"; import "google/cloud/extended_operations.proto"; import "google/protobuf/empty.proto"; diff --git a/protos/google/cloud/compute/zones/v1/zones.proto b/protos/google/cloud/compute/zones/v1/zones.proto index 04825ca09c7c6..a262f76854bd3 100644 --- a/protos/google/cloud/compute/zones/v1/zones.proto +++ b/protos/google/cloud/compute/zones/v1/zones.proto @@ -15,7 +15,7 @@ // Generated by the C++ microgenerator. // If you make any local changes, they will be lost. // file:///workspace/generator/discovery/compute_public_google_rest_v1.json -// revision: 20240903 +// revision: 20241015 syntax = "proto3"; @@ -24,7 +24,7 @@ package google.cloud.cpp.compute.zones.v1; import "google/api/annotations.proto"; import "google/api/client.proto"; import "google/api/field_behavior.proto"; -import "google/cloud/compute/v1/internal/common_144.proto"; +import "google/cloud/compute/v1/internal/common_142.proto"; // Service for the zones resource. // https://cloud.google.com/compute/docs/reference/rest/v1/zones From 66dc414d3b035f7c9ecc3d86fcf7371060623f20 Mon Sep 17 00:00:00 2001 From: Scott Hart Date: Tue, 5 Nov 2024 11:06:06 -0500 Subject: [PATCH 3/3] formatting --- .../v1/backend_services_client.h | 2 +- .../firewall_policies_rest_connection_impl.cc | 80 +++++-------------- .../v1/region_backend_services_client.h | 2 +- .../v1/secure_source_manager_client.h | 12 +-- 4 files changed, 28 insertions(+), 68 deletions(-) diff --git a/google/cloud/compute/backend_services/v1/backend_services_client.h b/google/cloud/compute/backend_services/v1/backend_services_client.h index c82407b852f78..12f0dedaf1857 100644 --- a/google/cloud/compute/backend_services/v1/backend_services_client.h +++ b/google/cloud/compute/backend_services/v1/backend_services_client.h @@ -611,7 +611,7 @@ class BackendServicesClient { /// "/zones/us-east1-b/instanceGroups/lb-backend-example" } /// https://cloud.google.com/compute/docs/reference/rest/v1/backendServices/getHealth /// - /// @param project + /// @param project /// @param backend_service Name of the BackendService resource to which the queried instance belongs. /// @param resource_group_reference_resource The ResourceGroupReference for this request. /// @param opts Optional. Override the class-level options, such as retry and diff --git a/google/cloud/compute/firewall_policies/v1/internal/firewall_policies_rest_connection_impl.cc b/google/cloud/compute/firewall_policies/v1/internal/firewall_policies_rest_connection_impl.cc index b96dadb795e3e..5e59ef3a82c70 100644 --- a/google/cloud/compute/firewall_policies/v1/internal/firewall_policies_rest_connection_impl.cc +++ b/google/cloud/compute/firewall_policies/v1/internal/firewall_policies_rest_connection_impl.cc @@ -94,14 +94,10 @@ FirewallPoliciesRestConnectionImpl::AddAssociation( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { - r.set_operation(op); - }, + v1::GetOperationRequest& r) { r.set_operation(op); }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { - r.set_operation(op); - }); + v1::DeleteOperationRequest& r) { r.set_operation(op); }); } StatusOr @@ -223,14 +219,10 @@ FirewallPoliciesRestConnectionImpl::AddRule( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { - r.set_operation(op); - }, + v1::GetOperationRequest& r) { r.set_operation(op); }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { - r.set_operation(op); - }); + v1::DeleteOperationRequest& r) { r.set_operation(op); }); } StatusOr @@ -353,14 +345,10 @@ FirewallPoliciesRestConnectionImpl::CloneRules( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { - r.set_operation(op); - }, + v1::GetOperationRequest& r) { r.set_operation(op); }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { - r.set_operation(op); - }); + v1::DeleteOperationRequest& r) { r.set_operation(op); }); } StatusOr @@ -483,14 +471,10 @@ FirewallPoliciesRestConnectionImpl::DeleteFirewallPolicy( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { - r.set_operation(op); - }, + v1::GetOperationRequest& r) { r.set_operation(op); }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { - r.set_operation(op); - }); + v1::DeleteOperationRequest& r) { r.set_operation(op); }); } StatusOr @@ -676,14 +660,10 @@ FirewallPoliciesRestConnectionImpl::InsertFirewallPolicy( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { - r.set_operation(op); - }, + v1::GetOperationRequest& r) { r.set_operation(op); }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { - r.set_operation(op); - }); + v1::DeleteOperationRequest& r) { r.set_operation(op); }); } StatusOr @@ -862,14 +842,10 @@ FirewallPoliciesRestConnectionImpl::Move( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { - r.set_operation(op); - }, + v1::GetOperationRequest& r) { r.set_operation(op); }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { - r.set_operation(op); - }); + v1::DeleteOperationRequest& r) { r.set_operation(op); }); } StatusOr @@ -991,14 +967,10 @@ FirewallPoliciesRestConnectionImpl::PatchFirewallPolicy( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { - r.set_operation(op); - }, + v1::GetOperationRequest& r) { r.set_operation(op); }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { - r.set_operation(op); - }); + v1::DeleteOperationRequest& r) { r.set_operation(op); }); } StatusOr @@ -1120,14 +1092,10 @@ FirewallPoliciesRestConnectionImpl::PatchRule( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { - r.set_operation(op); - }, + v1::GetOperationRequest& r) { r.set_operation(op); }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { - r.set_operation(op); - }); + v1::DeleteOperationRequest& r) { r.set_operation(op); }); } StatusOr @@ -1250,14 +1218,10 @@ FirewallPoliciesRestConnectionImpl::RemoveAssociation( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { - r.set_operation(op); - }, + v1::GetOperationRequest& r) { r.set_operation(op); }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { - r.set_operation(op); - }); + v1::DeleteOperationRequest& r) { r.set_operation(op); }); } StatusOr @@ -1379,14 +1343,10 @@ FirewallPoliciesRestConnectionImpl::RemoveRule( }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::GetOperationRequest& r) { - r.set_operation(op); - }, + v1::GetOperationRequest& r) { r.set_operation(op); }, [request](std::string const& op, google::cloud::cpp::compute::global_organization_operations:: - v1::DeleteOperationRequest& r) { - r.set_operation(op); - }); + v1::DeleteOperationRequest& r) { r.set_operation(op); }); } StatusOr diff --git a/google/cloud/compute/region_backend_services/v1/region_backend_services_client.h b/google/cloud/compute/region_backend_services/v1/region_backend_services_client.h index 7852860a3e009..a2a5db98fc245 100644 --- a/google/cloud/compute/region_backend_services/v1/region_backend_services_client.h +++ b/google/cloud/compute/region_backend_services/v1/region_backend_services_client.h @@ -279,7 +279,7 @@ class RegionBackendServicesClient { /// Gets the most recent health check results for this regional BackendService. /// https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices/getHealth /// - /// @param project + /// @param project /// @param region Name of the region scoping this request. /// @param backend_service Name of the BackendService resource for which to get health. /// @param resource_group_reference_resource The ResourceGroupReference for this request. diff --git a/google/cloud/securesourcemanager/v1/secure_source_manager_client.h b/google/cloud/securesourcemanager/v1/secure_source_manager_client.h index 8e1067d90a76f..143f931a7e542 100644 --- a/google/cloud/securesourcemanager/v1/secure_source_manager_client.h +++ b/google/cloud/securesourcemanager/v1/secure_source_manager_client.h @@ -1047,9 +1047,9 @@ class SecureSourceManagerClient { /// /// CreateBranchRule creates a branch rule in a given repository. /// - /// @param parent - /// @param branch_rule - /// @param branch_rule_id + /// @param parent + /// @param branch_rule + /// @param branch_rule_id /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return A [`future`] that becomes satisfied when the LRO @@ -1170,7 +1170,7 @@ class SecureSourceManagerClient { /// /// ListBranchRules lists branch rules in a given repository. /// - /// @param parent + /// @param parent /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return a [StreamRange](@ref google::cloud::StreamRange) @@ -1304,7 +1304,7 @@ class SecureSourceManagerClient { /// /// UpdateBranchRule updates a branch rule. /// - /// @param branch_rule + /// @param branch_rule /// @param update_mask Required. Field mask is used to specify the fields to be overwritten in the /// branchRule resource by the update. /// The fields specified in the update_mask are relative to the resource, not @@ -1429,7 +1429,7 @@ class SecureSourceManagerClient { /// /// DeleteBranchRule deletes a branch rule. /// - /// @param name + /// @param name /// @param opts Optional. Override the class-level options, such as retry and /// backoff policies. /// @return A [`future`] that becomes satisfied when the LRO